Difference between revisions of "Show PHP Error Log"

From TNG_Wiki
Jump to: navigation, search
(TNG User sites using this mod)
 
(65 intermediate revisions by 16 users not shown)
Line 1: Line 1:
{{TNGmod
+
{{restricted}}{{TNGmod
| mod_name        = Show System Errors Log Mod
+
| mod_name        = Show PHP Error Log
| mod_summary    = Adds a menu option to view and optionally clear, the system error log within the Admin screen.
+
| mod_summary    = Adds a menu option to view and optionally clear, the PHP error log within the Admin screen.
 
| mod_validation  = The mod is XHTML compliant.[[Image:Valid-xhtml10.png|44px]]
 
| mod_validation  = The mod is XHTML compliant.[[Image:Valid-xhtml10.png|44px]]
| download_link  = [http://mfo.me.uk/ccount/click.php?id=7 Show System Errors Log Mod v10.0.3.0]{{Tv1003}}
+
| mod_last_update = 17 Apr 2019
| download_stats  = [http://mfo.me.uk/ccount/index.php?action=stats&groupid=1 See download statistics]
+
| download_link  = for {{Tv120}}[https://www.royandboucher.com/ccount/click.php?id=485&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} show_php_error_log_v12.0.0.6.zip]<hr />for {{Tv110}}{{Tv1003}}[https://www.royandboucher.com/ccount/click.php?id=424&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} show_php_error_log_v10.0.3.5.zip]
| mod_author      = [[User:HiTowerUK|Roger Mitchell]]
+
 
| mod_url        = [http://mfo.me.uk Mitchell Families Online]
+
| download_stats  = [https://www.royandboucher.com/ccount/index.php?action=stats&id=424-485 Download stats for Show PHP Error Log]<br />
| mod_support     = [http://mfo.me.uk/ccount/click.php?id=7 My Mod Support]
+
[http://mfo.me.uk/ccount/index.php?action=stats&groupid=1 stats for Show System Errors Log]
| mod_version    = 10.0.3.0 for TNG V10.0.3+
+
| mod_author      = [[User:KenRoy|Ken Roy]]<br />[[User:HiTowerUK|Roger Mitchell]] original mod author
 +
| mod_url        = [[Show PHP Error Log]] (this page)
 +
| mod_support    = [https://tng.community/ TNG Community Forums]
 +
| mod_contact     = [https://www.royandboucher.com/tng/mod_support.php Ken Roy]
 +
| mod_version    = 12.0.0.6 for TNG V12+<br />10.0.3.5 for TNG V10.0.3+
 
| min_TNG_ver    = 9.0.0+ (Not tested on versions earlier than TNG 10.0.3 but will probably work)
 
| min_TNG_ver    = 9.0.0+ (Not tested on versions earlier than TNG 10.0.3 but will probably work)
| max_TNG_ver    = 10+  
+
| max_TNG_ver    = 12+  
| TNG_file_list  = admin_rightbanner.php, creates adminshowerrorlog.php
+
| TNG_file_list  = admin_rightbanner.php, creates admin_showerrorlog.php (adminshowerrorlog.php before TNG v12)
 
| related_mods    = None
 
| related_mods    = None
 
| notes          = None
 
| notes          = None
 
   
 
   
 
}}
 
}}
{|align=right
+
<!--[http://mfo.me.uk/ccount/click.php?id=10 Show System Errors Log Mod v10.0.3.4]{{Tv1003}} -->
|__TOC__
+
 
 +
{| style="margin-right:0.5 em;" align="right"
 +
| __TOC__
 
|}
 
|}
 +
  
 
== Purpose ==
 
== Purpose ==
If  you've ever had site system errors, this mod gives access to the system  error log without the need to exit your site or download the error log.
+
If  you've ever had site system errors, this mod gives access to the PHP error log without the need to exit your site or download the error log.
 +
 
 +
The [[Show PHP Error Log]] mod also sorts the log entries to show the most recent errors first.
 +
 
 +
The [[Show PHP Error Log]] mod can be used on sites that do not normally provide access to the PHP error log by adding overrides to your php.ini or by creating a .user.ini file (PHP 5.3 and later) as documented in [[PHP error log]]
  
 
== Introduction ==
 
== Introduction ==
Line 27: Line 38:
  
 
== Visualisation ==
 
== Visualisation ==
This is how the report looks. You can see the additional menu in the header. (Customised template 12 on TNG v10.0.3)
+
 
 +
This is how the report looks. You can see the additional menu in the header.  
 
{|
 
{|
 
|-
 
|-
| [[File:System_errors_log.png]]
+
| [[File:Show_PHP_error_log_display.png]]
 
|}
 
|}
 +
 +
Note that v10.0.3.5 renamed Roger Mitchell's and changed the System Errors Log to '''PHP Error Log''' in the above screen capture
  
 
== Notes ==
 
== Notes ==
 +
* Version 10.0.3.5 renames the mod to Show PHP Error Log and fixes the overlay of the Mod Manager clear log text in languages other than English.
 +
:Adds custom text for French-UTF8,and Czech-UTF8, German-UTF8, and Spanish-UTF8 provided by Ron Krzmarzick, and Swedish-UTF8 provided by Erik Hoppe
 +
* Version 10.0.3.4 includes the option to select the error log path and name.
 
* This mod only includes English language variables. To add support for other languages, open and edit the .cfg file to add your language translations.
 
* This mod only includes English language variables. To add support for other languages, open and edit the .cfg file to add your language translations.
 +
: Version 10.0.3.5 added cust_text.php variables for Czech, French, German, Spanish, and Swedish languages
 
* Mod has not been tested on TNG versions below 10.0.3 but it is likely to work on all TNG versions.
 
* Mod has not been tested on TNG versions below 10.0.3 but it is likely to work on all TNG versions.
* The error log is set to follow the same number of entries as adminlog.txt (set from Admin >> Setup >> Log Settings). However, if this is set to have no restrictions, a maximum of 100 lines will be applied. There is no technical reason for this other than readability. This value can be changed if required, by editing the .cfg file.
+
* The error log is not limited to display a set number of entries. The entire log will be displayed with the latest entries appearing first.
 +
* This mod will work "out of the box" on most installations but I have identified a couple of sites where this isn't the case. Some hosts archive the error log at the end of each month and start a new log. If this is the case, then there is probably less to be gained from my mod.
 +
* If you don't understand the entries in the error log, please, DON'T ask me what they mean. You will have to seek advice from elsewhere (Mr. Google, for example!). Again, perhaps this mod isn't for you.
  
 
==Requirements==
 
==Requirements==
Line 42: Line 62:
 
* A working TNG installation.
 
* A working TNG installation.
 
* An installed current version of the [[Mod Manager]]
 
* An installed current version of the [[Mod Manager]]
 +
* Access to your PHP error log. See [[PHP error log]] on how to get access by overriding the PHP definition file
  
 
==[[Mod Manager - Installing Config Files | Automated Installation]] ==
 
==[[Mod Manager - Installing Config Files | Automated Installation]] ==
Line 47: Line 68:
 
# Extract the contents of the zip file into your mods folder and upload to your site.
 
# Extract the contents of the zip file into your mods folder and upload to your site.
 
#  Follow the normal automated installation for Mod Manager, as shown in  the example [[Mod Manager - Installing Config Files]] to install the  chosen cfg file.
 
#  Follow the normal automated installation for Mod Manager, as shown in  the example [[Mod Manager - Installing Config Files]] to install the  chosen cfg file.
 +
 +
== Mod Manager Edit Options ==
 +
 +
In Mod Manager >> Edit Options, enter the path and name of the log you wish to view. The default is '''../../logs/php_error.log'''.
 +
 +
[[File:Show PHP error log edit options.png|1024px|Edit Options]]<br />
 +
 +
== PHP error log location ==
 +
 +
See [[PHP_error_log#PHP_error_log_location|PHP error log location]] for information on where you can find the PHP error log on your hosting service site or your local computer web server environment.
  
 
==In the event of a problem with your TNG site==
 
==In the event of a problem with your TNG site==
  
 
# Try using the [[Mod Manager]] Remove capability, or
 
# Try using the [[Mod Manager]] Remove capability, or
#  Restore backup copy of: personlib.php.
+
#  Restore backup copy of: admin_righbanner.php.
  
 
==Revision History==
 
==Revision History==
Line 59: Line 90:
 
! Date
 
! Date
 
! Contents
 
! Contents
 +
|-
 +
| v12.0.0.6
 +
| 17 Apr 2019
 +
| Updated by Ken Roy for TNG v12 cust_text.php insertion guidelines
 +
Updated Edit Option screen and mod description to make it easier to understand the installation and PHP error log access requirements
 +
|-
 +
| v10.0.3.5
 +
| 22 Jan 2018
 +
| Updated by Ken Roy to fix overlay of Mod Manager clearlog text in languages other than English
 +
Added cust_text.php for French-UTF8 <br />
 +
Added cust_text.php for Czech-UTF8, German-UTF8, and Spanish-UTF8 provided by Ron Krzmarzick<br />
 +
Added cust_text.php for Swedish-UTF8 provided by Erik Hoppe
 +
|-
 +
| v10.0.3.4
 +
| 23 May 2015
 +
| Added facility to select which log to view. Set from Mod Options page in Mod Manager
 +
|-
 +
| v10.0.3.3
 +
| 21 May 2015
 +
| Bug relating to sort order discovered by Del Groves has now been fixed. Limits on number of items displayed has been removed to allow whole log to be viewed.
 
|-
 
|-
 
| v10.0.3.0
 
| v10.0.3.0
Line 81: Line 132:
 
| [[User:HiTowerUK|Roger Mitchell]]
 
| [[User:HiTowerUK|Roger Mitchell]]
 
| Mod developer
 
| Mod developer
 +
| V10.0.3.4
 +
| 10.1.1
 +
| EN
 +
|-
 +
| [http://www.katiandgraham.com/genelaogy Chamberlain & Eidenbenz Genealogy]
 +
| [[User:hiraeth|Graham Chamberlain]]
 +
|
 
| V10.0.3.0
 
| V10.0.3.0
 
| 10.0.3
 
| 10.0.3
 +
| EN,DE,ES,FR,NL
 +
|-
 +
| [http://www.robisonandblythe.org/index.php Robison & Blythe Genealogy]
 +
| [[User:jefr58|Jeff Robison]]
 +
| Public Site
 +
| V10.0.3.4
 +
| 10.1.1
 +
| EN
 +
|-
 +
| [https://www.bradyfamilytree.org/ Brady Family Tree in Western Australia]
 +
| [[User:bradyfamilytree|Darryl Brady]]
 +
| Public site
 +
| V10.0.3.4
 +
| 10.1.1
 +
| EN, DE
 +
|-
 +
| [https://www.royandboucher.com/tng/ Our Roy and Boucher Family]
 +
| [[User:Ken Roy|Ken Roy]]
 +
| Use to view PHP error log on site where logs are not normally accessible.  See [[PHP error log]]
 +
| V12.0.0.6
 +
| 12.1.0
 +
| EN, FR
 +
|-
 +
| [https://genealogywings.com/ MOTYER Family Genealogy]
 +
| [[User:JMM|John Mark Motyer]]
 +
| Public site
 +
| [[User:JMM|see here]]
 +
| [[User:JMM|see here]]
 +
| EN, DE, RU
 +
|-
 +
| [https://donquigley.net Quigley Doyle Family Tree]
 +
| [[User:dwqwiz|Don Quigley]]
 +
| Public Site
 +
| 10.0.3.4
 +
| 10.1.1
 
| EN
 
| EN
 +
|-
 +
| [http://bumbery.com/ Bumbery-Wangler]
 +
| [[User:Bob|Bob Bumbery]]
 +
| Public Site
 +
| 10.0.3.4
 +
| 11.1.2
 +
| English
 +
|-
 +
| [https://www.kmtrees.com/index.php Roots & Relatives Remembered]
 +
| [[User:tngrlkrz| Ron Krzmarzick]]
 +
| Public & Private
 +
| 12.0.0.6
 +
| [https://kmtrees.com/modlist_wiki?whichoptions=basic&cachemethod=3&sortby=filename See Here]
 +
| EN,DE,CS,ES
 +
|-
 +
| [http://colegenealogy.dynu.net/ Cole / Tanner Family Tree]
 +
| [[User:dlcole|David Cole]]
 +
| Public/Private
 +
| [[User:Dlcole|see here]]
 +
| [[User:Dlcole|see here]]
 +
| English
 +
|-
 +
| [https://www.ourfamilyhistories.org Our Family Histories]
 +
| [[User: Bsl20b50|Bryan S. Larson]]
 +
| Public
 +
| [[User: Bsl20b50|See Here]]
 +
| [[User: Bsl20b50|See Here]]
 +
| EN
 +
|-
 +
| [https://www.jegersberg.com Jegersberg.com]
 +
| [[User:cfj|C. Jegersberg]]
 +
| Public & Private
 +
| 12.0.0.6
 +
| 12.1
 +
| NO,EN,SE
 +
|-
 +
| [http://slekt.solem.info/tng/ Solem Genealogy]
 +
| [[User:JTS|Jan-Thore Solem]]
 +
| Public & Private
 +
| 12.0.0.6
 +
| 12.1
 +
| NO,EN
 
|-
 
|-
 
| ...
 
| ...
Line 93: Line 228:
 
|}
 
|}
  
 +
[[Category:Mods for TNG v12]]
 +
[[Category:Mods for TNG v11]]
 
[[Category:Mods for TNG v10]]
 
[[Category:Mods for TNG v10]]
 +
[[Category:admin_rightbanner.php mods]]

Latest revision as of 11:54, 22 July 2019

Restricted Downloads of Show PHP Error Log are restricted to logged in users. If you do not have a user account on the TNG Wiki use the Request Account link to request a user account Restricted


Show PHP Error Log
Summary Adds a menu option to view and optionally clear, the PHP error log within the Admin screen.
Validation The mod is XHTML compliant.Valid-xhtml10.png
Mod Updated 17 Apr 2019
Download link for
TNG 12.0
show_php_error_log_v12.0.0.6.zip
for
TNG 11.0
TNG 10.0.3
show_php_error_log_v10.0.3.5.zip
Download stats Download stats for Show PHP Error Log
stats for Show System Errors Log
Author(s) Ken Roy
Roger Mitchell original mod author
Homepage Show PHP Error Log (this page)
Mod Support TNG Community Forums
Contact Developer Ken Roy
Latest Mod 12.0.0.6 for TNG V12+
10.0.3.5 for TNG V10.0.3+
Min TNG V 9.0.0+ (Not tested on versions earlier than TNG 10.0.3 but will probably work)
Max TNG V 12+
Files modified
admin_rightbanner.php, creates admin_showerrorlog.php (adminshowerrorlog.php before TNG v12)
Related Mods
None
Notes
None



Purpose

If you've ever had site system errors, this mod gives access to the PHP error log without the need to exit your site or download the error log.

The Show PHP Error Log mod also sorts the log entries to show the most recent errors first.

The Show PHP Error Log mod can be used on sites that do not normally provide access to the PHP error log by adding overrides to your php.ini or by creating a .user.ini file (PHP 5.3 and later) as documented in PHP error log

Introduction

Adds a menu option to view and optionally clear, the system error log within the Admin screen. The link to display this report is added to the top (horizontal) menu bar in the admin section of your site. The log is sorted in reverse chronological order to the way it is written, thus displaying the latest errors at the top.

Visualisation

This is how the report looks. You can see the additional menu in the header.

Show PHP error log display.png

Note that v10.0.3.5 renamed Roger Mitchell's and changed the System Errors Log to PHP Error Log in the above screen capture

Notes

  • Version 10.0.3.5 renames the mod to Show PHP Error Log and fixes the overlay of the Mod Manager clear log text in languages other than English.
Adds custom text for French-UTF8,and Czech-UTF8, German-UTF8, and Spanish-UTF8 provided by Ron Krzmarzick, and Swedish-UTF8 provided by Erik Hoppe
  • Version 10.0.3.4 includes the option to select the error log path and name.
  • This mod only includes English language variables. To add support for other languages, open and edit the .cfg file to add your language translations.
Version 10.0.3.5 added cust_text.php variables for Czech, French, German, Spanish, and Swedish languages
  • Mod has not been tested on TNG versions below 10.0.3 but it is likely to work on all TNG versions.
  • The error log is not limited to display a set number of entries. The entire log will be displayed with the latest entries appearing first.
  • This mod will work "out of the box" on most installations but I have identified a couple of sites where this isn't the case. Some hosts archive the error log at the end of each month and start a new log. If this is the case, then there is probably less to be gained from my mod.
  • If you don't understand the entries in the error log, please, DON'T ask me what they mean. You will have to seek advice from elsewhere (Mr. Google, for example!). Again, perhaps this mod isn't for you.

Requirements

  • A working TNG installation.
  • An installed current version of the Mod Manager
  • Access to your PHP error log. See PHP error log on how to get access by overriding the PHP definition file

Automated Installation

  1. Download the zip file from the download links in the mod summary area in the upper right.
  2. Extract the contents of the zip file into your mods folder and upload to your site.
  3. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the chosen cfg file.

Mod Manager Edit Options

In Mod Manager >> Edit Options, enter the path and name of the log you wish to view. The default is ../../logs/php_error.log.

Edit Options

PHP error log location

See PHP error log location for information on where you can find the PHP error log on your hosting service site or your local computer web server environment.

In the event of a problem with your TNG site

  1. Try using the Mod Manager Remove capability, or
  2. Restore backup copy of: admin_righbanner.php.

Revision History

Version Date Contents
v12.0.0.6 17 Apr 2019 Updated by Ken Roy for TNG v12 cust_text.php insertion guidelines

Updated Edit Option screen and mod description to make it easier to understand the installation and PHP error log access requirements

v10.0.3.5 22 Jan 2018 Updated by Ken Roy to fix overlay of Mod Manager clearlog text in languages other than English

Added cust_text.php for French-UTF8
Added cust_text.php for Czech-UTF8, German-UTF8, and Spanish-UTF8 provided by Ron Krzmarzick
Added cust_text.php for Swedish-UTF8 provided by Erik Hoppe

v10.0.3.4 23 May 2015 Added facility to select which log to view. Set from Mod Options page in Mod Manager
v10.0.3.3 21 May 2015 Bug relating to sort order discovered by Del Groves has now been fixed. Limits on number of items displayed has been removed to allow whole log to be viewed.
v10.0.3.0 20 November 2014 Initial release

TNG User sites using this mod

If you download and install this mod, please add your TNG sites to the table below

URL User Note Mod-Version TNG-Version User-language
Mitchell Families Online Roger Mitchell Mod developer V10.0.3.4 10.1.1 EN
Chamberlain & Eidenbenz Genealogy Graham Chamberlain V10.0.3.0 10.0.3 EN,DE,ES,FR,NL
Robison & Blythe Genealogy Jeff Robison Public Site V10.0.3.4 10.1.1 EN
Brady Family Tree in Western Australia Darryl Brady Public site V10.0.3.4 10.1.1 EN, DE
Our Roy and Boucher Family Ken Roy Use to view PHP error log on site where logs are not normally accessible. See PHP error log V12.0.0.6 12.1.0 EN, FR
MOTYER Family Genealogy John Mark Motyer Public site see here see here EN, DE, RU
Quigley Doyle Family Tree Don Quigley Public Site 10.0.3.4 10.1.1 EN
Bumbery-Wangler Bob Bumbery Public Site 10.0.3.4 11.1.2 English
Roots & Relatives Remembered Ron Krzmarzick Public & Private 12.0.0.6 See Here EN,DE,CS,ES
Cole / Tanner Family Tree David Cole Public/Private see here see here English
Our Family Histories Bryan S. Larson Public See Here See Here EN
Jegersberg.com C. Jegersberg Public & Private 12.0.0.6 12.1 NO,EN,SE
Solem Genealogy Jan-Thore Solem Public & Private 12.0.0.6 12.1 NO,EN
... ... ... ... ... ...