Tutorial overview
The tutorial consists of three pages:
- My first content app – This page, which describes the Bookshelf app.
- Part I - Creating a basic content app – Shows how to install Magnolia with Magnolia CLI and create the basic Bookshelf app from a content type definition.
- Part II - Fine-tuning a basic content app – Provides instructions to turn the basic app into the final and ready-to-use Bookshelf app.
Going through the tutorial you learn:
- How to define content types and use them to quickly create a content app.
- The basics of configuring fields and setting field validators.
- How to override configuration properties.
- How to make the elements of the app's UI ready for internationalization.
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.2 --single-branch https://git.magnolia-cms.com/scm/documentation/bookshelf.git
Bookshelf app use case
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?
Bookshelf app subapps
The Bookshelf app consists of two subapps.
Book browser
In the Book Browser subapp, you can:
- Browse in the book catalog.
- Add, rename and delete books.
- Add, rename and delete shelves (folders for organizing books).
Book detail
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.
Book properties
For each book item, the Bookshelf app can store and retrieve the following content properties:
- Short cataloging name (a required content property).
- Full book title.
- Author(s)' name(s).
- Whether the author(s) role is editorial or not.
- Book description.
- Publisher's name.
- Book publication date.
- ISBN-13 number.
Bookshelf app and Magnolia content types
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.