Manual

Easy to install to any host with PHP 4.2 or higher, Zend Optimizer^TM, GD 2.0 or higher, sockets, sessions, all of it is usually enabled by default. If PHP is running in Safe mode some of the features may not work. It is only FTP required to install the script.

As a payment TM Live skims 1% of the outgoing traffic. It is possible to buy a version without skim.

2. Setup
Automatic
1. Set permissions 777 to the root directory
2. Upload all the files from the archive there except manual.htm in binary mode;
3. To run setup.php in browser go to http://yuorsite.com/setup.php;
4. If there is no errors edit index page (index.php), it will be created after setup in the root, according to a traffic manager requirements;
5. Go to the admin panel (http://yuorsite.com/cm-admin.php) to section Templates, update default template as needed (but not rename), add more if needed;
6. Remove setup.php set permissions 755 to the root;

Manual (if permissions 777 cannot be set to the root)
1. Upload all the files from the archive there except manual.htm in binary mode;
2. Create these directories:
/backupfiles
/cmfiles
/datafiles
/logfiles
/settings
/styles
/temp
/templates
/thumbs
and set permissions 777 to them;
3. To run setup.php in browser go to http://yuorsite.com/setup.php;
4. If there is no errors edit index page (index.php), it will be created after setup in the root, according to a traffic manager requirements;
5. Go to the admin panel (http://yuorsite.com/cm-admin.php) to section Templates, update default template as needed (but not rename), add more if needed;
6. Remove setup.php set permissions 755 to the root;

Template(s) creation
Template default_1, which is created automatically, has to be edited so go to admin panel, select section Templates, select default_1 and press Edit.
In the opening window there is HTML code of the default template, it can be copied to the appropriate text editor for edition if needed. Every 10 minutes script will create the main page of the site based on this template so you need to write there its full HTML code or the main part of it. Also you need to use the special tags:
##THUMBXX## - will be replaced with a thumb with XX number (XX can be 0...3999);
##DESCXX## - will be replaced with a text description of the gallery with XX number;
##URLXX## - will be replaced with an URL of the gallery with XX number;
##WIDTHXX## - will be replaced with width of a thumb with XX number;
##HEIGHTXX## - will be replaced with height of a thumb with XX number;
##NICHEXX## - will be replaced with a category of the gallery with XX number;
##AMOUNTXX## - will be replaced with a content amount of the gallery with XX number (number of pictures/movies on a gallery)
##TYPEXX## - will be replaced with content type of the gallery with XX number (pictures/movies/other)
##PERCENTXX## - will be replaced with skim percent for the gallery with XX number
##OBJXX## - will be replaced with the ID of the gallery with XX number

Cron setup
To make the script updating stats and redrawing pages you need to setup cron. It is easy but may have some issues for newbies, just write with host admin panel or ssh the command line:
* * * * * cd /home/account-name/public_html/site-name; /usr/bin/php tmcron.php 1>/dev/null 2>/dev/null
This command consists of 3 parts:
- time to run {* * * * *} or {*/1 * * * *}, which means every minute;
- working directory change to the directory where php files of TM Live located {for example, cd /home/account-name/public_html/site-name;}
- run tmcron.php with PHP {/usr/bin/php tmcron.php 1>/dev/null 2>/dev/null} or {/usr/local/bin/php tmcron.php 1>/dev/null 2>/dev/null};
Syntax can be different, if there is Direct Admin panel, time to run must be writen {0-59 * * * *} instead of {* * * * *}, cPanel requires {* * * * *}.
Path to PHP can also be different. To find out the correct path to PHP in your system use ssh command whereis php or just ask your host admin.
Path to TM Live files will be different for each server, the easiest way to find it out - upload a file info.php with the code to your host and open it with browser by typing http://www.yoursite.com/info.php

3. Content management (section Main)

Gallery addition (Add)
On the section Main press button Add. In the opening window fill these forms:
Group - name of the group (rotator);
Thumb path - URL or relative path to the thumb(s), which you are going to stick to the gallery (up to 3);
Picture - path to the thumb(s) on your local computer;
Gallery URL - internet location (URL) of the gallery;
Description - text description of the gallery;
Category - category (niche) of the gallery;
## of Pics/Movs - number of pictures/movies on the gallery;
Sponsor - Sponsor name (optional);
Skim percent - Skim for the gallery (optional);
After fill the forms press Add, the gallery is added, will be in the list on the page Submissions after renew.

Bulk addition (Import)
On the section Main press button Import. In the opening window fill these forms:
Field1 - Field8 - forms define the data order in the text massive Data Input;
Sep - separator for the data in the massive;
Group - name of the group (rotator);
Data Input - text massive, must contain as low as URLs of galleries and other information such as text descriptions, niches...;
After fill the forms press Add Galleries, the galleries are added, will be in the list on the page Submissions after renew.

subsection Submissions
Contains the list of galleries in processing.
ID - ID of the gallery inside the manager;
Description - text description of the gallery (the gallery will be opened in a new window if someone clicks the description);
Category - category (niche) of the gallery;
## - amount of pictures/movies on the gallery;
Type - content type on the gallery (pictures/movies);
Sponsor - name of the sponsor;
Group - name of the group (rotator);
Poster - ID of the poster.
ID of the gallery can be highlighted with green (dark green means gallery in the process, light green means gallery is ready) or red - automatic processing is impossible for some reasons.

Actions available from the subsection Submissions:
- select all the galleries (Check All).
- change group of the gallery (Change Group), select one or more galleries and press Change Group, in the opening window there will be the options to change group.
- View & Select thumbs, view thumbs for the selected gallery (galleries) and remove some of them.
- Make Thumbs, make thumbs for the selected gallery (galleries) in the manual mode.
- Remove the gallery from the list (Decline).
- Remove the gallery from the list and add it to the blacklist (Blacklist).
- add to rotation as a new gallery (Add to Rotation).

subsection Stats
It allows to view stats for thumbs: CTR, number of clicks and shows for each thumb.
## - number of the gallery sorted by CTR;
PICTURE - active thumb of the gallery (to view others move cursor over the thumb), can be highlighted with blue (New status) or red (Bad status);
Gal ID - ID of the gallery;
Clicks/Shows - number of clicks/shows in the selected time period;
CTR - clicks to shows ratio, defines how attractive the thumb for visitors.

Actions available from the page Stats:
- Check all the galleries (Check All).
- Remove selected galleries (Remove Objects), the galleries will be removed without going to archive.
- Remake Thumbs allows to remake thumbs for the gallery without moving the gallery from the main database.
- Change Group allows to move the selected gallery to another group.
To view stats for another group change the group in a form above or below the stats.

subsection Edit Base
It allows to edit galleries in rotation.
View - view the gallery in a new window;
ID - ID of the gallery;
URL - URL of the gallery;
Description - text description of the gallery;
Category - category (niche) of the gallery;
## - number of pictures/movies on the gallery;
Type - content type (pictures/movies/other);
Sponsor - name of the gallery's sponsor;
Skim - dedicated skim for each gallery;
Status - status of the gallery.

Actions available from the page Edit Base:
- Save changes (Update Database).
- Export database to the text massive which is good for import to another copy of the script (Export Database).
To change the group of rotation you can select it in a form above or below the data.

subsection Groups
It allows to edit groups and its parameters.
Group - name of the group (there must not be two or more groups with the same name);
Mode - rotation mode (Random - thumbs are placed on the page in a random way, Chronological - the thumbs are placed in a chronological way, the first added is lower and the last added is higher on the page, TGP mode, Prod Boost - mode which boosts productivity, the most attractive thumbs are in the most attractive spots);
Range begin - start position number of the group;
Range end - end position number of the group;
Category - category (niche) of the group;
Th Width - thumb width;
Th Height - thumb height;
New % - portion of thumbs with new status on the page;
Daily new - maximum number of galleries added daily in full auto mode.

Actions available from the page Groups:
- Add a group (Add).
- Edit the group's parameters (Edit).
- Remove the group (Delete), then the you can select what to do with galleries from the removed group, avoid to remove DEFAULT group.
- Remove stats for the group (Reset Stats).
- Remove the map of the group (Reset Map).

subsection Actions
It allows to edit macrocommands (actions) for the thumbmaker.
ID - macrocommand's ID (for the action which will work with auto thumbmaker the name is default);
Action - macrocommand's body may include these commands:
--autocontrast*ct
autocorrects the contrast of the image same as Photoshop's autocontrast, optional parameter ct - content type with possible values (1 - photo, 2 - video)
--autolevels*ct
equalizes levels of the image, sometimes wrong way, same as Photoshop's autolevels, optional parameter ct - content type with possible values (1 - photo, 2 - video)
--brightness*amount*ct
corrects brightness, parameter amount (-255 - 255), optional parameter ct - content type with possible values (1 - photo, 2 - video)
--contrast*amount*ct
corrects contrast, parameter amount (-5.0 - 5.0), optional parameter ct - content type with possible values (1 - photo, 2 - video)
--copy*ct
creates a copy of the image in a new layer, optional parameter ct - content type with possible values (1 - photo, 2 - video)
--emboss*radius*ct
makes a relief in the image same as Photoshop's Emboss filter (radius must be 0.1-0.3), optional parameter ct - content type with possible values (1 - photo, 2 - video)
--gamma*r*g*b*ct
corrects gamma, parameters: r, g, b (0 - 2, 1 means no changes), optional parameter ct - content type with possible values (1 - photo, 2 - video)
--grayscale*ct
makes an image black and white, optional parameter ct - content type with possible values (1 - photo, 2 - video)
--high_pass*radius*ct
finds edges in the image same as Photoshop's Emboss filter (radius must be 0.1-0.6), optional parameter ct - content type with possible values (1 - photo, 2 - video)
--img_save*quality*ct
saves the image with the selected quality (0-100), optional parameter ct - content type with possible values (1 - photo, 2 - video)
--noise_reduce*radius*threshold*ct
remove the noise, parameters: radius (1-5, recommended 3), threshold (0-50, recommended 7-15), optional parameter ct - content type with possible values (1 - photo, 2 - video)
--overlay*file*x-offset*y-offset*mode*ct
overlays a logo or an image, file - path to the logo's file (jpg, gif, png supported), x-offset - offset from the left side of the thumb in pixels, y-offset - offset from the top of the thumb in pixels, mode - overlay mode (1 - overlays logo with black background, 2 - overlays a layer in the Soft Light mode), optional parameter ct - content type with possible values (1 - photo, 2 - video)
--resize*w*h*ct
resizes the image, w - target width, h - target height, optional parameter ct - content type with possible values (1 - photo, 2 - video). If w and h are not determined they will be taken from group parameters.
--saturate*amount*ct
corrects the saturation, parameter amount (-100 - 100), optional parameter ct - content type with possible values (1 - photo, 2 - video)
--smart_blur*radius*threshold*ct
smart blur same as Photoshop's Smart Blur, parameters: radius (1-5, recommended 4), threshold (0-255, recommended 30-40), optional parameter ct - content type with possible values (1 - photo, 2 - video)
--ushmask*amount*radius*threshold*ct
increases sharpness same as Photoshop's Unsharpen Mask, parameters: amount (0-255, recommended 80), radius (0.5-5, recommended 0.5), threshold (0-255, recommended 30-40), optional parameter ct - content type with possible values (1 - photo, 2 - video)

Actions available from the page Actions:
- Add a macrocommand (Add).
- Edit parameters of the macrocommand (Edit).
- Remove the macrocommand (Delete), avoid removal of the default macrocommand.

subsection Archive
Contains the galleries, removed from the rotation automatically.
ID - ID of the gallery;
Description - text description of the gallery (the gallery will be opened by clicking on it);
Category - category (niche) of the gallery;
## - number of the content on the gallery;
Type - type of the content on the gallery;
Sponsor - name of the sponsor of the gallery;
Group - name of the group (rotator);
Poster - poster's ID.

Actions available from the page Submissions:
- Check all the list (Check All).
- View the thumbs of the gallery (View Thumbs), allows to remove a part of them.
- Remove the gallery from the list (Delete).
- Move to the list Submissions (Move to Submissions).

4. Blacklist management (section Blacklist)

Basic principles
Cheating galleries may be not only removed but added to the blacklist to avoid repeated submissions. From the section Main subsection Submissions select cheating gallery (galleries) and press the button Blacklist.
While the domain is in the blacklist any submissions from the domain are prohibited, also the poster's e-mail will be blacklisted.

Domain addition
Any domain can also be blacklisted without submissions from it. Just press the button Add from section Blacklist. In the opening window fill the forms:
Domain - domain which has to be blacklisted;
E-mail - e-mail which has to be blacklisted;
Reason - reason for addition to the blacklist (optional).

Domain update
After addition some parameters of the blacklisted domain can be changed. Go to section Blacklist, select the domain and press Edit. In the opening window same as addition form all the parameters can be corrected.
After correction press Update Domain, blacklist updated.

Domain deletion
Go to section Blacklist, select the domain and press Delete. In the opening form confirm the deletion.
Press Delete Domain, the domain is removed from the blacklist and submissions from it are allowed.

5. Templates management (section Templates)

Basic principles of page rotation
The main page of the site which is shown to visitors is re-built by the script every 10 minutes on the template base. Script allows to show different pages to different visitors depending on category (niche) of the traffic and on the number of the visit. Reserved template names are used for it.
Reserved template name consist of 2 parts: {part 1}_{part 2}, the template is located in the directory /templates in the file {part 1}_{part 2}.tpl;
As the first part of template there can be a category, or the word default, the second part is always the number of visit.
Template which is created during the installation is called default_1, if there is no other templates the script makes the main page based on default_1, all the traffic comes to that page. If someone needs to create a different page for category Teen, template must be called teen_1, if someone needs to create a different page for non-unique visitors the template must be called default_2.
You cannot use templates with names other than reserved.

Template addition
From the section Templates press the button Add. In the opening window specify Template name and enter HTML code of the template. Some special tags can be used in HTML code..
After fill the form press Add Template, the template is added.

Template update
After addition a template can be changed at any time by HTML code correction. Go to section Templates, select the template and press Edit. In the opening window the only form contains the HTML code of the template. Some special tags can be used.
After HTML correction press the button Update Template, the template is updated.

Template deletion
From the section Templates select the template and press Delete. In the opening form confirm the deletion.
Press Delete Template, the template is removed.

Template renewal
If you want to put changes on the main page immediately after making it in the template you can renew the page manually, just go to section Templates and press the button Renew. The file /templates/{template name}.txt, which contains HTML code of the main page will be created.

6. General settings (section Settings)

subsection Site Info
Username - site admin's name;
Password - site admin's password.

subsection File System
Thumb path - local directory to store thumbs;
Path to CJ out - path to the out file of the trade script used if TM Live works with a trade script jointly;
FTP Server - FTP address of the remote server to store thumbs (only if the thumbs are located on the remote server);
FTP Username - FTP username (only if the thumbs are located on the remote server);
FTP Password - FTP password (only if the thumbs are located on the remote server);
FTP Directory - the directory to store thumbs on the remote FTP server (only if the thumbs are located on the remote server);
Positions to use - maximum number of spots where the thumbs/desc controlled by TM Live will be shown.

subsection Skim Management
Default to content - percent of clicks which goes to galleries;
First clicks - number of first clicks that always go to galleries, or trade scheme (ctct - means content-trade-content-trade).

subsection Content Manager Settings
Time to live - number of 10 minute cycles while the thumb keeps New status;
Days count - number of days to count stats;
Times to extract - number of tries to grab pictures from a gallery in automatic mode;
Content manager mode - how the content manager works (full automat means all the operations with new galleries are made by content manager, manual means all the operations are made by site admin);
Gallery check - if you want to check galleries in rotation for changes;
Extract images - extractor (grabber) mode (Autodetect - extractor detects type and amount of content on the gallery and corrects database, All of the gallery - copies all the pictures that can be used as a source for a thumb, Full size only - copies only full size pictures from picture galleries, does not works with movie galleries);
Process new galleries - determines the order to process galleries in Submission section in automatic mode (By Addition Time - the first added gallery is processed the first, Random - all the galleries are processed in random order);
Place new galleries - determines the spots where new thumbs will be tested;
Add new galleries - how to add new galleries in automatic mode (all the daily amount in one minute or one gallery per hour).

subsection TGP Settings
Accept third person submissions - allow other webmasters to submit galleries or not;
Protect with Passcode - use graphic passcode to protect from autosubmitters or not;
Approved posters only - accept galleries from approved posters or from everyone;
Allow new posters - allow webmasters to apply for becoming approved poster or not.

subsection Submission Rules
Rules for posters (wiil be shown on post.php).

subsection Category selector
It allows to select one or several categories for the website.

7. Backup management (section Backup)

Backup creation
From the section Backup press the button Backup, backup is created.
The file which contains the backup is located in /backupfiles directory and called tm-[date of creation]-bu.png, for the site with 100-150 thumbs size of the file must not exceed 2 Mb. To move the site to another host you just need to move that file.
Database of TM Live is quite stable to be broken but if the moving to another host is required backup will help.

Data restore
To restore data from previously created backup from section Backup select required file and press the button Restore. In the openning window select what exactly is needed to be restored and press the button Restore. The data will be restored.

8. TGP Features (section Posters)

Basic principles
In the section Posters there is a list of registered posters, who can submit their galleries to your site.
Poster ID - ID of the registered poster, must be entered when a gallery submited;
E-mail - poster's e-mail;
ICQ - ICQ of the poster;
Limit - daily limit for submissions;
Date - date of poster approval;
Status - poster's status, only Approved status allows to submit galleries.

Poster addition
From the section Posters press button Add, in openning window fill all the forms and press button Add.

Poster update
From the section Posters select the poster and press button Edit. In openning window correct required data.
After correction press the button Update, poster's data is updated.

Poster deletion
From the section Posters select the poster and press button Delete. In openning window confir deletion.
Press the button Delete, the poster is removed, submissions from him won't be accepted.

9. Page post.php
It is used for gallery addition by other webmasters (posters). It contains the forms:
Rules - rules that posters must follow (can be edited from the section Settings);

SUBMISSION FORM
E-mail - e-mail of the poster;
Gallery URL - URL of the poster's gallery;
Description - text description of the gallery;
# of Pics/Movs - number and type of content on the gallery;
Category - category (niche) of the gallery;
Passcode - digital code protecting from autosubmit (human test);
Enter Passcode - form to enter the digital code;
Poster ID - Poster's ID;
Password - Poster's password;

Add new Poster
Poster ID - requested poster's ID;
Password - requested poster's ID;
E-mail - e-mail of the poster;
ICQ - ICQ of the poster.