coWiki 0.3.4
Current user:   guest   Change Preferences
   List directory   Similar   Print version 
Diff: FAQ
 Legend:   Removed   Changed   Added 
 Ownership:  rw-rw-r-- iezzip users
 Modified:  26 Apr 04, 13:33
 Modified by:  Philip Iezzi (iezzip)
Rev.:  1 (Old)
 Ownership:  rw-rw-r-- iezzip users
 Modified:  07 Jan 06, 12:21
 Modified by:  Philip Iezzi (iezzip)
Rev.:  5 (Current)

+ YaBook FAQ - frequently asked questions
+ YaBook FAQ - frequently asked questions

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.



++ YaBook User

+++ 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.
* etc.


+++ 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 **:

// Change this if you are using a PHP file extension different to 'php':
define('YABO_PHPEXT', 'php5');

That's it!


+++ How do I rename my file extensions (Linux/Unix) ?

On a Unix system, use the file renaming script provided with ((, which can be found in *sourdough/resources/scripts/*. 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/ .
$> chmod u+x
$> ./

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) ?

(( 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.


++ Developer


Home | Pigalle | YaBook | PPhlogger | Sourdough | RSS 1.0 | GEO URL

Driven by coWiki 0.3.4 (Boron) web collaboration tool.