Settings
Overview
CONTENIDO comes with a lot of settings which can be edited in the backend. This table lists all supported settings with their default values. Settings alow to customize both the backend and the frontend.This page is still incomplete. Please help us to write a comprehensive CONTENIDO documentation.
How it works
Customizing CONTENIDO is very easy and can be done via system, client, group or user properties.
Explain how to edit system, client, group and user properties.
General settings
General settings can be set as system, client, client-language, group or user properties alike. They are read using the function getEffectiveSetting().
User settings have precendence over group settings, i.e. user settings always override group settings. If a user is added to more than one group, the result is undefined. Make sure that your groups don't override each other.
| Area/Type | Name | Description | Default |
|---|---|---|---|
| articles | show-new-window-checkbox | (true, false): If true, show "new window" checkbox for redirects in article properties. Note: If a redirect has been specified, the page is redirected to the new URL using an html page header. As header redirects can't open new windows, this setting is only useful, if a navigation module is used, which mentions the "open in new window" setting and adds a ′target="_blank"′ to the link, if necessary. | "false" |
| backend | leftframewidth | Defines the width of the left frame. | 245 |
| backend | preferred_idclient | ID of the client which should be selected after backend login | false |
| backend | sort_backend_users_by | "" | |
| backend | thumbnailmode | 100 | |
| cache | excludeidarts | false | |
| codemirror | activated | 'true' | |
| codemirror | * | ||
| cms_date | * | additional date/time formats, i. e. as mydateformat as name and {"dateFormat":"d.m.Y","timeFormat":"H:i:s"} as value | |
| cms_filelist_extensions | * | file extensions | |
| cms_filelist_style | * | filelist styles | |
| cms_teaser | * | teaser styles | |
| dateformat | full | "Y-m-d H:i:s" | |
| dateformat | date | "Y-m-d" | |
| dateformat | time | "H:i:s" | |
| encoding | file_encoding | Defines the encoding for written and read files in the layout handler. | UTF-8 |
| frontend.no_outputbuffer | idart | '' | |
| frontendusers | pluginsearch | (true, false): If true, the frontend users menu also searches trough plugins. However, searching trough plugins have a huge performance impact on the list. If you have a lot of frontend users, set this to false to disable this function. | true |
| frontendusers | pluginsearch_valid_plugins | If pluginsearch is set to true, you can hereby limit the plugins to search over. This property must be a comma-separated list (no whitespaces) of all plugins that should be used for pluginsearch. All other plugins will be skipped to improve performance. | "" |
| generator | basehref | (true, false): Defines if Contenido should automatically insert a base href tag. | true |
| generator | html5 | false | |
| generator | xhtml | (true, false): Defines if the tags generated by Contenido should be XHTML compliant. WARNING: This does not alter the HTML code in your layouts and modules! You have to revise your modules and layouts to be XHTML compliant. | false |
| layout | htmlvalidator | (true, false): If true, use the HTML validator. | true |
| login_error_page | idart | Defines error page for invalid logins | ''" |
| login_error_page | idcat | Defines error page for invalid logins. The start article will be used as error page | ''" |
| login_error_page | idcatart | Defines error page for invalid logins. NOT RECOMMENDED VERSION | ''" |
| modules | edit-with-tabs | (true, false) If set to "true" you can use the <tab> key to insert tabs in the input and output code areas (IE 6/7, FF 1.5/2). | "false" |
| modules | force-menu-check | If system/modulecheck is enabled, force module check while module list will be generated (instead of using database information). | "false" |
| modules | show-debug-rows | "never" | |
| navigation | idcat-home | 1 | |
| stats | ga_account | If set ... | "" |
| stats | piwik_site | If set ... | "" |
| stats | piwik_url | If set ... | "" |
| system | clickmenu | If set to 'true' ... | n/a |
| system | delaymenu_mouseover | 300 | |
| system | delaymenu_mouseout | 1000 | |
| system | insite_editing_activated | (true, false): Defines if insite editing is used in article editor. (was: insight_editing_activated) | true |
| system | languageorder | If set to "name", languages in the drop-down (top right) will be shown ordered by name, if not specified or set to something else, languages will be ordered by language id | name |
| versioning | activated | true | |
| versioning | path | ||
| versioning | prune_limit | '0' |
Password reset settings
These settings apply to the backend user password reset feature.
| Area/type | Name | Description | Default |
|---|---|---|---|
| pw_request | reset_threshold | amount of max password reset requests before a new one for a user can be created | 4 |
| pw_request | user_password_reset_expiration | How long a is a new password reset request valid; how much time for new password resets to expire | "+4 hour" |
| pw_request | outdated_threshold | Threshold value regarding when to consider password reset request to be outdated | "-1 day" |
Specific settings
Specific settings can be set as system, client, group or user properties. For which entities these settings can be set is documented in the scope column. They are read using the function getSystemProperty() for system settings or the getProperty()-method of the appropriate GenericDB-class.
Scopes: SYS - System, CLI - Client, CLA - ClientLanguage, GRP - Group, USR - User
| Area/Type | Name | Description | Default | Scope |
|---|---|---|---|---|
| backend | backend_label | SYS | ||
| backend | currentlogintime | Date and Time when this session has been started (automatically set by the backend) | n/a | USR |
| backend | lastlogintime | Date and Time when the last session was started (automatically set by the backend) | n/a | USR |
| backend | max_log_size | SYS | ||
| debug | debug_to_file | If set to 'true' ... | n/a | SYS |
| debug | debug_to_screen | If set to 'true' ... | n/a | SYS |
| expandstate | $uuid | USR | ||
| itemsperpage | $area | USR | ||
| maintenance | mode | (disabled, enabled): In maintenance mode, only sysadmins are allowed to login into contenido backend. | n/a | SYS |
| plugin | frontendgroups-pluginorder | SYS | ||
| plugin | $entity . '-pluginorder | SYS | ||
| plugin | $entity . '-lastscantime | SYS | ||
| pw_request | enable | (true, false): Property definies if contanido is allowed to generate new passwords for backenduser and submits them via mail. | true | SYS |
| stats | tracking | "off" | n/a | CLI |
| system | mail_encryption | SYS | ||
| system | mail_host | Host which is used for sending system mails (PW-Request). | localhost | SYS |
| system | mail_log | SYS | ||
| system | mail_pass | "" | ||
| system | mail_port | SYS | ||
| system | mail_sender | Sender mail-adress of Contenido Systemmails. (PW-Request). | info@contenido.org | SYS |
| system | mail_sender_name | Sender name of Contenido Systemmails. (PW-Request). | Contenido Backend | SYS |
| system | mail_user | "" | SYS | |
| system | modulecheck | if set to "false" (as string), modules aren't tested for syntax errors (needed for older PHP versions) | n/a | SYS |
| system | multiassign | If false, don't allow multi assignments for articles. | true | SYS & CLI |
| system | purge-dirstoexclude-withfiles | SYS | ||
| system | upldirlist-dirstoexclude | SYS | ||
| update | check | (true, false): Update checker notifies sysadmins, if there are new updates for contenido on contenido org. | false | SYS |
| update | check_period | SYS | ||
| update | news_feed | (true, false): Update RSS News notifies sysadmins, about news on contenido org and security issues. | false | SYS |
TinyMCE settings
| Area/Type | Name | Description | Default | Scope |
|---|---|---|---|---|
| tinymce | * | Starting with Contenido V4.6.16 all TinyMCE settings which may be specified for TinyMCE and the plugins may be specified as system, client, group or user properties. Use the name of the parameter according to the tinyMCE documentation as name ao the setting. These parameters can't be set as setting: document_base_url, file_browser_callback. | n/a | SCGU |
| tinymce_default | * | SCGU | ||
| tinymce_fullscreen | * | SCGU | ||
| tinymce_inline | * | SCGU | ||
| tinymce_mini | * | SCGU | ||
| tinymce_simple | * | SCGU | ||
| tinymce | content_css | Defines the stylesheet to include within tinyMCE. (<= V4.6.15: wysiwyg/tinymce-stylesheet-file) | SGU | |
| tinymce | theme_advanced_styles | Defines the available styles in the tinyMCE style dropdown. (<= V4.6.15: wysiwyg/tinymce-styles) | SGU | |
| tinymce | width | Defines the width of tinyMCE. (<= V4.6.15: wysiwyg/tinymce-width) | 100% | SGU |
| tinymce | height | Defines the height if tinyMCE. (<= V4.6.15: wysiwyg/tinymce-height) | 480px | SGU |
| tinymce | contenido_height_html | Overrides the tinyMCE height when editing the CMS_HTML element. (<= V4.6.15: wysiwyg/tinymce-height-html) | SGU | |
| tinymce | contenido_height_head | Overrides the tinyMCE height when editing the CMS_HTMLHEAD element. (<= V4.6.15: wysiwyg/tinymce-height-head) | SGU | |
| tinymce | contenido_gzip | If set to "true" use gzip compression. The server has to provide the compression method. | "false" | SGU |
| tinymce | contenido_toolbar_mode | Defines the tinyMCE toolbar mode (default "full"). Available choices: full, simple, mini, custom. (<= V4.6.15: wysiwyg/tinymce-toolbar-mode) | SGU | |
| tinymce | theme_advanced_buttons1 theme_advanced_buttons2 theme_advanced_buttons3 | Defines which items should be shown on the first/second/third toolbar. Please have a look at the tinyMCE documentation to find out which items you can use. Only used if the toolbar mode is "custom". (<= V4.6.15: wysiwyg/tinymce-toolbar1/2/3) | SGU | |
| tinymce | plugins | Defines which plugins should be loaded. Only used if the toolbar mode is "custom". (<= V4.6.15: wysiwyg/tinymce-plugins) | SGU | |
| tinymce | valid_elements | Defines which elements are allowed. See tinyMCE documentation for more information. (<= V4.6.15: wysiwyg/tinymce-valid-elements) |
| SGU |
| tinymce | extended_valid_elements | Defined which elements are allowed. These elements are added to valid_elements. (<= V4.6.15: wysiwyg/tinymce-extended-valid-elements) | SGU | |
| tinymce | contenido_background_color | This setting will be removed in version 4.9.7. Defines the tinyMCE background color (any valid CSS color value can be used). If you use an HTML hex color code, also include the # sign before the color (e.g. #ffffff). (<= V4.6.15: wysiwyg/tinymce-backgroundcolor) | white | SGU |
| tinymce | convert_urls | (true, false): Defines, if URLs will be converted (e.g. to relative URLs) at all. Please note, that URLs should be converted (e.g. for the time you may have to change the domain or server path). (<= V4.6.15: wysiwyg/tinymce-convert-urls) | true | SCGU |
| tinymce | relative_urls | (true, false): If convert_urls is true, then this setting specifies, if URLs will be converted to relative or absolute URLs. Please note, that relative URLs should be used (e.g. for the time you may have to change the domain or server path). | true | SCGU |
| tinymce | contenido_lists | If specified, adds dropdown lists with links for all articles (Insert Link popup window), images (Insert Image popup window) and/or all media/flash files (Insert Media/Flash popup window). Valid values are: link, image, media, flash. Values have to be separated by a comma, e.g. "link,image". Do not specify, if you have a lot of articles, images and/or media files. (<= V4.6.15: wysiwyg/tinymce-lists). | SGU |
Style-editor, Script-editor and HTML-editor settings
| Area/Type | Name | Description | Default | Scope |
|---|---|---|---|---|
| html_editor | wrap | {on, off} Defines the wrap attribute of the textarea to edit the HTML file. | 'off' | SCGU |
| script_editor | wrap | {on, off} Defines the wrap attribute of the textarea to edit the JS file. | off | SCU |
| style_editor | wrap | {on, off} Defines the wrap attribute of the textarea to edit the CSS file. In case of 'on' the lines will be wraped. | off | SCU |
Deprecated settings
These settings were available in former versions of CONTENIDO and are no more supported.
| Area/Type | Name | Description | Default | Scope |
|---|---|---|---|---|
| backend | small-navigation | (true, false): If true, a small navigation is shown. | false | SCGU |
| cms_img | directory-height | Height of the directory lister in rows | 5 | SGU |
| cms_img | directory-width | Width of the directory lister in pixels | 300 | SGU |
| cms_img | file-height | Height of the file lister in rows | 5 | SGU |
| cms_img | file-width | Width of the file lister in pixels | 300 | SGU |
| cms_img | description-height | Height of the description box in rows | 5 | SGU |
| cms_img | description-width | Width of the description box in characters | 70 | SGU |
| cms_img | preview-height | Height of the preview area in pixels | 400 | SGU |
| cms_img | preview-width | Width of the preview window in pixels | 600 | SGU |
| edit_area | activated | (true, false): Defines if syntax highlighting editor is used in backend for modul, js, css and html code. | true | SCGU |
| imagemagick | available | Set "1" if ImageMagick is available on your server to receive best results when resizing images | SGU | |
| modules | java-edit | Enable the java module editor. | SGU | |
| modules | disable-history | (true, false) If true, don't use the module history. | false | SCGU |
| modules | storeasfiles | Defines if Contenido should store modules as text files. THIS IS HIGHLY EXPERIMENTAL, ONLY USE IF YOU KNOW WHAT YOU ARE DOING! | off | S |
| modules | loadfromfiles | Defines if Contenido should load modules as text files. THIS IS HIGHLY EXPERIMENTAL, ONLY USE IF YOU KNOW WHAT YOU ARE DOING! | off | S |