Wagtail CRX (CodeRed CMS)

Stream Forms in Wagtail CRX allow you to build complex forms using StreamFields. This enables advanced features like multi-step forms, mixed content (text/images) between fields, and conditional logic.

To use them, you must first implement the CoderedStreamFormPage model in your project (see Implementation guide). Once implemented, you create a Stream Form page and add content via a StreamField. The StreamField uses a hierarchical structure:

1. Top Level: Contains step blocks. Each step block represents a single page in a multi-step form.
2. Inside Step Blocks: Each step contains its own StreamField where you can mix standard form fields with content blocks.

StreamField Structure:
- Step Block (Top Level)
  - StreamField (Nested)
    - Form Field
    - Content Block
    - Form Field

Wagtail CRX uses a hierarchical 'Parent-Child' relationship to organize site functionality. Specific features are implemented as collections of pages where a specialized 'Landing Page' acts as a parent to individual content pages (e.g., an 'Article Landing Page' acts as the parent for 'Article Pages').

To add a new content page, navigate to its designated parent page in the Wagtail admin and click the Add Child Page button.

Supported Parent-Child Relationships

Once the Mailchimp integration is implemented, you can configure how form data maps to Mailchimp via the Wagtail admin:

1. Accessing Integrations: Open a FormPage and navigate to the Integrations tab. Click the plus icon to add a new Mailchimp integration instance.
2. Interest Groups: Select the target Mailchimp list. You can then select the specific interest categories you want the subscriber to be assigned to.
3. Merge Variables: Map form submission values to Mailchimp merge variables using Django template syntax. The context available for rendering is the set of form submission fields.

Mapping Logic: If your form has a field named First Name, the context variable is first_name. To map this to a Mailchimp merge variable named FIRSTNAME, enter {{ first_name }} in the integration configuration field.

Wagtail CRX is designed with an abstraction-first development philosophy. Core functionality is implemented in Abstract models to ensure that migrations and core logic remain stable across different projects.

When you initialize a new Wagtail CRX project, the generated application includes Concrete implementations of these abstract models.

Best Practices for Developers:

• Use the Concrete models as a starting point: The pre-loaded concrete models are intended to be modified to suit your specific project needs.
• Caution when modifying core logic: While you are encouraged to customize the concrete models, changing built-in functionality can have untested consequences for the site structure.

A Location Landing Page (extending CoderedLocationIndexPage) acts as a container for multiple individual locations and displays them on an interactive Google Map.

In the Layout Tab, you can configure the map's initial state:

• Center Latitude: The latitude to center the map on.
• Center Longitude: The longitude to center the map on.
• Zoom: The default zoom level (values 1-20).
  • 1: World
  • 5: Landmass continent
  • 10: City
  • 15: Streets
  • 20: Buildings

Note: Zoom functionality requires a Google Maps API key configured in Settings > CRX Settings.

As of version 0.24, the Import/Export functionality has been relocated. You can find the Import tool by navigating to Settings > Import in the side menu.

Note: The ability to import or export pages using JSON was removed in version 0.24; only CSV is supported for page imports.