Site-wide Properties

by Mikko Ohtamaa last modified May 27, 2009 01:19 PM

Site-wide properties available at the properties tool.

Plone uses the properties tool's sheet site_properties to store some site-wide settings.

They can be set using GenericSetup throught the propertiestool.xml file. Check the CMFPlone/profiles/default/propertiestool.xml file for an example.

TitleDefault ValueTypeDesccription
allowAnonymousViewAbout
FalsebooleanIf False, only logged-in users will be able to view information about who created an item and when it was modified.
localTimeFormat%b %d, %YstringFormat to be used when displaying dates in short notation (e.g. without hours and minutes). It should follow the syntax as specified by Python's time.strftime. To know more, read the Python documentation for time.strftime.
localLongTimeFormat%b %d, %Y %I:%M %p
stringSimilar to localTimeFormat but including more information (e.g. with hours and minutes).
default_language en
stringThe default language for the site's content.
default_charset utf-8stringThe default charset in which the site's content is encoded.
use_folder_tabs
linesList of content types that should include the 'contents' view. Not used in Plone 3.
ext_editor False booleanIf True, an icon will be made visible on each page, to allow the user to edit content using an external editor. This requires an additional application called ExternalEditor to be installed on the client workstation.
available_editors None
Kupu
linesList of available editors that the users are able to select.
allowRolesToAddKeywords Manager
Reviewer
linesRoles allowed to add new keywords/categories when editing content.
auth_cookie_length 0 intLength of the authorization cookie.
calendar_starting_year 2001 intThe starting year to show in the calendar widget.
calendar_future_years_available
intThe number of future years, after the current year, to show in the calendar widget.
invalid_ids actions linesInvalid ids for content created in Plone.
default_page index_html
index.html
index.htm
FrontPage
linesAttributes or object ids that, if available, should be used as default page.
search_results_description_length
intLength of the description to be included in search results listings. For items with a longer description, text will be cropped.
ellipsis ... stringThe ellipsis that will be added at the end of the cropped description in search results listings.
typesLinkToFolderContentsInFC Large Plone
Folder Folder
linesContent types that should link to its 'contents' view, when listed in a 'contents' view.
visible_ids False booleanIf True, users will be able to set the ids for content items. If False, the ids will be generated automatically based on the normalized version of the title.
exposeDCMetaTags False booleanIf enabled, Plone will include Dublin Core metadata information at the HTML header.
types_not_searched ATBooleanCriterion
ATDateCriteria
...
linesList of content types whose instances won't be retrieved by search results.
disable_folder_sectionsFalseboolean

If True, the automatic site sections (portal tabs) generation will be disabled, so only actions in category portal_tabs will be included.

disable_nonfolderish_sections False booleanIf True, only folderish content items will be included in site sections.
typesUseViewActionInListings Image
File
linesList of content types that should link to its 'view' action in content listings.
verify_login_name True booleanIf True, when login fails, users will get a specific answer, telling their login name field wasn't found or the password was incorrect. If False, users will only be told that the login failed.
many_users False booleanIf True, the Plone user management screen will be optimized for a large amount of users, allowing only to search instead of listing them all.
many_groups False booleanIf True, the Plone group management screen will be optimized for a large amount of groups, allowing only to search instead of listing them all.
enable_livesearch True booleanWhen set to True, the global search box will show live results, only for browsers supporting javascript.
default_page_types Topic linesThe list of content types that can be used as default pages, so the user is able to selected them using the 'display' menu.
use_folder_contents ...
linesComplementary to use_folder_tabs. Not used in Plone 3.
forbidden_contenttypestext/structured
text/restructured
...
lines List of forbidden mimetypes that are not available in text areas. Mimetypes removed from this list will be available in text areas (e.g. page body). Only if the user isn't using Kupu, since it only supports HTML.
default_contenttype text/html
string Default mimetype for text areas.
enable_sitemapFalse
booleanExpose sitemap.xml.gz in the portal root according to the sitemaps.org standard.
number_of_days_to_keep 7 intIndicates how many days of undo history should be kept.
enable_inline_editing True booleanIf True, enables the inline editing feature, allowing users to click directly in the field value and change it without accessing the edit form. Only for browsers supporting Javascript.
enable_link_integrity_checks True booleanIf True, users will get warnings when they delete or move content that is linked from other content available in the site.
webstats_js
stringIntended for code snippets from external providers. It will be included in the rendered HTML as entered near the end of the page. It can be used to enable web statistics support from external providers (e.g. Google Analytics).
external_links_open_new_windowFalsestringIf True, all external links in the content region will open in a new window. Only for browsers supporting Javascript.
icon_visibility enabled stringIf 'disabled', content icons won't be shown in listings; if 'authenticated', content icons will be visible only for authenticated users; if 'enabled' content icons will be visible for all users.