Family Group Worksheet V9
|Family Group Worksheet V9|
|Summary||Provides a form for visitors to organize and submit family information for inclusion in the website.|
|Download stats||view statistics|
|Homepage||Bisbee Family Connection|
|Mod Support||Support for Family Group Worksheet V9|
|Contact Developer||Rick Bisbee|
|Min TNG V||9.0.0|
|Max TNG V||9|
Self installing -- does not use Mod Manager
Should not be attempted by novice users.
The administrator must understand how to upload files and folders using an FTP client or the Control Panel, navigate to website pages using a browser, be able to grasp basic concepts of data structures, and learn to write code for HTML links.
The Family Group Worksheet (FGW) is an add-on for TNGv9 that provides a form to be filled in by site visitors who wish to add their own families to the website. Depending on the options chosen by the site administrator, the form can be made accessible to all visitors, or limited to registered users who are logged in. If opened via tabs on personal or family group pages, it is pre-populated with data for editing. When submitted, the worksheet formats the data and emails it to the site administrator for consideration.
If the user enters a valid person ID for either head of family, information from the TNG database will populate the form so that it can be edited or extended. The user will only see living/private persons according to privileges granted to them by the website.
FGW comes with support files for several languages -- Dutch, English, French, German and Spanish. Some of these files were developed using Google Translate. If a native speaker cares to submit files that are more idiomatic, we will be happy to replace them. There is a master help file in English -- others will be provided as they become available. There are also help links on the form for some of the data fields.
A Mod Manager file to automatically add tabs to personal and family group pages for opening a copy of the worksheet for user input is available above.
The worksheet includes its own log file to track user access as well as attempts to spam the website.
Nobody much likes Captcha's as a means of fighting spam.
The FGW avoids the use of a Captcha in favor of some other techniques. These can be expanded if spam becomes a problem with a worksheet that is accessible to the public.
We've now experienced spam from public users. Beginning with version v184.108.40.206, the worksheet will display the website's default captcha (if any) for the first access to a worksheet; the challenge will not be issued again for subsequent worksheets for the remainder of the session.
FGW is well integrated into the website and does not modify any native TNG files. If used, the companion mod -- fgw_tabs.cfg -- modifies genlib.php.
There are environmental circumstances that may prevent third party script from working correctly. Please see the Section on Known Problems below if you suspect you will have difficulty.
FGW Revision History
|v220.127.116.11||15 Jan 2014||
|v18.104.22.168||27 Jul 2013||
|v22.214.171.124||19 May 2013||
|v126.96.36.199||12 Apr 2013||
|v188.8.131.52||30 Mar 2013||
|v184.108.40.206||3 Jan 2013||
|v220.127.116.11||19 Sep 2012||
|v18.104.22.168||28 Aug 2012||
|v22.214.171.124||23 Aug 2012||
|v126.96.36.199||28 Jul 2012||
|v188.8.131.52||2 Jul 2012||
|v184.108.40.206||27 Jun 2012||
|v9.00.0.14||25 Jun 2012||
|v9.00.0.13||21 May 2012||
|v9.00.0.12||8 May 2012||
|v9.00.0.11||17 Apr 2012||
|v220.127.116.11||16 Apr 2012||
|v18.104.22.168||14 Apr 2012||
|v22.214.171.124||11 Apr 2012||
|v126.96.36.199||9 Apr 2012||
|v188.8.131.52||5 Apr 2012||
|v184.108.40.206||5 Apr 2012||
Form shown is in the default styling, open for public access and with LDS event fields hidden (all configurable by the administrator.)
Upgrading / Installing FGW V9
If you are installing Family Group Worksheet for the first time, go to the third step below.
Beginning with FGW v220.127.116.11 there is no installation. Everything now works inside the fgw folder, so it is important to completely uninstall any previous version to get rid of all unnecessary files that may have deployed to various places on the website.
- If you are still using the Family Group Worksheet for TNGv813, go to your Mod Manager and Remove it.
- To upgrade TNGv9 versions prior to v18.104.22.168, make sure to use the Family Group Worksheet setup program to uninstall and then completely remove the fgw folder from the website.
- Download and unpack the zip file and place the fgw folder on your TNG website. It can be in the TNG root directory, extensions folder, or anywhere else you want it.
- Navigate to the fgw folder with a web browser and you should see the Family Group Worksheet ready for user input.
- Change or create links to the fgw folder for user access. See the Custom Drop Down Menu mod if you would like help adding a link to a TNG drop down menu.
- Navigate to the setup.php program inside the fgw folder to set your preferences for how it looks and works. You can bookmark the setup program in your browser to return to it in the future.
The Family Group Worksheet can be removed by deleting the fgw folder, removing the fgw_tabs.cfg mod, if used, and any custom links you created to reach it.
See Known Problems below if you experience any difficulties.
Administrator's Setup Page
When you navigate to ... fgw/setup.php you will see a setup screen where you can set your preferences or you can revert to the default settings. Bookmark this page in your browser for easy access in the future.
Linking to the Worksheet
You will need to add a link to the worksheet (... fgw/index.php) for users to access it. If you want, you can use the Custom Drop Down Menu mod to place a link to the worksheet in any of the standard TNG drop down menus, or create a custom drop down menu and add the link there.
If you are already using this mod for your links, and are upgrading from a previous version of fgw_v9, you will have to modify the link in your customconfig.php file to point to the fgw folder. For instance, if you put the fgw folder inside 'extensions', and you want your link in the TNG 'Find' menu, your customconfig link would look like this:
$link_nr = 0; $findmenulinks[$link_nr]['target'] = "extensions/fgw/index.php"; $findmenulinks[$link_nr]['sprite'] = ""; $findmenulinks[$link_nr]['icon'] = "extensions/fgw/img/families.gif"; $findmenulinks[$link_nr]['text'] = "Submit Family"; $findmenulinks[$link_nr]['literal'] = true; $findmenulinks[$link_nr]['admin'] = false;
See the entire article for the Custom Drop Down Menu mod on the TNGWiki for more information.
FGW Tabs Mod
For those who would like to have a tab at the top of each personal or family page to open a Family Group Worksheet pre-populated with data from the source page, see the companion FGW Tabs Mod.
Using a Captcha
If the website uses a captcha for TNG documents, it will also be used to challenge the Family Group Worksheet for anonymous users. After successfully passing the challenge the first time, it will not be issued again for access to subsequent worksheets for the remainder of the session.
If admins do not want to use their captcha here, or if their captcha does not work correctly for some reason, it can be suppressed in the code. Click on the support link above if this is an issue for you.
Checking Safe Mode Status
To see if your website is running with PHP safe mode turned on, go to your TNG Admin page, click on Setup and then click on the Diagnostics tab at the top of the page. Safe mode is no longer supported in PHP, so ask your hosting service about turning it off for your website.
I would like to thank the many people from the TNG users' list who contributed lots of ideas and suggestions as well as language translation files. I also want to thank those who contributed their time testing the initial versions.
Thanks to Chuck Bush who helped with the code for installing Worksheet tabs on TNG pages for individuals and families.
Many thanks to Friedhelm Kaemper for rewriting the German language files to make them more idiomatic.
|PHP4||PHP5 Compatibility issues.||We have been able to fix those problems that have been brought to our attention.|
|PHP in Safe Mode||Write restrictions||Safe mode will not permit third party scripts to write files if the owner of the folder/script is not the owner of the website. Site admins can either turn off safe mode or can somehow make themselves owner of the folder and its files. It may be that only the isp provider can resolve this for you. If anyone has a workable solution, please let us know and we will document it here.|
|Apache File Permissions||Write restrictions||On some Apache servers, the server (which runs the script) does not seem to be identified as owner or part of the 'group' for file/folder permissions. You may be able make it work by giving write permission to the whole 'world' (7-7-7), but that is not recommended for security reasons. It may be that only the isp provider can resolve this for you. If anyone has another solution, please let us know and we will document it here.|
|IIS server||Write restrictions||According to information on the Internet, IIS does not allow third party scripts to write files by default. Admins must set permissions for them. If you have experience doing this, please let us know and we will document it here.|
TNG User sites using this add-on
If you download and install this add-on, please add your TNG site to the table below
|A Bisbee Family History||Rick Bisbee||Public site (FGW developer)||v22.214.171.124/ TNG 9.2.2||EN|
|Mitchell Families Online||Roger Mitchell||Public site||v126.96.36.199 / TNG 9.2.2||EN|
|Our Family Histories||Bryan S. Larson||Public site||v188.8.131.52 / TNG 9.2.2||EN|
|Chamberlain & Eidenbenz Genealogy||Graham Chamberlain||Public site||v184.108.40.206 / TNG 9.2.2||EN,FR,DE,NL,ES|
|Kemp(e) Family History||Andrew Kemp||Public site||see User:Kempons||EN|
There is no warranty. Use the script at your own risk. It has been tested in all the TNG template styles without any particular problems. If you experience difficulty or would just like to comment, please Contact us here