Skip to content

User Guide

Ryan Hodges edited this page Sep 9, 2026 · 1 revision

User Guide

Below find direction on how to manage the many features of mp-layers:

Themes

Creating Themes

Editing Themes

Migrating Themes

Exporting Theme Fixtures

It is possible to migrate your themes from one server to another. This export will include:

  • Every Theme that is a child of the Theme being exported, one of their children, or any other 'descendant'.
  • Every Layer that is a child of the Theme being exported, one of their children, or any other 'descendant'.
  • Every ordering to maintain the assigned hierarchy of Themes and Layers
  • Every related object needed to support each Layer such as Companions, Attribute Infos, Lookup Infos, and Sliders
  • This does NOT include 'site' info (see 'Importing Theme Fixtures' for details)

The process is straight forward:

  1. Log in as an administrator to your.site.com/django-admin
  2. Navigate to Layers->Themes (your.site.com/django-admin/layers/theme/
  3. select the Theme(s) you wish to export
    • You may select more than one
    • You don't need to select themes that are 'descendants' of other selected themes, this will only slow your export down
  4. Select the 'Export Theme(s) For Migration' action and click Go
image

Your browser will download a .json file to your default downloads folder. This is your 'fixture' file.

Importing Theme Fixtures

Once you have exported a Theme 'fixture' file from a 'source' Madrona Portal server, you can now import your Theme and all of its descendants into a new 'target' server.

  1. Log in as an administrator to your.site.com/django-admin

  2. Navigate to Layers->Themes (your.site.com/django-admin/layers/theme/

  3. Click the 'IMPORT THEME FIXTURE' button at the top right of your screen

    • This is not the same as the 'IMPORT' button
  4. On the next screen, click the 'Browse...' button and find your fixture file

    • The name will be something like 'themes_x_y_z.json' where x, y, and z would be the IDs of three different selected during the 'Export Theme Fixtures' process above. You may have only selected 1 ('themes_x.json'), or several more.
    • image
  5. Click on the 'Preview' button to begin the upload. Once your fixture has been processed, you will be shown a list of all changes and updates that will be made by importing this file.

    • At this time, nothing has been changed on your target server - cancelling the import will leave your site as it was.
    • image
  6. Review the changes, then click 'Confirm' to accept those changes into your site, or 'Cancel' to reject them.

  7. If you confirm, when the process is complete, you will be redirected to the Themes page and a status message will appear at the top

    • image

Layers

Creating Layers

Editing Layers

Migrating Layers

Exporting Layer Fixtures

Importing Layer Fixtures

Specific Layer Forms

Attribute Infos

Lookup Infos