Child pages
  • Filesystem structure
Skip to end of metadata
Go to start of metadata

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:

namerequireddescription
ROOT/cms/yesThis folder is often called frontend or client folder. All files contained in this folder are related to a single client.
ROOT/contenido/yesThe CONTENIDO backend is located in this folder.
ROOT/data/yesConfiguration files and other stuff is located in the data folder.
ROOT/docs/noThis folder contains some documentation files. It could be deleted when read.
ROOT/setup/noThe setup folder should be deleted immediatly after a successfull installation.
ROOT/test/noCould 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.

namedescription
ROOT/cms/cacheContains 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/codeThis 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_cSmarty 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/cssWhen 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/dataThis 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/configThe 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/layoutsLayouts 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/logsThis folder is used for client specific log files. TODO explain how to enable client specific logs.
ROOT/cms/data/modulesThis 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/versionWhen editing style sheets, JavaScripts, layouts, modules or templates in CONTENIDOs backend, their previous content is versioned and stored in this folder.
ROOT/cms/imagesWhen 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/includesWhen 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/jsWhen 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/templatesThis 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/uploadAll 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/xmlWhen your modules or plugins need or create XML files, e.g. XML sitemaps or RSS feeds, these should be located in this folder.

Backend

namedescription
ROOT/contenido/classesContains one file for each CONTENIDO class.
ROOT/contenido/cronjobsCron or pseudocron jobs are located in this folder.
ROOT/contenido/externalExternal tools liek CodeMirror or TinyMCE can be found here. TODO the folders backendedit and frontend have to be described.
ROOT/contenido/imagesImages that are used in the CONTENIDO backend are located in this folder.
ROOT/contenido/includesContains files with functions used in the CONTENIDO backend that can also be used in plugins and modules.
ROOT/contenido/jarContains the Java package org.contenido that is used for the file upload drag and drop feature.
ROOT/contenido/pluginsCONTENIDO plugins are located in this folder.
ROOT/contenido/scriptsThis folder contains JavaScripts that are used in the CONTENIDO backend. This also includes the jQuery library.
ROOT/contenido/stylesThis folder contains CSS style sheets that are used in the CONTENIDO backend. This also includes the style sheets for jQuery.
ROOT/contenido/templatesTemplates 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/toolsCommand 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/xmlThis 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

namedescription
ROOT/data/cacheThis 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/configClient independant configuration files are located in this folder.
ROOT/data/cronlogWhen 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/localeThis folder contains gettext files used to localize the CONTENIDO backend.
ROOT/data/logsDepending upon configuration settings some log files are maintained that can be found in this folder.
ROOT/data/tempThis 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.
  • No labels