Easy Banner Free - 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 onto your server.
Set permission (chmod) of the data directory to 777
Run setup.php. It installs the table we will need and creates some files.
Go to the admin area (both username and password are 'admin') and set all variables.
Now you can start to use the script. New users may join by going to '
join.php', existing users can edit their accounts and see statistic at 'member.php'. Each new user must be enabled by admin. Until the user is not enabled, his/her banners are not shown.

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.

Below is a short description of each template and list of used variables.

To show the page where a new user can join your newsletter is used template 'join.html'. These variables may be used:

#%bwidth%#

Width of banners in your exchange system

#%bheight%#

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

#%userid%#

Username of the new user

#%userpass%#

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 gets 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

#%userid%#

Username of the new user

#%userpass%#

Password of the new user

#%siteurl%#

URL of the new user

#%urlbanner%#

Banner of banner of the new user

Also you as site admin get 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

#%userid%#

Username of the new user

#%userpass%#

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 members can log in at 'member.php'. To show the login form is used template 'member_login.html'. This template has no variables. After the user is logged in, he/she can select from 3 functions. To show that page is used template 'member_action.html'. These variables are used:

#%userid%#

Username of the user

#%userpass%#

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

#%userid%#

Username of the user

#%userpass%#

Password of the user

#%siteurl%#

URL of the user

#%urlbanner%#

Banner URL of the user

#%email%#

Email of the user

If the member selects 'Show HTML code', a page based on template 'member_html.txt' is displayed. There is one variable only: #%html%# - it's the HTML code to place on pages of the new user to get credits

If the member selects 'Show statistic', a page based on template 'member_stats.html' is displayed. These variables may be used:

#%userid%#

Username of the user

#%userpass%#

Password of the user

#%meshows%#

Number of banners displayed by the user

#%earned%#

Earned credits

#%weshow%#

Number of banners displayed for the user

#%notused%#

Not used credits