-
Notifications
You must be signed in to change notification settings - Fork 9
Help template
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.
Components -> Proclaim -> Templates, then click New or click an existing template title.
| 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 |
The General tab contains the template settings, terms & conditions, and filter configuration all in one view.
| 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). |
Settings that control which content is included in this template's output.
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. |
Configure which search and filter tools appear on frontend list views. Located at the bottom of the General 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.
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. |
Each context has a gear icon for additional view-level settings including filter display, pagination, and verse rendering options.
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 |
Configure default verse and scripture display settings for this template.
Per-item access control for Delete, Edit, and Edit State. Only visible to users with core.admin permission.
- 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.
- Help-templates -- Templates list view
- Help-templatecode -- Template code editing
- Help-templatecodes -- Template codes list
- Multi-Campus-Admin-Guide
- Multi-Campus-User-Guide
- Template-Customization-Guide
- Print-Friendly-View
- Content-Security-Policy
- Troubleshooting-FAQ
- Setting-up-your-development-environment
- Standards and Conventions
- Contributing-Workflow
- Database-Schema
- Location-API-Reference
- Backward-Compatibility-Breaks-10.1
- Proclaim-Code-Road-map
- Tasks
- Overview
- Admin Center
- Messages
- Media Files
- Servers
- Teachers
- Series
- Podcasts
- Topics
- Locations
- Comments
- Message Types
- Templates
- Utilities