Magnolia 5.7 reached extended end of life on May 31, 2022. Support for this branch is limited, see End-of-life policy. Please note that to cover the extra maintenance effort, this EEoL period is a paid extension in the life of the branch. Customers who opt for the extended maintenance will need a new license key to run future versions of Magnolia 5.7. If you have any questions or to subscribe to the extended maintenance, please get in touch with your local contact at Magnolia.
The JCR browser app is a Magnolia tool that allows you to work at the repository level in any workspace. You can see details that are not readily visible in a specific app's tree view, and edit content and associated configuration.
Configuration
The JCR app is based on the content app framework. The app is in the Tools app group that is only available to the superuser
role. This restriction is configured in the app launcher layout.
The app is configured in /modules/jcr-browser-app/apps/jcr-browser
.
Node name |
---|
modules |
jcr-browser-app |
apps |
jcr-browser |
Using the app
You can edit and add content in any workspace, but always do this with caution because you are working a repository level.
- Browsing: Use the dropdown to switch between workspaces. All workspaces are available. If you create a new workspace it will automatically be available in the app.
- Display system properties: Check to display properties such as UUIDs, creation dates and user information. These properties are omitted by default. When enabled they cannot be edited and editing actions are disabled.
- Editing: You can work with all content, except system properties, in the same way as any other app.
The Configuration app is essentially a JCR browser that displays the config
workspace.
Website JCR browser example
The JCR browser shows content as it is stored in the JCR and is useful for looking at details that you would not see in the Pages app.
Example: Comparison of Demo Travel's About page in the editor and JCR browser.
Node name | Value | Type |
---|---|---|
about | mgnl:page | |
main | mgnl:area | |
00 | mgnl:component | |
headline | About Magnolia Travels | String |
headlineLevel | small | String |
headline_de | Über Magnolia Travels | String |
imagePosition | below | String |
text | <p>We are a full serv ...</p> | String |
text_de | <p>Wir sind eine una...</p> | String |
04 | mgnl:component | |
column1 | mgnl:area | |
0 | mgnl:component | |
column2 | mgnl:area | |
03 | mgnl:component | |
headline | Learn more | String |
headlineLevel | medium | String |
headline_de | Mehr erfahren | String |
imagePosition | below | String |
00 | mgnl:component | |
01 | mgnl:component | |
02 | mgnl:component | |
layout | 8x4 | String |
footer | mgnl:area | |
.... | ||
hideInNav | false | Boolean |
title | About | String |
title_de | Über uns | String |
Nodes and properties:
<page folders> | Pages ( |
| Areas (mgnl:area ) are stored in content nodes: |
| Components (
|
| Component properties are stored under the component node:
|
| Area properties, if any, reside under the area node. |
| Page properties reside under the page node:
|
Editing in the Website JCR browser
While in some cases the JCR browser may be considered a quicker alternative to editing content in a dedicated app, editing directly in the JCR browser rather than in the app may actually cause more damage than good to the integrity of your data.
There are certain things that you can do in the browser that are not possible in the editor. Here are a few suggestions:
- Add multiple similar components to a page using the Duplicate item action. This saves the time and effort of adding the components from scratch in the editor. Duplicates can be amended in either the editor or browser.
- Add the same component to multiple pages. Duplicate a component on page 1 and then move the duplicate to the same area on page 2 or more.
While it is possible to move components from one page area to another, this is not a best practice. For seamless publishing your page content should always comply with the options in the template.
Publishing in the Website JCR browser
Publishing in the Website JCR browser is different from publishing in the Pages app:
- When you publish a page in the JCR Browser, only the page and its properties are published.
- When you publish a page in the Pages app, the page and ALL its children (properties, areas, components) are published.