Genealogy: Tracing yourself back to better people.
Credits & License Information
Back to main Credits pageHelp for pnTNG version 4.01
=========================================================================
README / INSTALLATION INSTRUCTIONS
pnTNG /pndoc/readme.txt
pnTNG (C) 2003 Cas Nuy and Wendel Voigt
=========================================================================
The pnTNG helper module for Zikula/Postnuke is very simple and requires no Zikula/PostNuke tables.
It can be configured to create TNG user IDs from Zikula/Postnuke user IDs. Unregistered
Zikula/Postnuke users will be given the TNG ID specified in Zikula/Postnuke pnTNG administration.
TNG user information can be used to populate the TNG user informaiton (for example, email IDs).
Actual TNG user permissions are still specified in TNG. However, visitors
logged into Zikula/Postnuke are logged in automatically to TNG.
The main TNG can be integrated into the Zikula/Postnuke site using IFRAMEs or by not using IFRAMES.
Using IFRAMEs often will give the best display results, but some browsers and search engines (like Google)
may not work as well. The non-IFRAME version is much more friendly to search engines, but requires
a small workaround to access the TNG administration page.
Comes with dynamic sideblocks that extract data from the TNG database:
* ThisDay can be set up to show births and deaths that happened on the current date.
The amount of informaiton on Living individuals can be set in the options.
* RandomPhoto can be set up to display random photos from TNG associated with people
Options include how to handle photos with living individuals.
(Note: only photos associated with people in TNG can be displayed.)
* WhatsNew displays TNG items that have changed
Options include the number of number of days and the maximum number of items to display
* MostWanted can be set to diplay individuals or families that you want to highlight
A simple list of ID numbers is all that is required
Works with :
Postnuke 0.764, Zikula 1.0
TNG 6.2.0, 7.0
======================
INSTALLATION
======================
Upon completion, you will have two Zikula/Postnuke Modules. One for TNG under a name you specify, and one
called pnTNG. The TNG module will not have its own administration area in Zikula/Postnuke. pnTNG acts as a
"helper" module for TNG and will provide a Zikula/Postnuke administration interface. Any pnTNG blocks installed
will also have the corresponding blocks administration interface.
1 **** TNG *****
1a. Install TNG stand alone and verify it is working correct.
It must be installed in the PostNuke modules directory.
You can chose the directory name under which you want place TNG. (e.g., genealogy, TNG, TNG6 )
This will become your TNG module name later in the installation.
You can access TNG directly by going to a URL similar to the following (change for your configuration)
http://www.yoursitename.com/modules/the_TNG_directory_name_you_picked
1b. If you have trouble with accessing the directory, you may need to first copy the .htaccess file from
step 2c into the directory with your TNG files.
1c. Configure TNG such that logon is required.
2 **** pnTNG *****
2a. Unzip the contents of pnTNG to your Zikula/Postnuke modules directory.
2b. Backup the the following files in your TNG directory since you will overwrite them in the next step:
end.php
meta.html
customconfig.php
2c. Copy the files in pnTNG\TNG\ to the root of your TNG directory created in step 1a.
This is the directory that contain's the TNG config.php file
This will overwrite the following existing TNG files:
end.php
meta.html
customconfig.php
and will add the following files:
.htaccess
index_pn.php
index_pnTNG.php
pnversion.php
NOTE: You will need to have a file named index.php in your TNG directory. This can be a file you
write, or you can rename the file index_pnTNG.php to index.php.
2d. Copy the files from pnTNG\PostNuke\*.php into your base Zikula/Postnuke directory
2e. During you first installation only, install pnTNG\PostNuke\genlog.tmp into your base Zikula/Postnuke directory
and rename to genlog.txt.
NOTE: Because of a quirk in the way TNG saves entries into it's access log file, the TNG access log will reside
in the genlog.txt located in the Zikula/Postnuke directory, not the one in the TNG directory.
You do not need to do this step when making an update (You should already have a genlog.txt file.)
3 **** Zikula/Postnuke *****
In Zikula/Postnuke Administration, go to Modules, then
3a. Initialize & activate pnTNG
3b. Initialize & activate TNG under the name you chose in step 1a
3c. In Zikula/Postnuke Administration, go to pnTNG (which was just activated) and select your options
There are a number of important settings
- You will need to select the module name you chose for TNG.
If you have made the proper selection and have the TNG module activated, you should
see two green status indicators.
- If you want unlogged in Zikula/Postnuke users to access TNG, then you need to specify the
TNG guest username
3d. Link the module into a menu block use {pnTNG} for pnTNG and [the_TNG_module_name_you_picked] for TNG directly.
For example you would use [TNG] if you had installed TNG in a directory called 'TNG'.
3e. To install blocks:
In Zikula/Postnuke Administration, go to Blocks, then select New Block, and select pnTNG/'block name'
Go to Blocks and edit the options for the block
======================
TIPS and NOTES
======================
* Upon first call from a non-logged in user, pnTNG will create a user under the user name
specified in the pnTNG administration.
In TNG, make sure the TNG user created has the read/write access you want
* When not using IFRAMEs, the Admin page must be accessed differently
Previously, links in your html pages to the Admin page looked like
<a href="admin/index.php">Administration</a>
To work around this problem, you can call the admin page directly by using using the following:
<a href="index.php?module=pnTNG&func=admin">Administration</a>
Using this will work if using IFRAMEs or if not using IFRAMEs for the site
* To have the application opened in a separate New Window (full screen) do the following :
1. Create a Core/HTML block with the following contents :
<a href="index.php?module=pnTNG&func=main" target=_blank">TNG</a>
2. Make sure that in Admin Panel you have checked the Full Screen option
* If you are just starting out and are using TNG's default index.php, you can use index_pnTNG.php instead.
This file has the same basic features but has been modified to take into account its use in Zikula/Postnuke.
You just need to rename index_pnTNG.php to index.php in your TNG installation directory.
If you already have a index.php, you can use index_pnTNG.php as an example on how to add links.
* When customizing TNG, please do not use header.php or footer.php as file names for your header or footer files.
(as specified in the TNG administration setup.) There is a conflict with Zikula/Postnuke files with the same name.
If you need to use a file with these names, please rename the files to something different (e.g., footerTNG.php)
README / INSTALLATION INSTRUCTIONS
pnTNG /pndoc/readme.txt
pnTNG (C) 2003 Cas Nuy and Wendel Voigt
=========================================================================
The pnTNG helper module for Zikula/Postnuke is very simple and requires no Zikula/PostNuke tables.
It can be configured to create TNG user IDs from Zikula/Postnuke user IDs. Unregistered
Zikula/Postnuke users will be given the TNG ID specified in Zikula/Postnuke pnTNG administration.
TNG user information can be used to populate the TNG user informaiton (for example, email IDs).
Actual TNG user permissions are still specified in TNG. However, visitors
logged into Zikula/Postnuke are logged in automatically to TNG.
The main TNG can be integrated into the Zikula/Postnuke site using IFRAMEs or by not using IFRAMES.
Using IFRAMEs often will give the best display results, but some browsers and search engines (like Google)
may not work as well. The non-IFRAME version is much more friendly to search engines, but requires
a small workaround to access the TNG administration page.
Comes with dynamic sideblocks that extract data from the TNG database:
* ThisDay can be set up to show births and deaths that happened on the current date.
The amount of informaiton on Living individuals can be set in the options.
* RandomPhoto can be set up to display random photos from TNG associated with people
Options include how to handle photos with living individuals.
(Note: only photos associated with people in TNG can be displayed.)
* WhatsNew displays TNG items that have changed
Options include the number of number of days and the maximum number of items to display
* MostWanted can be set to diplay individuals or families that you want to highlight
A simple list of ID numbers is all that is required
Works with :
Postnuke 0.764, Zikula 1.0
TNG 6.2.0, 7.0
======================
INSTALLATION
======================
Upon completion, you will have two Zikula/Postnuke Modules. One for TNG under a name you specify, and one
called pnTNG. The TNG module will not have its own administration area in Zikula/Postnuke. pnTNG acts as a
"helper" module for TNG and will provide a Zikula/Postnuke administration interface. Any pnTNG blocks installed
will also have the corresponding blocks administration interface.
1 **** TNG *****
1a. Install TNG stand alone and verify it is working correct.
It must be installed in the PostNuke modules directory.
You can chose the directory name under which you want place TNG. (e.g., genealogy, TNG, TNG6 )
This will become your TNG module name later in the installation.
You can access TNG directly by going to a URL similar to the following (change for your configuration)
http://www.yoursitename.com/modules/the_TNG_directory_name_you_picked
1b. If you have trouble with accessing the directory, you may need to first copy the .htaccess file from
step 2c into the directory with your TNG files.
1c. Configure TNG such that logon is required.
2 **** pnTNG *****
2a. Unzip the contents of pnTNG to your Zikula/Postnuke modules directory.
2b. Backup the the following files in your TNG directory since you will overwrite them in the next step:
end.php
meta.html
customconfig.php
2c. Copy the files in pnTNG\TNG\ to the root of your TNG directory created in step 1a.
This is the directory that contain's the TNG config.php file
This will overwrite the following existing TNG files:
end.php
meta.html
customconfig.php
and will add the following files:
.htaccess
index_pn.php
index_pnTNG.php
pnversion.php
NOTE: You will need to have a file named index.php in your TNG directory. This can be a file you
write, or you can rename the file index_pnTNG.php to index.php.
2d. Copy the files from pnTNG\PostNuke\*.php into your base Zikula/Postnuke directory
2e. During you first installation only, install pnTNG\PostNuke\genlog.tmp into your base Zikula/Postnuke directory
and rename to genlog.txt.
NOTE: Because of a quirk in the way TNG saves entries into it's access log file, the TNG access log will reside
in the genlog.txt located in the Zikula/Postnuke directory, not the one in the TNG directory.
You do not need to do this step when making an update (You should already have a genlog.txt file.)
3 **** Zikula/Postnuke *****
In Zikula/Postnuke Administration, go to Modules, then
3a. Initialize & activate pnTNG
3b. Initialize & activate TNG under the name you chose in step 1a
3c. In Zikula/Postnuke Administration, go to pnTNG (which was just activated) and select your options
There are a number of important settings
- You will need to select the module name you chose for TNG.
If you have made the proper selection and have the TNG module activated, you should
see two green status indicators.
- If you want unlogged in Zikula/Postnuke users to access TNG, then you need to specify the
TNG guest username
3d. Link the module into a menu block use {pnTNG} for pnTNG and [the_TNG_module_name_you_picked] for TNG directly.
For example you would use [TNG] if you had installed TNG in a directory called 'TNG'.
3e. To install blocks:
In Zikula/Postnuke Administration, go to Blocks, then select New Block, and select pnTNG/'block name'
Go to Blocks and edit the options for the block
======================
TIPS and NOTES
======================
* Upon first call from a non-logged in user, pnTNG will create a user under the user name
specified in the pnTNG administration.
In TNG, make sure the TNG user created has the read/write access you want
* When not using IFRAMEs, the Admin page must be accessed differently
Previously, links in your html pages to the Admin page looked like
<a href="admin/index.php">Administration</a>
To work around this problem, you can call the admin page directly by using using the following:
<a href="index.php?module=pnTNG&func=admin">Administration</a>
Using this will work if using IFRAMEs or if not using IFRAMEs for the site
* To have the application opened in a separate New Window (full screen) do the following :
1. Create a Core/HTML block with the following contents :
<a href="index.php?module=pnTNG&func=main" target=_blank">TNG</a>
2. Make sure that in Admin Panel you have checked the Full Screen option
* If you are just starting out and are using TNG's default index.php, you can use index_pnTNG.php instead.
This file has the same basic features but has been modified to take into account its use in Zikula/Postnuke.
You just need to rename index_pnTNG.php to index.php in your TNG installation directory.
If you already have a index.php, you can use index_pnTNG.php as an example on how to add links.
* When customizing TNG, please do not use header.php or footer.php as file names for your header or footer files.
(as specified in the TNG administration setup.) There is a conflict with Zikula/Postnuke files with the same name.
If you need to use a file with these names, please rename the files to something different (e.g., footerTNG.php)