Site-wide Properties

by Plone Documentation Team last modified Jun 04, 2011 08:52 AM
Contributors: Mikko Ohtamma, Martin Aspeli, Kamon Ayeva, Israel Saeta Pérez
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.

Title Default Value Type Desccription
allowAnonymousViewAbout
False boolean If False, only logged-in users will be able to view information about who created an item and when it was modified.
localTimeFormat %b %d, %Y string Format 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
string Similar to localTimeFormat but including more information (e.g. with hours and minutes).
default_language en
string The default language for the site's content.
default_charset utf-8 string The default charset in which the site's content is encoded.
use_folder_tabs
lines List of content types that should include the 'contents' view. Not used in Plone 3.
ext_editor False boolean If 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 TinyMCE
None
lines List of available editors that the users are able to select.
allowRolesToAddKeywords Manager
Reviewer
lines Roles allowed to add new keywords/categories when editing content.
auth_cookie_length 0 int Length of the authorization cookie.
calendar_starting_year 2001 int The starting year to show in the calendar widget.
calendar_future_years_available
int The number of future years, after the current year, to show in the calendar widget.
invalid_ids actions lines Invalid ids for content created in Plone.
default_page index_html
index.html
index.htm
FrontPage
lines Attributes or object ids that, if available, should be used as default page.
search_results_description_length
int Length of the description to be included in search results listings. For items with a longer description, text will be cropped.
ellipsis ... string The ellipsis that will be added at the end of the cropped description in search results listings.
typesLinkToFolderContentsInFC Large Plone
Folder Folder
lines Content types that should link to its 'contents' view, when listed in a 'contents' view.
visible_ids False boolean If 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 boolean If enabled, Plone will include Dublin Core metadata information at the HTML header.
types_not_searched ATBooleanCriterion
ATDateCriteria
...
lines List of content types whose instances won't be retrieved by search results.
disable_folder_sections False boolean

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 boolean If True, only folderish content items will be listed as site sections.
typesUseViewActionInListings Image
File
lines List of content types that should link to its 'view' action in content listings.
verify_login_name True boolean If 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 boolean If 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 boolean If 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 boolean When set to True, the global search box will show live results. Only for browsers supporting javascript.
default_page_types Topic lines The 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 ...
lines Complementary to use_folder_tabs. Not used in Plone 3.
forbidden_contenttypes text/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_sitemap False
boolean Expose sitemap.xml.gz in the portal root according to the sitemaps.org standard.
number_of_days_to_keep 7 int Indicates how many days of undo history should be kept.
enable_inline_editing True boolean If 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 boolean If True, users will get warnings when they delete or move content that is linked from other content available in the site.
webstats_js
string Intended 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_window False string If True, all external links in the content region will open in a new window. Only for browsers supporting Javascript.
icon_visibility enabled string Possible values are 'disabled', 'authenticated' or 'enabled'. If '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.