Skip to main content

Magnolia

Ai12z Magnolia Module Installation and Setup Guide

Step 1: Enable Connector

  1. Log in to the Ai12z portal using admin credentials.
  2. In the organization settings, verify that the connectors are enabled. Organization settings screen showing enabled connectors
  3. Navigate to your project.
  4. Select Project Settings.
  5. Click on the edit button next to Connectors and enable Magnolia

Step 2: Configure Connector

  1. Select Connectors from the project left navigation.
  2. In the Connector Store Confugation screen click on Magnolia's action menu > Edit
  3. In the Connector Configuration screen, fill out the information
    • Magnolia author site url
    • Magnolia user with access to get content
    • Crawler Settings: Name is required Magnolia connector configuration example
JSONATA Expression

It's important to parse the content from the data returned from Magnolia rest api.

{ "content": $.*.**.freeText }

The above expression selects all freeText from Magnolia object.

{
"content": [
"<p>Sample content</p>",
"<p>Sample content</p>",
"<p>Sample content</p>"
]
}

Optionally, you can map "id", "title", "description", "url" just like "content"

  1. Download Webhook Configuration.

Step 3: Magnolia Module Setup

Set Up the Module for Different Installations

Configuration for Magnolia ZIP Bundle Installation

  • Go to where the Magnolia ZIP bundle is installed, then place the ai12z module in the following directory:
    • C:\magnolia\magnolia-dx-core-demo-XXXX\apache-tomcat-XXXX\webapps\magnoliaAuthor\modules

Configuration for Magnolia CLI Installation

  • Go to where the Magnolia CLI is installed, then place the ai12z module in the following directory:
    • C:\magnolia\light-modules

Note:

  • Magnolia webhooks are only available with the DX Core feature and have been supported since the 6.2.22 Magnolia release.
  • Always restart the server whenever you make any changes in Magnolia CMS.