Directus Extension: Magnolia Dependency Checker

Display dependencies and usages of your Directus content within Magnolia CMS.

This extension provides a read-only interface that queries a Magnolia CMS instance to see where a specific Directus item is being used.

Features

• Dependency Listing: Shows a list of pages in Magnolia where the current item is referenced.
• Direct Links: Provides direct links to the Magnolia Admin Central to edit the corresponding pages.
• Smart Configuration: Automatically detects the Magnolia host via environment variables or falls back to per-field configuration.
• Visual Feedback: Shows loading states and clear messages if no dependencies are found.

Installation

Via NPM (Recommended)

npm install directus-extension-magnolia-dependency-checker

Manual Installation

1. Clone this repository.
2. Run npm install and npm run build.
3. Copy the dist folder to your Directus extensions directory (e.g. extensions/directus-extension-magnolia-dependency-checker).

Configuration

Environment Variable (Global)

To configure the Magnolia host globally for your Directus instance, set the following environment variable in your docker-compose.yaml or .env file:

MAGNOLIA_HOST=http://your-magnolia-instance:8080

Usage

1. Create a Text or String field in your Directus collection (usually a computed field or just for display).
2. Select Magnolia Dependencies as the interface for this field.
3. The extension will automatically use the Primary Key of the item to query Magnolia.

Requirements

• Directus v10.10.0 or higher
• Magnolia CMS with an accessible REST endpoint for usages (e.g. /.rest/directus/v1/usages/{id})