Installation and configuration guide for Sitemagic CMS
Here you will find the requirements for Sitemagic CMS, and a step-by-step guide explaining the configuration of the solution. Free help is available in our
forum, should you run into obstacles.
Requirements
On the server PHP 5.2 is required. The administration section requires Firefox, Safari or Internet Explorer 7 or newer. MySQL Server 5 is required for Sitemagic CMS Enterprise.
Installation guide
Download
Go to the
download section and get the most recent version of Sitemagic CMS. Extract the ZIP-file in a folder on the hard drive.
Configure username and password
Open the file config.xml.php in a text editor like Notepad for Windows. The file consist of so called XML. Find the following two lines:
<entry key="Username" value="admin" />
<entry key="Password" value="secretpassword" />
Enter the prefered username between the quotation marks after value in the first line (where it reads admin), and the prefered password between the quotation marks after value in the second line (where it reads secretpassword). The rest of the configuration elements are explained in the end of this document.
Transfer files to web hotel
Transfer all the files to the web hotel using a FTP program (for instance the free program
FileZilla). Assigh the system full access to the folders "data" and "files", and all subfolders and files in these folders. This is done by right clicking the folders, click Permissions, and here specify the access level.
The access level may differ, depending on the server set up. Folders can be assigned Read/Write/Execute for both owner, group and others (numeric value 777), which equals full access for anyone. This could potentially give other users on the server access to modify the content. Therefore, ask the provider of the web hotel, which access level to use for your specific set up.
Congratulations, you have now installed Sitemagic CMS, and can log in by visiting the web hotel using a program like Internet Explorer, Firefox or Safari. Notice: Sitemagic CMS uses pop-up windows to name elements, select links and much more. Deactivate pop-up blocks, or register the domain, on which Sitemagic CMS is installed, as safe/trusted/approved, to avoid annoying warnings about blocked windows.
More configuration for Sitemagic CMS
The basic configuration for Sitemagic CMS is found in the file config.xml.php, in which we modified the username and password earlier on. Open this file again in a text editor, and adjust the different values according to your needs (or use the default values). Each setting is explained in details below.
| Username |
Specify username for administration section. |
| Password |
Specify password for administration section.
|
| Language |
Specify language to use. The administration section is displayed in this language, as well as the Gallery extension and Contact form is displayed in the language specified. The default installation contains language packages for Danish (da) and English (en). |
| Languages |
List containing available language packages in the system. If a new language package is installed, it must be added to this list, in order to be able to select it when logging in to the administration section. |
| TemplatePublic |
Specify the template to use for the website. Available templates are found in the "templates" folder. |
| TemplateAdmin |
Specify the template to use for the administration section. Available templates are found in the "templates" folder. This value is typically the same as the value in TemplatePublic.
|
| AllowTemplateOverride |
Specify True to allow template to be overridden using the URL. This is useful when testing templates, or to create skin support. The prefered template may be specified using the following URL parameters:
SMTpl=MyTemplate (change template for both ordinary website and administration section)
SMTplPublic=MyTemplate (change template for ordinary website only)
SMTplAdmin=MyTemplate (change template for administration section only)
The specified template is used and remembered until the browser is restarted. |
| DefaultExtension |
Specify the extension to executed by default, if no other extension has been selected. It is recommended to keep the value SMPages. |
| ImageTheme |
Specify the prefered image package to use. This determines the look and feel of buttons. Available image packages are found in the "images" folder.
|
| LicenseKey |
Specify license key if such has been purchased. The Sitemagic name is displayed in the browser's title, if no license has been entered. Read more about the small text advert and license key.
|
| DatabaseConnection |
Specify database information, if Sitemagic CMS Enterprise is being used, which runs on top of the lightning fast MySQL database. Format is: server;database;username;password |
Installing templates
A new template is simply installed into the "templates" folder under the Sitemagic CMS installation. Afterwards the file config.xml.php is opened, and the name of the new template is specified in the following lines (notice that the values between the quotation marks after value might differ).
<entry key="TemplatePublic" value="Sitemagic" />
<entry key="TemplateAdmin" value="Sitemagic" />
Replace the value Sitemagic with the name of the folder, containing the new template.
Installing extensions
Copy the new extension to the "extensions" folder in Sitemagic CMS. Depending on the type of extension, it will typically be available from the administration section, if it creates a link in the menu. Some extension might also require database tables to be set up, which is primarily the case for extensions for Sitemagic CMS Enterprise. See additional installation instructions that comes with the specific extension.