Installation Guide (Slovencina)

From toendaCMS Wiki

Back to documentation

{{translateme}}

@all: this is a stupid translation from the german version of this document. I just translated. I didn't have a fresh installation at hand to verify what I wrote. Don't mind to check, correct or delete this whole thing. Hate to say this, but sorry for my bad english. Noehrgel

Requirements

The following requirements must be met.

• round about 15 MB free webspace
• PHP (version 4 or 5) with GD, mbstring and zlib modules activated. Register_Globals should be deactivated for security reasons.
• optional: a sql database (mysql is supported natively)

This content managment system is build with to different concepts of data storage in mind:

• using XML flatfiles. This just requires a webserver with PHP enabled and webspace. No database is needed at all. For small to medium size projects this is the appropriate choice.
• using a SQL database. A database like MySQL is needed. This storage concept is mainly useful for high traffic pages with lots of content.

At the moment there is no way to change from one mode of data storage to the other, ie. if you want to change from XML to database you'll have to copy paste all your data already in the database. A future release will have a import/export module for easily convert from one style to the other.

Installation

Download the current version from the toendaCMS webpage[1] and unzip the file. The unzipped files including all subdirectories must be uploaded to your server (for examples we'll use www.my-domain.org/cms).

Afterwards you'll have to check some file and directory permissions and eventually adjust them. The directories data/, cache/, tmp/ and engine/admin/sessions/ and all files inside need full read and write access for the webserver process. In almost all cases this means full access to these files, ie. use chmod 0777 to set the permissions of all files and directories inside data/. If you want to modify, extend or remove existing themes you although have to set permissions of the theme/ directory as stated above.

If all this has happened you're ready to start the toendaCMS installation routines by opening http://www.my-domain.org/cms in your favorite browser. If you've successfully set file and directory permissions you'll be welcomed by this screen:

(include missing picture)

The actual configuration can then be started using the "go to installation" button.

We'll show you the way through the seven included steps in the following. It is always a good thing to provide correct and meaningful data. Otherwise you'll be left alone with a disfunctional system.

Right now you've the choice between installation in german or english. After you've made your decision the system will do some testing if you've set up the file and directory permissions correct.

The results of all these tests will be shown in the next step. All test should pass! A small exception might be register_globals. It should be set to OFF, but if not, toendaCMS will work anyway. It's a security topic, which in most cases is out of your scope as is set by your webspace provider (it's a PHP parameter). If one of the other tests did not pass this means permissions aren't set to the right values. Correct this, now. Otherwise you won't be able to install, configure and use toendaCMS.

In the next step you'll have to accept the toendaCMS license. Read it carefully and if you've understood what this is all about, accept it. If you do not accept it, remove toendaCMS from you system immediatly.

The following step is used to determine which storage concept should be used. The part concerning about updating a installation is not important for a fresh installation and can savely be ignored.

The next step is needed for setting all parameter for databases. If you've selected XML storage this step will be automatically be passed by without user interaction. You have to make sure all the settings of this dialog are correct. If not you'll fail, as toendaCMS will not be able to access the database. If you're new to toendaCMS you should select to install demodata, for this is a good starting point to check out all the features.

The next step button will bring you to some general settings. Just one point should be mentioned here. It's important you set the right URL in here. This is important for some routines to work properly. In our example we would set it to "http://www.my-domain.org/cms/".

The second last step is about setting the site admin. You should use a secure password, ie. as many characters as possible and no plain words from the dictionary. Everyone knowing this password is able to gain full access to your toendaCMS installation (including modifying and deleting your data).

You've almost made it. Just have an eye on warnings and errors, that shouldn't be there of course if you've done everything correct. The system should be fully functional at this point and ready for your content.

There are two choices, first using the "administration" button to get to the backend login screen (used for the actual content managment and site configuration). Second the "starting page" link, that should show the newly created page. It doesn't as one last thing has to be done. The setup directory has to be deleted as using these routines everyone could destroy your installation. If you have done this, you'll be welcomed to your new system.

Congratulations! You are ready to use toendaCMS.

For further information about site administration follow this link.

This is everything to be said about installation. Comments and questions are welcome any time. Don't hesitate to give feedback. We're always happy if you do so! You're going to help other users, too.

Have fun using toendaCMS,

your toendaCMS crew