.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt =============== EXT: FireDevLog =============== :Created: 2010-02-18T17:33:18 :Changed by: Ingo Schmitt :Changed: 2011-03-30T12:20:28 :Classification: fire_devlog :Description: The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- :Keywords: firebug, firephp, devlog, logging, debug, forDevelopers :Author: Marketing Factory :Email: typo3@marketing-factory.de :Info 4: :Language: en |img-1| |img-2| EXT: FireDevLog - fire\_devlog .. _EXT-FireDevLog: EXT: FireDevLog =============== Extension Key: fire\_devlog Language: en Keywords: firebug, firephp, devlog, logging, debug, forDevelopers Copyright 2000-2011, Marketing Factory, Copyright 2011 -, Stefan Müller This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.org .. _Table-of-Contents: Table of Contents ----------------- `EXT: FireDevLog 1 <#__RefHeading__1085_501595654>`_ **`Introduction 3 <#__RefHeading__1087_501595654>`_** `What does it do? 3 <#__RefHeading__1089_501595654>`_ `Screenshots 3 <#__RefHeading__1091_501595654>`_ **`Users manual 4 <#__RefHeading__1093_501595654>`_** `Requirements 4 <#__RefHeading__1095_501595654>`_ `Installation 4 <#__RefHeading__1097_501595654>`_ `Extension configuration 4 <#__RefHeading__1099_501595654>`_ `FireBug and FirePHP configuration 4 <#__RefHeading__1101_501595654>`_ `Upgrading fire\_devlog from versions <= 1.1.0 5 <#__RefHeading__1371_501595654>`_ **`Known problems 6 <#__RefHeading__1103_501595654>`_** **`To-Do list 7 <#__RefHeading__1105_501595654>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ The fire\_devlog extension logs events from devlog into the Firebug Console by using FirePHP. .. _Screenshots: Screenshots ^^^^^^^^^^^ |img-3| .. _Users-manual: Users manual ------------ .. _Requirements: Requirements ^^^^^^^^^^^^ - Firefox browser - FireBug add-on - FirePHP >= 0.5.0 add-on. - TYPO3 4.3 or higher .. _Installation: Installation ^^^^^^^^^^^^ - Install latest stable Firefox Browser if you don't have one yet. (It's free) - Install latest stable FireBug add-on for Firefox - Install latest stable FirePHP add-on for Firefox, at least version 0.5.0 or higher. - Go to TYPO3 extension manager and import and install the extension fire\_devlog. .. _Extension-configuration: Extension configuration ^^^^^^^^^^^^^^^^^^^^^^^ - After installing the extension, the extension manager asks you that “ *This extension provides additional configuration options which become available once it is installed.* ”. Now click on the **Make updates** button. You will be prompted for the configuration: - |img-4| Activate the **Enable Logging** checkbox. This step is mandatory to use the extension! Please notice that as soon as you enable logging, the devlog data will be world readable public. Make sure that you restrict access to the logged data by using the other two settings. - When the **Limit access to logged in BE users** checkbox is activated, only Be users which are logged into the backend get access to the logging data. It is highly recommended to use this setting. - You can also limit access to a certain range of IP addresses by adding them to **Limit access to an IP Range** field. For example use 192.168.217.\* to limit access to hosts with IP addresses within 192.168.217.1 and 192.168.217.255 .. _FireBug-and-FirePHP-configuration: FireBug and FirePHP configuration ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - Open a page in the TYPO3 Frontend - Enable FireBug by clicking on the bug icon in the right lower corner of your browser: - |img-5| Enable FirePHP by clicking on the blue bug icon in the FireBug panel. - Turn off “modify user-agent header” - |img-6| - Enable Console and Net in the FireBug panel: - |img-7| That's it. As soon as you request a page which fires a devlog event, it will appear in the FireBug console .. _Upgrading-fire-devlog-from-versions-1-1-0: Upgrading fire\_devlog from versions <= 1.1.0 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ In versions higher than 1.1.0 a new option was introduced to explicitly enable logging. This option aims to protect users from accidentally revealing their logging data to the public. Here's what you should do after upgrading the extension in the extension manager: - Click on the extension in the extension manager to go to the extension settings. - Activate the **Enable logging** checkbox. - Check if the Limitation settings fit your privacy needs. .. _Known-problems: Known problems -------------- - Does not work with FirePHP below 0.5.0. - Please have a look at the issue tracker of the `fire\_devlog project `_ on TYPO3 forge. .. _To-Do-list: To-Do list ---------- Please have a look at the `fire\_devlog project `_ on TYPO3 forge. |img-2| 7 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 100 .. :id: Grafik1 .. :name: Grafik1 .. :width: 612 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 268 .. :id: Grafik3 .. :name: Grafik3 .. :width: 545 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik4 .. :name: Grafik4 .. :width: 21 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 298 .. :id: Grafik5 .. :name: Grafik5 .. :width: 514 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 280 .. :id: Grafik7 .. :name: Grafik7 .. :width: 611