You are here: start » installation

Installation

General Steps

CMSimple_XH

In the unzipped download you should find a folder “CMSimple_XH_*” or “cmsimplexh*” depending of the version of CMSimple_XH. This folder contains all files and folders that have to be uploaded to the internet server:

  • 2lang/ 1)
  • 2site/ (CMSimple_XH 1.5.x) 2)
  • cmsimple/
  • content/
  • core/ (CMSimple_XH >= 1.6.1)
  • css/ (CMSimple_XH < 1.6.1)
  • downloads/ (CMSimple_XH < 1.6)
  • FCKeditor/ (CMSimple_XH < 1.5)
  • images/ (CMSimple_XH < 1.6)
  • javascript/ (CMSimple_XH 1.6)
  • plugins/
  • templates/
  • userfiles/ (CMSimple_XH ≥ 1.4)
  • changelog_cmsimple.txt (CMSimple_XH < 1.5)
  • index.php
  • player.swf (CMSimple_XH < 1.4)
  • readme.php (CMSimple_XH 1.5.2 + 1.5.3)
  • readme.txt (CMSimple_XH < 1.5.2)
  • robots.txt (CMSimple_XH 1.5 and 1.5.1)

Typically you'll want to install CMSimple_XH directly in the web root (i.e. the root directory of your domain). If you plan to install it in a subfolder, create this folder on your internet server first. It is recommended to avoid special characters for the folder names (i.e. use only roman letters (a-z, A-Z), arabic digits (0-9), underscores and hyphens).

For CMSimple_XH < 1.5.7: The path of the CMSimple_XH installation folder must not contain any folder with exactly 2 letters, as folders named with 2 letters will be recognized as additional languages in multi language sites.

Upload all files and folders from the unzipped CMSimple_XH download to the chosen folder on your internet server. The folders 2lang/ and 2site/ are templates for second languages resp. subsites. If you don't need a multilingual website or additional subsites, you don't have to upload these folders.

The following folders have to be given writing permissions:

  • cmsimple/languages/ (CMSimple_XH >= 1.5)
  • content/
  • content/LANGCODE/ (CMSimple_XH >= 1.6)
  • core/css/ (CMSimple_XH >= 1.6.1)
  • css/ (CMSimple_XH 1.6)
  • downloads/ (CMSimple_XH < 1.6)
  • images/ (CMSimple_XH < 1.6)
  • userfiles/ and all its subfolders (CMSimple_XH ≥ 1.4)

The following files have to be given writing permissions:

  • cmsimple/config.php
  • cmsimple/log.txt
  • cmsimple/languages/* (all files)
  • content/content.htm
  • content/pagedata.php (CMSimple_XH < 1.6)
  • content/LANGCODE/content.htm (CMSimple_XH >= 1.6)

If you want to edit your template online you have to give writing permissions to the following files:

  • templates/your_template/template.htm
  • templates/your_template/stylesheet.css

See the section plugins regarding writable files and folders of the plugins.

Directly accessing files in some folders should be denied. This is already done by the shipped .htaccess files for Apache web servers. For other servers you have to do this by any means the web server or hoster provides.

The following folders should be protected:

  • 2lang/content/ (not actually this folder, but all its copies)3)
  • 2site/content/ (ditto)4)
  • cmsimple/
  • content/

The following files should be protected:

  • templates/*/template.htm5)

That's it, CMSimple_XH is installed, now you can browse to the domain or folder, into which you installed CMSimple_XH and you will see the default contents of CMSimple_XH. There you can read about the login procedure.

After giving the necessary rights to some files and folders, you should right away adjust basic settings.

Since CMSimple_XH 1.5.4 a simple system check is avaible under Settings→Info. After installing and setting the file permissions, you should check, if everything is alright.

Multiple Installations

It is possible to have multiple installations of CMSimple_XH on the same domain by installing them in different subfolders. These installations are mostly indepent from each other, and may have different passwords, templates and plugins etc.

Note, however, that they are not completely indepent, and that it's possible to compromise other installations on the same domain by server side scripting. Furthermore there may be some glitches regarding some of the functionality, especially with some plugins.

Templates

CMSimple_XH templates are usually offered as zip files for downloading. Unzip the file with a suitable program. A CMSimple_XH template consists usually of a template.htm, a stylesheet.css and a folder “images”, which are stored in a folder with the name of the template. In the following lets assume the template is called “new_template”. In the folder “new_template” you should find some structure like:

  • images/
  • stylesheet.css
  • template.htm

Often there are further files and subfolders in the folder “new_template”, the above example just gives the minimum.

On your internet server you'll find a folder named “templates” in the CMSimple_XH installation folder. This folder contains a subfolder for every template. Now you simply have to upload the folder “new_template” (complete with all files and subfolders) from your computer into this folder.

If you want to edit your template online in CMSimple_XH, writing permissions have to be set for template.htm and stylesheet.css. To activate the template globally (i.e. for all pages), log in to CMSimple_XH and choose:

Settings ⇒ CMS (CMSimple_XH < 1.5: Settings ⇒ Edit configuration)

Here you find under “Site ⇒ Template” a selectbox listing all installed templates of your CMSimple_XH site. Choose your template here and scroll down to the bottom of the page and click the button “Save”. The chosen template is now active on all pages.

If you want to use a template only on a single page, you can do it with the plugin page_params.

Plugins

The plugin's documentation 6) should describe, which folders have to be copied entirely into the folder plugins/ in your CMSimple_XH installation. Some plugins need certain folders and files to be put into your CMSimple_XH installation outside of the folder plugins/. This should likewise be explained in the plugin's documentation.

Which files and folders require writing permissions should also be described in the documentation of the plugin.

Some plugins start functioning after successful installation right away, an example is the plugin Canonical Links. As soon as the plugin is uploaded, it will automatically create a canonical link in the head area of the HTML source code.

Most plugins however require the call of functions along with certain parameters in the place where you want the plugin to start working. This can be the content of a page or a place in the template. See the respective plugin's documentation for details.

1) , 2) The folders 2lang/ and 2site/ are templates for second languages resp. subsites; don't upload them directly.
3) , 4) CMSimple_XH < 1.6 only
5) a respective .htaccess is only shipped since CMSimple_XH 1.6.5
6) look for a file readme.txt or similar in the plugin's root folder; usually a user manual can be found in the sub-folder help/ as help.htm; sometimes the documentation is available on the plugin vendor's website only
 
You are here: start » installation
Except where otherwise noted, content on this wiki is licensed under the following license: GNU Free Documentation License 1.3
Valid XHTML 1.0 Valid CSS Driven by DokuWiki