Engine Configuration

The configuration of the engine and it's Controllers happens mostly through .ini configuration files.

Voodoo Configuration files

The engine comes with two separate configuration files. The first one, the engine.ini is the file that has your database settings in them. You can read more on the database configuration on the Installation wiki.

The other configuration file is of your main interest for customizing your project. The file is called voodoo.ini. There are a few different sections within this file. The first one is related to the site itself.

The Engine section

[engine]
site.setup = Complete ; Off or Complete
site.formatter = Wiki_WikiFormatter
site.theme = dalines.org ; Off means use default
site.style = dalines.org.css
site.title = "dalines.org"
site.startpage = news

The first part is usually only changed once. The package of the engine has it set to Off. When it is Off it means the site is not yet available and the initial setup is not completed. Please check the Installation Guide for more information on the initial setup of your project.

The formatter is related to the formatting object for Wiki pages. The default formatter is the one that comes with the Wiki controller and has these Formatting options. You can change this to another object from your own Controller in case you have implemented your own Formatting.

Theme and Style are regarding the layout of your project. Themes are usually stored in /themes. You can create a directory here with the name of your site's theme. You will have to create a file with your theme name followed by .html for your global site layout setup. For more on templating, see the Templating wiki. The Style should be a .css file that contains the style of your site. In the example above it uses the dalines.org theme and it's style.

The Title entry is pretty straight forward and is related to the Title in the Title bar of your browser.

The final entry of this section is related to which part of the site should be shown when the user first opens the page. This can be a Controller alias or even a specific wiki page such as wiki/WikiStart. In the example above the News Controller is shown on initial page load.

The Template section

The second section is the template section and is related to the Templating engine you want to use for your project.

[template]
engine = SimpleTemplate
location = "../classes/"
template_path = ""

It defaults to the SimpleTemplate engine that comes with the project. However you should be able to use different templating engines such as Smarty.

Menu configuration

The menu can be configured easily in the menu section of the voodoo configuration file. The setup of the menu is as follows link/to/page = Menu Item Name. So for example, if you want to add a login link to the menu you can add auth = Login as an entry in the menu section.

[menu]
auth = Login
auth/logout = Logout
wiki/WikiStart = "Home Page"

However, you might not always want all menu items to show for everyone (logged in or not) all the times. For this you can use the menu.privileges section in the config file. This works in the same manner as all the other privilege sections in configuration files. For more information see the Privileges wiki page.

[menu.privileges]
menu.auth = Anonymous,
menu.auth/logout = Member

Controller Configuration files

The default configuration files are found in the controllers subdirectory called /conf.