Difference between revisions of "Living Color Mod"

From TNG_Wiki
Jump to navigation Jump to search
(Added TNG Sites using this mod)
(→‎Visualizations: added change to Events Map table color)
Line 94: Line 94:
  
 
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.
 
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 ===
 
=== Mod Manager ===

Revision as of 06:38, 2 September 2011

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.
TNG 8.1.2


Living Color Mod
Summary Displays names of living persons in selected color on personal and family group sheets.
Validation n/a
Mod Updated {{{mod_last_update}}}
Download link living_color_v812j.zip
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 8.1.2b
Min TNG V 8.1.2
Max TNG V 8.1.2
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.


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.

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.

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

Conflicts With Other Mods

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.

Revision History

I apologize for this flurry of initial file updates. When I made Living Color universal, it introduced a few subtle bugs that took a few days to find. There may be more but we'll continue to update as we become aware of them. Thanks for all your patience and support.

Version Date Contents
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 zipped config package: living_color_v812j.zip
  3. Unzip the config file and place it in the /mod 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.

Sites using this mod

Please add TNG site that you have found that utilize this modification!

URL User Note Mod-Version/TNG-Version User-language
Bisbee Family Connection Rick Bisbee Mod Developer V8.1.2/TNG 8.1.2 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 EN, FR