![]() |
The installation allows you to set all of the options at first run. It will build the necessary config files and save them, or if they can not be written to by PHP, it will display the contents of the files for you to manually upload. Most of these settings can be changed temporarily in your PHP source.
Here you set the admin username and password (defaults to admin for the username and admin for the password). Optionally you can set the admin's avatar for use in news posts (more on avatars later). The avatar should be a valid URL.
The administrator has protected access in the control panel so no one but yourself can edit the user.
This currently has one setting: the domain of the site on which you plan on using the script on.
The date format is written in PHP's date format form, the documentation of which can be found on php.net. "Display in pages" adds page navigation functionality to the bottom of the new entries, and, even if this is disabled, news items per page functions. "News items per page" should be a number specifying the maximum number of news entries the script should display on one page. If display in pages is disabled, this will be the cut off point.
The "display poll" option allows you to choose if you want the most recent poll, or if you want a random poll to be displayed. After you install BOAS, a 3rd option will be available, which is to display any one poll at a time. "Enable IP logging" helps preventing a single user from voting twice. Proxies and dynamic IP addresses will, of course, allow a bypass on this. Even with this disabled, the script will attempt to set a cookie to prevent multiple votes.
The gallery name is a value which must be used within the template in order to be seen. This designates the name of the gallery. You can also set the gallery description, which, like gallery name, requires for it to be used within the template. Watermark images allows you to provide a PNG file which it will apply over all uploaded images. This is done upon upload so updating your watermark information will not affect already uploaded files. Watermark position is set by the 9 buttons located below the disabled box. Click on the button representing the area on the image in which you would like the watermark to appear (assuming you have it enabled). Image type allows you to select which of the two supported formats you would like to save to. If you choose JPG, the JPG quality is a number between 1 and 100 which it will save with. Don't go too low on the quality if you expect your images to be visible.
"Create thumbnail" allows the script to generate a second smaller image to, hopefully, save bandwidth. The max thumb dimensions is the maximum size in which a thumbnail can be, and setting one to 0 allows the thumbnail to be any size as long as it is in proportion with the other dimension. Watermark margins defines how much space there must be between the border and the edge of the watermark (if watermarking is enabled).
After clicking "install" you will be taken to a page where a bit of information appears about what has been done. If any of them fail you will have to figure out how to fix them before reinstalling (sometimes requiring for config.php to be deleted). If all of the steps complete successfully, then you can continue to the control panel (cp). However, before using the script you must include a few files in your PHP source.
If you are currently using .html files you will need to rename the one you want to use to a .php. This is so it is processed by the PHP interpreter. After doing so, open the file in a text editor and at the very top before the doctype, , or any other statement add:
<?php include "path/to/BOAS/init.php"; ?>
Replacing path/to/BOAS/ with the path relative to the file in which your BOAS installation is contained. Next where you wish to see you gallery, news, or poll add:
<?php include "path/to/BOAS/viewalbums.php"; //gallery ?>
Or:
<?php include "path/to/BOAS/viewnews.php"; //news ?>
Or:
<?php include "path/to/BOAS/viewpoll.php"; //poll ?>
Again replacing path/to/BOAS/ with the path relative to the file in which BOAS is contained. Save and upload and you should be ready to use the cp.