Overview
CONTENIDOs filesystem structure seems a bit overwhelming for the novice developer but follows a quite straight forward scheme. This article describes this scheme and should help to find the files you're looking for.
IMPORTANT: The location of many folders can be configured to suite your needs. This can be achieved by editing several configuration files (TODO exlpain which). This article assumes that all folders have their default locations!
When installing CONTENIDO you have to define where to install it. On a usual *nix box running no other sites this is probably /var/www. Lets assume this folder as ROOT.
After a successfull installation you will find some folders in ROOT which I like to explain first:
| name | required | description |
|---|---|---|
ROOT/cms/ | yes | This folder is often called frontend or client folder. All files contained in this folder are related to a single client. |
ROOT/contenido/ | yes | The CONTENIDO backend is located in this folder. |
ROOT/data/ | yes | Configuration files and other stuff is located in the data folder. |
ROOT/docs/ | no | This folder contains some documentation files. It could be deleted when read. |
ROOT/setup/ | no | The setup folder should be deleted immediatly after a successfull installation. |
ROOT/test/ | no | Could be deleted when you're not interested in developing and testing the CONTENIDO core. |
Frontend
The frontend or client folder contains files which are related to exclusivly a single client. When creating additional clients you will have several of these frontend folders. The default client is named cms, but can be renamed to an arbitrary name, as long as it does not collide with existing folders in ROOT.
| name | description |
|---|---|
ROOT/cms/cache | Contains cached images, style sheets and JavaScript files. Images that are scaled using CONTENIDOs image functions (TODO include link to article describing image functions) are stored in this folder using a hash as name. Module specific style sheets and JavaScripts that are used for a template are merged to a single file each and stored using the templates name. |
ROOT/cms/cache/code | This folder contains the code cache (TODO add link describing the code cache functionality). When displaying an article in frontend, the PHP code of all its modules is merged into a single file, that is stored in this folder. TODO describe the naming conventions for these files. |
ROOT/cms/cache/templates_c | When using the Smarty plugin, templates are usually precompiled and stored in this folder. |
ROOT/cms/css | When developing a layout, its style sheets are often outsourced (which is really a good idea!) and should be located in this folder. |
ROOT/cms/data | |
ROOT/cms/images | |
ROOT/cms/includes | |
ROOT/cms/js | When developing a layout, its JavaScripts are often outsourced (which is really a good idea!) and should be located in this folder. |
ROOT/cms/templates | |
ROOT/cms/upload | |
ROOT/cms/xml |
Backend
Data
On this page you get an overview of the single directories in CONTENIDO.
This page is not complete yet.
This page does not contain all information.