Difference between revisions of "Living Color Mod"

From TNG_Wiki
Jump to navigation Jump to search
Line 48: Line 48:
 
! Date
 
! Date
 
! Contents
 
! Contents
|- valign="top"
 
| v9.0.0.6
 
| 26 Apr 2012
 
| In addition to highlighting names of persons whose ''''living'''' flag is set, this version adds capability to highlight names whose ''''private'''' flag is set. The admin can turn off highlighting for living or private flags, choose separate highlight colors, and display highlighted names on TNG pages for admins only or for both admins and registered users. See new Mod Manager edit options.
 
 
|- valign="top"
 
|- valign="top"
 
| v9.0.0.5
 
| v9.0.0.5

Revision as of 13:10, 27 April 2012

EDITING IN PROGRESS

Ambox notice.png Living Color has been tested with other popular mods and no conflicts have been noted. If you encounter a clash with other mods on your website, please provide the details and we will look into it.
If you are also using the Wiki Integration mod then it must be install prior to the Living Color Mod in TNG V8.
TNG 9.0
TNG 8.0


Living Color Mod
Summary Displays names of living persons in selected color on personal and family group sheets.
Validation Latest mod is XHTML compliant.Valid-xhtml10.png
Mod Updated {{{mod_last_update}}}
Download link living_color_v9006.zip for
TNG 9.0

living_color_v812j.zip for

TNG 8.1.2
Download stats {{{download_stats}}}
Author(s) Rick Bisbee
Homepage Bisbee Family Connection
Mod Support TNG Forums
Contact Developer Support for Living Color Mod
Latest Mod 9.0.0.6 for TNG V9.0
8.1.2j for TNG 8.1.2
Min TNG V 8.1.2
Max TNG V 9 (all)
Files modified
globallib.php, genlib.php, getperson.php, familygroup.php, search.php, admin_people.php, admin_families.php, showreport.php
Related Mods
None
Notes
Very easy to configure and use.
If you are also using the Wiki Integration mod then it must be install prior to the Living Color Mod in TNG V8.


Introduction

When you are logged in as Admin it is impossible to tell at a glance if a person is flagged as living without going into the Edit tab. It is important because all those not flagged as living may have vital information shown to unregistered visitors. This mod affects TNG pages by setting the names of everyone flagged as living to a color of your choice. The default is dark red, but you can change the color in the Mod Manager editor via the TNG Admin page. You can also determine who will be allowed to see living persons in the chosen color. By default it is Admin only, but you can set it to be visible to any logged in user who is permitted to see living persons. Note that this modification has only been tested in TNG v8.1.2 and TNG V9.0.0.

CAUTION: TNG families also have a 'living' flag which serves to limit information shown to the public about marriages. Living Color on family group sheets or in family search lists only reflects the status of a person's 'living' flag and says nothing about the state of family/marriage 'living' flags.

Modifications to Distributed Files

The basic modification is to globallib.php, where we change function getNameUniversal() to add color styling to the name of a living person if the user has the correct privileges and the calling script sets the $lc_flag. The enabling flag is set in the following scripts: getperson.php, familygroup.php, search.php, famsearch.php, admin_people.php, admin_families.php, showreport.php, whatsnew.php and descend.php. In globallib.php and genlib.php we strip styling from names used in page titles and photo captions.

Changes are made to the library files, and many of the other files are flagged to display their data in living_color. A TNG upgrade that replaces any of them will generate errors in mod manager. Doing a clean up will probably fix them, but we prefer to uninstall the mod first and reinstall it after the upgrade.

It would be prudent back up the affected TNG script files before installing any mod.

Conflicts With Other Mods

TNG version: 8.1.3

At the moment there are no known conflicts with other TNG mods. It should be noted however, that if you are using the Wiki Integration mod, you must install it before installing Living Color in TNG V8..

Revision History

Version Date Contents
v9.0.0.5 14 Apr 2012 Fixes Errors in Admin >> People when searching for those with no children or no parents.
v9.0.0.4 25 Feb 2012 Removes unwanted styling from CSV output in showreport.php
v9.0.0.3 21 Feb 2012 Adds living color to timelines
v9.0.0.2 16 Feb 2012 Prevent fatal errors if upgrade is installed on top of mod
v9.0.0.1 15 Feb 2012 Minor technical fix
v9.0.0.0 8 Feb 2012 Updated for TNG V9. No known conflicts or install dependencies.
v8.1.2j 18 Aug 2011 Deconflicted with Research Link Mod; add descendant charts (again).
v8.1.2i 15 Aug 2011 Deconflicted with Submit Photo/Document Mod.
v8.1.2h 15 Aug 2011 Deconflicted with Relationship Display Mod.
v8.1.2g 15 Aug 2011 Deconflicted with Deceased Icon mod; included What's New page.
v8.1.2f 13 Aug 2011 Fixed a few bugs, reduced it's impact on TNG scripts, and made it a bit more bullet-proof.
v8.1.2e 11 Aug 2011 Fixes a bug on family edit page, where if you added a parent by personID it showed the styling tags as part of the name. Also fixed the alt text for small photos in family group sheets to remove styling tags.
v8.1.2d 10 Aug 2011 Adds living color to virtually all pages and lists
v8.1.2c 9 Aug 2011 Adds living color to individual and family search lists
v8.1.2b 2 Aug 2011 Adds living color to descendant charts
v8.1.2a 29 Jul 2011 Initial release of Living Color Mod

Visualizations

User's Page View

This is how part of a page might appear with Admin or View living persons privilege. Bear in mind, the color simply shows that the living flag is set.

Lc001.jpg

The example above is shown with the Child Descendant Indicator Mod by Chuck Filteau that replaces the greater-than symbol (>) with the more traditional plus sign (+) to indicate that a person has children.


Note that if your are using the Event Map add children mod the child's name in the Google Map Events table will also be changed to use the Living Color.

Mod Manager

After the Living Color Mod is successfully installed, one of the items listed in the Mod Manager will look something like this.

Lc003.jpg

To change the program parameters, click on Edit.

Mod Manager Editor

The Mod Manager editor presents two program parameters for editing. The first sets the color of the text for a living person's name. The color can be expressed as a hex color code (e.g., #008080) or as a color constant (e.g., blue). In either case, do not surround the parameter with quotes. The second parameter sets access, either for just the Admin (default), or else for all users who have been granted View living persons privilege. After changing one or both values, click on Confirm Edit to save your preferences. Clicking on Read Existing Values from TNG files followed by Confirm Edit resets both values to their defaults as shown in parentheses.

Lc002.jpg

Requirements

  • A working TNG v8.1.2 installation
  • A copy of living_color_v812.cfg

Automated Install

  1. Remove and delete previously installed version.
  2. Download the appropriate zipped config package from the Mod Summary in the upper right hand corner
  3. Unzip the config file and place it in the /mods folder.
  4. Click on Mod Manager in the Admin panel and install it.
  5. In the Mod Manager listing for this mod, click on Edit and change the color and access parameters as desired.

Manual Installation

Manual installation is not supported.

Side Affects

The names shown in 'living color' are also links, but they will no longer change their color when you hover over them as do your normal links.

Acknowledgements and Disclaimer

Thanks to Ken Roy for his assistance and always helpful suggestions. Also kudos to Bryan Larson and Rob van Rij for suggesting useful extensions.

As always, use this script at your own risk. The author will not be responsible for any damage to your website resulting from its use.

See also

  • Deceased Indication - adds a headstone indicator viewable by all visitors to the page to indicate whether an individual is deceased

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
Bisbee Family Connection Rick Bisbee Mod Developer V8.1.2/TNG 8.1.2
V9.0.0.0/TNG V9.0.0 beta
EN
Our Roy and Boucher Family Ken Roy I also use this mod on a test system with the Wiki Integration mod V8.1.2/TNG 8.1.3
V9.0.0.0/TNG V9.0.0 beta
EN, FR
Our Family Histories Bryan S. Larson I use this mod with admin only enabled. V9.0.0.2/TNG V9.0.1 EN
Kielakowie.pl Janusz Kielak I also use this mod on a test system with the Wiki Integration mod V9.0.0.5/TNG V9.0.2 PL,EN,DE,ES,RUS