Blueprint Developer Manual / Version 2406.1
Table Of ContentsThe site model and the sites service are strongly connected with each other. While the site model consists of properties defining the site structure, the sites service uses this model to work with sites programmatically.
Sites Service
The sites service is designed to access the available sites and to determine the relation between sites and contents. The site model configures the behavior of the sites service.
For developing multi-site features the main entry point is the sites service.
Site Model
The site model is the centralized configuration of the CoreMedia Multi-Site behavior. Its configuration is required in all applications including the Command Line Tools.
While the server applications are configurable via Spring application.properties as usual,
the configuration for the Command Line Tools can be adjusted in the
commandline-tools-sitemodel.properties file in the
properties/corem directory of the
cms-tools-application module.
Site Model Properties
The following table illustrates the configurable site model properties. To get to know more about the properties and patterns used, consult the Javadoc of com.coremedia.cap.multisite.SiteModel.
sitemodel.site.indicator.documentType
| |
| Description |
Specifies the content type of the site indicator content item. Each site must only have one instance of that content type. |
| Default Value | CMSite
|
sitemodel.site.indicator.depth
| |
| Description |
Defines the depth under the root of the site folder, where the site indicator content item resides. |
| Deprecated |
Setting will phase out. First it will default to 0 and will be removed completely someday. In the end, the site indicator will always be located in the site root folder. |
| Default Value | 0 |
sitemodel.site.indicator.namePattern
| |
| Description |
Name pattern, which will be used for the name of the site indicator content item when
deriving a site. Only placeholder |
| Default Value | {0} [Site]
|
sitemodel.site.rootdocument.namePattern
| |
| Description |
Defines the pattern for the site's home page content item name, used while deriving a
site. Only placeholder |
| Default Value | {0}
|
sitemodel.site.manager.groupPattern
| |
| Description |
Defines the pattern for responsible default site manager group name when deriving a site. For available placeholders see Table 5.21, “Placeholders for Site Model Configuration” |
| Default Value | manager-{4}
|
sitemodel.siteManagerGroupProperty
| |
| Description |
Defines the property of the site indicator content item holding the site manager group names. |
| Default Value | siteManagerGroup
|
sitemodel.groupPropertyDelimitingRegEx
| |
| Description |
Defines the separator (as regular expression) how to split group names into elements, as for example for the site-manager-groups. |
| Default Value | comma, including trailing space characters
|
sitemodel.translationManagerRole
| |
| Description |
Defines the group name denoting the role which permits a user to start a translation workflow. |
| Default Value | translation-manager-role
|
sitemodel.idProperty
| |
| Description |
Defines the property of the site indicator content item which contains the site id. |
| Default Value | id
|
sitemodel.nameProperty
| |
| Description |
Defines the property of the site indicator content item which contains the site name. |
| Default Value | name
|
sitemodel.localeProperty
| |
| Description |
Defines the property of translatable content and the site indicator content item, which holds the locale of the content. |
| Default Value | locale
|
sitemodel.masterProperty
| |
| Description |
Defines the property of translatable content and the site indicator, which contains the link the master content item. |
| Default Value | master
|
sitemodel.masterVersionProperty
| |
| Description |
Defines the property of translatable content, which contains the version the corresponding master content item. |
| Default Value | masterVersion
|
sitemodel.rootProperty
| |
| Description |
Defines the property of the site indicator content item, which refers to the home page content item of this site. |
| Default Value | root
|
sitemodel.uriSegmentProperty
| |
| Description |
Defines the property of the site's home page content type, which defines the root URI segment of the site. |
| Default Value | segment
|
sitemodel.uriSegmentPattern
| |
| Description |
Defines the pattern for the default root URI segment when deriving a site. For available placeholders see Table 5.21, “Placeholders for Site Model Configuration”. |
| Default Value | {0}-{4}
|
sitemodel.rootFolderPathPattern
| |
| Description |
Defines the pattern to determine the site folder for a new derived site. For available placeholders see Table 5.21, “Placeholders for Site Model Configuration”. |
| Default Value | /Sites/{0}/{6}/{5}
|
sitemodel.rootFolderPathDefaultCountry
| |
| Description |
Defines the folder name for the country folder, if the locale chosen while deriving a site defines no country explicitly. |
| Default Value | NO_COUNTRY
|
sitemodel.translationWorkflowRobotUser
| |
| Description |
Defines the user name of the user responsible for creating derived content during a translation workflow.
|
| Default Value | translation-workflow-robot
|
Table 5.20. Properties of the Site Model
Site Model Placeholders
| Placeholder | Description | Example |
|---|---|---|
{0}
| site name | MySite
|
{1}
| site locale's language code | en
|
{2}
| site locale's country code (defaults to language code, if not available) | US
|
{3}
| site locale's variant (defaults to country or language code, if not available); using BCP 47 Extensions | u-cu-usd
|
{4}
| site locale's IETF BCP 47 language tag | en-US-u-cu-usd
|
{5}
|
site locale's language display name (localized in U.S. English); only available for
sitemodel.rootFolderPathPattern
| English
|
{6}
|
site locale's country display name (localized in U.S. English); only available for
sitemodel.rootFolderPathPattern
| United States
|
{7}
|
site locale's variant with the prefix variantPrefix configured in site model's
Spring context; defaults to empty String; only available for
sitemodel.rootFolderPathPattern. See
IANA Language Subtag Registry
for valid registered variants.
| _arevela
|
Table 5.21. Placeholders for Site Model Configuration
