Wiclear

You are here :

!Presentation
This is the central room to configure the behaviour of Wiclear.

((admin_preferences.png|Admin preferences||Admin preferences|400|400))

!Basic configuration
You will find here most of the configuration option that were asked to you during install. Things like database name, login and password, Wiki name or reply-to email address.

!Basic rights
This is here you will be able to change some basic rights
* allow anonymous edition
* allow anonymous comments
* allow open registration
* login timeout (max number of second the login form is valid)

!Editing conf
This is here you will change some editing behaviour
* force preview
* allow html tags
* max number of characters in links

!Theme
This is here you will choose the theme to use.
Currently, Wiclear is shipped with 3 themes
* default (no style) which is used right after a successfull installation and displays raw text
* blue, which is the original style : blue with rounded boxes
* dokuwiki, which was inspired by dokuwiki for clarity and elegance

There is another theme named dokuwiki_blog which is just a variation of the dokuwiki theme and enables the wiki_blog plugin. It transforms your wiki into a blog.

!Url style
Wiclear supports 4 different url styles :
* get
* path_info
* query_string
* path_info_mod_rewrite

The "get" format means all parameters to each pages are passed using the form &variable=value.
Example : http://localhost/wiclear/index.php?title=test&lang=en

The "path_info" format means page's link can be accessed with the '/' separator : http://localhost/wiclear/index.php/en/test%%%
As it is not possible to use this style of url for each pages, url style will revert to "get" for other operations.

The "query_string" mode replaces the first 'index.php/' with only '?' as in http://localhost/wiclear/?en/test
As the path_info format, for more complicated url, we revert to "get" format.

"path_info_mod_rewrite" is a variation around the "path_info" format. For it to works, you need help from the apache web server. The idea is to generate some url that the web server will transform on the fly so that the right page is served (this is called mod_rewrite). You will need a configuration file named .htaccess that will describe the kind of transformation apache will need to apply to transform those friendly url into apache understandable url.
Generated urls can be of the form : http://localhost/wiclear/en/test%%%
As you see this is even better than the "query_string" format.%%%
To put in place the .htaccess file, you have two choices :
* either you hand generate it, or
* you ask Wiclear to do it for you. This is experimental and may not work, but this is a good start if you want to fine tune it by hand thereafter.

!Other fields
The last remaining fields are path related configuration fields :
* server path : this is where you have installed wiclear
* application path : this is the name of the file used to serve Wiclear. This option is provided if you want to rename it in conjunction with path_info for example
* application path when using mod_rewrite : if the generated .htaccess doesn't suit your need and you want to generate different urls, then this is here you will change the application path in this mode
* Image relative path : this is where you will put uploaded files (not just images in fact)
* Icon relative path : this is where you will put icons used by Wiclear such as lang flags, icons for uploaded files browser, ...