Magnolia
Concept
Magnolia has a number of concepts:
- Usually Magnolia is set up in such a way that you have one instance running as the authoring system, one as the public system. This provides flexibility, scalability and security.
- If an instance is author or public is determined by a setting in the Config GUI. Setting isAdmin to true will generally let you edit pages etc. Set it to false for public instances - see Changing an author instance into a public instance
- To get content from the authoring instance to the public instance(s), you use a mechanism called activation, which is executed from the GUI. Activation pushes content from the source instance (the one you are using when you click activate) to its subscribers
- There can be any number of subscribers. Subscribers are configured through the GUI. Usually, there is one subscriber only, called the public instance
- Magnolia is delivered as a single war file which per default is set up as authoring.
- Magnolia stores all content (web pages, images, documents, configuration, data) in a content repository. The repository implementation we have chosen, Apache Jackrabbit, adheres to the Java Content Repository standard (JCR).
- Launch Screen shows apps
- Pages app shows site hierachy as site tree or list view and action bar at the right
- Pages have a template assignment which defines the look and feel
- Pages consist of areas
- Areas consist of components (editables are green)
- Images, documents, videos and other asset files are stored in the Assets app
Content Repository
Templates
Themes
A theme gives the site its visual identity through the use of images, colors and typography. A theme consists of Cascading Style Sheets (CSS), Javascript files, template images and an imaging configuration which tells the Imaging module how to resize and crop images for a particular page or component. The STK ships with two default themes:
- pop the black and pink look that you see in the demo-project and demo-features websites.
- pop-mobile the black and blue look you see in the the smartphone variation.
Installation
Installation according to [1]:
- download magnolia-bundled-webapp-5.2.1.war
- extract to directory magnoliaAuthor.war
- change property magnolia.home in magnoliaAuthor.war\WEB-INF\config\default\magnolia.properties to <JBOSS_DATA_DIR>\magnolia\
- create empty file magnoliaAuthor.war.dodeploy
- copy directory and empty file to <JBOSS_DIR>\standalone\deployments
- call http://localhost:8080/magnoliaAuthor
- click 'start installation'
- saved output to C:\Uwes\Documents\Magnolia\Magnolia Installation.htm
- extract to directory magnoliaPublic.war
- change property magnolia.home in magnoliaAuthor.war\WEB-INF\config\default\magnolia.properties to <JBOSS_DATA_DIR>\magnolia\
- create empty file magnoliaPublic.war.dodeploy
- copy directory and empty file to <JBOSS_DIR>\standalone\deployments
Configuration according to [2] for JBoss 7:
- edit <JBOSS_DIR>\configuration\standalone.xml according for JAAS
- edit <JBOSS_DIR>\bin\standalone.conf to increase java startup parameter for JBoss
- create module folder in <JBOSS_DIR>/modules/org/bouncycastle/main
- download jar files from [3] to this folder:
- bcmail-jdk15on-150.jar
- bcpg-jdk15on-150.jar
- bcprov-ext-jdk15on-150.jar
- bcprov-jdk15on-150.jar
- create a module.xml file in the same folder
- Create a jboss-deployment-structure.xml file in both magnolia's WEB-INF folder
- Remove the Bouncy Castle JAR files from magnolia's WEB-INF/lib folder:
- bcmail-jdk16-1.46.jar
- bcpg-jdk16-1.46.jar
- bcprov-jdk16-1.46.jar