“Total Topsite” Documentation by “Tyler Pesta” v1.0
“Total Topsite”
Thank you for purchasing Total Topsite. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here. Thanks so much!
Table of Contents
- Installation
- User Instructions
- FAQ
- Sources and Credits
A) Installation - top
Step 1
Start by extracting the zip file which you downloaded from our website.
Step 2
Upload the contents of tt_1.x folder to document root on your website, eg: public_html or www
Step 3
Create a MySQL database on your server.
Creating a MySQL Database will vary from server to server.
Your server control panel should have a MySQL databases area, where you will be able to create a database, database user, and database password.
Step 4
Open up config.php file located in /lib/ directory, and change the four constants as show below:
define('DB_SERVER', "localhost"); Usually localhost
define('DB_USER', "root"); Your database username created in step above
define('DB_PASS', "root"); Your database password created in step above
define('DB_DATABASE', "dbname"); Your database name created in step above
Step 5
Open your hosting control panel CPanel/H-Sphere etc. and using PhpMyAdmin or any other program execute sql.sql file. This will create all the necessary database tables.
Step 6
Point tour browser to your Total Topsite directory, and login with
Username: admin
Password: admin
Once logged in, click the User Panel button and change your password.
Then click the Admin Panel button and goto Site Settings -> Settings and update your Site URL, Site Name, and Admin Email etc.
Step 7
Add a cron job, for /crons/vote_reset.php, to run when you want the vote and click counts to be reset to 0.
If you would like the counts to be reset once a week, then you would add a cron job to run /crons/vote_reset.php to run at the time and day that you wish.
Step 8
chmod /cache/ to 777. This directory is used to store the captcha images.
Step 9
If you wish to incorporate ads on your site, you can add your ad code in the files in /banners/
Open each file, find this code:
<!-- replace code between these tags with your ad code -->
<img src="/images/banner_728x90.jpg" />
<!-- replace code between these tags with your ad code -->
Replace
<img src="/images/banner_728x90.jpg" />
with the code for your ad.
Make sure that Show Ads is set to On in your site settings.
Step 10
Create a logo image for your site and name it logo.jpg.
Next upload it to the /images/ folder.
Your logo will then be shown at the top of your site.
Also, if you wish to have a custom No Banner image, you can upload a 468x60 image named no_banner.jpg to the /images/ folder.
B) User Instructions - top
Registering
Click the Register Button to create your new account. You will be asked for a login name, password, email address, and captcha code if it is enabled.
If enabled by the admin, you may have to confirm your email address by clicking on a link that will be sent to you, so be sure to use a real email address.
Once your account is activated, you can then login to add your site.
Add Your Site
If you are logged in, you can click the Add Your Site button to add your first website.
You will need the name of your site, the URL eg: http://www.yoursite.com, and a description of your site. Also, you can add a URL to a banner for your site eg: http://www.yoursite.com/banner.jpg. The image the URL points to should be 468x60 pixels.
If enabled, you will have to wait for your site to be approved by the admin. Once approved, it will then show on the list of sites.
User Panel
From the user panel you can edit your profile, edit your sites, get voting code, see stats for your sites, and delete them if you wish.
Voting Code
Once your site has been added to the Topsite, you will want to add the vote code to your site so that your users can vote. The more votes your site gets, the more other people will want to check it out. So you should put the code where it will be visible and clicked on the most.
From the User Panel, click the Voting Code link.
This will take you to a page with a few options.
Choose which vote link style you would like and copy the code.
Then past the code into the HTML of your site, wherever you would like the button to showup.
Then when one of your users clicks the link, they will be brought to the Topsite and thier vote will be recorded.
Individual IPs can only vote once per day, so your users won't need to vote more than that.
C) F.A.Q. - top
Q. How often can you vote?
A. Once per IP per day.
Q. How often do votes reset?
A. This is controled by when the admin sets the cronjob to run.
Q. What size banner should I use for my site?
A. The banners for your sites should be 468x60 pixels.
Q. How many sites can I add?
A. Users can add an unlimited number of sites, but make sure they are all high quality or they probably won't be approved.
Q. I just added my site, but it isn't show up, how come?
A. The admin needs to approve it, once they do you will receive an email letting you know.
Q. Do votes still count while my site is waiting approval?
A. Yes, if you just added your site and it isn't approved yet, all votes it receives will still be counted.
Q. I made a mistake when I added my site, can I edit it?
A. Yes, go to your user panel and click the Edit Site link, you will be able to change any information about your site.
D) Sources and Credits - top
I've used the following images, icons or other files as listed.
Once again, thank you so much for purchasing this script. As I said at the beginning, I'd be glad to help you if you have any questions relating to this theme. No guarantees, but I'll do my best to assist. If you have a more general question relating to the scripts on CodeCanyon, you might consider visiting the forums and asking your question in the "Item Discussion" section.
Tyler Pesta
Go To Table of Contents