Magnolia 6.1 reached extended end of life on June 2, 2020. Support for this branch is limited, see End-of-life policy.
This tutorial guides you through the process of creating a content app in Magnolia. The app you create is called the Bookshelf app and you create it as a Magnolia light module from a custom content type definition.
The tutorial consists of three pages:
Going through the tutorial you learn:
If you want to skip the tutorial and install the final app immediately, clone the repository containing the ready-made Bookshelf app as a light module directly into your Magnolia light module folder with the command:
git clone -b release/6.1 --single-branch https://git.magnolia-cms.com/scm/documentation/bookshelf.git
The Bookshelf app you create in this tutorial is an example of content app. It is a simple book catalog allowing the user to store bibliographic data about each book: its title, the names of the author(s), publisher's name and the ISBN-13 number. The app also allows you to group selected book items into folders called shelves in the app.
What is a content app?
A Content app is a specialized app type for managing structured content. The content app user interface consists of a browser subapp and one or more detail subapps. Content apps make it easy to enter items such as products or events. Many native Magnolia apps such as Tours and Contacts are content apps. Because this app style is used often, the framework provides convenience classes to make building a content app faster.
The Bookshelf app consists of two subapps.
In the Book Browser subapp, you can:
The Book Detail subapp is a place where you can create and edit a book's bibliographic properties using text fields and a checkbox field.
For each book item, the Bookshelf app can store and retrieve the following content properties:
The Bookshelf app is based on Magnolia content types. Expand the following link to see more details about the app's design parameters.
On the next page, you create a basic Bookshelf app.