Easy Banner - Manual
Copyright
Notice
This script is a freeware.
You may distribute it by any way BUT you may not modify it!
Installation
Upload
all files to your server.
Set permission (chmod) of the data directory
to 777
Run setup.php. It installs
the table which we will need and creates some files.
Go to the admin area
(both username and password are "admin1"), to "configuration"
and enter a value to each field.
Now you can start to use the script. New
users may join by going to index.php,
existing users can edit their accounts and see statistic at member.php.
Each new user must be approved by admin. Until the user is not enabled, his/her
banners are not displayed.
Customization
All
public pages are based on templates. These are a common HTML pages editable
in your favorite editor with some special tags which will be replaced by any
value by the scripts. These tags look like #%someword%#. If you don't want some
of these values to be available, just remove them from your templates. All the
templates may be found in the data/templates directory. On the top of each
public page is added content of file _header.txt, on the bottom is added content
of file _footer.txt. Both these files may be found in the templates directory
as well.
Below is a short description of each template and list of used
variables.
To show the page where a new user can join your banner exchange
is used template join.html. These variables may be used:
#%width%# |
Width of banners in your exchange system |
#%height%# |
Height of banners in your exchange system |
To show a "thank you" page is used template join_success.html. Used variables:
#%memberfile%# |
URL of where existing users can log in |
#%username%# |
Username of the new user |
#%password%# |
Password of the new user |
#%email%# |
Email of the new user |
#%siteurl%# |
URL of the new user |
#%banner%# |
Banner of the new user |
#%html%# |
HTML code to place on pages of the new user to get credits |
Now the new user receives an email. This email is based on template email_join.txt.
The first line of this template must begin to the word 'Subject:' and below
this line must be one blank line. Used variables:
#%memberfile%# |
URL of where existing users can log in |
#%username%# |
Username of the new user |
#%password%# |
Password of the new user |
#%siteurl%# |
URL of the new user |
#%urlbanner%# |
Banner of banner of the new user |
Also admin now receives an
email. This email is based on template email_admin.txt.
The first line of this template must begin to the word 'Subject:' and below
this line must be one blank line. Used variables:
#%adminfile%# |
URL of where you can log in as admin |
#%username%# |
Username of the new user |
#%password%# |
Password of the new user |
#%siteurl%# |
URL of the new user |
#%urlbanner%# |
Banner URL of the new user |
#%memberemail%# |
Email of the new user |
Existing users can log in at
member.php.
To show the login form is used template member_login.html. This template
doesn't have variables. After the user is logged in, he/she can select from 3 functions.
To show this page is used template member_action.html. These variables
are available:
#%username%# |
Username of the user |
#%password%# |
Password of the user |
If the member selects "Edit account",
a page based on template member_edit.html is displayed. These variables
are used:
#%info%# |
Once the form is sent out and data are updated, it shows this info |
#%username%# |
Username of the user |
#%password%# |
Password of the user |
#%siteurl%# |
URL of the user |
#%urlbanner%# |
Banner URL of the user |
#%email%# |
Email of the user |
If the member selects "Display HTML
code", a page based on template member_html.txt is displayed. There variables
are available:
#%html%# |
The HTML code to place on pages of the user |
#%username%# |
Username of the user |
#%password%# |
Password of the user |
If the member selects
"Statistic", a page based on template member_stats.html is displayed.
These variables may be used:
#%username%# |
Username of the user |
#%password%# |
Password of the user |
#%i_m%# |
Number of banners displayed by the user |
#%i_earned%# |
Earned credits |
#%i_w%# |
Number of banners displayed for the user |
#%i_nu%# |
Not used credits |