View source for New Account Form Mod

<table>
<tr valign="top" style="background: #EEF3E2">
<td style="width: 25px; padding: 0.4em;">[[Image:Geographylogo.png|25px]]</td>
<td style="white-space: nowrap; padding: 0.7em 3px; border-right: 1px">'''Languages'''</td>
<td style="white-space: nowrap; padding: 0.7em 3px; border-right: 1px">[[New_Account_Form_Mod|'''English''']]</td>
<td style="white-space: nowrap; padding: 0.7em 3px; border-right: 1px">[[New_Account_Form_Mod/de|'''German''']]</td>
</tr>
</table><br />{{restricted}}{{V12_cust_text}}{{TNGmod
| mod_name        = New Account Form Mod
| mod_summary     = Changes $text variable for override and adds a Reason to Request an account
| mod_validation  = This mod is XHTML compliant.[[Image:Valid-xhtml10.png|44px]]
| mod_last_update = 7 Feb 2025
| download_link   = For{{Tv150}}[https://www.royandboucher.com/ccount/click.php?id=776&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} new_account_form_v15.0.0.3.zip]<hr style="clear: both;"/>For {{Tv130}}[https://www.royandboucher.com/ccount/click.php?id=552&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} new_account_form_v13.0.0.2.zip]<hr />For {{Tv120}}{{Tv110}}{{Tv100}}[https://www.royandboucher.com/ccount/click.php?id=254&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} new_account_form_v10.0.0.1.zip] <hr />For {{Tv90}}[https://www.royandboucher.com/ccount/click.php?id=74&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} new_account_form_v9.0.0.0.zip] <hr />For {{Tv80}}[https://www.royandboucher.com/ccount/click.php?id=75&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} new_account_form_v8.1.0.zip]<hr />For {{Tv70}}[https://www.royandboucher.com/ccount/click.php?id=76&user={{#replace:{{CURRENTLOGGEDUSER}}}}&page={{PAGENAMEE}} new_account_form_v1.1.zip] for TNG V7
| download_stats = [https://www.royandboucher.com/ccount/index.php?action=stats&id=74-75-76-254-552 View download statistics]
| mod_author      = Ken Roy
| mod_url         = [[New Account Form Mod]] (This page)
| mod_support     = [https://tng.community/index.php?/forums/forum/15-tng-modifications/ TNG Community Forums]
| mod_contact     =
| mod_version     = v15.0.0.3 for TNG 15+<br />v13.0.0.2 for TNG 13+<br />v10.0.0.1 for TNG 10+<br />9.0.0.0 for TNG v9 and up<br />8.1.0 for TNG V8<br />1.1 for TNG V7
| min_TNG_ver     = 7.0.0
| max_TNG_ver     = 15+
| TNG_file_list   = newacctform.php
| related_mods    = 
| notes           = You need to edit the config file to reflect your own reasons for a User Account Request and the information required in the Notes field. <br />If using multiple languages, please add the [[New Account Form Mod#Custom Text Additions|custom text]] for your other language files.
}}{| style="margin-right:0.5 em;" align="right" 
| __TOC__
|}
== Introduction ==

'''Note that with TNG V8''', $text['acctcomments'] is used for the newacctform.php and can be overridden using the normal custom text overrides in cust_text.php without impacting the use of $text['comments'], which might eliminate the need for this mod.

This sample mod:
* changes $text[comments] to '''$text[usercomments]''' to make it easier to override the text since $text[comments] is also used elsewhere within TNG V7 and provides the languages/English and English-UTF8/cust_text.php overrides for $text['acctcomments'] for TNG V8 
* adds a '''$text[userreason]''' to indicate when a User Account is required
* makes the Phone Number a required field 
* makes the Notes a required field 

This mod Automated Install was tested on TNG 7.1.0 and above.  The mod will work with other TNG version where you are using the [[Mod Manager]], or you will need to figure out what line numbers to modify, since no Manual Install instructions are provided. 

The New Account Form Mod is provided as an '''example''' of how to modify the New Account Form (newacctform.php).  Since this will be unique to each site, you will need to edit the config file for the text you want to display and whether you want to make certain fields required or not.

<span style="color: red">'''Note''' that you cannot use php comment characters to comment out lines in the Mod Manager config file, you need to remove the lines.</span>  You can add comments between the end of a keyword parameter and the start of the next keyword parameter sequence.  See [[Mod Manager Syntax]]

== Developer ==

Ken Roy developed this mod with help from several other TNG users on the Forum or User2 list.

== Advantages ==

This mod
* identifies the reason you need a User ID on your site, such as to '''view information on living''' cousins
* reduces the number of User Account requests received from people who are related to ancestors in the 1600s and 1700s
* eliminates the need for additional correspondence with the requester to determine how they are related to a person in your family tree

==Revision History==
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
|-
! Version
! width="100"|Date
! Contents
|-
| 15.0.0.3
| 7 Feb 2025
| Updated mod for TNG v15
|-
| 13.0.0.2
| 3 Oct 2020
| Reworked mod for TNG V10 provided by Bryan Larson. Updated for TNG 10.1 to add Wiki icon and URL generated by %wikipage:New_Account_Form_Mod%
|-
| 10.0.0.1
| 25 Oct 2014
| Reworked mod for TNG V10 provided by Bryan Larson. Updated for TNG 10.1 to add Wiki icon and URL generated by %wikipage:New_Account_Form_Mod%
|-
| 9.0.0.0
| 2 Feb 2012
| Reworked mod for TNG V9.  
|-
| 8.1.0
| 24 May 2010
| Reworked mod for TNG V8
|-
| 1.1
| 17 Dec 2009
| Changed hard-coded name to use $dbowner to make it usable on all sites, increased the number of rows and added a width="30%" to the column for the $text[usercomments] that replaces Notes, based on feedback from Bryan Larson
|-
| 1.0
| 17 Dec 2009
| updated config file and published to TNG wiki.  Original Mod Manager config file was created on 25 May 2009 but not uploaded to the TNG Wiki.  
|}

== Automated Install ==

# Download the appropriate distribution for your TNG version from the download links in the status area in the upper right.
# Extract the New_Account_Form.zip to your '''admin/mod_folder (V7)''' or '''mods (v8+)'''.  
# Edit the config file as appropriate for how you want to modify the New Account Form.  This mod is provided as an example on how I modified the form for my site as shown in the [[New_Account_Form_Mod#Visual_of_Mod|Visual of Mod]] below.
# Follow the normal automated installation for Mod Manager, as shown in the example [[Mod Manager - Installing Config Files]] to install the '''new_account_form.cfg'''.

== Custom Text Additions == 

'''Note''' that config file only includes the English language changes, so if you support multiple languages you will need to modify the config file to add the custom text for your other languages, or you need to manually add the custom text.

The following custom text will be added to your English/cust_text.php file by this mod.  If you are using other languages, you must add these lines to each of your language cust_text.php files with appropriate translations of course.

<syntaxhighlight lang="php" >
//  New Account Request Form additions
//  Reason why you need a User ID on our site
$text['userreason'] = "Note that you must provide a direct connection to the <strong>person ID (Innnn) of your grandparent, great-grandparent, or great-great-grandparent</strong> who is in our database.  A User ID is only needed to view information on <strong>Living Cousins</strong>, and will only be approved if you provide information that documents your relationship to a person already in our family tree.  <strong>Relationships from the 1600-1700 are too far removed for me to grant access to Living people.</strong> Thanks. $dbowner";
//  Change to Notes field
$text['acctcomments'] = "Person ID of person you are related to and relationship *:<br /><br />Please enter the <strong>person ID (Innnn) of your grandparent, great-grandparent, or great-great-grandparent</strong> who is in our database and indicate how you are related to that person and thus to our family tree.  A user ID is only needed to view Living cousins. <strong>Relationships from the 1600-1700 are too far removed for me to grant access to Living people.</strong> <br />Thanks. $dbowner";
//  Make Phone Number and Notes field required
$text['enterphone'] = "Please enter your Telephone number.";
$text['enterusercomments'] = "Please enter Person ID to whom you are related and how you are related to that person, including the information on your parents and grandparents.";
</syntaxhighlight>

For TNG V7, $text['acctcomments'] in above text additions was $text['usercomments'].

=== French Custom Text ===
For example, you would add to the French/cust_text.php

<syntaxhighlight lang="php" >
//  New Account Request Form additions
//  Reason why you need a User ID on our site
$text['userreason'] = "Notez que vous devez fournir une parenté <strong>directe à l'identification de personne (Innnn) de votre aïeul, bisaïeul, ou trisaïeuls</strong> qui est dans ma base de données.  Un compte d'utilisateur est seulement nécessaire pour voir l'information sur les cousins et cousines en vie. <strong>Les parentés du 1600-1700 sont trop lointains enlevés pour que j'accorde l'accès aux personnes vivantes.</strong><br />Merci. $dbowner";
//  Change to Notes field
$text['acctcomments'] = "Veuillez écrire <strong>l'identification de personne (Innnn) de votre aïeul, bisaïeul, ou trisaïeuls</strong> qui est dans ma base de données et indiquez comment vous êtes lié à cette personne et ainsi à notre arbre généalogique. Un compte utilisateur est seulement nécessaire pour voir l'information sur vos cousins et cousines vivants. Les parentés du 1600-1700 sont trop lointains enlevés pour que j'accorde l'accès aux personnes vivantes. <strong>Si vous n'êtes pas parent, un compte utilisateur ne sera pas fournie.</strong><br />Merci. $dbowner";
//  Make Phone Number and Notes field required
$text['enterphone'] = "Veuillez écrire votre numero de téléphone.";
$text['enterusercomments'] = "Veuillez écrire <strong>l'identification de personne (Innnn) de votre aïeul, bisaïeul, ou trisaïeuls</strong> qui est dans notre base de données et indiquez comment vous êtes lié à cette personne";
</syntaxhighlight>

For TNG V7, $text['acctcomments'] in above text additions was $text['usercomments'].

== Visualization of this mod ==

=== Without Mod ===
{|
|
Without this mod, the Register for New User Account Form displays as shown in the image on the right.
|[[Image:New_Account_Form.jpg|600px|right]]
|}

=== With Mod Installed ===

{|
|
With the New Account Request Form Mod, the New User Account Form includes a '''Reason for requesting a User Account''' above the form, and what information you should enter in the Notes field that now is shown as '''Person ID of person you are related to and relationship''' as shown in the image on the right.  The Phone Number and Notes field were added to the required fields, so will display a message if left empty.
|[[Image:New_Account_Form_mod.jpg|600px|right]]
|}

== Sites using this mod ==
If you download and install this mod, please add your TNG site to the table below:

{| border="0" cellspacing="1" cellpadding="2" class="wikitable" width="100%"
|-
! URL
! User
! Note
! Mod-Version
! TNG-Version
! User-language

|- style="vertical-align:top;"
| [https://www.royandboucher.com/ Our Roy and Boucher Family]
| [[User:Ken Roy| Ken Roy]]
| I use this TNG mod to indicate my requirements for a User ID. 
| 15.0.0.3
| {{Tv150}}
| EN, FR
|-
| [http://leverette-family-history.us Leverette Family History]
| [[User:Jefflev3893|Jeff Leverette]]
| 
| 10.0.0.1
| 10.1.3
| EN
|-
| [http://www.mymispoche.com/ MyMispoche]
| [[User:Carltonb|Carlton Brooks]]
| 
| 10.0.0.1
| 10.1.3
| EN
|-
| [https://www.ourlife.us OurLife Family History - McMullen Clan]
| [[User:Seanst|Sean Thompson]]
| Not a public site
| 10.0.0.1
| 11.1.0
| English
|-
| [https://acadianfamily.com Our Acadian Family]
| [[User:Randal Suire|Randal Suire]]
| Modified Mod - comments on right side. Media/Private
| 10.0.0.1
| 12.0.1
| En, Fr
|-
| [https://www.ourfamilyhistories.org/ Our Family Histories]
| [[User:Bsl20b50|Bryan S. Larson]]
| Customized for my own use. Public site.
| [[User:Bsl20b50|See here]]
| [[User:Bsl20b50|See here]]
| EN
|-
| [https://www.lookingbackwards.net/tng/ LookingBackwards - All Our Relations]
| [[User:Ash.Mitchell|Ashleigh Mitchell]]
| Public
| 13.0.0.2
| 13.0.4
| EN
|-
|}
[[Category:Mods for TNG v15]]
[[Category:Mods for TNG v14]]
[[Category:Mods for TNG v13]]
[[Category:Mods for TNG v12]]
[[Category:Mods for TNG v11]]
[[Category:Mods for TNG v10]]
[[Category:Mods for TNG v9]]
[[Category:Mods for TNG v8]]
[[Category:Mods for TNG v7]]
[[Category:newacctform.php mods]]