Free tag images

Free tag images
Summary	Allows you to tag media for people or things not belonging to your genealogy
Validation
Mod Updated	30 Jul 2023
Download link	For TNG 15.0 TNG 14.0 V14.0.0.3a For TNG 13.0.3 V13.0.3.2d
Download stats	Show statistics
Author(s)	Michel Kirsch
Homepage	Racines luxo-hennuyeres
Mod Support	TNG Community Forums
Contact Developer
Latest Mod	13.0.3.2d for TNG v13 - 14.0.0.3a for TNG v14
Min TNG V	13.0
Max TNG V	V 13.1.2 for v13x
Files modified	adminlib.php admin_editmedia.php ajx_updateorder.php genlib.php img_viewer.php js/img_viewer.js js/selectutils.js languages/English-UTF8/cust_text.php languages/English/cust_text.php languages/French-UTF8/cust_text.php languages/French/cust_text.php showmedialib.php
Related Mods
Notes

NOTE for TNG14 users.

From TNG version V14, the functionalities offered by the Mod are integrated into TNG.
The version v14.0.0.3 allows you to migrate your old image tags to the new TNG14 system. (see this article).
After migration, you can uninstall then delete the mod OR keep it to display coloured tags as with the old mod.
See this section

Purpose of the Mod

If a person in a photo is not part of your genealogy, this mod allows you to tag them as well as others. Example: "Clara, the baker's daughter". You can also tag objects ("The Smith's house") or map parts, etc... (See examples below: Visualisation) The length of the freetag is limited to 50 characters (60 in version2x).
version 2x allows you to enter a link limited to 120 characters.
The combination freetag + link must be unique for the current media !

Development

Written by : Michel Kirsch from Charleroi - Hainaut - Belgium

Requirements

A TNG V13.0.3 or TNG V14.0 installation in working order.

IMPORTANT : Before installing

Before installing, it is best to make a backup copy of the files that will be modified by this mod. (see #TNG Modules Impacted )

Visualisation

In the media editing screen, go to the bottom of the screen and click on "Image tags".

In the presented media, draw a rectangle around the person or thing you want to tag.

In the window that opens, you have the choice of searching for a person in your genealogy OR entering a free tag of up to 60 characters.
Once you have entered your tag, you can enter a link of max 120 char, pointing to an external (or internal, why not) web page (version2+). When finished, click on "Click to confirm" in the list to save your new free tag.

Your tag is now part of the media.

If you have entered an internet link in the window above, it will be displayed with an other colour
You can modify the used colors for the free tags (with or without link) in the Mod parameters ([Edit Options] button).
The colors can be entered as you prefer : floralwhite, #FFFAF0, rgba(255, 230, 249, 0.6), etc... Be sure to respect the syntax of the colors. Quotation marks are NOT allowed !

TNG Modules Impacted

You can click on the [Expand] link on the right to display the list of TNG Modules change and the [Collapse] link to hide this section again.

The following TNG Modules are modified, and should be backed up prior to installing this mod:

adminlib.php
admin_editmedia.php
ajx_updateorder.php
genlib.php
img_viewer.php
js/img_viewer.js
js/selectutils.js
languages/English-UTF8/cust_text.php
languages/English/cust_text.php
languages/French-UTF8/cust_text.php
languages/French/cust_text.php
showmedialib.php

Files copied by this Mod

Source	Destination
mods/free_tag_images_x/admin_free_tag_images.php	TNG root
mods/free_tag_images_x/findpersonform3.php	TNG root
mods/free_tag_images_x/fti_css.php (protected against erase)	TNG root

Tables modified by this Mod

Note : all these modification are undo with clicking on the "Restore" button (see image below, "Installation" section)

Table	Action
tng_trees	Adds a dummy tree named "Z_FREE_TAG_Mod_TREE"
tng_people	Adds a dummy person with id = "I0" and firstname = "Click to Confirm" (depends of install's language)
tng_image_tags	Adds a new field named "freelabel"
tng_image_tags	Modify the table's index to include the new field in it.

INSTALLATION

• Unzip the received file directly in the "mods" sub directory of your TNG installation.
  
• Via Mod Manager, install the Mod.
  
• Once the Mod installed, you must click on the "Modify" button in order to create the mod's environment.
  

(clicking more than once on this button has no undesirable effects)

TNG14 Migration

• Unzip the received file directly in the "mods" sub directory of your TNG installation.
  
• Via Mod Manager, install the Mod.
  
• Once the Mod is installed, you must click on the "Migrate" button in order to migrate the tags created with the Mod to the TNG14 free tag system.
  

This action will migrate your tags, delete the dummy person in tng_people, delete the dummy tree in tng_trees and restore your tng_image_tags table in its original state.
(clicking more than once on this button has no undesirable effects)

.

Deleting the mod is not an obligation. If you decide to keep it, the tags (even those of TNG) will be colored as in the examples on this page (Return to top)

Upgrade

When upgrading to a newer version

• Don't "Restore" your environment : you will lose all your free labels! (see image above)
• Uninstall and eventually Delete the current Mod.
• Proceed as for an installation with the new Mod.
• Clicking on "Modify" is needed if you upgrade from version 1x to version 2x.

Uninstall

If you don't want to use the Mod anymore, restore your environment by clicking on the "Restore" button (see image above, "Installation" section)
Clicking this button makes you lose ALL your free tags !

In the event of a problem

• Try using the Mod Manager Remove capability
• Copy the backup of the affected files back to your TNG directory
• If the problem persists, open an issue in the TNG Community Forums or on the page of Michel Kirsch. At worst, send a mail to

Historic of modifications

Version	Release Date	Contents
14.0.0.3a	30 Jul 2023	Fix the freeze problem for Chromium-based browsers.
14.0.0.3	15 Dec 2022	To use with TNG14 only ! This version allows you to migrate your old image tags to the new TNG14 system. (see Image_Tags_TNG_v14). After migration, you can uninstall then delete the mod OR keep it to display coloured tags as with the old mod.
13.0.3.2d	04 Jan 2022	Moved the call for CSS in the head section of genlib.php
13.0.3.2c	18 Nov 2021	Add possibility to join an url to the label - 2 kinds of labels (with or without url) - Label and text colors modifiable by Admin in Mod's options (via fti_css.php file (protected))
13.0.3.2 - 2a - 2b	12-18 Nov 2021	Test versions - Not published
13.0.3.1a	12 Nov 2021	Fix incompatibility with Media Tooltip
13.0.3.1	11 Nov 2021	First online version.

Sites using this mod

If you download and install this mod, please add your TNG site to the table below:
If you have any problem to do it, send me a mail...

URL	User	Note	Mod-Version	TNG-Version	User-language
Racines luxo-hennuyeres	Michel Kirsch	Mod's Developer	14.0.0.3a	14.0.3	FR/EN/NL/GE/ES
Malkins' in Nu Tirani - New Zealand	Rick Malkin	Private	v14.0.0.3	TNG 15.0	EN
GénéaKat	Katryne Chauvigné-Bourlaud	Public/Private	14.0.0.3a	14.0.4	FR,EN,SP
Kielakowie.com	Janusz Kielak	Public site	14.0.0.3	14.0.1	PL, EN, DE
Von den Isert's und den Schmidt's	Mabba	Local	14.0.0.3a	TNG 15.0	DE