Editing 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|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 [[#Templates|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===
A content repository is designed to store, search and retrieve hierarchical data. Data consists of a tree of nodes with associated properties. Data is stored in the properties. They may store simple values such as numbers and strings or binary data (images, documents) of arbitrary length. Nodes may optionally have one or more types associated with them, which in turn dictates the type of their properties, the number and type of their child nodes, and certain behavioral characteristics.

===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 [http://documentation.magnolia-cms.com/display/DOCS/Deploying+a+WAR+on+JBoss+AS]:
* 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 [http://wiki.magnolia-cms.com/pages/viewpage.action?pageId=1802332] 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 [http://www.bouncycastle.org/latest_releases.html] 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