-
Welcome to the TNG installation guide!
IMPORTANT: This is the FULL INSTALLATION guide. If you are upgrading an existing installation, please exit this page immediately and refer
instead to the readme file that came with your upgrade!
Start
Choose your installation path:
Express Installation (Recommended)
Move quickly, with all the steps on a single page. You could even follow along with this video: https://vimeo.com/39681100
Regular Installation
If you'd rather move carefully and have everything explained in detail, along with troubleshooting tips if things go wrong
Don't worry, if you regret your choice, you can switch over at any time.
-
Express Installation
Just complete these steps IN ORDER. If you have questions, or if anything refuses to work, please look over at the corresponding steps in the
Regular Installation for more information and troubleshooting hints.
Upload or copy all files and folders to the location on your web site where you plan
to run TNG. This can be the root folder or any subfolder.
If you were viewing this guide locally, close it now and browse to it on your site instead (for example, "http://www.mysite.com/readme.html").
Use a browser, not an FTP program!
Set permissions:
Rename folders:
For security reasons, we recommend you choose different names for the GEDCOM and Backups folders.
Backups Folder: |
|
|
GEDCOM Folder: |
|
|
Choose your language and character set:
If the choices you see are what you want, then you don't need to do anything here.
Establish database connection:
If you don't know this information, ask your web host. They may want you to create the database yourself, but they can show you how. NOTE:
Most people will not need to enter anything for the Port or Socket.
Create tables:
This uses default table names with a "tng_" prefix. To use custom names, create the tables from the Regular Installation. If you're using UTF-8 as your character set, you should set the collation to utf8_unicode_ci, utf8_general_ci or similar. If you're not using UTF-8, latin_swedish_ci is a common choice. If you're not sure,
look here, or
blank out the box below to use the default assigned to your database by your host.
Create a user:
(Note: All fields are required. More information about this user can be entered later.)
Create a tree:
(Note: Both fields are required. More information about this tree can be entered later. You can create more trees later if necessary.)
Select a template (see choices at http://lythgoes.net/genealogy/templates.php):
(Note: This is optional. You may change the template again later from Admin/Setup/Template Settings.)
TNG is now installed and ready to use! Before you dive in, however, it is recommended that you still visit the
Regular Installation instructions and review the following sections:
You might also want to read the Getting Started
articles on the TNG Wiki for additional information.
Go to your home page
Go to the Admin menu
-
Regular Installation
Files
Step 1: Extract Files
If you downloaded TNG from the Internet:
The file you downloaded is a zip file, which means it actually contains quite a few files all "zipped up"
together. Please find this file and unzip or extract the included files to a new folder or directory (name doesn't matter)
on the hard drive of your local computer. Your operating system may be able to handle this operation, but
if not, there are several specialized utilities can find on the Internet to do this job for you.
A few you might look at are WinZip or
PKZip for Windows, or
ZipIt or StuffIt for Mac.
Some files should extract into subfolders (for example, "css", "img", "js", "languages", and various media-related folders, among others). If you don't see any subfolders after performing the extraction, please delete the files you extracted and perform the extraction process again
with different options.
If you obtained TNG on a CD:
All the files you need are already extracted in the proper folders on the CD. You can copy everything to a new folder on the hard drive of your local computer if you wish, but it isn't necessary.
Next >>
-
Files
Step 2: Connect to Your Remote Web Site
Connect to the remote web site where you plan to install TNG. This could be done using a
control panel file manager shown to you by your hosting provider, or using an FTP program
(FTP stands for "File Transfer Protocol"). If you use the FTP method, you will need to know your
FTP host name, username and password.
Once you get to your site, navigate to the folder where your site's home page resides.
From here on, we will refer to this folder as the root folder (even though it probably
isn't called that). If you're setting up a new site, the folder might be called "www", and your
home page will likely be called "index.html", "index.htm" or "default.htm.
<< Prev Next >>
-
Files
Step 3: Setting up Your Remote Environment
Now that you've found your root folder, you need to decide whether you want your web address to
point directly to your TNG installation, or if you want to keep a separate home page.
If you want your address (ie, http://www.yoursite.com) to take you directly to your genealogy,
you will need to delete any existing home page or plan to merge it with TNG's home page, which is called "index.php".
You will be installing TNG in the root folder, so
you can then skip the rest of this step. For you, the root folder and the genealogy folder will
be the same.
If you plan to set up a larger environment of which genealogy
is just one section, you might want to create a subfolder on your site to hold your TNG files. You can name this folder
anything you'd like, but we will refer to it from here on as the genealogy folder.
<< Prev Next >>
-
Files
Step 4: Uploading Files to Your Site
Using an FTP program or an online file manager, upload all the extracted TNG files from your local computer to your remote site, putting all files
in their respective folders. If the folders cannot be uploaded as a group, create the folders on your site first,
then upload the files within those folders to the corresponding locations. All files not in a subfolder should go in your genealogy folder. Remember,
the "genealogy" folder is just whichever location you choose to hold your TNG files. It does not have to be named "genealogy".
Note: Some hosting providers might allow you to upload the zip file and extract it there on your remote site. If your online file
manager will only let you upload a few files at a time, uploading the zip file would save you a lot of time.
IMPORTANT: If you are viewing this "readme" page on your home computer, finish this step and then
load the readme.html page from your remote site instead (for example, "http://www.mysite.com/readme.html").
Use a browser, not an FTP program! This will make the rest of the installation much easier.
<< Prev Next >>
-
Permissions
Step 1: Explanation of "Permissions"
You will now be asked to set the "permissions" on some files and folders. If you have a
good understanding of permissions, please feel free to skip over this explanation to the next step.
Otherwise, please read this. You may be able to set your permissions with the click of a single
button in the next step, but you will still benefit from this explanation.
So what are permissions? Permissions dictate who can do what with which files. In other words,
you can say who has "permission" to write to or read from a certain file. TNG requires that everyone
be able to write to some files and folders, so we will need to set those permissions accordingly.
Some people like to refer to these permissions as a three-digit number. Others prefer a string of "rwx" characters,
and still others just speak of "read, write and execute". When you are setting permissions, you may
encounter any of these three methods.
With each permission you set, you are granting rights to three different entities: the "owner" (that's you),
the "group", and the "world" (includes all visitors to your site, even you). That's why permissions
always come in groups of three.
If you follow the number method, each number represents a sum of read, write and execute for the
different entities. Read = 4, Write = 2 and Execute = 1, so if we tell you to set a file to "664",
it means that the owner and group will have Read and Write permissions (4+2), the world will have only
Read permissions (4), and no one will have Execute permissions.
Using the "rwx" method, 664 would then be represented as rw-rw-r-- (the "-" character means that a
permission is omitted).
Note: Mac OS X users could use the DonationWare software called BatChmod (available at
VersionTracker.com or
MacUpdate.com) or Fetch (available at Fetchsoftworks.com) to do the permissions settings in a
user-friendly environment.
For more information, please see the TNG Wiki article Permissions Explained.
<< Prev Next >>
-
Permissions
Step 2: Setting Permissions
If you are viewing this page from your web site, you may be able to set all required permissions by
clicking this button (go ahead and try it):
If that operation was not successful, please read the following:
Within your genealogy folder, find the files adminlog.txt, config.php, genlog.txt, importconfig.php, logconfig.php, mapconfig.php, pedconfig.php, subroot.php, templateconfig.php
and whatsnew.txt and give them all Read/Write permissions (666, or rw-rw-rw-)
using your file manager or FTP program. Each
FTP program or file manager is different in the method used to set permissions, so please ask your
hosting provider or read the documentation on your software for more detailed instructions if necessary.
NOTE: In some cases, 664 permissions (or rw-rw-r--) may be enough for each of the files mentioned above.
You may also need to change permissions on the photos, histories, documents, headstones, media, gedcom, gendex and backups folders.
755 should work in most cases, but if you have trouble uploading media, importing or backing up, try 777 instead.
<< Prev Next >>
-
Permissions
Step 3: Advanced Settings
If you are not your own site administrator (you're using a hosting provider), the environment will most likely be all set up for you already,
and you probably won't have access to your PHP configuration anyway, so in most cases you can skip this step.
If you are the site administrator, however, please make sure that your php.ini file (part of PHP, not TNG) contains the following settings:
file_uploads = On
error_reporting = E_ALL & ~E_NOTICE
If you have PHP 5, please make sure you use extension=php_mysql.dll and copy lib-mysql.dll to where PHP can find it.
If you can find a line in php.ini referencing the value LimitRequestBody then comment it out or
delete it, as this will prevent you from uploading files larger than the size indicated on that line
(sometimes this value is located in the php.conf file, so look for it there if you don't find it in
php.ini).
You may also wish to increase the value for upload_max_filesize if you have a large
GEDCOM file. It could also be advantageous to set output_buffering to "On".
If your PHP installation is on a Windows machine, you may have to change the session.save_path
variable to point to your Windows temporary folder (i.e., C:\Temp). If you make changes to your php.ini
file, you must restart your PHP service before the changes take effect.
<< Prev Next >>
-
Folders
Now you will have the chance to rename a few of the subfolders inside the genealogy folder on your
remote site. These folders were included in the TNG zip file and should already be on your site. Renaming them is mostly optional, but it is HIGHLY RECOMMENDED
that you rename your backups and gedcom folders to something else besides "backups" and "gedcom" to protect
your data from others who may know the TNG folder structure.
Multimedia Folder: |
|
|
Photos Folder: |
|
|
Documents Folder: |
|
|
Histories Folder: |
|
|
Headstones Folder: |
|
|
GENDEX Folder: |
|
|
Backups Folder: |
|
|
GEDCOM Folder: |
|
|
Mods Folder: |
|
|
Extensions Folder: |
|
|
If the above process fails to rename the folders, you will need to use your FTP program or online file manager
to rename them. If you need to do that, make the changes within TNG as well after the installation is complete by going
to the Admin/Setup area at http://www.yoursite.com/genealogy/admin_setup.php (if you're reading this
from your web site, click here: admin_setup.php.
From there go to "Setup" and click on "General Settings" and "Import Settings".
Set the permissions on these folders to 755, or rwxr-xr-x). If 755 doesn't work, try 777 (rwxrwxrwx) instead.
If the operation to create these folders earlier in this guide was successful, then they should already have the
needed permissions.
NOTE: If you discover later that you cannot add media or cannot write to these folders, it could mean that the folders were
created with the wrong "owner". Usually this will only happen if you're running your own server. If your folders have the wrong owner, you
will need to use an FTP program to manually set the owner or recreate the folders.
<< Prev Next >>
-
Languages and Character Sets
The default language is English, using the UTF-8 character set. If you don't make any changes, that is the language everyone will see when they visit your site for the first time.
To change your default language and/or character set, please select a new language from the list below.
You can read more about using TNG with UTF-8 here.
If you want to support multiple languages, you can do that later from the Admin/Languages area.
<< Prev Next >>
-
Database Tables
Step 1: Establish a Database Connection
It is now necessary to establish a connection with your MySQL database. This database must be created before proceeding!
In most cases your provider will already have created the database for you. If not, your provider will likely have given you access to
an online "control panel" that you can use to create the database yourself. In most cases TNG cannot create it for you, so please make sure that
you have a database, then return to this step. You can find more information on creating a database on
this page on the TNG Wiki. Note: If you plan to use TNG
with a content management system like Drupal, Joomla or something else, you must use the same database for both TNG and the CMS.
Next, you will need
to enter the correct database connection information here before TNG can do anything besides let you edit the settings.
If you don't know the requested information, please ask your hosting provider to give it to you.
Here's a brief description of each item:
Host Name: The computer where your database resides. It's usually the same one your web site is on,
so the value here is most always "localhost" (no quotes).
Database Name: Sometimes a hosting provider will set up a database for you and will tell you the name.
Other times they will expect you to create your own database using your "control panel". TNG will
attempt to do that for you here if the database name you enter does not exist, but in many cases the host will not let this happen
from a script. If that's the case, you will need to create an empty MySQL database using your
control panel and give it a name yourself before entering the information below.
Database Username and Password: This information is specific to the database and may be different than any
other username and password your host has given you. If you had to set up the database yourself, you may also
need to set up a user and give it a name and password. If so, make sure you give this user ALL rights and
assign it to the database. The assignment may be a separate step.
Database Port and Socket: Most people will not need to enter anything here, but if your hosting provider gives you a port or socket, enter them here.
More information on these parameters is available on this page on the TNG Wiki.
Enter your information here, then click "Save and Verify" below:
This information should have been saved in your TNG General Settings. You can enter the information directly
by going to the Admin/Setup area at http://www.yoursite.com/genealogy/admin_setup.php (if you're reading this
from your web site, click here: admin_setup.php.
From there go to "Setup" and click on "General Settings."
What might cause this operation to fail? Here are some things to watch for:
1. Always check to make sure you have spelled everything correctly and have the right case.
2. Some database utilities add a prefix to your database and/or username. You may think you set up a database named "genealogy", but in reality it may have been named "prefix_genealogy". Be sure to look at what was created to make sure you have the right name.
3. Sometimes the host name requires a port number (ie, "localhost:3306") or a socket path (ie, "localhost:/path/to/socket"). Check with your hosting provider.
4. Some providers require that your database name and your database username are the same. Others make your control panel username/password match your database username/password.
5. You may have just forgotten to assign the user to your database.
6. If you are running MySQL 4.1 with anything less than PHP 5, the difference in password authentication schemes could cause a problem. Check here for instructions on how to fix this: http://dev.mysql.com/docss/mysql/en/Old_client.html
<< Prev Next >>
-
Database Tables
Step 2: Create the Database Tables
Next you will need to create the database tables. To do that, make any necessary adjustments to table
names, then click the button below.
If you're using UTF-8 as your character set, you should change the Collation to utf8_unicode_ci, utf8_general_ci or similar. If you're not sure,
look here.
IMPORTANT: If you created the tables previously, doing this will erase ALL of your existing TNG data!
Assuming you connected to your database earlier, what might cause this operation to fail?
Here are some troubleshooting tips:
1. Make sure you are running this script from your web site and not from your home computer.
2. Check to make sure your database user has ALL rights. The user may be set up correctly, but if it doesn't have rights to create or delete tables, you won't make it past this step.
3. You may have just forgotten to assign the user to your database.
4. If you are running MySQL 4.1 with anything less than PHP 5, the difference in password authentication schemes could cause a problem. Check here for instructions on how to fix this: http://dev.mysql.com/docss/mysql/en/Old_client.html
<< Prev Next >>
-
Other Settings
Step 1: General Settings
There are other general settings you can change if desired. To see these settings,
go to the Admin area at http://www.yoursite.com/genealogy/admin.php (if you're reading this
from your web site, click here: admin.php.
From there go to Setup and click on General Settings. Please see the Help link on that
page for detailed information on each option
Make changes to the General Settings as needed. You shouldn't need to change any of the table names.
Click the Help link at the top of the page for an explanation of each field. You can come back and make
changes here at any time.
You might also look at the TNG Wiki article on General Settings,
which provides links to detailed illustrated instructions on setting up the Site Design and Definition, Media, Languages, Privacy, and Cemeteries sections,
as well as instructions on moving your configuration files if you use the Config Path.
NOTE on the Root Path setting: The value you see here the first time should be the correct value,
so you shouldn't have to tamper with this. If you do, you can retrieve the original value by blanking
out the value and saving the page. You must then return to the Settings page and save it again.
NOTE on the Config Path setting: This allows you to indicate a path above or outside the root for your
writable configuration files. Entering a value here is completely optional. You
should enter a path ONLY if you are able to move the files named on the screen to the proper location.
When you're finished, be sure to click the Save button to save your new settings.
<< Prev Next >>
-
Other Settings
Step 2: Chart, Import, Log and Map settings
To set options in other areas, go back to the Setup page, then:
Select Chart Settings to set up all pedigree chart variables. Edit the settings to reflect your web site's overall style and to accommodate your data. An extensive help file is accessible from this page to explain all options found there. You only need to do this if you don't like the current way pedigree charts are displayed, and you don't have to do it now if you're not sure what the effects will be.
Select Log Settings to set up all log-related variables. Remember to read the Help screen for information on each setting.
Select Import Settings to set up all import-related variables. Again, be sure to read the corresponding Help screen for information about anything
on this page. Pay special attention to the fields labeled Local Photo/History/Document/Headstone/Other Media Path(s). If you are planning to import a
GEDCOM file that contains links to photos, histories or other media, and if you want to maintain a directory structure for your media on the site (instead of
putting all the media in the same folder), you'll want to fill these values before you import your file. For more information, please see the TNG Wiki article
Setup - Import Settings.
Select Map Settings to set up all map related variables.
For more information, see the TNG Wiki article on Google Maps - Getting Started.
Select Template Settings to easily change the template you're using, and to change the images and text in your template home page and custom header.
For more information, see the TNG Wiki article on Template Settings.
<< Prev Next >>
-
Your Data
Step 1: Setting up Users
Next you must set up at least one user. A "User" can represent one or more people with the same access rights. Until you have at least one user,
your Administration area will be wide open to all visitors, and all visitors to the public part of your site will be able
to see all data for all individuals. You can set up your first user here or from the Admin menu. To create a user here, please fill in all of the following
fields and click the Submit button. This user will have full administrator rights. You can enter more information about this user later from the Admin menu.
To create a user from the Admin main menu, go to the Users area and click on the Add New tab.
You may add as many users as you like, but the first user you add MUST be an administrator (that's you). An administrator must have Add,
Edit and Delete rights and must not be assigned to a tree. On the first user you won't even have the option to assign a tree.
Since you haven't set up any trees yet, you won't be able to assign users to trees just yet anyway.
If you do not create an administrator first, or if you delete your administrator user, you may have trouble getting back here!
Only an administrator will be able to access system-wide functions like the Setup or Users.
Only users with some combination of Add, Edit and Delete rights will be allowed into the Admin area. Assigning a user to a tree or
branch limits that user's rights to their assigned tree or branch.
See the Help on the Admin/Users pages for more information.
<< Prev Next >>
-
Your Data
Step 2: Setting up Trees
Next you must create at least one tree. A "Tree" is defined as an independent data set, or a group of individuals, families and sources that is
independent from any other such group. You can create your first tree here or from the Admin menu. To create a tree here, please fill in both fields
below and click the Submit button. You will not be able to edit the Tree ID after you save this page. It should be a short, alpha-numeric identifier with no spaces.
It will not be displayed on any public pages. You can enter more information about this tree later from the Admin menu.
To create a tree from the Admin main menu, go to the Trees area and click on the Add New tab.
Do you need multiple trees? Data from one tree cannot be linked to data in another tree, so the
rule of thumb here is that if any links exist among your potential trees, the data really should be
merged into one tree. Most people will only need one tree unless they are planning to maintain separate
and independent GEDCOMs.
The first two fields (Tree ID and Tree Name) are required, but everything else here is optional.
You will not be able to edit the Tree ID after you save this page. It should be a short identifier
with no spaces. It will not be displayed on any public pages.
Do not set up branches at this time. Come back to do that after importing or entering your data.
For more information, see the TNG Wiki article Setup - Tree,
which also covers how to disable the gedcom download.
<< Prev Next >>
-
Your Data
Step 3: Importing a GEDCOM
If you are not planning on importing any data from a GEDCOM file, you can skip this step. Otherwise,
go back to the Admin main menu and click on Import/Export to prepare to import your GEDCOM file. Your file
must be in standard 5.5 or 4.0 format, and you can import it directly from your local computer or from
the "gedcom" folder on your remote site. Please read the Help file linked to from this page for detailed
information about all import options.
If you are using multibyte characters in any part of your file (for example, characters you can't find on
a standard Western keyboard), you should also be careful to use the ANSI (sometimes called "Windows") or UTF-8 character set when creating
your file. Some genealogy programs will call this the "Windows" character set. For more information, see the
TNG Wiki article on Character Sets.
If your GEDCOM file is large, the import may not finish. You will know the import has finished
when you see a "Finished" message with the number of people, families and sources that were imported.
If your import does not finish, your host may have a limit on the size of uploaded files. If you cannot
resolve this with your site administrator, copy the GEDCOM file to the "gedcom" folder. Then proceed to
import the file, leaving the first field on the Import screen blank (see the Help on that page for
more details).
If the import begins but halts before you see the "Finished" message, your web server may be killing
the import to save resources for other processes. If this happens, make sure your GEDCOM file is in
the "gedcom" folder on the remote site, then return to the Import Settings and check the box labeled
"Save Import State". Finally, try your import again. This time you will see a link at the top of the
page that says, "If Import fails, click here to resume." Click on that link and the import will begin
again at the point it stopped. You might have to click this link multiple times, depending on how large
your file is or how concerned your host is about resources.
If your GEDCOM included media links, you will need to upload the actual files manually
to the appropriate TNG folders (e.g., "photos") that you created earlier.
Be sure to preserve any existing file structure from your Local Photo and Local History paths (See Import Settings) if
that's important to you. For more information, see the TNG Wiki articles on
Importing Data and
Importing Media.
<< Prev Next >>
-
Your Data
Step 4: Custom Event Types
TNG maintains the most commonly used GEDCOM tags (ie, Birth, Death, Marriage) as "standard", meaning
they are always imported every time. All others, including proprietary tags specific to certain software
packages, are deemed "Custom Event Types". Events of these types are not imported or displayed until
you tell TNG to "Accept" them.
The easiest way to set up all your needed Custom Event Types is to import your GEDCOM file using the
"Only import Custom Event Types" option before importing the rest of your data.
After that, go to the Custom Event Types area on the Admin main menu. All Custom Event Types used in your GEDCOM
will be displayed there, but all will be set to "Ignore". Edit each ones you want to import and switch the
flag from "Ignore" to "Accept". Also change the "Display" field to something more readable (for example, change
"OCCU" to "Occupation". You may enter a different Display message for each language you are supporting.
Do not change the "Type/Description" field.
Once you've made your desired changes, import your GEDCOM file again (this time without checking the
"Only import Custom Event Types" box) to see the custom events imported and
displayed, along with your other data.
You can also elect to import and "Accept" all Custom Event Types automatically.
If you're not importing a GEDCOM file, or if you'd rather set up Custom Event Types by hand, you
may do so by going to Admin/Custom Event Types.
See the Help file on that page for more information.
<< Prev Next >>
-
Your Data
Step 5: Manual Data Entry
If you are planning to enter your data manually, choose People, Families, Sources or Repositories from the Admin
main menu to get started. Everything should be fairly self-explanatory, but all pages have associated
help files you can use if you need them. There are no rules as to whether you should enter people or
families first. It's up to your personal style and preference.
<< Prev Next >>
-
Your Data
Step 6: Secondary Processes
After importing or entering your data, go back to the Import/Export area and click on the
Secondary Processes tab to perform various additional functions.
See the Help file on this screen for detailed information on each process. For example, click "Track Lines"
to trace the lines of descent within your genealogy. This places a small mark next to children in a family
group who have offspring of their own, allowing users to more easily follow your lines of descent.
If your desktop software did not sort children or spouses according to birth or marriage date,
you can use the "Sort Children" or "Sort Spouses" utilities to do that now.
From this area you can also create a GENDEX file to enable your site to be indexed on the TNG Network.
Another option here is "Relabel Branches". (You can create "Branches" in a tree in order to confine
user rights to only a part of that tree. To create branches in a tree, go back to Trees, then click the
Branches icon for that tree.) If you re-import your data with the "Replace All Data" option after
setting up your branches, your branches will be removed during the import. Use the "Relabel Branches"
feature to put them back.
<< Prev Next >>
-
Your Data
Step 7: Media (Photos, Histories, Documents, Headstones, etc.)
Media links may be imported as part of your GEDCOM file, or you may set them up manually
using the Admin menu. If you import these items with your GEDCOM, you will still need to copy the actual
files to the corresponding TNG folders (e.g., "photos", "histories" or "documents").
"Cemeteries" are not supported as separate entities by the GEDCOM standard, so these will
not be imported in a GEDCOM file as such. You will need to use the Admin menu to set them up. If you had links to
photos of headstones in your GEDCOM, they will be imported as "photos". You can then use TNG to convert
them to "headstones". See the Help under Admin/Media for more information.
All media must have a unique physical path and file name. Because of that,
you will see an error message if you try to add a second record for the same file name.
Media may be linked to individuals, families, sources, repositories, events and places. All media links
may be imported from a GEDCOM file, with the exception of media linked to places.
Links to media are held in separate tables, so re-importing your
GEDCOM will not break these links unless the ID numbers in your GEDCOM have changed since your last import.
You should verify they are the same before re-importing. NOTE: if you imported these items with your
GEDCOM and have changed your Root Path since then, importing these items again will create duplicates.
To avoid this, click the option on the Import screen to ignore media present in the GEDCOM.
For more information, please see the TNG Wiki article Media - Import.
<< Prev Next >>
-
Your Data
Step 8: Utilities: Backup/Optimize/Restore
It is recommended that you back up your table data regularly using the Backup utility. This will
create a series of .bak files in the "backups" folder. If possible, it is also recommended that you
set permissions on the "backups" folder to 771 (rwxrwx-x) for maximum security (must be done *after*
backups have been created). To avoid data loss
in the event of a server crash, copy or move these .bak files down to your local computer.
If your data becomes corrupted or lost, you can use the Restore utility to bring it back.
The Optimize utility can be used to speed up your data access by removing slots for deleted records.
For more information, please see the TNG Wiki articles Data Protection.
<< Prev Next >>
-
Customizing Your TNG Pages
Step 1: Templates
An easy way to quickly give your site a professional look and feel is to install one of TNG's
pre-built templates. The templates files are in the "templates" folder. To select a template, go to Admin/Setup/Template Settings and choose the
number of the one you want. Also make sure that "Enable Template Selection" is set to Yes, then click "Save" at the bottom. You can change templates as
many times as you'd like. If you do not want to use a template and would rather customize the default home page, header and footer, then set "Enable
Template Selection" to No.
You can easily change most of the images and text used in the template home page (index.php) and custom header (topmenu.php)
using the new Admin/Setup/Template Settings capability. You may also make changes directly to the template files. See the
Template Settings
article on the TNG Wiki for more information.
More information on templates can be found on this page on the TNG Wiki.
<< Prev Next >>
-
Customizing Your TNG Pages
Step 2: Style Sheets
Even if you use one of the pre-built templates, you may want to make changes to fonts, colors, text
sizes and other style elements. All of these aspects are controlled by "style sheets". Style sheet files
end with the .css extension. The core style sheet used by TNG is called genstyle.css (general rules) and can be found in the "css" folder.
The "css" folder also contains default versions of the template style sheet (templatestyle.css), mytngstyle.css (for you to make your
own style changes) and a few others, including tngtabs1.css/tngtabs2.css
(two different tab styles).
Each template also includes its own copy of templatestyle.css, mytngstyle.css and the tab style sheets
that override the default style rules.
If you want to change the existing style rules from any of CSS file or add your own style rules, you should
make those changes in the file called mytngstyle.css, as that file will not be overwritten in future updates.
IMPORTANT: Make your changes in the copy of mytngstyle.css within the folder for the template you're using. For example, if you're
using Template #3, make your custom style changes in templates/template3/css/mytngstyle.css. If you are planning on switching
among multiple templates, you might need to make changes in the other copies of mytngstyle.css as well. If you will not be using a template,
make your changes in the main css/mytngstyle.css file.
To make changes to mytngstyle.css, simply open it in a text editor, make your
changes, then save the file back to your web site. If you want to redefine a style block from genstyle.css, just copy it from that
file into mytngstyle.css and add your own changes. Anything you redefine in that file will take precendence, so only copy the lines
you want to change. Some comments are included in genstyle.css to help you know which
lines control what elements. If you're not sure what you can do in a style sheet, we recommend you try
http://www.htmlhelp.com/reference/css,
or simply search the Internet for "style sheets help").
Tabs: Some TNG pages have a series of tabs across the top. You can choose from two different tab styles
(see the General Setting page for more information). If you choose the square style, you can change
the colors of these tabs in the "tngtabs2.css" file. You will want to make your "active" tab match the
"fieldnameback" definition from genstyle.css, and you will want to make your "inactive" tab match
the "databack" definition from genstyle.css.
If you choose the slanted tab style, you can change the attributes in "tngtabs1.css", but the colors
are made from image files. To create new tab images in a different color, make sure your "photos" folder
has been made writeable, then go to the page switchcolor.php in your browser (http://www.yoursite.com/genealogy/switchcolor.php).
If you're reading this page from your web site, click here: switchcolor.php.
You will see a utility that will help you create new tab images. Again, you will want to make your "active" tab match the
"fieldnameback" definition from genstyle.css, and you will want to make your "inactive" tab match
the "databack" definition from genstyle.css.If the utility does not work for you,
you may not have the GD image library installed on your web site. Try creating the tabs here instead:
http://lythgoes.net/genealogy/switchcolor.php.
<< Prev Next >>
-
Customizing Your TNG Pages
Step 3: Header, Footer and "Meta" Files
If you have other style sheets you want to add, or if you have scripting code or meta tags you want to
place on all your TNG pages, add them to the TNG files called meta.php (public pages) and
adminmeta.php (admin pages).
To change the appearance of the header that appears on all TNG pages (except the home page), edit
topmenu.php (the default "Custom Header" file) in a text or HTML editor and customize as needed. The contents of this file will
include the opening BODY tag.If you decide to use a different file for your Custom Header, you will need to indicate
that in the General Settings in the Custom Header field.
To change the appearance of the footer that appears on all TNG pages (except the home page), edit
footer.php (the default "Custom Footer" file) in a text or HTML editor and customize it in the same manner. The contents of this file
will appear on each page just before the closing BODY tag. If you decide to use a different file for your
Custom Footer, you will need to indicate that in the General Settings in the Custom Footer field.
Things to note about these pages:
1. They are actually only page fragments, meaning that they are pieces of HTML and not complete HTML pages.
If you open them in a "smart" editor like FrontPage, it may try to "fix" these fragments by adding back
the "missing" pieces. It is therefore recommended that you first open them in a text editor or save
a backup copy just so you can compare before and after and delete any elements that are added back.
For instance, the topmenu.php file contains a <BODY> tag but no ending </BODY> tag. If the </BODY> tag is added back, your pages may not display properly.
2. You may rename these files if you want. If you do, be sure to put the new names in the appropriate
fields on the General Settings page. Maintaining ".php" as the file extension is essential if you plan to
include any PHP code.
<< Prev Next >>
-
Customizing Your TNG Pages
Step 4: Home Page
Your home page for TNG is called index.php. If you had a prior home page called "index.htm" or
"index.html", you may have to remove it in order for your new home page to be displayed when your
domain name alone is entered into a browser.
To customize your home page, open index.php in your text or HTML editor and make changes as needed.
You may rename it, but if you do you will also need to indicate the new name in the General Settings.
If you are planning to use TNG as a Nuke module, you will want to use and customize the version of this
file that comes with the TNG Nuke Add-on instead.
For more information, please see the TNG Wiki articles on
Home Pages - Getting Started and
User Pages - Getting Started.
<< Prev Next >>
-
Final Notes
Searching:
When doing a simple search from the default "home page" (index.php), TNG looks to see if the search
terms are "contained" in the corresponding fields of the target records. In other words, a search for
"Ed" will find "Edward", "Fred" and "Cedrick". This is intentional so that as many results as
possible will be returned. If you wish to limit responses to those that start with the search term(s),
simply edit the index.html file and include the following hidden fields in the form: lnqualify (for
surnames; value="starts with") and fnqualify (for given names; same value). This will coerce the search
to find results where the beginning of the data starts with the search term(s). This also has the
additional benefit of significantly improving performance during the simple search. If you have a
large database, this might be something to consider.
RSS:
To use the RSS newsfeed feature, open your favorite RSS reader and subscribe with this URL: http://yourdomain.com/yourgenealogyfolder/tngrss.php.
You can make the feed appear in a different language by appending "&lang=yourlanguage", where "yourlanguage" is the name of the language in TNG.
Timelines:
Depending on your margins or sidebar width, you may find that the bars on the timeline do not line up correctly with the year markers. If this is
the case, please edit the file timeline2.php and adjust the values $lineoffset, $chartwidth, $checkboxcellwidth and $division as needed.
Files to Delete:
When you're done with the installation, there are some files you might want to remove from your site in order to provide greater security.
Those files are: readme.html (this file), ajx_tnginstall.php and appendix.html.
More Information:
You might also want to read the Getting Started
articles on the TNG Wiki.
Go to your home page
Go to the Admin menu
<< Prev Next >>
-
Appendix
Appendix (list of files)
<< Prev