released on 14 August 2002, has been downloaded for 2235 times.
Please visit phpBanner ver 0.0.2 to get more information.
phpBanner ver 0.0.1 Documentation
General Information
Please read the INSTALL file for installation instructions.
This phpBanner using phpMember ver 0.0.1 to provide client membership and phpFile ver 0.0.1 to provide banner image file management.
phpBanner is split into three parts:
- Admin interface, accessible through http://<yourdomain>/<PathToPhpBanner>/admin/
- Clients interface, accessible through http://<yourdomain>/<PathToPhpBanner>/
- A backend, which handles banner inclusion.
The Admin Interface
Through this web based control center, you can manage your clients and banners.
The Client Interface
Your clients can administer their own banner easily through this web based interface.
The Backend
You display banners in your web site pages by inserting a code fragment below into a PHP3-powered page. On every page you want to display banners, you have to include config.php3 and banner.php3. These files are in your phpBanner-require-installation-directory. Banner appearance performed using the get_banner()-function. This function has the following syntax
array get_banner(string key, mixed value);
There are three available key-parameter:
- key-parameter "client", the value-parameter is your client_id which you can obtain through admin-client interface.
- key-parameter "keyword", the value-parameter is banner keyword which you can define through admin-banner interface.
- key-parameter "size", the value-parameter is image size of the banner which you can see through link "Dir" at admin-client interface.
This function return an associative-array with two element which describe below.
- id, banner_id value.
- alt, banner image alt text.
See the usage example below :
<?
require("require/config.php3");
require("require/banner.php3");
?>
<html>
<head>
<title>phpBanner demo</title>
</head>
<body>
This is top banner<p>
<?
$banner=get_banner("keyword","new"); # get banner_id where keyword is "new"
?><p>
<a href="link.php3?banner_id=<?echo
$banner[id];?>">
<img border=0 src="view.php3?banner_id=<?echo
$banner[id];?>"
alt="<?echo
$banner[alt];?>">
</a>
This is middle banner<p>
<?
$banner=get_banner("client",1); #
get banner_id where client_id = 1
?><p>
<a href="link.php3?banner_id=<?echo $banner[id];?>">
<img border=0 src="view.php3?banner_id=<?echo
$banner[id];?>"
alt="<?echo
$banner[alt];?>">
</a>
This is bottom banner<p>
<?
$banner=get_banner("size","468x60"); # get banner_id
where image dimension is "468x60"
?><p>
<a href="link.php3?banner_id=<?echo $banner[id];?>">
<img border=0 src="view.php3?banner_id=<?echo
$banner[id];?>"
alt="<?echo
$banner[alt];?>">
</a>
</body>
</html>
You may call get_banner()-function as many as you want, it won't be return any similar banner_id. If you call get_banner()-function more then available active banner that you have then it will be display a default image which you can redefine at config.php3.
Every banner has reserved-hit and reserved-click; the banner will be displayed as many as the reserved-hit you define. So does the reserved-click work. The banner displays will be count, and if the counts exceed the reserved amount then the script will automatically set the banner-status to "disable". Remember that banner-status will set to "disable" only if both counts of hit and click were exceeded. You can make various banner prices based on combination reserved-hit and reserved-click. If you want to create banner based on single paramater hit or click set the other parameter to zero "0".
