Skip to content

Help template

Brent Cordis edited this page Mar 10, 2026 · 3 revisions

Template (Edit)

Overview

The Template edit screen uses a visual Layout Editor to configure how Proclaim content displays on the frontend. Each template manages 7 view contexts, allowing you to arrange elements, set link behaviors, and control display options through drag-and-drop.

How to Access

Components -> Proclaim -> Templates, then click New or click an existing template title.

Toolbar

Button Action
Save Saves and stays on the edit screen
Save & Close Saves and returns to the templates list
Save & New Saves and opens a blank form
Cancel Discards changes and returns to the list
Help Opens this help page

Tabs

General Tab

The General tab contains the template settings, terms & conditions, and filter configuration all in one view.

Template Settings

Field Description
Template Title Required. Descriptive name for this template.
Text Optional descriptive text for the template.
Status Published, Unpublished, or Trashed.
ID Auto-generated identifier (read-only).

Content Scope

Settings that control which content is included in this template's output.

Terms & Conditions

A section within the General tab for configuring terms displayed on the frontend:

Field Description
Use Terms Toggle to enable/disable terms display.
Terms Rich text editor for the terms content.

Filter Settings

Configure which search and filter tools appear on frontend list views. Located at the bottom of the General tab.

Layout Editor Tab

The Layout Editor provides 7 context tabs, one for each view type:

Context Prefix Description
Messages List (none) How messages appear in list views. 20+ available elements.
Message Details d How a single message displays on its detail page.
Teachers List ts How teachers appear in list views.
Teacher Details td How a single teacher displays on their detail page.
Series List s How series appear in list views.
Series Details sd How a single series displays on its detail page.
Landing Page (none) Section ordering for the Proclaim landing page.

The Layout Editor loads via AJAX when you switch to this tab for faster initial page load.

Element Configuration

Each context contains a list of display elements that can be:

  • Reordered by dragging up/down
  • Enabled/disabled via toggle
  • Configured with properties:
Property Description
Element What to display (Title, Scripture, Teacher, Date, Image, Media, etc.)
Link Option How the element links: No Link, Sermon Link, Popup, Teacher Link, Series Link, Direct Download, etc.
Display Settings Show/hide toggles, text formatting, color (via ColorPicker)
Scripture Settings Per-element settings for scripture display: show Bible version, verse tooltip on hover, and scripture separator character. These are configured individually for each element that displays scripture.

View Settings

Each context has a gear icon for additional view-level settings including filter display, pagination, and verse rendering options.

Media Tab

Configure media button appearance for this template:

Setting Description
Button Style Bootstrap button type (Primary, Success, Info, etc.)
Button Color Custom color via ColorPicker
Icon Type Icon displayed on media buttons
Button Size Button dimensions
Player Settings Default player width, height, popup behavior

Display Defaults Tab

Configure default verse and scripture display settings for this template.

Permissions Tab

Per-item access control for Delete, Edit, and Edit State. Only visible to users with core.admin permission.

Tips

  • Template ID 1 is the default and cannot be unpublished. It serves as the fallback template.
  • Drag elements to reorder them -- the editor order matches the render order on the frontend.
  • Use the Landing Page context to control which sections (Teachers, Series, Topics, Locations) appear and in what order.
  • For pixel-perfect control, use custom Template Codes (see Help-templatecode).
  • In multi-campus deployments, create separate templates per campus and assign via menu items.
  • The Layout Editor loads on demand -- switch to the tab and wait briefly for it to initialize.

Related

Clone this wiki locally