.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================= EXT: Log analyzer ================= :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed: 2008-03-15T16:04:53 :Author: Michael Cannon :Email: michael@cannonbose.com :Info 3: :Info 4: .. _EXT-Log-analyzer: EXT: Log analyzer ================= Extension Key: **log\_analyzer** Copyright 2007, Michael Cannon, 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.com .. _Table-of-Contents: Table of Contents ----------------- **EXT: Log analyzer 1** **Introduction 1** Thank you 1 What does it do? 1 Screenshots 1 **Adminstration 3** Installing log\_analyzer 3 **Configuration 3** Advanced Configuration 4 Crontab 5 **Tutorial 5** Creation of new Log-recipient 5 Usage of Backend aggregator 5 **FAQ 6** **Known problems 6** .. _Introduction: Introduction ------------ .. _Thank-you: Thank you ^^^^^^^^^ A big thank you goes to Stonebriar Community Church, `http://www.stonebriar.org `_ , for sponsoring this extension's development and release to the TYPO3 Extension Repository. .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This extension is used to list changes made in the TYPO3 system that have been integrated with the TYPO3 system log. When combined with the difference\_viewer extension, the changes are clearly presented on a front-end page. This extension also provides a means to email the daily change report to a defined backend usergroup. .. _Screenshots: Screenshots ^^^^^^^^^^^ Backend List |img-1| Email |img-2| Report Summary |img-3| Report Change Log |img-4| .. _Adminstration: Adminstration ------------- Target group: Administrators .. _Installing-log-analyzer: Installing log\_analyzer ^^^^^^^^^^^^^^^^^^^^^^^^ For installing of log\_analyzer plug-in follow next steps: Select “Ext Manager” from TYPO3 Backend “Tools” section In the drop-down “Menu” choose “Import extensions” Search for “log\_analyzer” Download and install. Configure settings to your environment. .. _Configuration: Configuration ------------- After installing the log\_analyzer extension you have to configure it to your website. Configuration is handled through the Extension Manager through the log\_analyzer extension. Configuration Options |img-5| **page\_uid // UID of the page, where difference\_viewer plug-in is inserted. This page will be used to display table of differences.** **base\_url // Base URL for links in XLS-file. This property should be adjusted according to your website location.** **report\_period** **// Definition of time period for sending reports in seconds. Right now is set to twenty-four hours.** **be\_group** **// Definition of user’s group, to whom XLS-report will be sent.** .. _Advanced-Configuration: Advanced Configuration ^^^^^^^^^^^^^^^^^^^^^^ Target group - Developers In log\_analyzer/config.php you may perform some advanced configuration. **//Names of the tables and their convenient names, that will be used in “Content record type” list and “Type” column. You may define convenient names for tables from database here.** $tables\_names = array( 'pages' => 'Pages', 'tt\_news' => 'News', 'tt\_content' => 'Content', ); **// names of the fields and their convenient names, that will be used in “Title” column** $tables\_fields = array( 'pages' => 'pages.title', 'tt\_news' => 'tt\_news.title', 'tt\_content' => 'pages.title', 'be\_users' => 'be\_users.realName', ); **//$report\_type is used for internal class. This property MUST NOT be changed!!!** $report\_type = array( 'be' => 1, 'view\_daily' => 2, 'view\_custom' => 3, 'xls\_mail' => 4, ); **// filter for crontab. You may choose ‘all’ to send reports for all tables, where changes took place, or some specific.** $cron\_tables = array( 'all', //'tt\_news', //'tt\_content' ); **// log enable/disable for debug uses** if (!defined(LOGGER)) define('LOGGER',true); If you want to use log you should chmod log\_analyzer plug-in folder to 0775 and possibly create file log in this folder via “touch log”. .. _Crontab: Crontab ^^^^^^^ Edit log\_analyzer/cron\_job.sh to your web server environment and create a daily cronjob to call the script. You might have to \`chmod 0775 cron\_job.sh\`. .. _Tutorial: Tutorial -------- .. _Creation-of-new-Log-recipient: Creation of new Log-recipient ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Create a new backend usergroup group called “log\_subscribers” or whatever was specified in your log\_analyzer configuration. Create or edit the backend user to receive the log\_analyzer reports and add the backend usergroup “log\_subscribers”. .. _Usage-of-Backend-aggregator: Usage of Backend aggregator ^^^^^^^^^^^^^^^^^^^^^^^^^^^ **Mode “Dashboard”** In TYPO3 backend press “Log Analyzer” module icon. In right part of the screen filters for report’s generation are located Press “Calendar Wizard” (“ ”) button near field “From” to display calendar style date input. |img-6| In the window with calendar choose day(for example, 12 :sup:`th` of November) and in field “From” will appear 11-12-2007. |img-7| Press “Calendar Wizard” button near field “To”. And window with calendar will appears. In the window with calendar choose day(for example, 15th of November) and in field “To” will appear 11-15-2007. In list “Content record type” choose type of record that you want to see in generated report, for example: All(for choosing two and more items in this list, press “Shift” button and then press on the names of content record types with the help of right mouse button) |img-8| In list “Author” choose author of changes, whom you want to see in generated report, for example: All(for choosing two and more items in this list, press “Shift” button and then press on the names of authors with the help of right mouse button) |img-9| .. _FAQ: FAQ --- Use extension date2cal for show calendar wizard. If this extension is not installed in your system, input date in manual mode using MM-DD- YYYY input format. Use extension difference\_viewer for adding difference viewing to log reporting “see difference” links. .. _Known-problems: Known problems -------------- No known problems |img-10| EXT: Log analyzer - 6 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.jpeg .. :align: left .. :border: 0 .. :height: 577 .. :id: graphics1 .. :name: graphics1 .. :width: 576 .. |img-2| image:: img-2.jpeg .. :align: left .. :border: 0 .. :height: 121 .. :id: graphics21 .. :name: graphics21 .. :width: 576 .. |img-3| image:: img-3.jpeg .. :align: left .. :border: 0 .. :height: 133 .. :id: graphics22 .. :name: graphics22 .. :width: 576 .. |img-4| image:: img-4.jpeg .. :align: left .. :border: 0 .. :height: 150 .. :id: graphics23 .. :name: graphics23 .. :width: 576 .. |img-5| image:: img-5.jpeg .. :align: left .. :border: 0 .. :height: 580 .. :id: graphics2 .. :name: graphics2 .. :width: 576 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 89 .. :id: graphics8 .. :name: graphics8 .. :width: 220 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 169 .. :id: graphics9 .. :name: graphics9 .. :width: 261 .. |img-8| image:: img-8.png .. :align: left .. :border: 0 .. :height: 92 .. :id: graphics10 .. :name: graphics10 .. :width: 213 .. |img-9| image:: img-9.jpeg .. :align: left .. :border: 0 .. :height: 81 .. :id: graphics3 .. :name: graphics3 .. :width: 288 .. |img-10| image:: img-10.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102