GeneralTips.rst

General Tips

Typo3 Debug Mode

Manual to always display Exceptions and Errors in the backend and frontend of Typo3:

Typo3: Debugging and Development Setup

Errors

• Does the error happens on every page or only on a specific one?
• Does the error happens on every form or only on a specific one?

Tips:

• On general errors:
  • Always check the Javascript console of your browser, see :ref:`javascriptProblem`.
  • Always check the Webserver log files.

Procedure to Find an Irreproducible Error

• Find out the date and time on which the error occurred as precisely as possible
• Find out the user-name of the person who experienced the error
• Search the logs at the time of the Error:
  • qfq.log
    • location: fileadmin/protected/qfqProject/log/qfq.log
      • NOTE: The log directory has been moved into qfqProject with a recent upgrade of QFQ. For backwards compatibility logs are still stored in fileadmin/protected/log/ if that directory already exists.
    • Look for error messages which were sent to the user at that time. (search for user-name in file)
    • Look at actions performed during the time of Error
  • FormSubmitLog
    • location: table named 'FormSubmitLog' in the qfq database
    • In the SQL Table FormSubmitLog search the column FEUser for the user-name
    • does the data (in the column formData) submitted at the time of the error coincide with the data saved in the database?
  • sql.log
    • location: fileadmin/protected/log/sql.og
    • search for the form that was active when the error occurred:
      • e.g.: If the form is named 'requestGreview' search for 'form:requestGreview'

Caching

Content, generated by QFQ, is generally not cached. But the QFQ content records are cached by Typo3. This means if there is a content element 'Insert Records' on a page 'A' which includes a QFQ record from page 'B' and such QFQ record is modified (the SQL definition, not the delivered output), the new definition becomes by default only visible if the cached is cleared.

To simplify the situation, set on the page of the QFQ record (B) in Page TS Config:

TCEMAIN.clearCacheCmd = pages

QFQ specific