Difference between revisions of "Customized Logs Mod"

From TNG_Wiki
Jump to navigation Jump to search
m (fix mod version for TNG V8.0.2)
(185 intermediate revisions by 40 users not shown)
Line 1: Line 1:
{{TNGmod
+
{{restricted}}{{TNGmod
 
| mod_name        = Customized Logs
 
| mod_name        = Customized Logs
 
| mod_summary    = Splits search engine bot access to a different log file
 
| mod_summary    = Splits search engine bot access to a different log file
| download_link  = [[Media:customized_logs_v8.1.0a.zip|customized_logs_v8.1.0a.zip]] for TNG V8.0.2<br  />[[Media:customized_logs_v8.1.0.zip|customized_logs_v8.1.0.zip]] for TNG V8 and V8.0.1<br />[[Media:customized_logs_v2.2.zip|customized_logs_v2.2.zip]] for TNG V7
+
| mod_validation  =
| mod_author     = Brian McFadyen<br />Ken Roy developed install config file
+
| mod_last_update = 23 Feb 2019
| mod_url         = [[Customized Logs Mod]] (this page)<br />
+
| download_link  =  
 +
for{{Tv1210}} [https://www.ourfamilyhistories.org/ccount/click.php?id=32&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} customized_logs_v12.1.0.5c.zip]<hr />
 +
for{{Tv120}}{{Tv111}} [https://www.ourfamilyhistories.org/ccount/click.php?id=29&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} customized_logs_v11.1.0.4.zip]<hr />
 +
for{{Tv110}} [https://www.ourfamilyhistories.org/ccount/click.php?id=24&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} customized_logs_v11.0.0.0.zip]<hr />
 +
for{{Tv100}}{{Tv1010}}[https://www.ourfamilyhistories.org/ccount/click.php?id=23&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} customized_logs_v10.0.0.8.zip]<hr />
 +
for{{Tv922}} [https://www.ourfamilyhistories.org/ccount/click.php?id=6&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} customized_logs_v9.2.2.6.zip]<hr />for{{Tv921}} [http://ccount.bisbeefamily.com/click.php?id=42 customized_logs_v9.2.0.3.zip]<hr />for{{Tv911}}[http://ccount.bisbeefamily.com/click.php?id=37 customized_logs_v9.1.1.2.zip]<hr />
 +
for{{Tv91}}[https://www.royandboucher.com/ccount/click.php?id=92 customized_logs_v9.1.0.1.zip]<hr />for {{Tv90}}[https://www.royandboucher.com/ccount/click.php?id=93 customized_logs_v9.0.0.0.zip]<hr />
 +
for {{Tv802}}[https://www.royandboucher.com/ccount/click.php?id=94 customized_logs_v8.1.0a.zip] <hr  /> for {{Tv80}}[https://www.royandboucher.com/ccount/click.php?id=95 customized_logs_v8.1.0.zip]<hr />
 +
for {{Tv70}}[[Media:customized_logs_v2.2.zip|customized_logs_v2.2.zip]]  
 +
| download_stats = [https://www.ourfamilyhistories.org/ccount/index.php?action=stats&groupid=2 View download statistics for for v9.2.2.6 to v12.1.0.5]<br />
 +
[http://dlmax.org/counter?action=stats&id=5 statistics for v9.2.2.5]<br />
 +
[http://ccount.bisbeefamily.com/index.php?action=stats&id=42-37 statistics for v9.1.1.2 to v9.2.0.3]<hr />
 +
[https://www.royandboucher.com/ccount/index.php?action=stats&id=92-93-94-95 statistics for earlier versions]
 +
| mod_author = Brian McFadyen<br />Ken Roy developed install config file<br />Previously maintained by Rick Bisbee<br />Current development by Bryan S. Larson
 +
| mod_url = [[Customized Logs Mod]] (this page)<br />
 
[http://genwiki.mcfadyen.ca/index.php?title=Customized_Logs Customized Logs] for history
 
[http://genwiki.mcfadyen.ca/index.php?title=Customized_Logs Customized Logs] for history
| mod_support     = [http://www.tngforum.us/ TNG Forums]
+
| mod_support = [http://tng.community/ TNG Community Forums]
| mod_version    = 8.1.0
+
| mod_contact = [https://www.ourfamilyhistories.org/mod_support.php Support for Customized Logs]
| use_mod_manager = Yes
+
| mod_version = See download links
| manual_install  = No<br />For previous versions see [http://genwiki.mcfadyen.ca/index.php?title=Customized_Logs Customized Logs]
+
| min_TNG_ver = 7.1.0
| min_TNG_ver     = 7.1.0
+
| max_TNG_ver = 12.1
| max_TNG_ver     = 8.0
+
| TNG_file_list  = clconfig.php<br />showlog.php<br />log.php<br />botgenlog.txt<br />botlogxml.php<br />showbotlog.php<br />showuserlog.php<br />userlog.txt<br />userlogxml.php<br />extensions/log_botchecks.php
| TNG_file_list  = showlog.php<br />log.php<br />botgenlog.txt<br />botlogxml.php<br />showbotlog.php<br />extensions/log_botchecks.php
+
| related_mods    = You can [[Customized_Logs_Mod#Edit_Logging_Option|change the default log option]] to include the referrer info, to display the UserAgent string and to enable logging to the userlog.txt file
| related_mods    = You can [[Customized_Logs_Mod#Edit_Logging_Option|change the default log option]] to include the referrer info
 
 
| notes          =  
 
| notes          =  
 
}}
 
}}
Line 22: Line 35:
 
== Introduction ==
 
== Introduction ==
  
The Customized Logs mod splits the search engine bots from the normal TNG user access into two separate logs, one for normal access and one for bots. This TNG modification will also change the way site accesses are logged.
+
The Customized Logs mod splits the search engine bots from the normal TNG user access into three separate logs, one for normal access by visitors, one for normal access by users and one for bots. This TNG modification will also change the way site accesses are logged.
  
 
* It will include additional information indicating where the access was linked from (the referrer info) if you change the option
 
* It will include additional information indicating where the access was linked from (the referrer info) if you change the option
  
* It will split the log into two files: one for browsers and one for crawlers
+
* It will include additional information containing the User-Agent string of the visiting user in the Visitor log if you change the option
  
* It will enhance the filter options available through the Admin->Setup->Log Settings. Filtering based upon Host IP Address and logged in User Descriptions will be added to the existing filter on Host Name.  
+
* It will split the log into three files: one for visiting browsers, one for known users and one for crawlers
 +
 
 +
* It will enhance the filter options available through the Admin->Setup->[[setup_log_settings|Log Settings]]. Filtering based upon Host IP Address and logged in User Descriptions will be added to the existing filter on Host Name.
 +
 
 +
* It will optionally add a button to Backup / Clear Log file. Clicking on the button makes a backup of the log file then clears all of the entries from the log file.  
  
 
The mod has an option to show the referrer information in the access log.  The default install option is to not show the referrer, which will cause the log to appear the same as the original TNG log.  You can change the option to include the referrer using the [[Mod_Manager_-_Installing_Config_Files#Edit_Config_File_Steps|Mod Manager Edit]] capability.
 
The mod has an option to show the referrer information in the access log.  The default install option is to not show the referrer, which will cause the log to appear the same as the original TNG log.  You can change the option to include the referrer using the [[Mod_Manager_-_Installing_Config_Files#Edit_Config_File_Steps|Mod Manager Edit]] capability.
 +
 +
The mod has an option to show the user-agent information in the access log.  The default install option is to not show the user-agent, which will cause the log to appear the same as the original TNG log.  You can change the option to include the user-agent using the [[Mod_Manager_-_Installing_Config_Files#Edit_Config_File_Steps|Mod Manager Edit]] capability.
 +
 +
The mod has an option to split the known users from the visiting users in different logs.  The default install option is to split the information. You can change the option to include the user-agent using the [[Mod_Manager_-_Installing_Config_Files#Edit_Config_File_Steps|Mod Manager Edit]] capability.
 +
  
 
== Developer ==
 
== Developer ==
  
The TNG Customized Logs Mod was developed by Brian McFadyen.
+
* The TNG Customized Logs Mod was originally developed by Brian McFadyen.
 +
 
 +
* It includes a [[List of Bots]] provided by Jerome Liebowitz on the user list.
 +
 
 +
* The original Mod Manager configuration file was created by Ken Roy.
 +
 
 +
* The Backup/Clear function was originally developed by Jim Graham and incorporated into the Customized Logs mod by Bryan S. Larson.
 +
 
 +
* Customized Logs is currently maintained and developed by Bryan S. Larson.
 +
 
 +
 
 +
==Requirements==
 +
 
 +
* A working TNG installation.
 +
* A backup of the TNG '''log.php''' and '''showlog.php''' files.
 +
* An installed current version of the [[Mod Manager]].
 +
* ensure the new logfiles '''botgenlog.txt''' and '''userlog.txt''' are writeable
 +
 
  
This version of the mod also includes the [[List of Bots]] was provided by Jerome Liebowitz on the user list.
+
== Upgrading / Installing Customized Logs Mod V10.0.0.2 and later ==
 +
=== First time installation: ===
 +
# Download the appropriate zip file for the Mod Manager configuration file
 +
# Extract all the files in customized_logs zip file
 +
# Upload customized_logs_v10.0.0.n.cfg and the entire customized_logs folder to your '''mods''' folder.
 +
#  Follow the normal automated installation for Mod Manager, as shown in  the example [[Mod Manager - Installing Config Files]] to install the  '''customized_logs''' file.
 +
# Click the '''Check Now''' button in Mod Manager screen to create the necessary user and bot log.txt files if they do not exist
 +
# Optionally,  [[Customized_Logs_Mod#Optional_Parameters|Optional Parameters]] using  the [[Mod_Manager_-_Installing_Config_Files#Edit_Config_File_Steps|Mod  Manager Edit]] capability
 +
 
 +
=== Upgrading from previous versions: ===
 +
# Create backups of botgenlog.txt and userlog.txt (those files are deleted by versions 10.0.0.0 and earlier of this mod)
 +
# Installing the mod:
 +
## From versions 10.0.0.0 and older
 +
### Uninstall the old version of the mod using the mod manager
 +
### Unzip and upload the new version of the mod to your mods directory
 +
###  Follow the normal automated installation for Mod Manager, as shown in    the example [[Mod Manager - Installing Config Files]] to install the  new version of the  '''customized_logs''' file.
 +
### Restore your backed up copies of botgenlog.txt and userlog.txt to your root directory
 +
 
 +
==[[Mod Manager - Installing Config Files | Automated Installation V10.0.0.0 and earlier]] ==
 +
 
 +
# Download the appropriate zip file for the Mod Manager configuration file
 +
# [[Mod_Manager_-_Installing_Config_Files#Remove_Mod_Steps|Remove Previously Installed]] mod
 +
# Extract all the files in customized_logs zip file to your '''mods''' folder. 
 +
#  Follow the normal automated installation for Mod Manager, as shown in  the example [[Mod Manager - Installing Config Files]] to install the  '''customized_logs''' file.
 +
# Click the "Check Now" button - this will create empty an userlog and botlog if they do not already exist.
 +
#  Optionally, [[Customized_Logs_Mod#Optional_Parameters|Optional Parameters]] using the  [[Mod_Manager_-_Installing_Config_Files#Edit_Config_File_Steps|Mod  Manager Edit]] capability
 +
 
 +
 
 +
== Optional Parameters ==
 +
 
 +
This  mod has 5 optional parameters which can be modified using the  [[Mod_Manager_-_Installing_Config_Files#Edit_Config_File_Steps|Mod  Manager Edit]] capability.
 +
# Restrict logs to admin only: When  enabled, this option restricts all log files to administrators only.  This is enabled by default.
 +
# Add link to clear/backup log files:  When enabled, each log file will have a button to clear/backup that log  file. The first time the button is used, a directory is created  (genlog_backup) where all backups generated by this button are stored.
 +
# Referrer Option: When enabled, this option will show the referrer information in the access log. This is disabled by default.
 +
#  Include useragent string in the log file: When enabled, this option  appends the useragent string to each log entry. This is disabled by default.
 +
# Log the user actions in separate user log: This option  logs all action by registered users in a separate user log. This option  is enabled by default.
 +
# Specify a preferred time format for timestamps (i.e. 12 hour or 24 hour short or long).
  
The Mod Manager configuration file was created by Ken Roy.
 
  
 
==Revision History==
 
==Revision History==
  
{| border="1" cellspacing="5" cellpadding="2" width="100%" class="wikitable"
+
{| border="1" cellspacing="5" cellpadding="2" width="65%" class="wikitable"
 
|-
 
|-
 
! Version
 
! Version
 
! Date
 
! Date
 
! Contents
 
! Contents
 +
|-
 +
| V12.1.0.5c
 +
| 23 Feb 2019
 +
| This version has been updated to support TNG V12.1. Updated with newer mod manager syntax and removed the need for the "Check" button. Added more bots and spiders to bot list. <span style="color: Red">This version only works with TNG V12.1 or newer. For TNG V12.0.3 or below, use a previous version of the mod.</span>
 +
|-
 +
| V11.1.0.4
 +
| 6 Feb 2017
 +
| This version has been updated to support TNG V11.1.
 +
|-
 +
| V11.0.2.3
 +
| 25 Jan 2017
 +
| This version has minor changes to code to add support for TNG/WordPress sites. Thanks goes to Roger Moffat for this change.
 +
|-
 +
| V11.0.2.2
 +
| 6 Sep 2016
 +
| This version has been updated to support mod manager changes in TNG V11.0.2 which now uses the $extspath variable for the extensions folder.
 +
|-
 +
| V11.0.0.0
 +
| 14 Mar 2016
 +
| This version has been updated to support TNG V11. It also adds '''BOLD''' text for usernames in the user log (suggested by Jay Wilpolt) and adds translations for the backup/clear button.
 +
|-
 +
| V10.0.0.8
 +
| 23 Jan 2016
 +
| This version adds an option for 4 different time formats for the timestamp on log entries. Thanks to Bernard Wortelboer for the suggestion and some of the code for this feature. This version also corrects an error in the cust_text modifications in some languages.
 +
|-
 +
| V10.0.0.7
 +
| 4 Jan 2016
 +
| This version adds support for Italian as well as updated translations for German and Dutch. Thanks goes to Richard Falzini, [[File:Oname.gif‎|top]] and Marco van den Heuvel for the translations of text variables.
 +
|-
 +
| V10.0.0.6
 +
| 25 Mar 2015
 +
| This version adds code to show the original IP address on sites that use a CDN service (i.e. CloudFlare). Thanks goes to Fred Feldman for the suggestion and the code.
 +
|-
 +
| V10.0.0.5
 +
| 5 Mar 2015
 +
| This version fixes several bugs, improves logging of bots, adds new bots to the list of identified bots, cleans up syntax and other code changes as well. <span style="color:#990000">NOTE: this version has only been tested with TNG V10.1 and may or may not work with older versions of TNG.</span> Please report any incompatibility issues with older versions so the wiki can be updated appropriately.
 +
|-
 +
| V10.0.0.4
 +
| 24 Feb 2015
 +
| This version fixes a syntax error found in V10.0.0.3
 +
|-
 +
| V10.0.0.3
 +
| 20 Feb 2015
 +
| This version adds improvements and fixes from previous versions of the mod:
 +
*  The "Check Now" button should now work on more sites. In some cases, the file that ran the checks was converted to a single line of code by FTP processes - this file is now created by the mod rather than moved by the mod.
 +
* Other minor improvements
 +
* Cleaned up mod manager instructions for a more clarity
 +
|-
 +
| V10.0.0.2
 +
| 2 Jul 2014
 +
| This version adds several improvements from previous versions of the mod:
 +
* Simplified installation procedure while still protecting existing logs and eliminates the customized_logs_readme.txt file. Now, there is a "Check Now" button that checks to see if the appropriate logs exist and if necessary, create those files
 +
* Optional button to backup/clear the log files - there are buttons specific to each separate log
 +
* Option to restrict all logs to admin only
 +
* Cleaned up edit options screen for a more clean set of options for changing options
 +
<br />
 +
Credit goes to Jim Graham for developing the original backup/clear function that was modified for this version.
 +
|-
 +
| V10.0.0.1
 +
| 30 Mar 2014
 +
| Updated to prevent user log and bot log from being cleared when reinstalling mod. <br />
 +
<span style="color:#990000">Note: follow instructions from customized_logs_readme.txt file before installing or upgrading this version of the mod!</span> <br />
 +
Thanks to Graham Chamberlain for the suggestion used for this version.
 +
|-
 +
| V10.0.0.0
 +
| 6 February 2014
 +
| Updated for TNG V10
 +
|-
 +
| V9.2.2.6
 +
| 4&nbsp;October&nbsp;2013
 +
|
 +
* Minor bugfix
 +
|-
 +
| V9.2.2.5
 +
| 10&nbsp;August&nbsp;2013
 +
|
 +
* Bugfix, making the V9.2.2.4 version install with the changed log.php file from TNG 9.2.2
 +
|-
 +
| V9.2.2.4
 +
| 27&nbsp;May&nbsp;2013
 +
|
 +
* Essentially the same as V9.2.0.4 with the correct versioning system applied
 +
|-
 +
| V9.2.0.4
 +
| 26&nbsp;May&nbsp;2013
 +
|
 +
* <span style="color:#990000"> Use this version only if you have installed the new log.php file for testing in TGNv9.2.1.</span> Otherwise use the older version 9.2.0.3
 +
*:Note that this mod should have been named 9.2.2.4 to avoid any confusion that it applies to log.php released after TNG 9.2.1
 +
* added the custom known users logfile
 +
* using the translation files for the frontend files and added the English and Dutch languages
 +
* using additional filtering on User Agent stings
 +
* added descriptive page-titles, headers and changed the navigation structure
 +
|-
 +
| V9.2.0.3
 +
| 13&nbsp;Apr&nbsp;2013
 +
|
 +
* <span style="color:#990000"> Use this version only if you have installed the new log.php file for testing in TGNv9.2.0.</span> Otherwise use the older version 9.1.1.2.
 +
* Temporary stop-gap for modified log.php file released for testing about 12 April 2013.
 +
* changes log_botchecks.php to simplify the bot list.
 +
|-
 +
| V9.1.1.2
 +
| 23&nbsp;Jan&nbsp;2013
 +
| Updated for TNG V9.1.1
 +
|-
 +
| V9.1.0.1
 +
| 24&nbsp;Dec&nbsp;2012
 +
| Updated for TNG V9.1.0
 +
|-
 +
| V9.0.0.0
 +
| 2&nbsp;Feb&nbsp;2012
 +
| Updated for TNG V9
 
|-
 
|-
 
| V8.1.0a
 
| V8.1.0a
| Oct 16, 2010
+
| 16&nbsp;Oct&nbsp;2010
 
| Updated for TNG V8.0.2
 
| Updated for TNG V8.0.2
 
|-
 
|-
 
| <strike>V8.1.1</strike>
 
| <strike>V8.1.1</strike>
| <strike>May 30, 2010</strike>
+
| <strike>30&nbsp;May&nbsp;2010</strike>
 
| <strike>Corrections for TNG V8 and revised .cfg to conform to new standard folder distribution.</strike>
 
| <strike>Corrections for TNG V8 and revised .cfg to conform to new standard folder distribution.</strike>
 
|-
 
|-
 
| V8.1.0
 
| V8.1.0
| May 24, 2010
+
| 24&nbsp;May&nbsp;2010
 
| Updated for TNG8 and new version schema.
 
| Updated for TNG8 and new version schema.
 
|-
 
|-
 
| V2.2
 
| V2.2
| Dec 5, 2009
+
| 5&nbsp;Dec&nbsp;2009
 
| Updated Mod Manager config file to include [[List of Bots]] provided by Jerome Leibowitz and to provide the Edit capability for the logging option.
 
| Updated Mod Manager config file to include [[List of Bots]] provided by Jerome Leibowitz and to provide the Edit capability for the logging option.
 
|-
 
|-
 
| V2.0
 
| V2.0
| May 16, 2009
+
| 16&nbsp;May&nbsp;2009
 
| Original Mod Manager config file
 
| Original Mod Manager config file
 
|-
 
|-
 
| Rev 1.11
 
| Rev 1.11
| Apr 27, 2009
+
| 27&nbsp;Apr&nbsp;2009
 
| validated and updated for V7.1.0
 
| validated and updated for V7.1.0
 
|-
 
|-
Line 77: Line 262:
 
|}
 
|}
  
==Requirements==
+
== Sites using this mod ==
  
* A working TNG installation.
+
If you download and install this mod, please add your TNG site to the table below
* A backup of the TNG '''log.php''' and '''showlog.php''' files.
 
* An installed current version of the [[Mod Manager]].
 
* ensure the new logfile '''botgenlog.txt''' is writeable
 
  
==[[Mod Manager - Installing Config Files | Automated Installation]] ==
+
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
+
|-
# Download the [[Media:customized_logs_v2.2.zip]] mod configuration file
+
! URL
# [[Mod_Manager_-_Installing_Config_Files#Remove_Mod_Steps|Remove Previously Installed]] mod
+
! User
# Extract all the files in customized_logs_v2.2.zip to your '''./admin/mod_folder'''.   
+
! Note
# Follow the normal automated installation for Mod Manager, as shown in the example [[Mod Manager - Installing Config Files]] to install the '''customized_logs_v2.2'''.
+
! Mod-Version
# Optionally, [[Customized_Logs_Mod#Edit_Logging_Option|Edit Logging Option]] using the [[Mod_Manager_-_Installing_Config_Files#Edit_Config_File_Steps|Mod Manager Edit]] capability
+
! TNG-Version
 
+
! User-language
== Edit Logging Option ==
+
|-
 
+
| [https://www.ourfamilyhistories.org Our Family Histories]
This mod has an option to show the referrer information in the access log.  The default install option is to not show the referrer, which will cause the log to appear the same as the original TNG log.
+
| [[User:bsl20b50|Bryan S. Larson]]
 
+
|  Current Developer. I added new options and features for V10.0.0.2 through the current version as well as past fixes and tweaks. On my own site, I have also added buttons  linking to additional analytics pages that I use.
If you want to show the referred, you can change the option to include the referrer using the [[Mod_Manager_-_Installing_Config_Files#Edit_Config_File_Steps|Mod Manager Edit]] capability.
+
| [[User: Bsl20b50|See Here]]
 
+
| [[User: Bsl20b50|See Here]]
== TNG User sites using this mod ==
+
| EN
*Please add TNG site that you have found that utilize this modification
+
|-
=== Site List ===
+
| [http://genealogy.mcfadyen.ca/ Brian McFadyen's Genealogy site]  
*[http://genealogy.mcfadyen.ca/ Brian McFadyen's Genealogy site] Brian McFadyen is the developer of the customized logs mod.
+
| [[User:Bmcfadyen|Brian McFadyen]]
*[http://www.royandboucher.com/genealogy/searchform.php Our Acadian, French Canadian, and Maine Ancestors] I have used Brian McFadyen's customized log since its early days.
+
| Developer of the customized logs mod  
*[http://x.liebowitzes.com/genealogy/ Roni & Jerry's Genealogy and Family History] If a new bot appears that I haven't identified on his mod, I just add it to his modification of log.php (as described in the instructions). (as provided on the user list)
+
| V8.1.1<br />V8.1.3/
 
+
| 8.0.2<br />TNG 8.1.1 test
[[Category:Modifications]]
+
| EN
 +
|-
 +
| [https://www.royandboucher.com/ Our Roy and Boucher Family]
 +
| [[User:Ken Roy|Ken Roy]]
 +
| I have used Brian McFadyen's customized log since its early days.
 +
| V10.0.0.2
 +
| TNG 10.0.2
 +
| English, French
 +
|-
 +
| [http://x.liebowitzes.com/genealogy/ Roni & Jerry's Genealogy and Family History]
 +
| [[User:jliebo|Jerry Liebowitz]]
 +
| If a new bot appears that I haven't identified on Brian's mod, I just add it to extensions> log_botchecks.php<br/> (as described in the instructions as provided on the user list)
 +
| V9.2.2.6
 +
| TNG 9.2.2
 +
| EN
 +
|-
 +
| [http://www.katiandgraham.com/genealogy/ Chamberlain & Eidenbenz Geneaolgy]
 +
| [[User:hiraeth|Graham Chamberlain]]
 +
| Public Site
 +
| v11.1.0.4
 +
| v12.0.1
 +
| EN, FR, DE, ES, NL
 +
|-
 +
| [http://www.bisbeefamily.com A Bisbee Family History]
 +
| [[User:Kazooter|Rick Bisbee]]
 +
|
 +
| v9.0.0.0
 +
| v9.0.4
 +
| EN
 +
|-
 +
| [http://www.chambersancestry.info Chambers Family Ancestry]
 +
| [[User:ChambersAncestry|Tom Chambers]]
 +
| Very smooth installation & configuration, and helps to catch the bad guys.
 +
| v9.1.1.2
 +
| v9.1.1
 +
| EN
 +
|-
 +
| [http://www.arsenaultfamily.com  Arsenault/Simpson Family Website]
 +
| [[User:BobA|Bob Arsenault]]
 +
|
 +
| v9.1.1.2
 +
| v9.1.2
 +
| EN
 +
|-
 +
| [https://www.gilbert-family-history.net  Gilbert family history]
 +
| [[User:Warren Gilbert|Warren S Gilbert]]
 +
|
 +
| v10.0.0.0
 +
| TNG 10.0.0
 +
| EN
 +
|-
 +
| [http://history.dlmax.org/ Max Westen's genealogy site]
 +
| [[User:Max|Max Westen]]
 +
| Developer of some additions of this mod(starting 9.2.0.4)
 +
| v9.2.2.4
 +
| TNG 9.2.1
 +
| NL, EN
 +
|-
 +
| [https://genealogywings.com/ MOTYER Family Genealogy]
 +
| [[User:JMM|John Mark Motyer]]
 +
| Public site
 +
| [[User:JMM|see here]]
 +
| [[User:JMM|see here]]
 +
| EN, DE, RU
 +
|-
 +
| [http://www.1820Settlers.com British 1820 Settlers to South Africa]
 +
| [[User:PaulTT|Paul Tanner-Tremaine]]
 +
| Public site
 +
| v10.0.0.6
 +
| TNG 10.1.1
 +
| EN
 +
|-
 +
| [http://mfo.me.uk Mitchell Families Online]
 +
| [[User:HiTowerUK|Roger Mitchell]]
 +
| Another great update - excellent mod!
 +
| v10.0.0.2
 +
| TNG 10.0.2
 +
| EN
 +
|-
 +
| [http://www.total-family-history.com Total Family History]
 +
| [[User:Fallonman|Scott Bennett]]
 +
| Private Site (For right now)
 +
| v10.0.0.1
 +
| TNG 10.0.1
 +
| EN
 +
|-
 +
| [http://genealogy.oceanwharf.com Hooley Family Links]
 +
| [[User:lastejas|Rick Hooley]]
 +
| Public/Private
 +
| [[User: lastejas|See Here]]
 +
| [[User: lastejas|See Here]]
 +
| EN
 +
|-
 +
| [http://www.wortelboer.tk Wortelboer Genealogy]
 +
| [[User:Bernard57|Bernard Wortelboer]]
 +
|
 +
| v11.0.2.2
 +
| 11.0.2
 +
| NL/EN
 +
|-
 +
| [http://tng.rudischmit.eu Schmit/Heemskerk Family]
 +
| [[User:Kaasneef|Rudi Schmit]]
 +
|
 +
| v10.0.0.7
 +
| 10.1.3
 +
| NL
 +
|-
 +
| [https://vanseeventer.nl Familie van Seeventer]
 +
| [[User:see7ter|Sandor van Seeventer]]
 +
| Public site
 +
| V11.1.0.4
 +
| 12.0.1 beta 2
 +
| DE/EN/NL
 +
|-
 +
| [https://www.bradyfamilytree.org/ Brady Family Tree in Western Australia]
 +
| [[User:bradyfamilytree|Darryl Brady]]
 +
| Public site
 +
| 10.0.0.6
 +
| 10.1.1
 +
| EN, DE
 +
|-
 +
| [http://www.kempfamilyhistory.com/ Kemp(e) Family History]
 +
| [[User:Kempons|Andrew Kemp]]
 +
| Public site
 +
| see [[User:Kempons]]
 +
| see [[User:Kempons]]
 +
| EN
 +
|-
 +
| [https://www.gambrillfamilytree.com/ Gambrill Family Tree]
 +
| [[User:bobbyfamilytree|Bobby Gambrill]]
 +
| Public site
 +
| V11.0.2.2
 +
| 11.0.2
 +
| EN
 +
|-
 +
| [https://www.rgstrong-genes.com R G Strong Family Genealogy]
 +
| [[User:Rgstrong|Russell Strong]]
 +
| Public Site
 +
| 11.1.0.4
 +
| 12.0.2
 +
| EN, FR, DE, NL
 +
|-
 +
| [http://graham-clan.co.uk/thefamilytree/index.php The Grahams of Helensburgh]
 +
| [[User:Fruin|Jim Graham]]
 +
| Public/Private
 +
| 11.1.0.4
 +
| 12.0
 +
| EN
 +
|-
 +
| [http://www.roebuckfamily.com/Donald/genealogy/index.php Roebuck and Families Ancestry Website]
 +
| [[User:don1two|Donald Roebuck]]
 +
| Public site except for Living
 +
| 11.0.2.2
 +
| 11.0.2
 +
| EN
 +
|-
 +
| [http://www.ccggpa.org/cemeteries/index.php Crawford County Genealogy Gateway]
 +
| [[User:Fraber|Frank Bernosky]]
 +
| Public site except for Living
 +
| 11.1.0.4
 +
| 11.1
 +
| EN
 +
|-
 +
| [https://www.rintoulbowman.com/ Rintoul/Bowman Family]
 +
| [[User:Adrintoul|Andrew Rintoul]]
 +
| Public/Private
 +
| 11.1.0.4
 +
| 12.0
 +
| EN, DE, ES, FR
 +
|-
 +
| [http://racine-ad.fr/TNG/index.php Racine d'Alsace]
 +
| [[User:Louis42|J-Louis Valory]]
 +
| Public/Private - T17 customized
 +
| 11.1.0.4
 +
| 12.0.2
 +
| FR
 +
|-
 +
| [http://bumbery.com/ Bumbery-Wangler]
 +
| [[User:Bob|Bob Bumbery]]
 +
| Public site
 +
| 11.1.0.4
 +
| 11.1.2
 +
| English
 +
|-
 +
| [https://familyhistories.us/ Family HIstories]
 +
| [[User:Steve1200|Steven Davis]]
 +
| Public/Private site
 +
| v11.1.0.4
 +
| v12.0.1
 +
| English
 +
|-
 +
| [http://colegenealogy.dynu.net/ Cole / Tanner Family Tree]
 +
| [[User:dlcole|David Cole]]
 +
| Public/Private
 +
| [[User:Dlcole|see here]]
 +
| [[User:Dlcole|see here]]
 +
| English
 +
|-
 +
| [http://geneagraphie.com Families all over the world]
 +
| [[User:Henri_Textor|Hans Weebers]]
 +
| Public/Private
 +
| v11.1.0.4
 +
| v12.0.1
 +
| EN, NL, DE, FR
 +
|-
 +
| [[User:JPB|Current info on my user site]]
 +
| [[User:JPB|JPB]]
 +
| Public site
 +
| ...
 +
| ...
 +
| DE, EN, FR
 +
|-
 +
| [https://www.kmtrees.com Roots & Relatives Remembered]
 +
| [[User:Tngrlkrz|Ron Krzmarzick]]
 +
| Public & Private
 +
| 12.1.0.5b Wamp only
 +
| [https://kmtrees.com/modlist_wiki?whichoptions=basic&cachemethod=3&sortby=filename See Here]
 +
| EN,DE,CS,ES
 +
|-
 +
| [https://www.sackett-tree.org Thurmon King's New Sackett Family Database]
 +
| [[User:tcsmithgeol|Ted Smith]]
 +
| Public site
 +
| 12.1.0.5c
 +
| v12.1
 +
| EN
 +
|-
 +
|}
 +
[[Category:Mods for TNG v7]]
 +
[[Category:Mods for TNG v8]]
 +
[[Category:Mods for TNG v9]]
 +
[[Category:Mods for TNG v10]]
 +
[[Category:Mods for TNG v11]]
 +
[[Category:Mods for TNG v12]]
 +
[[Category:showlog.php mods]]
 +
[[Category:log.php mods]]

Revision as of 17:05, 6 April 2019

Restricted Downloads of Customized Logs Mod 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
Caution If you have trouble downloading with Google Chrome, Vivaldi, Brave or other Chromium based browser, try using a right-click and select Open in new Window, then F5, or use another browser such as Firefox


Caution


Customized Logs
Summary Splits search engine bot access to a different log file
Validation
Mod Updated 23 Feb 2019
Download link for
TNG 12.1.0
customized_logs_v12.1.0.5c.zip

for

TNG 12.0
TNG 11.1
customized_logs_v11.1.0.4.zip

for

TNG 11.0
customized_logs_v11.0.0.0.zip

for

TNG 10.0
TNG 10.1.0
customized_logs_v10.0.0.8.zip

for

TNG 9.2.2
customized_logs_v9.2.2.6.zip
for
TNG 9.2.1
customized_logs_v9.2.0.3.zip
for
TNG 9.1.1
customized_logs_v9.1.1.2.zip

for

TNG 9.1
customized_logs_v9.1.0.1.zip
for
TNG 9.0
customized_logs_v9.0.0.0.zip

for

TNG 8.0.2
customized_logs_v8.1.0a.zip
for
TNG 8.0
customized_logs_v8.1.0.zip

for

TNG 7.0
customized_logs_v2.2.zip
Download stats View download statistics for for v9.2.2.6 to v12.1.0.5

statistics for v9.2.2.5

statistics for v9.1.1.2 to v9.2.0.3
statistics for earlier versions
Author(s) Brian McFadyen
Ken Roy developed install config file
Previously maintained by Rick Bisbee
Current development by Bryan S. Larson
Homepage Customized Logs Mod (this page)
Customized Logs for history
Mod Support TNG Community Forums
Contact Developer Support for Customized Logs
Latest Mod See download links
Min TNG V 7.1.0
Max TNG V 12.1
Files modified
clconfig.php
showlog.php
log.php
botgenlog.txt
botlogxml.php
showbotlog.php
showuserlog.php
userlog.txt
userlogxml.php
extensions/log_botchecks.php
Related Mods
You can change the default log option to include the referrer info, to display the UserAgent string and to enable logging to the userlog.txt file
Notes


Introduction

The Customized Logs mod splits the search engine bots from the normal TNG user access into three separate logs, one for normal access by visitors, one for normal access by users and one for bots. This TNG modification will also change the way site accesses are logged.

  • It will include additional information indicating where the access was linked from (the referrer info) if you change the option
  • It will include additional information containing the User-Agent string of the visiting user in the Visitor log if you change the option
  • It will split the log into three files: one for visiting browsers, one for known users and one for crawlers
  • It will enhance the filter options available through the Admin->Setup->Log Settings. Filtering based upon Host IP Address and logged in User Descriptions will be added to the existing filter on Host Name.
  • It will optionally add a button to Backup / Clear Log file. Clicking on the button makes a backup of the log file then clears all of the entries from the log file.

The mod has an option to show the referrer information in the access log. The default install option is to not show the referrer, which will cause the log to appear the same as the original TNG log. You can change the option to include the referrer using the Mod Manager Edit capability.

The mod has an option to show the user-agent information in the access log. The default install option is to not show the user-agent, which will cause the log to appear the same as the original TNG log. You can change the option to include the user-agent using the Mod Manager Edit capability.

The mod has an option to split the known users from the visiting users in different logs. The default install option is to split the information. You can change the option to include the user-agent using the Mod Manager Edit capability.


Developer

  • The TNG Customized Logs Mod was originally developed by Brian McFadyen.
  • It includes a List of Bots provided by Jerome Liebowitz on the user list.
  • The original Mod Manager configuration file was created by Ken Roy.
  • The Backup/Clear function was originally developed by Jim Graham and incorporated into the Customized Logs mod by Bryan S. Larson.
  • Customized Logs is currently maintained and developed by Bryan S. Larson.


Requirements

  • A working TNG installation.
  • A backup of the TNG log.php and showlog.php files.
  • An installed current version of the Mod Manager.
  • ensure the new logfiles botgenlog.txt and userlog.txt are writeable


Upgrading / Installing Customized Logs Mod V10.0.0.2 and later

First time installation:

  1. Download the appropriate zip file for the Mod Manager configuration file
  2. Extract all the files in customized_logs zip file
  3. Upload customized_logs_v10.0.0.n.cfg and the entire customized_logs folder to your mods folder.
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the customized_logs file.
  5. Click the Check Now button in Mod Manager screen to create the necessary user and bot log.txt files if they do not exist
  6. Optionally, Optional Parameters using the Mod Manager Edit capability

Upgrading from previous versions:

  1. Create backups of botgenlog.txt and userlog.txt (those files are deleted by versions 10.0.0.0 and earlier of this mod)
  2. Installing the mod:
    1. From versions 10.0.0.0 and older
      1. Uninstall the old version of the mod using the mod manager
      2. Unzip and upload the new version of the mod to your mods directory
      3. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the new version of the customized_logs file.
      4. Restore your backed up copies of botgenlog.txt and userlog.txt to your root directory

Automated Installation V10.0.0.0 and earlier

  1. Download the appropriate zip file for the Mod Manager configuration file
  2. Remove Previously Installed mod
  3. Extract all the files in customized_logs zip file to your mods folder.
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the customized_logs file.
  5. Click the "Check Now" button - this will create empty an userlog and botlog if they do not already exist.
  6. Optionally, Optional Parameters using the Mod Manager Edit capability


Optional Parameters

This mod has 5 optional parameters which can be modified using the Mod Manager Edit capability.

  1. Restrict logs to admin only: When enabled, this option restricts all log files to administrators only. This is enabled by default.
  2. Add link to clear/backup log files: When enabled, each log file will have a button to clear/backup that log file. The first time the button is used, a directory is created (genlog_backup) where all backups generated by this button are stored.
  3. Referrer Option: When enabled, this option will show the referrer information in the access log. This is disabled by default.
  4. Include useragent string in the log file: When enabled, this option appends the useragent string to each log entry. This is disabled by default.
  5. Log the user actions in separate user log: This option logs all action by registered users in a separate user log. This option is enabled by default.
  6. Specify a preferred time format for timestamps (i.e. 12 hour or 24 hour short or long).


Revision History

Version Date Contents
V12.1.0.5c 23 Feb 2019 This version has been updated to support TNG V12.1. Updated with newer mod manager syntax and removed the need for the "Check" button. Added more bots and spiders to bot list. This version only works with TNG V12.1 or newer. For TNG V12.0.3 or below, use a previous version of the mod.
V11.1.0.4 6 Feb 2017 This version has been updated to support TNG V11.1.
V11.0.2.3 25 Jan 2017 This version has minor changes to code to add support for TNG/WordPress sites. Thanks goes to Roger Moffat for this change.
V11.0.2.2 6 Sep 2016 This version has been updated to support mod manager changes in TNG V11.0.2 which now uses the $extspath variable for the extensions folder.
V11.0.0.0 14 Mar 2016 This version has been updated to support TNG V11. It also adds BOLD text for usernames in the user log (suggested by Jay Wilpolt) and adds translations for the backup/clear button.
V10.0.0.8 23 Jan 2016 This version adds an option for 4 different time formats for the timestamp on log entries. Thanks to Bernard Wortelboer for the suggestion and some of the code for this feature. This version also corrects an error in the cust_text modifications in some languages.
V10.0.0.7 4 Jan 2016 This version adds support for Italian as well as updated translations for German and Dutch. Thanks goes to Richard Falzini, Oname.gif and Marco van den Heuvel for the translations of text variables.
V10.0.0.6 25 Mar 2015 This version adds code to show the original IP address on sites that use a CDN service (i.e. CloudFlare). Thanks goes to Fred Feldman for the suggestion and the code.
V10.0.0.5 5 Mar 2015 This version fixes several bugs, improves logging of bots, adds new bots to the list of identified bots, cleans up syntax and other code changes as well. NOTE: this version has only been tested with TNG V10.1 and may or may not work with older versions of TNG. Please report any incompatibility issues with older versions so the wiki can be updated appropriately.
V10.0.0.4 24 Feb 2015 This version fixes a syntax error found in V10.0.0.3
V10.0.0.3 20 Feb 2015 This version adds improvements and fixes from previous versions of the mod:
  • The "Check Now" button should now work on more sites. In some cases, the file that ran the checks was converted to a single line of code by FTP processes - this file is now created by the mod rather than moved by the mod.
  • Other minor improvements
  • Cleaned up mod manager instructions for a more clarity
V10.0.0.2 2 Jul 2014 This version adds several improvements from previous versions of the mod:
  • Simplified installation procedure while still protecting existing logs and eliminates the customized_logs_readme.txt file. Now, there is a "Check Now" button that checks to see if the appropriate logs exist and if necessary, create those files
  • Optional button to backup/clear the log files - there are buttons specific to each separate log
  • Option to restrict all logs to admin only
  • Cleaned up edit options screen for a more clean set of options for changing options


Credit goes to Jim Graham for developing the original backup/clear function that was modified for this version.

V10.0.0.1 30 Mar 2014 Updated to prevent user log and bot log from being cleared when reinstalling mod.

Note: follow instructions from customized_logs_readme.txt file before installing or upgrading this version of the mod!
Thanks to Graham Chamberlain for the suggestion used for this version.

V10.0.0.0 6 February 2014 Updated for TNG V10
V9.2.2.6 4 October 2013
  • Minor bugfix
V9.2.2.5 10 August 2013
  • Bugfix, making the V9.2.2.4 version install with the changed log.php file from TNG 9.2.2
V9.2.2.4 27 May 2013
  • Essentially the same as V9.2.0.4 with the correct versioning system applied
V9.2.0.4 26 May 2013
  • Use this version only if you have installed the new log.php file for testing in TGNv9.2.1. Otherwise use the older version 9.2.0.3
    Note that this mod should have been named 9.2.2.4 to avoid any confusion that it applies to log.php released after TNG 9.2.1
  • added the custom known users logfile
  • using the translation files for the frontend files and added the English and Dutch languages
  • using additional filtering on User Agent stings
  • added descriptive page-titles, headers and changed the navigation structure
V9.2.0.3 13 Apr 2013
  • Use this version only if you have installed the new log.php file for testing in TGNv9.2.0. Otherwise use the older version 9.1.1.2.
  • Temporary stop-gap for modified log.php file released for testing about 12 April 2013.
  • changes log_botchecks.php to simplify the bot list.
V9.1.1.2 23 Jan 2013 Updated for TNG V9.1.1
V9.1.0.1 24 Dec 2012 Updated for TNG V9.1.0
V9.0.0.0 2 Feb 2012 Updated for TNG V9
V8.1.0a 16 Oct 2010 Updated for TNG V8.0.2
V8.1.1 30 May 2010 Corrections for TNG V8 and revised .cfg to conform to new standard folder distribution.
V8.1.0 24 May 2010 Updated for TNG8 and new version schema.
V2.2 5 Dec 2009 Updated Mod Manager config file to include List of Bots provided by Jerome Leibowitz and to provide the Edit capability for the logging option.
V2.0 16 May 2009 Original Mod Manager config file
Rev 1.11 27 Apr 2009 validated and updated for V7.1.0
See Customized Logs on Brian McFadyen's site for previous revision history

Sites using this mod

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

URL User Note Mod-Version TNG-Version User-language
Our Family Histories Bryan S. Larson Current Developer. I added new options and features for V10.0.0.2 through the current version as well as past fixes and tweaks. On my own site, I have also added buttons linking to additional analytics pages that I use. See Here See Here EN
Brian McFadyen's Genealogy site Brian McFadyen Developer of the customized logs mod V8.1.1
V8.1.3/
8.0.2
TNG 8.1.1 test
EN
Our Roy and Boucher Family Ken Roy I have used Brian McFadyen's customized log since its early days. V10.0.0.2 TNG 10.0.2 English, French
Roni & Jerry's Genealogy and Family History Jerry Liebowitz If a new bot appears that I haven't identified on Brian's mod, I just add it to extensions> log_botchecks.php
(as described in the instructions as provided on the user list)
V9.2.2.6 TNG 9.2.2 EN
Chamberlain & Eidenbenz Geneaolgy Graham Chamberlain Public Site v11.1.0.4 v12.0.1 EN, FR, DE, ES, NL
A Bisbee Family History Rick Bisbee v9.0.0.0 v9.0.4 EN
Chambers Family Ancestry Tom Chambers Very smooth installation & configuration, and helps to catch the bad guys. v9.1.1.2 v9.1.1 EN
Arsenault/Simpson Family Website Bob Arsenault v9.1.1.2 v9.1.2 EN
Gilbert family history Warren S Gilbert v10.0.0.0 TNG 10.0.0 EN
Max Westen's genealogy site Max Westen Developer of some additions of this mod(starting 9.2.0.4) v9.2.2.4 TNG 9.2.1 NL, EN
MOTYER Family Genealogy John Mark Motyer Public site see here see here EN, DE, RU
British 1820 Settlers to South Africa Paul Tanner-Tremaine Public site v10.0.0.6 TNG 10.1.1 EN
Mitchell Families Online Roger Mitchell Another great update - excellent mod! v10.0.0.2 TNG 10.0.2 EN
Total Family History Scott Bennett Private Site (For right now) v10.0.0.1 TNG 10.0.1 EN
Hooley Family Links Rick Hooley Public/Private See Here See Here EN
Wortelboer Genealogy Bernard Wortelboer v11.0.2.2 11.0.2 NL/EN
Schmit/Heemskerk Family Rudi Schmit v10.0.0.7 10.1.3 NL
Familie van Seeventer Sandor van Seeventer Public site V11.1.0.4 12.0.1 beta 2 DE/EN/NL
Brady Family Tree in Western Australia Darryl Brady Public site 10.0.0.6 10.1.1 EN, DE
Kemp(e) Family History Andrew Kemp Public site see User:Kempons see User:Kempons EN
Gambrill Family Tree Bobby Gambrill Public site V11.0.2.2 11.0.2 EN
R G Strong Family Genealogy Russell Strong Public Site 11.1.0.4 12.0.2 EN, FR, DE, NL
The Grahams of Helensburgh Jim Graham Public/Private 11.1.0.4 12.0 EN
Roebuck and Families Ancestry Website Donald Roebuck Public site except for Living 11.0.2.2 11.0.2 EN
Crawford County Genealogy Gateway Frank Bernosky Public site except for Living 11.1.0.4 11.1 EN
Rintoul/Bowman Family Andrew Rintoul Public/Private 11.1.0.4 12.0 EN, DE, ES, FR
Racine d'Alsace J-Louis Valory Public/Private - T17 customized 11.1.0.4 12.0.2 FR
Bumbery-Wangler Bob Bumbery Public site 11.1.0.4 11.1.2 English
Family HIstories Steven Davis Public/Private site v11.1.0.4 v12.0.1 English
Cole / Tanner Family Tree David Cole Public/Private see here see here English
Families all over the world Hans Weebers Public/Private v11.1.0.4 v12.0.1 EN, NL, DE, FR
Current info on my user site JPB Public site ... ... DE, EN, FR
Roots & Relatives Remembered Ron Krzmarzick Public & Private 12.1.0.5b Wamp only See Here EN,DE,CS,ES
Thurmon King's New Sackett Family Database Ted Smith Public site 12.1.0.5c v12.1 EN