dalines.org Engine Installation

This part of the EngineGuide is to help you through the installation and setup process of the dalines.org Engine. This Guide assumes you have a fair share of knowledge of PHP, Apache and MySQL.

Step One: Download Latest Release

Please refer to the EngineDownload page to get the latest release of the dalines.org Engine. Once you have downloaded the latest version, unpack it to a temporary directory.

Step Two: Initial Setup

In the temporary directory there are six subdirectories. In case you are setting the Engine up at a VirtualHost you can just copy all the six subdirectories to the location you desire and set the DocRoot in your VirtualHost directive to /your/desired/location/docroot. I recommend using this option.

In case you want the engine to run in a subdirectory of an already existing website/!VirtualHost, I recommend to copy only the content of the docroot subdirectory to the desired location and placing all the other directories outside of your docroot for security purposes.

For example, your VirtualHost of yourwebsite.com is located at /var/www/yourwebsite.com and you want to place your Project Voodoo instance at yourwebsite.com/DoE, you could place the other five subdirectories in /var/www/dalines.org.engine/. If you go for such a setup there are two files that need modification.

First of all the file voodoo.php in the /docroot subdirectory needs to be edited. There is a line require_once('../conf/const.php');. Change that to link to the right directory where your const.php is located.

Secondly, the /conf/const.php file needs a few changes. All the defines in that file that are references to directory locations need to be modified correctly.

Step Three: Database Creation

You need to create a MySQL database and a User with a Password that has SELECT,INSERT,UPDATE and DELETE privileges to that database. Once you have created the database you have to modify a few settings in /conf/engine.ini.

[database]
driver				= MySQL
server				= localhost
name				= ; Put your database name here
user				= ; Put the username here
password			= ; And the password should go here

Note: If your MySQL server is not on the webserver, please specify the hostname/ip in the server option.

Step Four: Project Setup

Once the above settings are updated you can connect to your Voodoo website. You will be redirected to http://your/url/setup/Init. This will show you all the SQL statements that you will need to execute to make the Voodoo pages work. I recommend copying the statements and manually inserting them into the database with a good tool (SQLYog) or just through the Command Line mysql interface.

Alternatively, there is an option in the Engines AdminController that enables you to execute setup queries for Controllers through the web interface. I suggest not to use this, unless you are absolutely sure of what all is gonna be executed. This is especially true if you use Third Party Controllers. To enable this option, refer to your /spellbook/Admin/conf/admin.ini file and change the insecure_sql_execution to On.

After you have execute those queries in one way or another, your Project site is ready for usage. Please goto http://your/url/setup/CreateAdmin. You should now add an Admin user to your project. Once you have created an Admin user, you can edit your /conf/voodoo.ini file and change the site.setup from Off to Complete.

Note: You can only create an Admin user in case the project does not have one already, or, if your user has admin.create privileges.

Your Project site is now ready.