Magnolia: Difference between revisions

From Wiki RB4
Line 12: Line 12:
* '''Launch Screen''' shows apps
* '''Launch Screen''' shows apps
* '''Pages''' app shows site hierachy as site tree or list view and action bar at the right
* '''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 have a [[#Templates|template]] assignment which defines the look and feel
** Pages consist of '''areas'''
** Pages consist of '''areas'''
** Areas consist of '''components''' (editables are green)
** Areas consist of '''components''' (editables are green)

Revision as of 19:56, 15 January 2014

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.
  • You control the public instance from the author environment through means of activating content from the author environment to its subscriber(s)


  • 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

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