Customized Logs Mod
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 | ||
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 |
The latest version of this mod uses the guidelines for TNG v12+ cust_text.php files. If you are using TNGv12+, and any cust_text.php file in this mod is marked with a Bad Target error, you need to update your cust_text.php files before you can install this mod. [Show instructions]
If you upgraded to TNGv12+, and did not update your cust_text.php files as instructed in the upgrade readme script, then you must use the TNG Mod Manager to update them. To do so:
[See details in the TNGv12 Change Impacts Article][Hide the instructions] |
|
Customized Logs | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Summary | Splits search engine bot access to a different log file | ||||||||||||||||||
Validation | |||||||||||||||||||
Mod Updated | 22 Mar 2024 | ||||||||||||||||||
Download link | For
For
For
For
[Show older versions]
For
For
For
For
For
For
For
For
For
For
For
For
customized_logs_v2.2.zip | ||||||||||||||||||
Download stats | Current V13.0.0.10 Previous v12 and v13 | ||||||||||||||||||
Author(s) | Brian McFadyen Ken Roy developed install config file Current development by Rick Bisbee | ||||||||||||||||||
Homepage | |||||||||||||||||||
Mod Support | TNG Community Forums | ||||||||||||||||||
Contact Developer | Support for Customized_Logs_Mod | ||||||||||||||||||
Latest Mod | 14.0.1.11c for TNG 14.0.1+, 14.0.0.11a for TNG 14.0.0, 13.0.0.10 for TNG v13+ 2.3.0.7 for TNG v12.3 See mod versions | ||||||||||||||||||
Min TNG V | 7.1.0 | ||||||||||||||||||
Max TNG V | 14+ | ||||||||||||||||||
Files modified | clconfig.php css/genstyle.css log.php showlog.php languages/English-UTF8/cust_text.php languages/English/cust_text.php languages/Dutch-UTF8/cust_text.php languages/Dutch/cust_text.php languages/French-UTF8/cust_text.php languages/German-UTF8/cust_text.php languages/German/cust_text.php languages/Italian-UTF8/cust_text.php languages/Italian/cust_text.php Files added: botgenlog.txt userlog.txt showbotlog.php showuserlog.php ajx_botlogxml.php ajx_userlogxml.php elog_botchecks.php clbotsites.txt cust_botsites.txt clagents.txt cust_agents.txt | ||||||||||||||||||
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.
Changes for TNGv13
Custom Logs Mod v13.0.0.10 separates the robot listings from the cfg and log_botchecks.php files so that both developer and users can update their lists without having them overwritten by new versions of the mod. There are now two sets of lists, one pair to record identifying fragments from the website IP or URL that launched the bot (clbotsites.txt and cust_botsites.txt), the other pair to record identifying fragments from the bot's user-agent (clagents.txt and cust_agents.txt.) If they do not already exist, all four files are installed in the extensions folder the first time the mod is installed. If the developer posts updated listings (clagents.txt and/or clbotsites.txt,) they may be downloaded and installed manually without requiring a new version of the mod. Of course, user additions should go into the cust_agents.txt and cust_botsites.txt files.
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.
- V12.1.0.6 and v13.1.0.8 was updated to fix PHP 7.2 and 7.3 warnings and notices by Ken Roy.
- Mod versions 13+ are currently maintained and developed by Rick Bisbee.
- Mod versions 14+ are currently maintained and developed by MichelK. Design by Steven Davis
Requirements
- A working TNG installation.
- A backup of the TNG log.php and showlog.php files.
- An installed current version of the Mod Manager.
Upgrading / Installing Customized Logs Mod V13.0.0.10 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_v13.0.0.10 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.
- ensure the new logfiles botgenlog.txt and userlog.txt are writeable.
- Set the desired options using the Mod Manager Options Edit for this mod.
Upgrading From Previous Versions
Be sure to read this before uninstalling an older version of the Customized Logs Mod.
If you have been running an older version of the mod, you can save your custom additions by retrieving them from your current log_botchecks.php file in the extensions folder, and then creating and adding them to a cust_agents.txt and/or cust_botsites.txt files in the extensions folder as appropriate. If you manually create these files beforehand, the mod will not overwrite them during installation. Note that the files are strictly text files. Enter each agent or URL fragment on a separate line with no additional punctuation like commas or quotes, and do not include any PHP syntax for arrays.
To help you place them correctly, note that in previous versions of the mod, log_botchecks.php files contained "bot" site URL fragments in the $spiders array and bot user-agent fragments in the $bots array. Avoid mixing these elements in your new lists, or else they will not work as intended.
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.
- Optionally, Optional Parameters using the Mod Manager Edit capability
- Ensure the new logfiles botgenlog.txt and userlog.txt are writeable
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
- From versions 10.0.0.0 and older
Automated Installation V10.0.0.0 and earlier
- Download the appropriate zip file for the Mod Manager configuration file
- 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, 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.
- 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).
Revision History
Mod Version | TNG Version | Date | Contents
|
---|---|---|---|
14.0.1.11c | 14.0.1+ | 22 Mar 2024 | Design modifications by Steven Davis |
14.0.1.11b | 14.0.1 | 14 May 2023 | Suppress the new line in front of the bot line - Add a 'nowrap' in the date columns - Suppress hard-coded names in log_botcheck.php |
14.0.1.11a | 14.0.1 | 27 Jan 2023 | TNG14.0.1 Ready |
14.0.0.11a | 14.0 | 08 Jan 2023 | TNG14 Ready - PHP8.2 Ready - Two missing empty files added (for new users of the Mod) |
14.0.0.11 | 14.0 | 29 Dec 2022 | TNG14 Ready - PHP8.2 Ready |
13.0.0.10 | 13.0 | 6 Jan 2022 |
|
13.0.0.9 | 13.0 | 31 Dec 2021 |
|
13.1.0.8 | 13.1 | 31 Dec 2021 | Superseded by Customized Logs Mod version 13.0.0.9 for all versions of TNGv13. This version will no longer be maintained. |
13.1.0.8 | 13.1 | 3 Nov 2021 | Updated for TNG 13.1 code change only cfg file changed. Same mods folder as v13.0.0.8 |
13.0.0.8 | 13.0 | 12 Sep 2020 | Updated for TNG 13 and fixes the Auto Refresh / Turn Off auto refresh toggle which is now supported with tree selection. |
12.3.0.7 | 12.3 | 15 Mar 2020 | Updated for TNG 12.3 and includes several new $text variables and and updates for TNG 12.3 change log item 11. Logs/Security: Log entries will now screen out attempts to log redirection and other malicious code. This is the same code ad the V12.3.0.7_beta1 |
12.3.0.7_beta1 | 12.3 | 23 Feb 2020 | Updated for TNG 12.3 and includes several new $text variables and and updates for TNG 12.3 change log item 11. Logs/Security: Log entries will now screen out attempts to log redirection and other malicious code. |
12.1.0.6 | 12.1 | 15 Nov 2019 | This version has been updated to fix several PHP 7.3 warnings and notices This version only works with TNG V12.1 or newer. For TNG V12.0.3 or below, use a previous version of the mod. TNG 2.2 might be needed to resolve PHP 7.3 errors |
12.1.0.5c | 12.1 | 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. |
11.1.0.4 | 11.1 | 6 Feb 2017 | This version has been updated to support TNG V11.1. |
11.0.2.3 | 11.0 | 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. |
11.0.2.2 | 11.0 | 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. |
11.0.0.0 | 11.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. |
10.0.0.8 | 10.0 | 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. |
10.0.0.7 | 10.0 | 4 Jan 2016 | This version adds support for Italian as well as updated translations for German and Dutch. Thanks goes to Richard Falzini, and Marco van den Heuvel for the translations of text variables. |
10.0.0.6 | 10.0 | 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. |
10.0.0.5 | 10.0 | 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. |
10.0.0.4 | 10.0 | 24 Feb 2015 | This version fixes a syntax error found in V10.0.0.3 |
10.0.0.3 | 10.0 | 20 Feb 2015 | This version adds improvements and fixes from previous versions of the mod:
|
10.0.0.2 | 10.0 | 2 Jul 2014 | This version adds several improvements from previous versions of the mod:
Credit goes to Jim Graham for developing the original backup/clear function that was modified for this version. |
10.0.0.1 | 10.0 | 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! |
10.0.0.0 | 10.0 | 6 February 2014 | Updated for TNG V10 |
9.2.2.6 | 9.2.2 | 4 October 2013 |
|
9.2.2.5 | 9.2.2 | 10 August 2013 |
|
9.2.2.4 | 9.2.2 | 27 May 2013 |
|
9.2.0.4 | 9.2 | 26 May 2013 |
|
9.2.0.3 | 9.2 | 13 Apr 2013 |
|
9.1.1.2 | 9.1 | 23 Jan 2013 | Updated for TNG V9.1.1 |
9.1.0.1 | 9.1 | 24 Dec 2012 | Updated for TNG V9.1.0 |
9.0.0.0 | 9.0 | 2 Feb 2012 | Updated for TNG V9 |
8.1.0a | 8.1 | 16 Oct 2010 | Updated for TNG V8.0.2 |
8.1.0 | 8.0 | 24 May 2010 | Updated for TNG8 and new version schema. |
2.2 | 7 | 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. |
2.0 | 7 | 16 May 2009 | Original Mod Manager config file |
Rev 1.11 | 7 | 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 | 8.1.1 8.1.3/ |
8.0.2 TNG 8.1.1 test |
EN | |
Treichel-Familie.de | Andreas Treichel | Public & Private | 14.0.1.11b | 14.0.3 | DE, UK, FR, ES, PL | |
Roger's Ramblings | Roger Moffat | 13.0.0.10 | 13.1.1 | EN | ||
Our Roy and Boucher Family | Ken Roy | I have used Brian McFadyen's customized log since its early days. | 14.0.1.11b |
|
EN,FR | |
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> clbotsites.txt (as described in the instructions as provided on the user list) |
9.2.2.6 | 9.2.2 | EN | |
Chamberlain & Eidenbenz Geneaolgy | Graham Chamberlain | Public Site | 11.1.0.4 | 12.0.1 | EN,FR,DE,ES,NL | |
A Bisbee Family History | Rick Bisbee | 9.0.0.0 | 9.0.4 | EN | ||
Chambers Family Ancestry | Tom Chambers | Very smooth installation & configuration, and helps to catch the bad guys. | 9.1.1.2 | 9.1.1 | EN | |
Arsenault/Simpson Family Website | Bob Arsenault | 9.1.1.2 | 9.1.2 | EN | ||
Gilbert family history | Warren S Gilbert | 13.0.0.9 | 13.1.0 | EN | ||
Max Westen's genealogy site | Max Westen | Developer of some additions of this mod(starting 9.2.0.4) | 9.2.2.4 | 9.2.1 | NL,EN | |
MOTYER Family Genealogy | John Mark Motyer | Public site | See here | See here | EN | |
British 1820 Settlers to South Africa | Paul Tanner-Tremaine | Public site | 10.0.0.6 | 10.1.1 | EN | |
Mitchell Families Online | Roger Mitchell | Another great update - excellent mod! | 10.0.0.2 | 10.0.2 | EN | |
Total Family History | Scott Bennett | Private Site (For right now) | 10.0.0.1 | 10.0.1 | EN | |
Hooley Family Links | Rick Hooley | Public/Private | See Here | See Here | EN | |
Wortelboer Genealogy | Bernard Wortelboer | 11.0.2.2 | 11.0.2 | NL,EN | ||
Schmit/Heemskerk Family | Rudi Schmit | 10.0.0.7 | 10.1.3 | NL | ||
Familie van Seeventer | Sandor van Seeventer | Public site | 14.0.0.11c |
|
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 | 11.0.2.2 | 11.0.2 | EN | |
R G Strong Family Genealogy | Russell Strong | Public Site | 14.0.1.11b | 14.0.4 | 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/Private site | 13.0.0.8 | 13.0.0 | EN | |
Family Histories | Steven Davis | Public/Private site | 12.3.0.7 | 12.3 | EN | |
The Cole / Tanner Family Tree | David Cole | Public/Private | see here | see here | EN,DE,FR,ES,NL | |
Families all over the world | Hans Weebers | Public/Private | 11.1.0.4 | 12.0.1 | EN,NL,DE,FR | |
Genealogische Datenbank | JPB | Public site | see here | see here | DE,EN,FR | |
Roots & Relatives Remembered | Ron Krzmarzick | Public & Private | See here | See here | EN,DE,CS | |
Thurmon King's New Sackett Family Database | Ted Smith | Public site | 12.1.0.5c | 12.1 | EN | |
Auf den Spuren meiner Vorfahren | UHaase | Public/Private | 10.1.3.0 | 12.2 | DE,EN | |
Barta-Joggele Online aus Mauren, Liechtenstein | Gerald Meier | Private | 14.0.1.11a | 14.0.1 | DE,EN,ES,FR,IT,PT,CZ | |
Our Immigrant Ancestors | Jim Larson | Private | 14.0.1.11c | 14.0.5 | EN,NO | |
Auf den Spuren meiner Ahnen | Michael Klein | Public/Private site | 14.0.1.11a |
|
EN, DE | |
The Duttons of New England | Darrin Dutton | Public / Private | 13.0.0.8 | 13.0.2 | EN | |
Racines Luxo-hennuyères | Michel Kirsch | Public site (registration) | 14.0.1.11c | 14.0.4 | FR,EN,GE,NL | |
The Severijns / Timmer Familytree | Rob Severijns | Public / Private | See here | See here | NL, EN | |
Johnson / Bryans Family Tree | Charlie Ferrero | Public | 13.1.0.8 | 13.1 | EN | |
Sejarah Thümann | Jeffrey Thümann | Public | 13.0.0.10 | 13.0.3 | NL, EN | |
Helwegs Ahnen | Andreas Helweg | Public | 13.0.0.10 | 13.1 | DE,EN,DK,NL | |
Osage County Cousins | Larry G Banks | Public / Private | 14.0.1.11a | 14.0.1 | EN | |
Joseph Oran Holtz Genealogy Pages | Jim Holt | Private | See Here | See Here | EN | |
Your Roots are Showing | Harold Craswell | Public/Private | See Here | See Here | EN | |
La Saga BIGEY | Francois BIGEY | Public | 14.0.0.11b | 14 | FR | |
Les Lapierre d'Amérique | Normand Lapierre | Public/Private site | 14.0.0.11a | 14.0 | FR, EN | |
Kielakowie.com | Janusz Kielak | Public site | 14.0.1.11a | 14.0.1 | PL, EN, DE | |
Solem Genealogy | Jan-Thore Solem | Private | 14.0.1.11b | 14.0.2 | EN, NO | |
American Kindred | AmericanKindred | Public | 14.0.1.11b | 14.0.2 | EN | |
Harnett Sheehan Families | Kathy Harnett Sheehan | Private/Very helpful mod! | 14.0.1.11a | 14.0.2 | EN | |
Stammbaum der Familie Datschetzky | Christian Datschetzky | Public | 14.0.1.11b | 14.0.3 | DE, EN | |
Racine d'Alsace | J-Louis Valory | Public (registration) | 14.0.1.11c | 14.0.4 | FR | |
Bastiaanssen Genealogy | Jan Bastiaanssen | Public / Private | 13.0.0.9 |
|
EN, NL, ES
|
- Mods for TNG v14
- Mods for TNG v13
- Mods for TNG v12
- Mods for TNG v11
- Mods for TNG v10
- Mods for TNG v9
- Mods for TNG v8
- Mods for TNG v7
- Genstyle.css mods
- Showlog.php mods
- Log.php mods
- Cust text.php Dutch mods
- Cust text.php English mods
- Cust text.php French mods
- Cust text.php German mods
- Cust text.php Greek mods
- Cust text.php Italian mods