Campaign importer module
The Campaign Importer module enables you to import static campaign pages into magnolia without templating.
Therefore it allows you to import static HTML files and related resources (CSS, JS) into Magnolia and convert them into magnolia pages.
Marketing campaigns typically have a very short lifespan. A campaign promotes specific products or services and is decommissioned after the campaign ends. A marketing agency commonly creates the campaign outside of Magnolia and delivers it as static HTML pages. Integrating such as campaign into Magnolia usually requires the services of an IT professional or developer.
The Campaign Importer app eliminates this need, allowing marketers to import and publish marketing campaigns without IT support. The campaign can then take full advantage of Magnolia’s features such as integrated marketing tags management , multilanguage support, A/B testing using page variants and personalization .
Installing with Maven
Maven is the easiest way to install the module. Add the following to your bundle:
<dependency>
<groupId>info.magnolia.campaign</groupId>
<artifactId>magnolia-campaign-import</artifactId>
<version>3.1.12</version>
</dependency>Usage
The Campaign Importer app is installed by the Campaign Importer module. The app is located at Configuration > /modules/campaign-importer/.
- Workspace
-
The app operates on the campaigns workspace where campaign content is stored.
- Node types
-
The Campaign Importer module registers a custom
mgnl:campaignnode type. The app operates on nodes of this type.
Importing a campaign archive
To import a campaign archive:
-
Open the Campaign Importer app.
-
Click Import Campaign.
-
Browse to a .zip archive that contains the static campaign content.
-
Click Save changes.
The archived contents are now displayed in the app.
Campaign archive file format
| Please note that in the current versions CSS files can’t have absolute paths references to images. |
The app imports campaign files as a compressed archive (.zip) and creates a Magnolia node structure that matches the internal structure of the archive. HTML files are at the archive root and CSS, JavaScript and image files in separate directories.
css/
js/
images/
fonts/
index.html
register.html
thanks.htmlWhile this is the typical structure the App can also import campaigns that are structured differently. For example, if a campaign archive contains a large number of HTML pages structured into separate subfolders the app will respect this structure and create a similar representation in the Magnolia content tree.
Please note the your zip file needs an index.html file
|
Creating campaign pages
To create pages from the imported files:
-
Select the imported campaign and click Create Pages.
-
Select a node in the content tree under which you want to create the campaign pages. To create pages at the root level type / (forward slash).
-
Open the Pages app to view the created pages.