• Test Site: http://trial.upavadi.net/ site Does not use wordpress / TNG integration
• Live Site: http://www.upavadi.net/ site uses Kloosterman method for wordpress / TNG integration
• On both sites, WordPress and TNG are installed in their own folders.

License

The code is licenced under the MIT licence

Introduction

This widget replicates the WordPress login/log out task and also logs into TNG, The Next Generation of Genealogy Sitebuilding.

• Adds a Registration Form which may replace the WordPress registration form by deselecting ‘Membership>Anyone can register’ in WordPress Dashboard>Settings.
• Adds a User Profile page which saves the changes in WordPress and TNG database
• Adds an enhanced Password-Reset module which checks for the presence of email of registered user.
• Almost all the text used in pages and emails is customisable by the administrator.

• User may login using either registered user Name or email. On successful login, if User Name exists in TNG database, the user is also logged in to TNG.

• GDPR Privacy policy is implemented

Compatibility

• The plugin has been tested on TNG 9.1, 10.1.3, 13.1 and 14.x
  • database changes made to TNG 11.x are allowed for. My thanks to Darrin for supplying details.
• PHP version 5.4 – 8.0.1
• WordPress V 4.9 – 5.9 platform
• A WordPress twenty Twelve child theme. (Not tested in any other theme).
• Works on default TNG table names defined in TNG Setup.

Issues

WP-TNG Integration is achieved by displaying TNG content within WordPress wrapper. To my knowledge, there are 2 main methods available for achieving this. Works well with TNG V 9 – 10 and 12. Changes in V11 implemented but have not been tested.

1. Mark Barnes method (MB-Method) uses a plugin to replace WP page with TNG content. This method does not sem to work in WordPress v6.xx.
   • If using this method, deselect “Integrate TNG/Wordpress logins: ” option.
2. Cees Kloosterman Method (CK-Method) uses customized Header and Footer files by replacing TNG Header and footer by Hard coding topmenu.php, footer.php and meta.php, in TNG folder. This is a very simple and effective method and I have now converted my live site CK-Method.
3. The plugin is also tested with TNG V12 using both integration methods
4. Send email uses Worpress mail. It is possible that emails do not work if you have SMTP mail enabled in WordPress. Please let me know if this is an issue.

**Change Log **

• Current Vesion 3.1.3 Beta: Ready for Beta Test

  • Variables updated for PHP 8
  • New registration enambled to 3.1.2
  • Ready for Beta Test

•  3.1.2 Beta Not Released

  • Add ability to work with TNG tables with modified table names, as they appear in TNG setup.
  • Tighter error trapping
  • sometimes it failed to recognize TNG V12. FIXED.
  • Three Utilities not added yet.
    • Registration
    • User Profile
    • Lost Password
    • Added success token for successful initialization
  • Tested with PHP 8.0.1 – No errors
  • Tested with WordPress 5.9
    • Throws up few WordPress errors with PHP 8.0.1 – Plugin has no errors.
    • Please note that there is a major change in how WordPress 5.9 deals with Widgets. There is a convoluted way in which it registers a new widget. Best way, for now, is to have the plugin widget active when upgarding to 5.9. I am trying to get my head around how this works!!

• Version 3.0 Not released

• Version2.0.3.2

  • A fix for an open session error reported by the WordPress Site Health plugin.
  • A private mod for redirecting Social media logins. * Commented Out **

• 2.0.3.1

  • Fix typo which prevented Full Name and Email fields for the user updated in TNG Users. (My Thanks to Jan Strømsnes. https://stromsnes.info/)

• 2.0.3

  • change current version number
  • Fix bug which gave incorrect information in Profile Page.
  • fix ‘undeclared variable’ notice

• 2.0.2

  • Fix bug which gave incorrect information in Profile Page. (My Thanks to Jan Strømsnes https://stromsnes.info/)
  • change current version number
  • fix ‘undeclared variable’ notice
  • fix conflict with some plugins with consent confirmation
  • fix typo(s) when new pages are gnerated
  • fix conflict with WordPress editor when editing active files

• 2.0.1

  • change current version number
  • fix ‘undeclared variable’ notice
  • fix conflict with some plugins with consent confirmation

Activation

On activation,

• plugin inserts following pages if they do not exist.

• Plugin checks for the path to TNG folder. If it cannot locate the folder, administrator is prompted to submit TNG Root (absolute) Path and if tng folder is found, plugin is activated.

• Please note that you may get PHP warnings, if debug is active, complaining that it canno find subroot.php in TNG folder. Navigate to the bottom to see the prompt

New Registration Form

A link to registration form is included in the login widget.

• On submission, submitted user name and user email is checked against WP and TNG user details.

• If New User Consent is enabled, submitter is asked to give consent before new registration is accepted. On successful submission,

• New registrations are entered in WP and TNG User tables.

• In TNG, user awaits Review (TNG>Admin Panel>User>Review Tab).

• In WP, user is allocated ‘Subscriber’ role.

• Note: I allocate Contributor (or above) role to all my users.

  • Subscriber role does not have any privilages.
  • For this to be effective, I deselect Membership> Anyone can register in WP Dashboard>Settings.

• New user receives an email generated by the plugin.

• Email is sent to Administrator for new registrations, password reset alerts.

• If there is an anamoly in data, email is sent to administrator with details of the data held.

• Text for screen alerts and email can be configured, by the administrator.

• Recaptcha V2 can be used by entering public & private keys and enabling recaptcha in dashboard panel>WP-TNG-Login> Captcha keys.

• If you have recaptcha V3 installed then there is no need to enable V2.

Password Reset

• Some WP Password-Reset routines are re-written.
• Password reset is only allowed if the submitted email is in WP database.
• If the submitted email is in TNG database only, email is sent to administrator with credential details and submitter is requested to await a response from the administrator.

Profile Page

WP user page is not easily available so this profile page may come in useful.

• On successful login,
  • if user is an administrator, link to Dashboard is shown
  • otherwise a link to Profile page shown. Text for this can be edited in admin panel.
• Here user can make changes to user data, including password, and data is saved in WP and TNG database.
• If user has default phot specified in TNG, this will be displayed here.

Customized Text

All text is held in config.json file and can be edited by going to admin panel and accessing via admin-menu.

• WP-TNG-Login
  • Plugin Paths:
    • Enter TNG absolute path, Tng URL and Name of TNG photo folder
  • Login Text:
    • Enter text for Greeting, user page and slug names for profile and registration
  • Captcha Keys
    • enter Public and Private Keys
    • Enable Captcha
  • Profile Page
    • Here you can control the text of all the labels
    • Enable/disable additional interest fields
  • Registration Page
    • Here you can control the text of all the labels
    • Enable/disable additional interest fields
  • Registration Messages
    • Registration Success Message
    • New Registration email
    • Email in TNg only – anamoly
    • Introduction text (Appears before Reg Form)
      • Enable Intro Text
  • Password-Reset Messages
    • Text for Suggest Password Reset to New Registration
    • Text for Forgot Your Password
    • Text for Lost Password email
  • Privacy and Consent
    • Enable consent for new user (Track TNG setting if avalable)
    • Edit User consent agreement Text
    • Seek Consent from existing User
    • Edit consent agreement Text for existing user
    • Enable Cookie Approval Message (Track TNG setting if avalable)
    • Edit Cookie Message
    • Show link to Data Protection Policy (Track TNG setting if avalable)
    • Use TNG document or your own customized document

Privacy

TNG V12 Introduces privacy policy and this plugin will track TNG settings. For V 9 – 11, privacy policy can still be implemented

• Privacy settings can be accessed from Admin Dashboard>WP-TNG Login>Privacy

• On first activation, visit the privacy panel

• If you are using TNG Version 12, panel will display the 3 privacy settings in TNG and appropriate checkbox(s) checked below. I suggest you leave the default checkbox settings as they are. Any change to these 3 settings shoud be done in TNG admin panel. After every change in TNG, revisit this panel and save the changes.

• if you are using TNG Version 9, 10 or 11, you may still use the the settings. Only difference would be notification of Cookies which is described below, under cookies.

• The options:

  • Enable User Consent regarding personal info
    • tracks V12 setting, Prompt for consent regarding personal info.
      • New user registration: User is asked to give consent to store personal information.
      • Text for this is in User consent agreement Text
      • Prompt to notify user that they must give consent is in Prompt for consent agreement.
      • User registration is completed when this agreement is accepted.
  • Show link to data protection policy
    • tracks V12 setting,Show link to data protection policy
      • You have an option of using either
        • TNG Privacy Document or
        • your own document (I already had WordPress before upgrade to V12. So I use this page)
      • You would need to enter appropriate URL in URL for Document Location. I have provided some some prompts below the text area.
      • New user has an option of viewing the Privacy-policy before giving consent.
  • Show Cookie Message for anonymous visitor
    • tracks V12 setting, Show cookie approval message .
    • I have had a good think about this and after taking advice I came to the conclusion that session cookies are not that bad. As long as visitor is informed, in the privacy docunment that the site uses session cookies, that should suffice.
    • When anonymous visitor visits
      • WordPress does not save any session cookies
      • TNG V9, 10 or 11 do not save any session cookies
      • TNG v12 saves a PHPID cookie and if Show cookie approval message is enabled, a pop-up stating site uses cookies and accept option. If accepted, TNG places and identifier cookie.
    • So this is what I have decided to do. When Show Cookie Message for anonymous visitor is checked
      • When an anonymous visitor comes to the site, a banner below the login panel shows that the site uses cookies.
      • The banner goes away as soon as visitor logs in.
      • Text for the banner (best keep it short) is entered in Cookie Message
      • If TNG V12 is in use, all thg pages will display TNG cookie popup until the pop-up is ackowledged.

• There is an additional option

• Seek Consent from existing User: This allows you to seek consent from existing users who have not given consent before. User is only logged in if consent is given. Text for the content is entered in text area, Prompt for Logged In User Consent. You may also add that site uses cookies.

Please let me know if there are any bugs or you have any suggestions