Site definition
A site definition contains site-wide configuration such as navigation, common page areas, and JavaScript that you want to load on every page. A site definition also contains a reference to your theme and defines locales for entering content in multiple languages.
Do I need a site definition?
No, it is not necessary to use a site definition. A site based on concrete template definitions works perfectly well. A site definition is an advanced option. It is useful when you have a large site and want to avoid repeating a similar configuration.
Without a site definition you can still:
-
Choose which templates are available to editors.
-
Add CSS and JavaScript at the page level instead of site level.
-
Configure variations for each page template.
But without a site definition you cannot use:
-
sitefntemplating functions
Prerequisites
You need the Site module in order to create a site definition. The Site module may not always be included, for example, when you create your own webapp based on the empty webapp. Add a dependency to the Site module in your webapp POM file.
|
DX Core provides the multisite feature. It allows you to configure a different site definition for each website in a single Magnolia instance. Each site can be mapped to a different domain and you can serve content from different workspaces. These features are in the Multisite module. For multisite configuration details, see: |
|
Site limitation In DX Core, the number of sites that can be used is defined by the number of sites purchased. In the Community Edition, you can only create and use one site. |
Configuring a site definition
You configure a site definition in the Site app.
| Property | Description |
|---|---|
|
optional |
|
optional The template prototype is a master template definition which applies to the whole site. Anything you configure in the prototype is applied to all page templates. |
|
optional Template availability defines which page templates are available to editors in the Pages app. There are more ways to control page template availability. |
|
optional, default is Enables and disables the site definition. |
|
|
|
optional Reference to a theme that defines the look and feel of the site. Themes are configured in |
|
optional Locale configuration and support for entering and serving content in multiple languages. For more details how to configure this |
|
optional URI mappings that define which node in a workspace should be served when a particular URI is requested. |
|
optional Custom template properties that you can access from a script without having to write a class. |
|
optional Variations adapt the site for different devices or geographical locations. The Site app is actually a shortcut that displays the configuration from:
|
Example site configuration
Site configuration for the Travel Demo site that ships with Magnolia CE Demo. See below also how the site module configuration extends it.
travel:
templates:
class: info.magnolia.module.site.templates.ReferencingPrototypeTemplateSettings
prototypeId: travel-demo:pages/prototype
availability:
templates:
home:
id: travel-demo:pages/home
standard:
id: travel-demo:pages/standard
searchResultPage:
id: travel-demo:pages/searchResultPage
pur:
id: travel-demo:pages/pur
tour:
id: tours:pages/tour
categoryOverview:
id: tours:pages/categoryOverview
destinationCatOverview:
id: tours:pages/destinationCatOverview
enableAllWithRenderType:
freemarker: freemarker
spa: spa
theme:
name: travel-demo-theme
i18n:
class: info.magnolia.cms.i18n.DefaultI18nContentSupport
enabled: true
fallbackLocale: en
locales:
en:
country:
enabled: true
language: en
de:
country:
enabled: true
language: de
cors:
travel:
uris:
rest:
patternString: /.rest/*
allowedOrigins:
all: *
allowedMethods:
get: GET
allowedHeaders:
accept: Accept
content-type: Content-Type
origin: Origin
x-pingother: X-PINGOTHER
x-requested-with: X-Requested-Withconfig:
site:
extends: /modules/travel-demo/config/travel
...Site definitions in CE and DX Core
The steps to create a site definition can vary depending on which modules you have installed. In Magnolia Community edition, you are only allowed a single site definition. For Magnolia DX Core, multiple site definitions are allowed. These instructions can be used as a guide for creating a new site definition from scratch.
Community Edition
When using Community edition, only the site module is installed. Therefore, you only have the option for a single definition as community edition can only support one site. Multiple sites would require multiple author instances or an upgrade to DX Core.
DX Core
When using DX Core, only the multisite module is installed. With the multisite module you can have as many sites as required. However, there are physical limits as each new site that is added creates additional complexity. It can sometimes be helpful to break installations into multiple author instances. Especially in cases where you have multiple different teams spanning different regions.
|
You can have as many author instances as you need as long as the content stays independent. |