This is a work in progress. If you have a question that you think would benefit others using YaBook, please add it to the comments and we will address it in this FAQ.
What would make this unique or different from any other guestbook ?
Here are just some points that make YaBook somehow different:
- easiest installation ever! There is not even an install script. Also, there will never be any upgrade script required to run manually. YaBook auto-detects a new installation and performs incremental upgrades if required.
- full PHP 5 support. YaBook is written for PHP 5. This is especially due to the framework Sourdough which is the base of YaBook.
- easy customizable with templates. In the future there will be a whole bunch of skins available. Also, you can embed YaBook easy into another site design without changing a lot.
- Administration is neatly integrated, this means the administrator does not need to click through tons of admin pages, he always finds the actions he needs to perform right next to the guestbook entries.
- similarity with its "sister" Pigalle (image gallery): If someone is using both he will notice the same concept, the same way of templating and the same great customizability.
- secure design. Only allows BBcode styled tags, URL hiding of submitted URL to prevent searchengines from grabbing, email obfuscation
- possible admin approval of new guestbook entries
- multi language support
- supports multiple DBS: MySQL (including the new mysqli extension), PostgreSQL, SQLite. Soon there will be support for MSSQL and maybe Sybase, InterBase, Frontbase.
- Anti-flood spambot protection by Captcha image verification.
How do I run YaBook with a file extension different to .php (e.g. .php5) ?
As YaBook is designed to easy run with different file extensions, this is a pretty simple task. You should make sure, though, that you are running YaBook 0.98-alpha or newer version, as extension handling was a bit messy in earlier versions.
Rename all your file extensions (according to the FAQ entries below) and set the new extension in phpext.inc:
// Change this if you are using a PHP file extension different to 'php':
How do I rename my file extensions (Linux/Unix) ?
On a Unix system, use the file renaming script provided with Sourdough, which can be found in sourdough/resources/scripts/extrename.pl. Enter the YaBook root directory and execute it from there. This small Perl-script is preconfigured to change .php extensions to .php5. Open it and change its configuration, if required.
$> cd yabook/
$> cp private/lib/sourdough/resources/scripts/extrename.pl .
$> chmod u+x extrename.pl
We have now renamed all files to the new extension. The script didn't rename any thirdparty files included in the Sourdough framework, but you don't need to worry about this.
How do I rename my file extensions (Windows) ?
Sourdough provides you with a batch script to rename your file extensions. It can be found in sourdough/resources/scripts/extrename.bat and uses forfiles.exe.
Before applying the script to your files, please temporarely move away the thirdparty directory from your file structure as those files should keep their .php extension. Move private/lib/sourdough/thirdparty to e.g. C:\Temp.
Now copy the script to your YaBook root directory and execute it:
> CD yabook/
> COPY private/lib/sourdough/resources/scripts/extrename.bat .
> COPY private/lib/sourdough/resources/scripts/forfiles.exe .
> EXTRENAME.BAT php php5
The sample above shows you how to rename all .php extensions to .php5. Change the command parameters according to your needs.
After the script has renamed everything, move back your thirdparty directory from C:\Temp to the original location private/lib/sourdough/thirdparty. If you know any better way of excluding the thirdparty directory from file renaming in the extrename.bat script, please let me know and post it to the [sourdough-devel] mailing-list.