Filesystem structure
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. Files are systemwide ressources.
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 | Smarty cache for templates that are used with the class cSmartyFrontend when using the Smarty plugin. Smarty usually precompiles its templates and stores them 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. This folder can have arbitrary subfolders. You can e.g. put all files for a single layout in its own folder. This folder should also be used to store any CSS framework (e.g. Blueprint et.al.) you might use. |
ROOT/cms/data | This folder contains client specific files that change on a regular basis. It contains no files on its own but has a set of subfolders which are described below. |
ROOT/cms/data/config | The config folder contains client specific configuration files. These are structured by defined environments as subfolders. By default there is just the production environment, but this can e.g. be extended by development, testing or staging. |
ROOT/cms/data/layouts | Layouts that can be created using the CONTENIDO backend are stored in this folder. They have each an own folder with a single HTML file, both having the same name as the layout. |
ROOT/cms/data/logs | This folder is used for client specific log files. TODO explain how to enable client specific logs. |
ROOT/cms/data/modules | This is probably one of the most important folders in each client folder. It contains the installed modules which have a folder structure on their own. |
ROOT/cms/data/version | When editing style sheets, JavaScripts, layouts, modules or templates in CONTENIDOs backend, their previous content is versioned and stored in this folder. |
ROOT/cms/images | When developing a layout, its images should be located in this folder. This folder even can have arbitrary subfolders. You can e.g. put all files for a single layout in its own folder. |
ROOT/cms/includes | When developing modules that share functions or classes these could be located in this folder, although it might be a good idea to create another folder classes for these. |
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. This folder can have arbitrary subfolders. You can e.g. put all files for a single layout in its own folder. This folder should also be used to store any JavaScript framework (e.g. jQuery, prototype et.al.) you might use. |
ROOT/cms/templates | This folder contains cTemplate and Smarty templates. This could be either templates for content types as CMS_FILELIST or CMS_TEASER or even templates that are used by more than one module. |
ROOT/cms/upload | All files that are uploaded using CONTENIDOs file manager or the content types CMS_IMGEDITOR or CMS_LINKEDITOR are stored in this folder. This folder can have arbitrary subfolders. |
ROOT/cms/xml | When your modules or plugins need or create XML files, e.g. XML sitemaps or RSS feeds, these should be located in this folder. |
Backend
| name | description |
|---|---|
ROOT/contenido/classes | Contains one file for each CONTENIDO class. |
ROOT/contenido/cronjobs | Cron or pseudocron jobs are located in this folder. |
ROOT/contenido/external | External tools liek CodeMirror or TinyMCE can be found here. TODO the folders backendedit and frontend have to be described. |
ROOT/contenido/images | Images that are used in the CONTENIDO backend are located in this folder. |
ROOT/contenido/includes | Contains files with functions used in the CONTENIDO backend that can also be used in plugins and modules. |
ROOT/contenido/jar | Contains the Java package org.contenido that is used for the file upload drag and drop feature. |
ROOT/contenido/plugins | CONTENIDO plugins are located in this folder. |
ROOT/contenido/scripts | This folder contains JavaScripts that are used in the CONTENIDO backend. This also includes the jQuery library. |
ROOT/contenido/styles | This folder contains CSS style sheets that are used in the CONTENIDO backend. This also includes the style sheets for jQuery. |
ROOT/contenido/templates | Templates that are used to render pages in the CONTENIDO backend. |
ROOT/contenido/templates_c | Smarty cache for templates that are used with the class cSmartyBackend when using the Smarty plugin. Smarty usually precompiles its templates and stores them in this folder. |
ROOT/contenido/tools | Command line tools (CLI) that are used for certain CONTENIDO related tasks e.g. automatic creation of the autoloader configuration file or the detection of PHP dependencies. |
ROOT/contenido/xml | This folder contains some XML files required for the CONTENIDO backend. legend.xml contains descriptions of the icon legend shown in Content | Article. navigation.xml defines the structure of the main- and subnavigation. system.xml defines settings which will be displayed on the system configuration page in Administration | System. |
Data
| name | description |
|---|---|
ROOT/data/cache | This folder is used for caching of client independant files that are created by some plugins (e.g. PIFA or PIXI) and modules. Also the CONTENIDO UpdateNotifier uses this folder for its files. |
ROOT/data/config | Client independant configuration files are located in this folder. |
ROOT/data/cronlog | When cronjobs are setup, these usually store *.job-files containing a timestamp in this folder to signal that and when they have been run last. |
ROOT/data/locale | This folder contains gettext files used to localize the CONTENIDO backend. |
ROOT/data/logs | Depending upon configuration settings some log files are maintained that can be found in this folder. |
ROOT/data/temp | This folder is intended to be used for any temporary data. When using this folder it might be a good idea to create a subfolder for each task in order to avoid name collisions. |