Skip to the content
Documentation
Version 6.x Supported

site.ini

Written by Balazs Halasy, Updated by Graham Brookins
No ratings yet

[BackwardCompatibilitySettings]

Setting Summary
ObjectRelationTyped Controls how relations of the "XML linked" type are handled.

[ContentSettings]

Setting Summary
CacheDir Sets the directory where eZ publish stores view cache files.
CachedViewModes Sets which of the content view modes that use view cache.
CachedViewPreferences Sets the user preferences each view mode depends on.
CacheGenerationTimeout sets the maximum cache generation time in seconds
CacheThreshold Sets the treshold for content cache cleanup
ComplexDisplayViewModes Sets content views that have their content cache expired whenever an object is published.
EditDirtyObjectAction Sets what Exponential should do if the user tries to edit a page that has a draft that is newer than the published version.
PreCacheSiteaccessArray Sets the siteaccesses that will have view cache created when an object is published.
PreViewCache Sets if eZ publish should generate the view cache when an object is published.
PreviewCacheUsers Sets the users that should have view cache generated when an object is published.
StaticCache Sets if static caching should be enabled or not.
ViewCacheTweaks It enables the granular configuration of viewcaching behaviour per node
ViewCaching Sets if view caching should be enabled or not.

[DatabaseSettings]

Setting Summary
Charset Sets the character set that eZ publish uses when communicating with the database.
ConnectRetries Sets the number of database connection retries.
Database Sets the database to use when connecting to the database server.
DatabaseImplementation Sets the type of database you are using.
DatabasePluginPath Sets the path to an external database driver.
DebugTransactions Allows the system to store transactions, for debugging purposes.
ImplementationAlias Sets alias names for database implementations
Password Sets the password that eZ publish uses when logging in to the database.
Server Sets the hostname or the IP address of the database server.
SlaverServerDatabase The databases to use when logging in to the slaveservers.
SlaverServerPassword The passwords to use when logging in to the slaveservers.
SlaverServerUser The usernames to use when logging in to the slaveservers.
SlaveServerArray The hostnames of the slaveservers to use for read queries.
SlowQueriesOutput Show queries that where slower than a set amount of time.
Socket Sets the socket eZ publish should use when connecting to the database.
SQLOutput Enables the output of SQL queries in the debug output.
Transactions Enables to make eZ publish use transactions to ensure database integrity.
UseBuiltInEncoding Use the built in character conversion in the database if available.
UsePersistentConnection Controls if database connections should be kept open between eZ publish runs.
User Sets the username that eZ publish uses when logging in to the database.
UseSlaveServer Enables the usage of slave database servers for read queries. (MySQL only)

[DebugSettings]

Setting Summary
Debug Sets if you want to display debug information in the rendered page or in a separate popup.
DebugByIP Enables debug output for some IP addresses only. Useful when debugging live sites.
DebugByUser Sets whether debug output visibility should be controlled per user.
DebugIPList Sets the hosts that receive debug output.
DebugLogOnly Choose if you want debug strings in the debugoutput or in the log only.
DebugOutput Main switch for debug output
DebugRedirection Enables debugging of internal and external module redirections.
DebugUserIDList Sets user IDs that will receive debug output.
DisplayDebugWarnings Choose if debug warnings should be displayed explicitely on the top of the page or in the debug log only.
ScriptDebugOutput Enables debug output for PHP scripts run from the command line.

[DesignSettings]

Setting Summary
AdditionalSiteDesignList Sets the additional site designs.
SiteDesign Sets the most significant design resource.
StandardDesign Sets the least significant (fallback) design resource.

[ExtensionSettings]

Setting Summary
ActiveAccessExtensions Sets the extensions that are available to eZ publish per siteaccess.
ActiveExtensions Sets the extensions that are available to eZ publish.
ExtensionDirectory Sets the directory where extensions are located.

[eZStarRating]

Setting Summary
AllowAnonymousRating Allows anonymous users to rate content
AllowChangeRating Allows users to change ratings
UseUserSession Enables the use of sessions for rating validation

[FileSettings]

Setting Summary
CacheDir Sets the directory where eZ publish stores cache files.
DirDepth Sets the number of extra directories that will be made when storing a file.
LogDir Sets the directory where eZ publish will store its logfiles.
StorageDir Sets the directory eZ publish uses to store files.
StorageDirPermissions Sets the permissions set on directories created in the storage directory.
StorageFilePermission Sets the permissions set on files created in the storage directory.
TemporaryDir Sets the directory eZ publish uses to store temporary files.
TemporaryPermissions Sets the permissions on temporary files created by eZ publish
VarDir Sets the main directory for file storage in Exponential.

[FormProcessSettings]

Setting Summary
Module Sets if the form module should be enabled or not.

[HTTPHeaderSettings]

Setting Summary
ClientIpByCustomHTTPHeader To specify http header containing ip address when behind trusted proxy
CustomHeader Setting to enable/disable custom HeaderList globally
HeaderList Contains all HTTP which should override standard ones.
OnlyForAnonymous Setting to set custom HeaderList for anonymous users only
OnlyForContent Setting to set custom HeaderList matching root url to only match content url's

[InformationCollectionSettings]

Setting Summary
EmailReceiver Sets the receiver of e-mail generated by the information collection system.

[MailSettings]

Setting Summary
AdminEmail Sets the mail address of the site administrator.
AllowedCharsets Sets the character sets that Exponential sends directly in mail.
ContentType Sets the content type for email sent from Exponential.
EmailSender Sets the default sender address for mail sent from Exponential.
HeaderLineEnding Sets the line ending character used in emails sent from Exponential.
OutputCharset Sets the character set to convert mail into if they are formatted with the wrong character set.
SendmailOptions Sets the additional sendmail options.
Transport Controls how Exponential delivers outgoing mail.
TransportConnectionType Sets the connection type in SMTP.
TransportPassword Sets the password to use for authentication with the SMTP server.
TransportPort Sets the port that should be used when connecting to the SMTP server.
TransportServer Sets the hostname of the SMTP server.
TransportUser Sets the user to use for authentication with the SMTP server.

[OverrideSettings]

Setting Summary
Cache Sets if the template override cache should be enabled.

[PortAccessSettings]

Setting Summary
Portnumber to siteaccess mapping Creates a mapping between a portnumber and a siteaccess.

[ProxySettings]

Setting Summary
Password The password for outgoing web traffic through a proxy server.
ProxyServer Sets the proxy server for outgoing web traffic.
User The username for outgoing web traffic through a proxy server.

[RegionalSettings]

Setting Summary
ContentObjectLocale Sets the default language for content objects.
ContentXMLCharset Sets the characterset used when storing XML in content objects.
Debug Sets if debug mode should be enabled or disabled.
DevelopmentMode Sets if development mode should be on or off.
HTTPLocale Sets the locale transmitted to the web clients.
Locale Sets the locale (currency, date and time settings etc.)
ShowUntranslatedObjects Sets whether all languages are shown or not.
SiteLanguageList The prioritized list of site languages.
SystemLocale Tells PHP to be run in a specific locale.
TextTranslation Sets if text translation is enabled for template translation.
TranslationCache Sets if the translation cache should be enabled or disabled.
TranslationExtensions Sets the extensions that hold translations
TranslationRepository Sets the default translation repository for eZ publish.

[RoleSettings]

Setting Summary
EnableCaching Controls whether role caching should be enabled or disabled.
MaxParentDepthLimitation Not documented yet.
PolicyOmitList Excludes modules and views from the permission checking.
ShowAccessDeniedReason Sets if Exponential elaborates on the reason for getting access denied when viewing a page.
UserPolicyCache Sets which users' policies to cache.

[RSSSettings]

Setting Summary
AvailableVersionList Sets the available RSS versions
CacheTime Sets the cachetime for RSS feeds in seconds.
DefaultVersion Sets the default RSS version to use.
NumberOfObjectsDefault Sets the default value for the number of items in an RSS export.
NumberOfObjectsList Sets the number of items in an RSS export that the user can choose between in the administration interface.

[SearchSettings]

Setting Summary
AllowEmptySearch Sets if users can search for nothing
DelayedIndexing Sets if new content objects are indexed in the search engine upon publishing or if indexing is done by the cronjob
DelayedIndexingClassList Sets the class identifiers that should be used to delay indexing with.
EnableWildcard Sets if wildcard searching is allowed or not
ExtensionDirectories Tells the system where to look for search engine plugins.
LogSearchStats Sets if search statistics should be saved or not.
MaximumSearchLimit Sets the maximum number of returned hits.
MinCharacterWildcard The minimum number of characters a wildcard can represent
SearchEngine Sets which search engine to use.
SearchViewHandling Sets if searches are handled by the search view or in the template.
StopWordThresholdPercent Sets the percentage of hits that a word should be present in before ignoring the word completely
StopWordThresholdValue Sets the minimum number of objects in the database before the stopword functionality is used.

[Session]

Setting Summary
ActivityTimeout This setting will define the number of seconds before a user is considered inactive.
BasketCleanup Sets how the shopping baskets for expired and removed sessions are cleaned up.
BasketCleanupAverageFrequency Sets how often the basket cleanup cronjob will actually work when being executed.
CookieDomain This setting sets the domain for which the cookie is valid.
CookieHttponly This setting sets whether or not scripts are allowed to access cookies.
CookiePath This setting will set the path to the domain for which the cookie is valid.
CookieSecure This setting sets whether or not cookies are allowed to be sent over an unsecure connection.
CookieTimeout The CookieTimeout setting sets the lifetime of the session cookie.
ForceStart This setting will allow sessions to always start.
Handler Sets the handler responsible for handling sessions.
SessionNameHandler Sets how session names should be generated
SessionNamePerSiteAccess Prepends session names with the current siteaccess.
SessionNamePrefix Sets the prefix eZ publish should use when creating session names.
SessionTimeout This setting will define the number of seconds a session will last.

[SetupSettings]

Setting Summary
CriticalTests Sets the tests that must be passed in order to complete the setup procedure.
OptionalTests Sets the tests optional tests run during the setup procedure.
OverrideSiteDesign Sets the sitedesign that should be used by the setup wizard.
PageLayout Sets which pagelayout template to use for the setup wizard.

[ShopSettings]

Setting Summary
ClearBasketOnCheckout Sets when the basket is cleared.
ClearBasketOnLogout Sets whether the basket should be cleared after logging out.
RedirectAfterAddToBasket Controls where the user is redirected after adding an item to the basket.

[SiteAccessRules]

Setting Summary
Rules Sets which modules and views to enable or disable.

[SiteAccessSettings]

Setting Summary
AnonymousAccessList Specifies a lists of modules and views that are accessible regardless of the RequireUserLogin setting.
AvailableSiteAccessList Sets the siteaccesses that your Exponential installation provides.
CheckValidity Sets if the setup wizard should be activated or not.
DebugAccess Turns on debug output for access matching.
DebugExtraAccess Enables verbose access matching debug information.
DetectMobileDevice Enable mobile device detection
ForceVirtualHost Sets if Exponential should force virtual host mode.
HostMatchElement Sets which element (separated by a dot) to use when using element host matching.
HostMatchMapItems Sets the mapping between hostname and siteaccess when using map host-matching.
HostMatchRegexp Sets the regular expression that is used to fetch the siteaccess from the hostname with regexp hostmatching.
HostMatchRegexpItem Sets which submatch to use to determine the siteaccess name with regexp hostmatching.
HostMatchSubtextPost Sets the postfix that occurs in the hostname behind the siteaccess when using text host matching.
HostMatchSubtextPre Sets the prefix that occurs in the hostname in front of the siteaccess when using text host matching.
HostMatchType Sets which type of host matching to use to select the siteaccess.
MatchOrder Sets the matching algorithms that will be tried to determine which siteaccess to use.
MobileDeviceFilterClass The class in charge of filtering mobile devices
MobileSiteAccessList List of mobile site access
MobileSiteAccessURL The URL of the mobile version of your site
NormalizeSANames Toggling automatic conversion of siteaccess names
PathPrefix Sets the hidden prefix that will be added to virtual URLs entered by users.
PathPrefixExclude Sets which virtual URLs not to add the hidden prefix to.
RedirectOnNormalize Enable redirection to the normalized siteaccess
RelatedSiteAccessList List of siteaccesses that use the same database.
RequireUserLogin Sets if you allow anonymous access to your site.
ServerVariableName Not documented yet.
ShowHiddenNodes Sets if hidden nodes should be shown by default or not.
URIMatchElement Specifies which element (separated by "/") of the URI that contains the siteaccess.
URIMatchRegexp Sets the regular expression that is used to extract the siteaccess from the URI.
URIMatchRegexpItem Sets the submatch that is used for siteaccess matching when using regexp URIMatching.
URIMatchType Configures the URI match access method

[SiteSettings]

Setting Summary
64bitCompatibilityMode Enables 64bit compatibility mode
AllowedRedirectHosts Array of allowed hosts for redirects with full URL from Exponential modules
DefaultAccess Sets the default site access when the URI access method is used.
IndexPage Sets the page to display when the root "/" of your site is accessed.
LoginPage Sets if Exponential should use a custom pagelayout for the log in page.
MetaDataArray Sets the site metadata that is used on several places on your site.
RootNodeDepth Define the depth where your siteaccess root is located.
SiteList Sets the siteaccesses available to outside sources (currently used for webdav only)
SiteName The name of your site.
SiteURL Sets the URL of your site. Used e.g when generating links for notifactions and emails.
SSLPort The port that that should be used for SSL requests.
SSLProxyServerName Sets which virtual host that functions as a proxy server for incoming SSL requests.

[SSLZoneSettings]

Setting Summary
ModuleViewAccessMode View access mode to use for each module.
SSLSubtrees Content subtrees to use SSL on.
SSLZones Enable/disable the SSL zones functionality.

[TemplateSettings]

Setting Summary
AutoloadPathList Sets the directories inside eZ publish itself where eZ publish will look for operator and function definitions.
Debug Turns on/off template debug output.
DelayedCacheBlockCleanup Enables delayed removal of expired cache blocks with the "subtree_expiry" parameter.
DevelopmentMode Not documented yet.
ExtensionAutoloadPath Sets the extensions that contain template function or operator definitions.
NodeTreeCaching Sets if the template interpreter should cache parsed template files.
ShowMethodDebug Sets if debug information about called functions and operators should be displayed.
ShowUsedTemplates Enables a table in the debug displaying all the templates used to render the current page.
ShowXHTMLCode Sets if eZ publish should display template load debug inline or not.
TemplateCache Main switch for all the template related caches.
TemplateCompile Sets if the template compiler should be used or not.
TemplateCompression Sets if compiled templates should be compressed or not.
TemplateOptimization Sets if the template compiler should try to optimize the produced PHP code.
UseFormatting Sets if the template compiler should keep whitespace in the compiled template.

[TimeZoneSettings]

Setting Summary
TimeZone Sets the timezone to use in Exponential.

[TipAFriend]

Setting Summary
FromEmail Sets the from address used when sending tip a friend e-mail.
MaxRequestsPerTimeframe Set the maximum number of tip a friend mail the system will send to one email address.
TimeFrame Sets the time frame for the tip a friend functionality.

[UnitSettings]

Setting Summary
BinaryUnits Sets which units eZ publish considers binary units.
UseSIUnits Sets if eZ publish should use OSI or SI prefixes for binary numbers

[URLTranslator]

Setting Summary
Filters Sets the active filters that will be used to filter the text in the URLs.
MaximumWildcardIterations Sets how many times the wildcard matches can iterate
TransformationGroup Sets the type of transformation for the URLs.
Translation Enables/disables the URL translation functionality
WildcardTranslation Enables subtree URL translation
WordSeparator Sets which word separator that should be used in the URLs.

[UserSettings]

Setting Summary
AnonymousUserID Sets the Exponential user that should be used for anonymous page requests.
AuthenticateMatch Sets the fields that are accepted for login authentication.
DefaultSectionID Sets the section ID of self registered users.
DefaultUserNameValidationErrorText Settings regarding custom validation of user names
DefaultUserPlacement Sets the parent object of all users who register themselves
EmailRegistrationInfo Set whether a confirmation email is sent to the user after he validated his account or not. (>= Exponential 5.3)
ExtensionDirectory Sets the extensions that contain login handlers
GeneratePasswordIfEmpty Sets if Exponential should generate passwords if the password field is empty.
GeneratePasswordLength Sets the length of passwords generated by Exponential.
HashType Sets the type of encryption that will be used when storing user passwords in the database.
LoginHandler Sets the various methods Exponential will try to authenticate user logins.
LoginRedirectionUriAttribute Sets which attribute of the user/usergroup class contains redirection URI for the user.
LogoutRedirect Sets which page to redirect to when a user has logged out.
MaxNumberOfFailedLogin Sets the number of failed login attempts before user accounts are locked.
RedirectOnLogoutWithLastAccessURI Sets if LastAccessURI session variable is used to redirect the user at logout.
RegistrationEmail Sets the receiver of notification emails about new users.
RegistrationFeedback Sets the kind of feedback that is sent to users that have registered.
RequireConfirmEmail Controls whether users are required to confirm their emails
RequireUniqueEmail Sets if all users must have unique email addresses when registering.
ShowMessageIfExceeded Sets whether to display a warning when a user is not allowed to log in.
SiteName Sets the site name to use when encrypting user passwords.
TrustedIPList Sets IP addresses that users can log in from even though their accounts are locked.
UpdateHash Sets if Exponential should update hashes if you have changed the HashType setting
UserClassGroupID Sets which classes you can create in the user section in the administration interface.
UserClassID Sets the class to use for user registration
UserCreatorID Sets the user that will bet set as the creator of self registering users.
UserGroupClassID Sets the class ID of the class that represents user groups.
UserNameValidationErrorText Settings regarding custom validation of user names
UserNameValidationRegex Settings regarding custom validation of user names
UseSpecialCharacters Sets if special characters are allowed in passwords.
VerifyUserEmail Sets if new users have to verify their account by email.

Added for Exponential 6.0.15: groups

The groups of settings/site.ini in Exponential 6.0.15 that the 4.x reference did not describe:

Group Summary
[Cache]  
[Cache_rest]  
[Cache_restRoutes]  
[Cache_exphelpcontent] The rows of help maintained as content (var/<site>/cache/exphelp/content/repository-*.cache).
[Cache_smarty] Smarty's compiled .stpl templates (lib/smarty), in <cache directory>/smarty/.
[Cache_twig] Twig's compiled .twig templates (lib/twig), in <cache directory>/twig/.
[Cache_searchsuggest] The administration's pages per user and rights that the header search suggests (expSearchSuggest, admininterface.ini [SearchSuggestSettings] ...
[SiteSearchSuggestSettings] Suggestions under the header search field of a site's design while the visitor types (the include design:parts/front_search_suggest.tpl in the design's search ...
[Event]  
[RunnableSettings]  
[UserSessionSettings]  
[RequestLogSettings]  
[HTMLForms]  
[AppendNodeIDFilterSettings] This configuration group is related to the eZURLAliasFilterAppendNodeID URL filter This makes it possible to filter on which type of content the node id will ...
[AdminEnvironment]  
[AdminSiteAccessMenu]  
[SiteDataSettings] Site data: the name/value rows of the table ezsite_data (eZSiteData), such as ezpublish-version.
[PasswordSettings]  
[PasswordChangeRequiredSettings]  
[SignInSecondFactorSettings]  
[PasskeySettings]  
[ContentFieldMarkerSettings]  
[ReauthSettings]  
[ReauthGroup_account]  
[ReauthGroup_users]  
[ReauthGroup_system]  
[ReauthGroup_export]  
[ReauthGroup_delete]  
[ReauthGroup_content]  
[ConfigurationSettings]  
[PageLayoutHooks]  
[TemplateBridgeSettings] The converters of exp:template:convert (lib/templatebridge/classes/exptemplatedesignconverter.php): ConverterList[<from>-<to>]=<class> converts one template ...
[ContentSecurityPolicy]  
[eZINISettings]  
[LinkCheck]  
[SettingsViewSettings]  

In this section

Contributors

Comments (6 historical)

Written by readers of the earlier documentation sites, kept as they were.

  1. Re: Missing ...

    marcin ·

    Missing [SiteSettings][Dir]

    1. Re: Re: Missing ...

      Olivier Clavel ·

      [SiteSettings] -> DefaultPage : Page where you get redirected after login and logout. Different from IndexPage. (default /content/view/full/2/)

  2. missing QueryAnalysisOutput

    Gaetano Giunta ·

    in DatabaseSettings: if enabled (and sqloutput enabled), executed queres have an analysis done and sipalyed

  3. missinga AlwaysLog[]

    Gaetano Giunta ·

    in DebugSettings: used to set types of info that will be logged even if debug output is off

  4. Typo

    Name ·

    There is a typo on this page:
    > Sets if the translation cache should be anabled or disabled.
    Should be E-nabled instead of A-nabled.

  5. ShareCompiledTemplates-Settings

    Name ·

    The following TemplateSettings are missing:
    # If you share compiled templates with other site accesses
    ShareCompiledTemplates=disabled
    # Where to store shared compiled templates
    SharedCompiledTemplatesDir=

Comments

Add a comment

Comments are read by a moderator before they appear.