mercury_editor_page_templates

A Drupal module that provides a template system for creating pages with pre-configured layouts and content using Mercury Editor.

Overview

Streamlines page creation by providing pre-defined templates that integrate with Mercury Editor. Content creators can select templates when creating new pages, ensuring consistency and reducing setup time.

Features

• Template Management: Create, edit, and delete page templates via admin interface
• Content Type Integration: Configure templates for specific content types
• YAML Configuration: Define templates using YAML for easy editing
• Flexible Field Support: Support for any field machine name
• Region Support: Layout regions for content placement
• Mercury Editor Integration: Seamless integration with Mercury Editor

Requirements

• Drupal 10.x or 11.x
• layout_paragraphs: ^2.1
• mercury_editor: ^2.0,
• paragraphs: ^1.15,
• php: >=8.1

Installation

composer require drupal/mercury_editor_page_templates
drush en mercury_editor_page_templates

Quick Start

1. Configure Mercury Editor: Set up content types in Mercury Editor settings
2. Create Templates: Go to Configuration > Content authoring > Mercury Editor Page Templates
3. Use Templates: When creating content, select from available templates

YAML Template Example

-
  type: custom_section
  description: 'Main Content Section'
  layout: two_column_75_25
  paragraphs:
    -
      type: content_block
      description: 'Content block with title and body in the first region'
      field_config:
        -
          field_name: field_title
          field_structure:
            value: 'Welcome to Our Site'
        -
          field_name: field_body
          field_structure:
            value: 'This is the main content that appears in the first region with detailed information about our services and offerings.'
            format: full_html
      style_options:
        background_color: 'Light Blue'
        text_alignment: 'Left'
        padding_size: 'Medium'
      region: first
    -
      type: text_block
      description: 'Simple text block in the second region'
      field_config:
        -
          field_name: body
          field_structure:
            value: 'This is sidebar content that appears in the second region.'
            format: full_html
      style_options:
        background_color: 'bg-light border-2'
        text_alignment: 'text-center font-bold'
        border_style: 'border-solid border-gray-300'
      region: second

Troubleshooting

Templates not showing?

• Ensure content type is configured in Mercury Editor
• Check template is assigned to correct content type
• Validate YAML syntax

YAML errors?

• Use 2-space indentation
• Check for missing colons after field names
• Validate with online YAML validator