Contenido

Backend customizing

Author Timo A. Hummel
Created 22th October 2003
Audience Site Administrators
Applies to Contenido 4.6 or later

Introduction

Backend customizing is a mechanism to customize various parameters of the backend. There are not many settings you can do, as this mechanism is relatively new. However, this mechanism will be used more and more in the future.

How it works

Customizing Contenido settings is very easy and can be done via the group or user customizing settings. Here's an example for the user customizing:



Important: User settings have precendence before group settings. User settings always override group settings. If the user is added to more than one group, the result is undefined. Make sure that your groups don't override each other.

Common parameters

Area/Type Property Value (Description) Applies to
backend currentlogintime Date and Time when this session has been started (automatically set by the backend) Users
backend lastlogintime Date and Time when the last session was started (automatically set by the backend) Users
backend preferred_idclient ID of the client which should be selected after backend login System, Clients, Groups, Users
backend leftframewidth Defines the width of the left frame. Standard value is 250. System, Clients, Group, Users
backend small-navigation true or false (default). if true, a small navigation is shown System, Clients, Groups, Users
cms_img directory-height Height of the directory lister in rows, default 5 System, Groups, Users
cms_img directory-width Width of the directory lister in pixels, default 300 System, Groups, Users
cms_img file-height Height of the file lister in rows, default 5 System, Groups, Users
cms_img file-width Width of the file lister in pixels, default 300 System, Groups, Users
cms_img description-height Height of the description box in rows, default 5 System, Groups, Users
cms_img description-width Width of the description box in characters, default 70 System, Groups, Users
cms_img preview-height Height of the preview area in pixels, default 400 System, Groups, Users
cms_img preview-width Width of the preview window in pixels, default 600 System, Groups, Users
imagemagick available Set "1" if ImageMagick is available on your server to receive best results when resizing images System, Groups, Users
modules java-edit Enable the java module editor System, Groups, Users
modules edit-with-tabs If set to "true" you can use the key to insert tabs in the input and output code areas (IE 6/7, FF 1.5/2) System, Clients, Groups, Users
modules disable-history If true, don't use the module history. System, Clients, Groups, Users
modules storeasfiles Defines if Contenido should store modules as text files. THIS IS HIGHLY EXPERIMENTAL, ONLY USE IF YOU KNOW WHAT YOU ARE DOING! Default off. System
modules loadfromfiles Defines if Contenido should load modules as text files. THIS IS HIGHLY EXPERIMENTAL, ONLY USE IF YOU KNOW WHAT YOU ARE DOING! Default off. System
modules force-menu-check If system/modulecheck is enabled, force module check while module list will be generated (instead of using database information). Default $quot;false$quot;. System, Clients, Groups, Users
system modulecheck if set to "false" (as string), modules aren't tested for syntax errors (needed for older PHP versions) System
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 (default) System, Clients, Groups, Users
system multiassign If false, don't allow multi assignments for articles. System, Clients
layout htmlvalidator If true or not defined, use the HTML validator. System, Groups, Users
frontendusers pluginsearch If true or not defined, the frontend users menu also searches trough plugins. However, searching trough plugins have a huge performance inpact on the list. If you have alot of frontend users, set this to false to disable this function. System, Clients, Users
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. System, Clients, Users
generator xhtml Defines if the Tags generated by Contenido should be XHTML compilant. WARNING: This does not alter the HTML code in your layouts and modules! You have to revise your modules and layouts to be XHTML compilant. "true" or "false" (as string). Default: "false". System, Clients
generator basehref Defines if Contenido should automatically insert a base href tag. "true" or "false" (as string). Default: "true". System, Clients

SPAW-Related parameters

wysiwyg spaw-styles The CSS style names which appear in the styles drop-down. System, Groups, Users
wysiwyg spaw-stylesheet-file The stylesheet file to use for the WYSIWYG. System, Groups, Users
wysiwyg spaw-toolbar-mode The toolbar mode to use. Allowed values: default, full, mini, nofont, sidetable System, Groups, Users
wysiwyg spaw-height The height of the SPAW editor widget (fallback mode, currently not used) System, Groups, Users
wysiwyg spaw-height-html The height of the SPAW editor when editing CMS_HTML elements System, Groups, Users
wysiwyg spaw-height-head The height of the SPAW editor when editing CMS_HEAD elements System, Groups, Users
wysiwyg spaw-width The width of the SPAW editor widget (fallback mode, currently not used)
(usage: XX% => percentage statement / XX => pixel statement)
System, Groups, Users
wysiwyg spaw-theme SPAW editor theme, defaults to "contenido" System, Groups, Users



tinyMCE-related Parameters

wysiwyg tinymce-stylesheet-file Defines the stylesheet to include within tinyMCE. System, Groups, Users
wysiwyg tinymce-styles Defines the available styles in the tinyMCE style dropdown. System, Groups, Users
wysiwyg tinymce-width Defines the width of tinyMCE (default 100%) System, Groups, Users
wysiwyg tinymce-height Defines the height if tinyMCE (default 480) System, Groups, Users
wysiwyg tinymce-toolbar-mode Defines the tinyMCE toolbar mode (default "full"). Available choices: full, simple, mini, custom System, Groups, Users
wysiwyg tinymce-height-html Overrides the tinyMCE height when editing the CMS_HTML element System, Groups, Users
wysiwyg tinymce-height-head Overrides the tinyMCE height when editing the CMS_HTMLHEAD element System, Groups, Users
wysiwyg tinymce-toolbar1 Defines which items should be shown on the first 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. System, Groups, Users
wysiwyg tinymce-toolbar2 Defines which items should be shown on the second toolbar. Only used if the toolbar mode is custom. System, Groups, Users
wysiwyg tinymce-toolbar3 Defines which items should be shown on the third toolbar. Only used if the toolbar mode is custom. System, Groups, Users
wysiwyg tinymce-plugins Defines which plugins should be loaded. Only used if the toolbar mode is custom. System, Groups, Users
wysiwyg tinymce-valid-elements Defines which elements are allowed. See tinyMCE documentation for more information. System, Groups, Users
wysiwyg tinymce-extended-valid-elements Defined which elements are allowed. These elements are added to tinymce-valid-elements (or to the standard tinyMCE valid_elements).  
wysiwyg tinymce-backgroundcolor Defines the tinyMCE background color (any valid CSS color value can be used). If you use a HTML hex color code, also include the # sign before the color (e.g. #ffffff). Default is white. System, Groups, Users
wysiwyg tinymce-lists If specified, adds dropdown lists with links for all articles (Insert Link popup window), all images (Insert Image popup window) and/or all flash files (Insert Flash popup window). Valid values are: link, image, 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 flash files.
System, Groups, Users



Style-editor, Script-editor and HTML-editor related Parameters

style_editor wrap {on, off} Default off. Defines the wrap attribute of the textarea to edit the CSS file. In case of 'on' the lines will be wraped. System, Clients, Users
script_editor wrap {on, off} Default off. Defines the wrap attribute of the textarea to edit the JS file. System, Clients, Users
html_editor wrap {on, off} Default off. Defines the wrap attribute of the textarea to edit the HTML file. System, Clients, Users