Before you can begin using TGP Rotator you need to setup some pages for it to use to display the galleries in your database. To manage your pages
locate and click on the Manage Pages link in the Setup section of the control panel menu. This document will describe how to add, update, and edit
the TGP pages that you will be having TGP Rotator generate for you.
Adding a Page
The first time you click on the Manage Pages link, you will immediately be taken to the page creation interface. After you have some pages created,
the Manage Pages link will take you to the page management interface. At the top of the page you will find a button that says Add a New Page. You
can click that button at any time to add new pages to TGP Rotator.
On the page creation interface there will be several fields that you will need to fill in. Each of those fields is described below.
Directory - This is the full directory path on your server where you want the page generated
Filename - This is the name of the file that you want to use for the page
Page URL - This is the full URL to the page, and should correspond with the Directory and Filename settings
Category - This field allows you to restrict the page to a certain category, or to allow all categories by choosing Mixed
Build Order - This field allows you to specify the build order for the page. Lower numbered pages are built first
Once you have filled in the fields how you want them, press the Add This Page button. Although you can only create one page at a time, there is
no limit to the total number of pages you can have. To add more pages, simply repeat this process for each one. Note that it is possible to create
pages outside the document root of the site where the software is installed. If you have other domains under the same account on your server, you
can use this to generate TGP pages for those other sites. For more information see the Multiple Domain Support
section of the software manual.
When you add a page you should first make sure that the Directory setting that you use points to a directory
that has already been created and has 777 permissions. You should also make sure that a file does not already exist in that directory. If a file does already
exist in that directory you should delete or rename it so that TGP Rotator can create the page. Once you assign a page to TGP Rotator you should no longer edit
that file manually. Any changes you need to make should be done through TGP Rotator's template editor.
Updating a Page
If you need to make changes to the page after it has been created, click on the [Edit] link that corresponds to the page that you want
to change. This will pop up a window where you can edit the page settings. If you change the directory or filename, please read over the
important notes section above to make sure that you have correct permissions and that the file does not already exist. Once you have made the changes
you want, press the Update This Page button. The software will save your settings and the next time you rebuild your pages the changes will take affect.
Deleting a Page
To delete a page simply click on the [Delete] link that corresponds to the page that you want to remove. A window will pop up asking if you are
sure that you want to remove the page. Click the OK button to remove the page or the cancel button to abort the deletion. When a page is deleted
the software will remove it's template, so if there is something you want to save from the template be sure to make a copy of it before you delete
the page. If you delete and then re-add a page, it will not use the same template from the page that was deleted, it will use the software's default
template that is included with the software.
Category Page Creation
If you have a large number of categories and want to generate pages for one or all of them, it would be very time consuming to add one page at a time
through the standard page creation interface. Instead the software has a utility which will add multiple categories for you at once. From the
Manage Pages interface you can click on the Category Page Creation button or from the Add a Single Page interface click on the Automatic Category Page Creation
link. This will bring you to a page where you can configure how and what pages should be created.
Directory - Enter the full directory path where you want the pages to be created when they are built
Directory URL - Enter the full URL that points to the directory you entered in the Directory field
File Extension - Enter the file extension to use for all of the created pages
Category - Select the category you want to create the pages for or All Categories to create pages for all of your categories
Pages - Select the number of pages per category (more on this later)
Conversions - Select the type of conversions that should be applied to the category name (more on this later)
Once you have filled out all of the fields with the values you want, press the Create Category Pages button. The software will automatically add the new
pages to the database and you will be returned to the category page creation form.
The Pages value allows you to specify the number of pages that should be created for each category. If you select to create more than one page, the
page creation feature will automatically number each subsequent page that is added. For example, if you enter 3 in that field and select the category
named Hardcore, the following 3 pages will be added:
Using your category names without applying any conversions to them would result in some unusual page names and possibly even some that conflict
with the server's operating system. Some servers do not allow spaces or other special characters in the filenames that are stored on the system.
For that reason, conversions must be applied to the category names.
Remove all non-alphanumeric characters
This will remove all characters in the category name that are not letters (a-z) or numbers (0-9). Examples:
Hardcore -> Hardcore
Porn Stars -> PornStars
Adrianna's Pics -> AdriannasPics
Replace all non-alphanumeric characters with a dash
This will replace all characters in the category name that are not letters (a-z) or numbers (0-9) with a dash (-). Examples:
Hardcore -> Hardcore
Porn Stars -> Porn-Stars
Adrianna's Pics -> Adrianna-s-Pics
Replace all non-alphanumeric characters with an underscore
This will replace all characters in the category name that are not letters (a-z) or numbers (0-9) with an underscore (_). Examples:
Hardcore -> Hardcore
Porn Stars -> Porn_Stars
Adrianna's Pics -> Adrianna_s_Pics
All letters lower case
This will replace a letters (a-z) in the category name with their lowercase equivalent. Examples:
Hardcore -> hardcore
PornStars -> pornstars
No change in text case
This will not make any changes to the letters that appear in the category name.