The main shortcode for displaying a grid or list of sermon posts, with optional search bar, taxonomy filters, and pagination.
Basic Usage
[isermons-list layout="grid" columns="3" per_page="9"]
Key Attributes
- layout –
gridfor a card grid layout, orlistfor a single-column list. - columns – Number of grid columns:
1,2,3, or4. Only applies when layout isgrid. - per_page – Number of sermons shown per page. Use
-1to show all sermons without pagination. - search – Leave empty to hide the search bar, or enter a placeholder text string to show it.
- filters – Comma-separated list of taxonomies to show as filter dropdowns, e.g.
filters="categories,series,preachers". Leave empty to hide all filters. - filters_operator –
AND(sermon must match all selected filters) orOR(sermon must match any one filter). - meta_data – Comma-separated list of metadata fields to show on each sermon card, e.g.
meta_data="preacher,date,series". - hover –
enableto show a hover overlay with a play button on grid cards, ordisable. - watch – Custom label for the watch/play button on sermons with video. Default: Watch Sermon.
- relation – Taxonomy slug used for related sermon matching when placed inside the Details Page Related Sermons field.
- imi_isermons-categories – Pre-filter by a specific category slug or ID.
- imi_isermons-series – Pre-filter by a specific series slug or ID.
- imi_isermons-books – Pre-filter by a specific book slug or ID.
- imi_isermons-topics – Pre-filter by a specific topic slug or ID.
- imi_isermons-preachers – Pre-filter by a specific preacher slug or ID.
[Screenshot placeholder: Frontend display of the [isermons-list] shortcode in grid layout — 3-column sermon cards with thumbnail, title, date, preacher name, and play button]