Customized Logs Mod

Customized Logs
Summary	Splits search engine bot access to a different log file
Validation
Mod Updated	{{{mod_last_update}}}
Download link	for TNG 10.0 customized_logs_v10.0.0.1.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	statistics for v10.0.0.1 statistics for v9.2.2.6 to v9.10.0.0.0 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 Max Westen and Bryan Larson
Homepage	Customized Logs Mod (this page) Customized Logs for history
Mod Support	TNG Forums
Contact Developer	Support for Customized Logs
Latest Mod	See download links
Min TNG V	7.1.0
Max TNG V	10.0.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.

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 Mod Manager configuration file was created by Ken Roy.

• Customized Logs is currently maintained and developed by Max Westen and Bryan 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

Revision History

Version	Date	Contents
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

Upgrading / Installing Customized Logs Mod V10.0.0.1 and later

First time installation:

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
4. Upload customized_logs_v10.0.0.1.cfg and the entire customized_logs folder to your mods folder.
5. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the customized_logs file.
6. Optionally, Edit Logging Option 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 9.x and older
      1. Uninstall the old version of the mod using the mod manager
      2. 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
   2. From V10.0.0.0
      1. DO NOT uninstall the old version of the mod using the mod manager; you need to DELETE the old mod WITHOUT uninstalling it and replace it with the new version of the mod.
      2. Upload the new version of the mod configuration file to your mods directory
      3. Restore your backed up copies of botgenlog.txt and userlog.txt to your root directory if necessary

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. Optionally, Edit Logging Option using the Mod Manager Edit capability

Edit Logging Option

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.

If you want to show the referred, you can change the option to include the referrer using the Mod Manager Edit capability.

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
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.0	TNG 10.0.0	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	...	v9.1.1.2	TNG 9.1.1	English, French, German, Spanish, Dutch
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
Our Family Histories	Bryan S. Larson	Developer of some fixes. I have a slightly modified custom version on my own site that includes some buttons to additional analytics pages that I use.	v10.0.0.1	v10.0.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	10.0.0.1	10.0.2	EN, DE, RU
British 1820 Settlers to South Africa	Paul Tanner-Tremaine	Public site	v10.0.0.1	TNG 10.0.1	EN
Mitchell Families Online	Roger Mitchell	Great update - thanks to Bryan and Graham	v10.0.0.1	TNG 10.0.1	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	login: guest pwd: guest	v10.0.0.1	TNG10.0.1	EN
Pannier Genealogy	Martin Pannier		see here	see here	DE