Chapter 1

Building First TGP

CONTENTS

In this chapter we focus on main settings needed before publishing submission form. We also present a sample of how to build a new TGP. Finally, we present few other TGB features.

The strategy

A very important problem, which must be under our attention before building first TGP is that we need galleries. Usually, a TGP may post from dozens to few hundreds of galleries, which may be a real problem. When we use a regular script for galleries management, which doesn't perform any check on gallery submission, we may receive hundreds of galleries everyday, many of them on the strength of different submission engines.

It is a known fact that not all categories get the same submission amount in a period of time. Usually, there are two or three categories absorbing 35-50 percents of the daily submission amount. Running a categorized TGP requires that even the less submited category must be entierly filled.

TGB performs a deep check for every gallery before queueing it for review, so you must be aware that the daily number of queued galleries will decrease.

Galleries posted at a particular moment of time will be listed only in those TGPs already built at that moment. Still, you are allowed to edit these galleries in order to be listed in other TGP's you have build after gallery posting.

In conclusion, you must publish the submission form few days before actually running your TGPs, in order to have enough galleries to be listed. See Insert info section of Chapter 3 for details about how to publish the submission form.

First part of this chapter describes how to customize the submission checkup system in order to make it the accept only good galleries. If you simply publish the submission form without setting all the paramaters described bellow, it will not work.

Categories      Global: Main (bottom frame) -> Categories (top-left frame)

First step is defining the categories. For that you must fill the Categories form with the names of categories you want for your TGPs.

In this section you must define all categories used in all your TGPs. We call these global categories. There may be TGPs using only part of these categories.

We recommend that categories with two words names to be defined as a single word ("Big Girls" to be defined as "BigGirls"). That's because of the traffic script which may be in trouble with two words category names.

Descriptions      Global: Main (bottom frame) -> Description (top-left frame)

TGB uses prewritten descriptions. That means the submiter do not have the permission to write his own gallery description, but he must choose one from a list. It is your task to write all descriptions for each category. We recommend that you define at least a double amount of descriptions than the amount of galleries you intend to list in a category. For each category, descriptions may be edited by filling the central frame.

Notice that these are global descriptions, which may be found in the submission form. For each TGP you will define local descriptions.

Points      Global: Main (bottom frame) -> Points (top-left frame)

A great feature of TGB is that it allows you to use points for placing galleries according to their quality. Of course, you can choose not to use points, and the galleries will be posted in their submission order.

If you want to use points you must check Use Points check-box and decide the maximum number of points per gallery. You also must set the number of points to be added to trusted webmasters (partners) and the number of points to be substracted for the galleries without recip.

Your reviewers must assess the quality of each approuved gallery using points between 1 and the maximum number you decided. Points appear in the botton frame of the review window as radio buttons.

Figure 1 shows a sample of points form.

Files      Global: Main (bottom frame) -> Files (top-left frame)

This form allows you to set the type and the amount of files composing the gallery. Notice that these dimensions are checked on every gallery submission.

First part is dedicated to the files type. We suggest that you allow all types of video and image files. Types of allowed files are identified by their extention. You must fill the edit box with files extentions (such as "gif", "mpg"), separated by blank. Figure 2 shows a sample of this part.

Second part, File size limits, allows you to set the limits, in Kilobytes, of images and videos. These limits apply to big pictures, not thumbnails. Figure 3 shows a sample of this part.

Third part, Content amounts limits, let you customize limits for the amount of images and/or videos in one gallery. You may see a sample in figure 4.

Submissions      Global: Main (bottom frame) -> Submissions (top-left frame)

This section allows you to set the maximum number of daily submissions, separated for regular and trusted webmasters. For each of them you are allowed to customize the maximum number of submissions per category.

A useful feature of TGB is that it allows you to receive submissions only from your server. That means you can avoid submission engines, which generally post low quality galleries.

Bans      Global: Main (bottom frame) -> Bans (top-left frame)

This section is in charge with cheaters. Here you can interdict a lot of HTML tags and JavaScript functions which are generally used by cheaters. The script scan the gallery on submission and, when it finds one banned tag or function it rejects the gallery.

For understunding the meaning of every forbidden tag/function you must consult a HTML/JavaScript guide. We recommend that you check all the boxes in this section. Of course, you may customize it in the way you want.

Ads      Global: Main (bottom frame) -> Ads (top-left frame)

TGB provides you a few additional features acting as a rejection filter for low quality galleries. It is a known fact that reviewing galleries is a boring task, and there is no reason for losing your time with low quality galleries. By using features of this section you reject part of these low quality galleries at submission.

The banners and buttons from Maximum "x" banners and buttons per page apply to all images inside anchors ( tags), except thumbnails. If the amount of banners in a gallery exceeds the limit you set, the gallery will be rejected by script.

Outside links refers to links which doesn't follow the content. The script counts all links pointing to something else than content. If this value exceeds the limit you set, the gallery will be rejected.

You may see a sample in figure 5.

Button      Global: Main (bottom frame) -> Button (top-left frame)

Here you forbid hotlinking buttons (recips) from domains you fill in the form. This helps you to avoid paying for extra-bandwidth. For that, this form must be filled with all domains of the TGPs hosting recip banners (or the domain of your banner farm, if you have one).

Database      Global: Main (bottom frame) -> Database (top-left frame)

This section provides you a tool for supervising webmasters (submiters) activity, or rather, their inactivity. You probably don't want to keep in your database those webmasters who didn't post galleries for a long period of time. The form allows you to separately customize "forget" period for regular, trusted and blacklisted webmasters. You must fill the number of months of webmasters inactivity.

New TGP      Global: Main (bottom frame) -> New TGP (top-left frame)

Before building the new TGP, you must create the TGP directory and script directory on your host, and set their UNIX mode to 777 or 755. UNIX 777 mode means that all users are allowed to read, write and execute directory files; 755 means the owner is allowed to write (modify) files, all the others beeing allowed to read and execute them. You may use any of these modes.

The "TGP directory" may be your web root directory or any other inside it. Suppose your web root directory is named public_html. The "TGP directory" may be public_html or any other directory inside public_html. Suppose your TGP domain name is "mydomain.com". By typing "http://mydomain.com/some_file.html" in the browser address field, the browser will load "some_file.html" from your public_html directory.

The web root directory is set on HTTP server installation (public_html in our sample), so the only thing you have to do is to set it's mode to 777 (755). Most of FTP clients (such as WS FTP Pro) used for remote connection to UNIX systems allow you to edit directory mode usig the CHMOD command.

If you plan to instal your TGP in other directory (necessarily starting from web root directory), you must create it and set it's mode to 777 (755). If you name this "other_directory", it's URL is "http://mydomain.com/other_directory/". TGB will upload your site files in this directory.

The script directory may be the same as the TGP directory, or a different one. We recommend that you create it in cgi-bin directory and give it a suggestive name, such as "tgp". Bush will upload a file in this directory. Do not edit this file!

In the table below you find detailed explanations about the information you must provide when creating a new TGP. For each field we have shown a sample, supposing the TGP directory is the same as your web root directory (public_html).

TGP Name This is the name of your TGP. Sample:
My First TGP
Short TGP name
(for internal use) 		You must pick out a short name for your TGP. This is only for internal use. You will find it, after TGP was built, in the TGPs area (the right side of bottom frame). Sample:
MFTGP
TGP directory URL: This is the URL of your TGP directory. Sample:
http://www.mydomain.com/
TGP directory mode: This must be the same you set for the TGP directory, using your FTP connection.
Script directory URL:
blank if the same as tgp directory URL 		Leave this filed blank, if you chose to be the same as TGP directory.
If you created the tgp directory (in your cgi-bin), this is:
http://www.mydomain.com/cgi-bin/tgp/
Full path to Perl:
from server root 		This information must be provided to you by your server administrator. Usualy, it is:
/usr/bin/perl
Full path to tgp directory:
from server root 		This is exactly what it sais: the TGP directory full path. If your FTP connection doesn't allow you to access the directory tree starting from the root, you must ask for this to your server administrator. Sample:
dir1/dir2/mydomain/mydomain.com/public_html
Full path to script directory:
from server root
blank if the same as tgp directory 		Blank or:
dir1/dir2/mydomain/mydomain.com/cgi-bin/tgp
Domain name or IP-address for FTP connection: Sample:
127.34.34.34
FTP port:
if non-standard 		For standard host you may let it blank, or 21. Otherwise ask your server administrator.
Path to tgp directory:
required only if ftp connection root reassigned 		This is the path to your TGP directory starting from the point you are loged in, using a FTP client. This may be the same or part of the full path. If you know the full path (from the server root) to your TGP directory, this "simple" path starts from the login point. Sample:
mydomain/mydomain.com/public_html
Path to script directory:
required only if ftp connection root reassigned
blank if the same as tgp directory 		Blank or:
mydomain/mydomain.com/cgi-bin/tgp
FTP login: Username for FTP login.
FTP password:
will not be written down, used only during installation 		FTP password.

Note that these settings can be changed after TGP building.

Besides the sections presented above, which must be completed in order to make submission form work, there are few other features provided by script which allow you to customize it's behavoir.

Trusted webmasters      Global: Main (bottom frame) -> Trusted webmasters (top-left frame)

You may choose to let Bush give trusted status to those webmasters with averge galleries lifetime greater than a value you are allowed to choose. Trusted webmasters are allowed to post galleries without review.

Change password      Global: Main (bottom frame) -> Change password (top-left frame)

You must type and retype the new script password. Do not copy-paste the new password! In case you didn't typed it correctly first time and you use copy-paste for retype filed, this may cause you losing script access.

Color setup      Global: Main (bottom frame) -> Color setup (top-left frame)

Bush allows you to customize colors for backgrounds, texts, links and active links, for different frames and sections.

Update all TGP      Global: Main (bottom frame) -> Update all TGP (top-left frame)

When click on this link, all TGP's will be updated, using current galleries lists. You may need to use this when you did some changes to one or many TGP's (or when you build a new one).

This will not affect the tomorrow list. Galleries "for posting" remain as they are.

Daily update      Global: Main (bottom frame) -> Daily update (top-left frame)

This is the manual daily update. Bush automatically updates all TGP's, once in a day. The automatic daily update hour is added in the crontab server file, it may be changed by anyone who has permission to edit this file.

You may need to use this link if the automatic daily update doesn't work (it may happen when cron server task doesn't work properly).

In this case, galleries "for posting" (approved on review or submited by trusted webmasters) are inserted into current lists. After daily update, you will have "0 for posting".

Unblock update      Global: Main (bottom frame) -> Unblock update (top-left frame)

The update implies alteration of many files composing the entire database and uploading files on remote servers. Depending on database size, server power and the number of remote servers (TGPs) the update process may take a few minutes.

TGB continuously performs galleries checkup and updates TGPs everytime a gallery is removed from the list.

It may happend that you click on Update all TGP or Daily update in that period of time when script executes database files update. As the update process is not finished yet, and it receives a new update command, the script will return an error message and it may occur an update blocking. In this case, you must click on Unblock update link, and after Done, you may click again on Daily update or Update all TGP link.

If the sites are not automatically updated by cron, and, after you tried many times to manually update them, they still remain un-updated, then you must use the Unblock update and try to manually update sites after that.

Index Chapter 2