Definitions app
The Definitions app is the single place to find all definitions loaded by Magnolia through the Registry API.
The app displays active definitions from all sources (YAML, JCR config workspace, Code, and in-memory) and origins (classpath, file system, and JCR resources workspace).
Light development introduced an additional configuration source in Magnolia and the app provides an overview of both JCR and file-based definitions. At a glance, back and front-end developers can see the definition sources.
In the Definitions app users can:
-
View, search and filter definitions by multiple criteria.
-
Access definitions in either the Configuration or Resource files app directly from the Definitions app.
The app also shows definition decorations and configuration errors.
Definition types
The app includes all definitions that are bound to info.magnolia.config.registry.Registry (for example, info.magnolia.rendering.template.registry.TemplateDefinitionRegistry).
Searching and filtering definitions
The in-app search field and filters allow you to quickly find what you are looking for.
| In-app search in the Definitions app is case-sensitive. |
The search field searches through parent node names in the Title column. In addition, the following filters are available:
-
Type: Select definition type.
-
Module: Select a module. The field displays all modules.
-
Origin: See Resources: Origin and loading order.
-
jcr
-
file
-
code
-
inMemory
-
extra
-
-
Decorated: See Definition decoration.
-
Severity
-
SEVERE
-
MAJOR
-
DEPRECATED
-
MINOR
-
Results are presented in a tree view display. This is to ensure you can understand in which folder the item you’ve searched for is located.
Viewing definitions
You can expand any definition node to view a representation of the full configuration.
Accessing definitions
Dedicated actions allow you to access a definition for editing in either the Resource files or Configuration app:
-
Show in Resources app displays for file-based definitions. The action opens the file in read only mode in the Resource files app. You can choose to hotfix the definition in the app or edit it on the file system.
-
Show in Configuration app displays for JCR-based definitions. The action opens the definition in the Configuration app where you can edit the definition in the JCR.
All YAML definitions display in the Origin column as file. The origin of these definitions could be the file system or the classpath. You can see each origin in the Resource Files app.
Decorated definitions
Decorated definitions are marked in the Decorated column. The Show definition decorators action opens the Applied definition decorators popup which shows the source file and the decorated path of each decorator.
Definition errors
The app makes it easy to find problematic definitions via either the Problem severity column in the browser or the Problems sub app.
The following deprecated definitions are shown:
| Deprecations whose origin is in Magnolia code are not displayed in the Problems sub app. |
-
Deprecated classes used by any definition.
-
Deprecated or non-existing templates used by block definitions.
-
Deprecated or non-existing page template definitions referenced from site definitions.
-
Deprecated or non-existing theme definitions referenced from site definitions.
-
Template references:
-
Deprecated or non-existing dialogs.
-
Deprecated or non-existing component definitions used in page definitions.
-
Non-existing template script paths.
-
Configured but non-existing renderer.
-