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). (<= V4.6.15: wysiwyg/tinymce-relative-urls)	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