The sermons shortcode will allow users to easily display listings of sermons in pages or posts without knowing PHP or editing template files. Add the shortcode in a post or page, and use the arguments to query based on series, preacher, and many other possibilities (see the Arguments).
See the WordPress Codex for information on using the arguments.
Examples
[sermons]
This will list the 10 most recent sermons with default options.
[sermons per_page="20"]
This will list the 20 most recent sermons with pagination for older sermnons.
[sermons filter_by="wpfc_sermon_series" filter_value="winter-revival-2012" hide_pagination="1"]
This will list the 10 most recent sermons, without pagination, that are assigned to series "Winter Revival 2012". You can use the Series "slug" or the ID in the shortcode, and you can specify multiple series by separating them with a comma (",").
[sermons per_page="-1"]
This will list every sermon.
[sermons filter_by="preache" filter_value="pastor-paul-chappell"]
This will list the 10 most recent sermons, including pagination, that are assigned to the preacher "Pastor Paul Chappell". You can use the preacher "slug" or the ID in the shortcode, you can specify multiple by separating them with a comma (",").
Arguments
- per_page – Define how many sermons to show per page. Overrides the default WordPress setting.
- sermons – Use comma separated list of individual sermon IDs to show just them; e.g. [sermons sermons="1,3,66,32"]
- order – "DESC" for descending; "ASC" for ascending
- orderby – Options: "date" (default), "id", "none", "title", "name", 'rand', 'comment_count'
- filter_by – Options: "series", "preachers", "topics", "books", "service_type"
- filter_value – Use the "slug" related to the taxonomy field you want to filter by; e.g. [sermons filter_by="wpfc_sermon_series" filter_value="by-the-cross"] (or the ID)
- hide_pagination - Set to 1 to hide; e.g. [sermons hide_pagination="1"]
- image_size - Possible values: sermon_small, sermon_medium, sermon_wide, thumbnail, medium, large, full, or any size added with add_image_size()
- year - Show only sermons created in the specified year
- month - Show only sermons created in the specified month, regardless of year
- week - Show only sermons created in the specified week
- day - Show only sermons created on the specified day
- after - Show only sermons created after the specified date; e.g. [sermons after="2016-08-24"] - this will show sermons created after August 24th, 2016
- before - Show only sermons created before the specified date, check the "after" filter for usage
Displaying a Grid of Series or Speakers
[sermon_images]
This will list all sermon series and their associated image in a grid.
There are several different optional parameters:
- display – "series", "preachers"
- order – "DESC" for descending; "ASC" for ascending
- orderby – name (default), id, count, slug, term_group, none
- size – Any size registered with add_image_size. The default is "sermon_medium"
- hide_title - Hides title if set to "yes"
- show_description - Shows description if set to "yes"
An example that uses some options:
[sermon_images display="preachers" order="DESC" orderby="id" size="sermon_small"]
Simple List of Series or Speakers
[list_sermons]
This will list all series or speakers in a simple unordered list. There are several different optional parameters:
- display – "series", "preachers", "topics", "books"
- order – "DESC" for descending; "ASC" for ascending
- orderby – name (default), id, count, slug, term_group, none
An example that uses all options:
[list_sermons display="preachers" order="DESC" orderby="id"]
Display the Latest Series Image
[latest_series]
This will display information about the latest sermon series, including the image, title (optional), and description (optional). There are several different optional parameters:
- image_class – options: any CSS class you want applied to the image. The default is 'latest-series-image'
- size – options: any size registered with add_image_size. The default is "large"
- show_title – options: true or false to show or hide the series title (true is the default)
- title_wrapper – options: p, h1, h2, h3, h4, h5, h6, div (default is h3)
- title_class – options: any CSS class you want applied to the title wrapper. The default is 'latest-series-title'
- service_type – options: use the service type slug to show the latest series from a particular service type created in Sermons → Service Types
- show_desc – options: true or false to show or hide the series description (false is the default)
- wrapper_class – options: any CSS class you want applied to the div which wraps the output. The default is 'latest-series'
An example that uses all options:
[latest_series image_class="thumb" size="medium" show_title="true" title_wrapper="h1" title_class="custom-title-class" service_type="sunday-am" show_desc="true" wrapper_class="custom-wrapper-class"]
Sermon Sorting
[sermon_sort_fields]
It will add a couple of dropdown selections to quickly navigate to all sermons in a series or by a particular speaker. It can be used anywhere in your theme that supports shortcodes. The sort fields are now included in the archive page already.
- series_filter - Do filtering in this specific series (slug)
- service_type_filter -
- series - Force specific series to show. Slug only
- preachers - Force specific preacher to show. Slug only
- topics - Force specific topic to show. Slug only
- books - Force specific book to show. Slug only
- visibility - 'none' to hide the forced fields, 'disable' to show them as disabled and 'suggest' to just set the default value while allowing user to change it. Default 'suggest'
- hide_topics - Hides the topics dropdown if set to "yes"
- hide_series - Hides the series dropdown if set to "yes"
- hide_preachers - Hides the preachers dropdown if set to "yes"
- hide_books - Hides the books dropdown if set to "yes"
