You can find the latest stable version (3.3.3) in the releases section
The code is licenced under the MIT licence
The TngApi plugin for Wordpress is a stand-alone plugin. It integrates smoothly with TNG ( The Next Generation of Genealogy Sitebuilding ) to display genealogy data in Wordpress pages.
Current Released Version V3.3.3A
Security Update
Jquery version "jquery-1.10.2.min .js" replaced with jquery-3.5.0.min .js in /js folder
Coy of current 3.5.0 version is jquery-current.min .js in /js folder
Modified familyuser.html.php and submit_images.html.htp to use jquery-current.min .js.
Deleted js/jquery-1.10.2.min .js
3.3.3
Special characters, Æ, Ø, Å or Swedish Ä, Ö, showing as ???. Fixed.
There was an obscure condition when the plugin would crash
3.3.2
Fix bug in setting maximum image upload size. Now the Image size is set in htaccess file, in templates folder. Only change file size.
_php_value upload_maxfilesize 3M
3M = 3Mb upload size
Updated code in Upload Images.
Allow email notification for changes
Fix PHP 8.01 warnings.
Fix PHP errors generated by PHP version change
Trap PHP warnings so that the error does not lock up Wordpress.
If TNG folder is not found, a mini form is generated in the dashboard to allow administrator to update value.
If there is TNG database error, a mini form is generated in the dashboard to allow administrator to update values.
if Wordpress user is not in TNG, exit plugin page.
Anamolies in upload images: Fixed
Family Page
Cousins Button. If this TNG mod is active, the button can be activated by removing the comment line in line 16.
Event - Marriage Anniversaries: Added: Ignore Divorced
Event templates (Birthdays, marriage and death anniversaries) - Removed flaky datepicker and replaced with drop down months. Added a Today button to revert to current month
Search Family Widget: -Fixed compatibility with Wordpress 5
Fixed Typos
Fix table responsive
Image upload: Fixed coding bug
Added version check for 11, 12 and 13
Update README.md
Bug fixes post bootstrap
Added Tweeter Bootstrap for responsive display
Minor bug fixes
Fixed inconsistent display of 'hasKids' flag
remove typo in update family (line 788)
Allow display of completed changes submitted by user on 'thank-you' page
Changed plugin name to TngApi-V3
Modified settings and family template to cater for varying installations
Situation where only one of a new mother or father is added and then the head person would not be registered as a child - Fixed
situation where new parents were added and then the head person would not be registered as a child - Fixed
when children added to person with multiple marriages, incorrect personIDs were given. Fixed.
remove special event inheritance from father.
TNG Submit Header showed User name instead of head Person Name - fixed
Event Report: Death Anniversaries: Added default image if there is one.
Event Report: Birthdays: Added default image if there is one
Media for individual allocated to All Trees and individual allocated to one tree: media did not show for individual - Fixed
Accept blank settings page on Activation
Bug fixes
Update README.md
Update Version Number
Bump up version number and tidy up
Five Temporary Wordpress tables to hold User Submitted Data.
wp_tng_children, wp_tng_events, wp_tng_families, wp_tng_notes and wp_tng_peop-le
User Submission Page to display User Data
Admin Submission Page to User Submissions
Facility to update TNG database from submission page
Cater for multiple trees
Respect Privacy flag for individual, family and notes
Specify whether a (customized) special event is to be tracked
Specify path to TNG from TNG links
Path dependent on whether TNG Page Integration is used or not
Option to remove wordpress temporary tables on deactivation
Bug fixes
Not released
Tab Shortcode
Image Upload Shortcode
Default Image upload from Family Page
Date Selector for Event Reports
Bug fixes
This plugin assumes that:
http://mytngsite.com/tng).You will need the connection settings for your TNG Database handy.
If you are not sure, you can see them in config.php, in your tng directory.
After installing the plugin you can find the settings page in the Wordpress>Admin Panel>settings>TngApi.
Here you'll need to specify:
Notification Email address:
TNG Path: The location of your TNG installation as it is on disk (i.e. /path/to/tng)
URL to TNG Folder: This is the url to TNG folder. It will be of the form http://yoursite.com/TNG folder name/
TNG Integration Path: Enter TNG folder name here. If you are using TNG Wordpress Integration by Mark Barnes, enter the name of the page you have specified to display TNG pages within Wordpress container. Leave blank if you are using Kloosterman method.
TNG Photo Folder: Enter the name of the folder to use to get media from TNG. Default is photos
TNG Collection ID for Photo Uploads: User images are uploaded in to one of TNG folders with the collection name specified by you in the admin set up. Enter the name for the collection you have set up in TNG admin > media. Mine is called “My Uploads”. Before you enter this, refer to the section, Image Upload, below.
Hint: My collection is set as
TNG Event to Track: If you would like to track a customized field or event, you may create this as a special event type (TNG Admin> Custom Event Types > Add New) or use an existing one. Select this event in the drop down list. This feature may be turned off by selecting Do not track.
Your Database connection settings:
Deactivation: The plug-in creates some temporary tables in the Wordpress database to store changes submitted by the user. On Deactivation, there is an option to either
Select Remove User Submitted data if you are upgrading or permanently removing TngApi plug-in.
There are a number of useful shortcodes for you to play with. You can find them all in the plug-in>upavadi>shortcodes directory.
| 1 | [upavadi_pages_familysearch] | Shortcode used on a page to display results of Name-Search Widget. |
| 2 | [upavadi_pages_familyuser] | Family page for Person |
| 3 | [upavadi_pages_familyform] | Update details of Persons Family |
| 4 | [upavadi_pages_addfamilyform] | Add Details of Spouse, children and notes | 5 | [upavadi_pages_personnotes] | Add Notes for Person | 6 | [upavadi_pages_birthdays] | Birthdays Report | 7 | [upavadi_pages_manniversaries] | Marriage Anniversaries Report | 8 | [upavadi_pages_danniversaries] | Death Anniversaries Report | 9 | [upavadi_pages_submit-image] | Upload Image | 10 | [upavadi_pages_userfamilysheet] | Display Pending Submissions submitted by the logged in user. |
By placing the directory outside the plugin, your custom shortcodes would not be overwritten on any future updates.
| 1 | search | To enable search widget, Family Search, to display data. Page can also be used for search | Required for the widget | 2 | family | To enable search widget, Family Search, to display data. Page can also be used for search | Required for the widget | 3 | thank-you | Submission Acknowledge Page. Displays Thank you message and details of changes submitted by the user | Required |
| 4 | events | An events page to display reports of birthdays, anniversaries and death anniversaries for the month. Give it an appropriate name.I have named this page, events. | Optional |
| 5 | images | An image upload page. Give it an appropriate name. | Optional |
The family page may be populated with 5 shortcodes using the TAB shortcode.
[tabs]'[tab title="Family"]``[upavadi_pages_familyuser]``[/tab][tab title="Update Family"]``[upavadi_pages_familyform]``[/tab][tab title="Add Family"]``[upavadi_pages_addfamilyform]``[/tab][[tab title="Update Person Notes"]``[upavadi_pages_personnotes]``[/tab][tab title="Pending Submissions "]``[[upavadi_pages_userfamilysheet]``[/tab][/tabs]Advantage of placing these shortcodes is that all 5 shortcodes are synchronized to the logged in user and same personID.
There are 3 shortcodes for displaying events for the current month. Place these 3 shortcodes on one page, using tabs.
[upavadi_pages__birthdays] Birthdays[upavadi_pages__manniversaries] Marriage Anniversaries[upavadi_pages__danniversaries] Death Anniversaries Report[upavadi_pages_submit-image] in your Upload page .Profile image upload is included in the family page. Here the user does not need to enter any information. The profile image is saved with PersonID. An Email is generated to the Administrator on upload.
Once the User has submitted changes, a thank-you page is displayed which will show changes submitted by the user.
thank-you with your message you would like to be displayed, in this page.[upavadi_pages_userfamilysheet] shortcode to display changes submitted by the userCaveat:
In my last test with TNG V12, the updates worked but I am not comfortable ( and not that experienced ) with the way I have to update the TNG database. I expect it would work with V13 as there are no changes to the tables that would impact on this routine. But I have not tested the update process.
Please have look at TNG Submits>Please Read, in worpress Dashboard for fuller explanation.
These are saved in temporary Wordpress tables. Administrator can view each submission, approve and then transfer the changes to the TNG database.
You are presented with a list of original values and changes. Here you would accept the changes you would like to implement. You also have an opportunity to modify most of the submitted changes.
Wordpress>admin>TNG Submits>Pending Submissions displays number of outstanding submits. Pending submissions gives a list of submissions with User name, affected person and date of submission.
You are presented with a list of original values and changes. Here you would accept the changes you would like to implement. You also have an opportunity to modify most of the submitted changes.
Click on View to open the submission.
The page is divided in sections. You will have to go through each section and Accept changes you approve.
If you are selecting an event or Notes section for update, you must Accept ALL. As TNG stores this data differently, it is essential that all the data for the item is submitted.
Once you have checked the submission, you may Save Accepted Changes. Save Accepted Changes will transfer your selected changes to the TNG database. Your submission page should update to reflect the updated values.
Once you are happy with the change, you can click on Discard Submission to delete the user submission.
There are 3 reports which can be placed in a Wordpress page. If you would like to display these reports, create a page for the templates. There are three shortcodes for Birthdays, Marriage Anniversaries and Death Anniversaries. Each shortcode has Month and year selector. By placing these shortcodes in one page, month selection would apply to all 3 templates.
[upavadi_pages__birthdays] Birthdays[upavadi_pages__manniversaries] Marriage Anniversaries[upavadi_pages__danniversaries] Death Anniversaries Report
Above reports use Person hyperlinks to the 'Family' page.[tab] shortcode to place these 3 events in one page.[tabs] [tab title="Birthdays"][upavadi_pages_birthdays][/tab] [tab title="Marriage Anniversaries"][upavadi_pages_manniversaries][/tab] [tab title="DeathAnniversaries"][upavadi_pages_danniversaries][/tab] [/tabs]
This is very much a project that can evolve so please feel free to fork and submit pull requests.