CMSimple.ORG

Valid HTML 4.01 Transitional

Dichos y Refranes Escribir al Reves

CMSimple.ORG > Installer's Manual > The configuration

The configuration

The settings for the CMSimple installation can be set in the file ./CMSimple/config.php or by using the "Edit configuration" form which is found under the menu item "SETTINGS" (only visible when logged in).

The settings names refer to variable names in the config.php, ie. security_password is same as $cf['security']['password']

Explanation of the variables

$cf['security']['password']="test";
This is the login password, default set to "test". If you change it, when you are logged in, you need to log in again using the new password. If your browser's cache is turned on, you may need to empty the browser's cookie cache.

$cf['security']['type']="page"; (Only available from version 2.8 - replaces the $cf['security']['wwwaut'])

There are 3 options for security type:
1: page - gives a login page (default)
2: javascript - gives a javascript login prompt
3: wwwaut - gives an WWW-Authenticate prompt - do not use this, unless you know, what you are doing.

In all instances, the login process is started by adding &login to the URL and hitting ENTER.

Please note:
To make it easier to upgrade from previous version of CMSimple to version 2.8 and higher this variable is defined in cms.php if it is not set in config.php. This may not be the case in later versions of CMSimple, so please update it in your configuration file.

$cf['security']['username']="admin"; (Optional and not included by default from version 2.8)
The username is only used for security type wwwaut - if not set, the default username defined in login.php is admin

$cf['site']['title']="The name of the site";
Used for the title bar and for some templates as part of the top logo. 

$cf['site']['template']="default";
The chosen design template - see Changing the layout

$cf['language']['default']="en";
The language for the main site.

$cf['meta']['keywords']="CMSimple, Content Management System, php";
Keywords for Search Engine Optimization.

$cf['meta']['description']="CMSimple is a simple content management system for smart maintainance of small commercial or private sites. It is simple - small - smart! It is Free Software licensed under AGPL";
Description of the site - used by some search engines.

$cf['backup']['numberoffiles']="5";
The number of old content files to be stored in the ./content folder as back-up. Please note, that backup is only activated, when you hit "LOGOUT" in the edit menu.

$cf['images']['maxsize']="150000";
The maximal size of images allowed to be uploaded by the upload function under "IMAGES" (only admin). Specified in bytes - the default setting equals to 150 KB.

$cf['downloads']['maxsize']="1000000";
The maximal size of files allowed to be uploaded by the upload function under "DOWNLOADS" (only admin). Specified in bytes - the default setting equals to almost 1 MB. Server restrictions may also apply - both in php.ini and in Apache setttings (more info).

$cf['mailform']['email']="";
If this is set, the mailform will be set active. A few webhotels do not allow mailing through PHP.

$cf['guestbook']['maxlength']="";  (Not used anymore from version 2.8)

$cf['editor']['height']="(screen.availHeight)-400";
The height of the inbuild WYSIWYG editor (OEdit) specified in javascript as the height of the browser window minus 400px.

$cf['editor']['external']="";
If you want to use an external editor, it must be specified here - read more here.

$cf['menu']['color']="000000";
If you use the images for the Table of Contens stored in the file /cmsimple/images.php you can set the color of the icons by a HEX value here. The 'default' template in CMSimple distribution uses this feature. (In stylesheet, look for url(../../index.php?image=doc))

$cf['menu']['highlightcolor']="808080";
Same as above - this is the color for the icon for the selected page.

$cf['menu']['levels']="3"; (Only available from version 2.8)
The heading levels to split into seperate pages. CMSimple was created to only split into 3 levels, and normaly this is also the most recommendable. Making a deep tree structure may not be good usability. If you change from 3 to 4, you will have to replace all your H4 headings used for internal headings to some other heading formating. Additional H-buttons for build in editor can be added under editor_buttons in language configuration.

Please note:
To make it easier to upgrade from previous version of CMSimple to version 2.8 and higher this variable is defined in cms.php if it is not set in config.php. This may not be the case in later versions of CMSimple, so please update it in your configuration file.


$cf['menu']['levelcatch']="10"; (Only available from version 2.8)
If you have ie. an H3 page is following an H1 page, it will be hidden from navigation in CMSimple (TOC, submenu), only available in next/pevious page and search result, unless this variable is set. If you keep your counting right, you can set it to 0.

Please note:
To make it easier to upgrade from previous version of CMSimple to version 2.8 and higher this variable is defined in cms.php if it is not set in config.php. This may not be the case in later versions of CMSimple, so please update it in your configuration file.


$cf['menu']['sdoc']=""; (Only available from version 2.8)
Can be set to parent if you want the ancestor headlines get the stylesheet class sdoc/sdocs instead of the normal doc/docs.

$cf['uri']['seperator']=":";
The character used for seperate page names in URL.

$cf['uri']['length']="200";
The length of the URI to match - this is set to make it easier to get hold of a page, if you by mistake format the entire contents of a page to a heading.

$cf['xhtml']['endtags']="";
Set to true if you want endtags in CMSimple generated output.
This is NOT applied to the contents generated in editor.

$cf['xhtml']['amp']="true";
Set to true if you want &s in CMSimple generated output to be written as & - ie. in URLs.
This is NOT applied to the contents generated in editor.

$cf['plugins']['folder']="";
To activate an add-on or plugin loader you must specify the plugins folder, normally with the value plugins

$cf['functions']['file']="functions.php";  (Only available from version 2.8)
Backward compatibility for DHTML menus (from before version 2.8) and functions geturl, geturlwp, autogallery and newsbox.
This can variable may be set empty or/and file be deleted for optimization, if none of these functions are used.  

$cf['scripting']['regexp']="\#CMSimple (.*?)\#";
The regular expression used for CMSimple Scripting.

Please note:
To make it easier to upgrade from previous version of CMSimple to version 2.8 and higher this variable is defined in cms.php if it is not set in config.php. This may not be the case in later versions of CMSimple, so please update it in your configuration file.

This is how the configuration form looks like:

Image