Homepage Monklets
Overview
Monklets are predefined code snippets that allow you to bring in other module content (sermons, events, etc.) into your pages. There are a few monklets that have been created that are placed in the content area of your sidebar sections.
You can use a monklet inside a section by placing your cursor in the content area, selecting
Insert > Insert Monklet > "Desired Monklet"
Some monklets allow/require inline parameters to define items from a specific group, category, etc. You can use one of the inline "find" parameters such as the "find_category" parameter to display items from a specific category. Example: {{section-monklet-featured-articles|find_category="stories"}}
These monklets were designed to be used on Trotter's homepage, but can be used in other full width sections throughout your site! You can find other section monklets included on your theme HERE.
Next Steps
This monklet will display a row of 3 images/buttons from a link list. If images are not used, then a simple list of buttons will display (up to 4). The list of items can be setup under Content > Link Lists, and the name, link and image fields are used for each item.
When using this monklet, you will need to use the "find" parameter to tell the monklet which link list to display. An example would look like this: {{section-monklet-next-steps|find="next-steps-links"}}
Latest Sermon
This monklet will display the most recent sermon, and there are two versions available:
- Section Monklet - Latest Sermon -> displays the article details on the left and image on the right (this is the default setup on the homepage)
- Section Monklet - Latest Sermon Left Image -> displays the image on the left and article details on the right
This monklet will display the most recent sermon with the sermon details on the left and image on the right. If you want to display the latest sermon from a specific group or category, you can use the find_group and find_category inline parameters as needed.
Here is an example of what this would look like if you wanted to display a sermon from the category "Prayer": {{section-monklet-latest-sermon|find_category="prayer"}}
Note about the sermon image: this monklet will pull the image loaded for the latest sermon; however, because the monklet uses a square orientation for the image spot, the sides of the image will cut off. You can specify a different image for this spot by using the "square image option" field. If this field is blank, then this will default to the standard image loaded for the sermon.
Featured Events
This monklet will display the 6 most recent events published as featured. If you want to display the latest featured events from a specific group or category, you can use the find_group and find_category inline parameters as needed.
Here is an example of what this would look like if you wanted to display an event from the category "Children's Ministry": {{section-monklet-featured-events|find_category="childrens-ministry"}}
Latest Article
This monklet will display the most recent article, and there are two versions available:
- Section Monklet - Latest Article Left Image -> displays the image on the left and article details on the right (this is the default setup on the homepage)
- Section Monklet - Latest Article -> displays the article details on the left and image on the right
If you want to display the latest article from a specific group or category, you can use the find_group and find_category inline parameters as needed.
Here is an example of what this would look like if you wanted to display a sermon from the category "Prayer": {{section-monklet-latest-article-left-image|find_category="prayer"}}
Latest Blog Post
This monklet will display the most recent blog post, and there are two versions available:
- Section Monklet - Latest Post -> displays the blog post details on the left and image on the right (this is the default setup on the homepage)
- Section Monklet - Latest Post Left Image -> displays the image on the left and blog post details on the right
Note: you must use the "name" inline parameter to define which blog to pull from. Here is an example of what this would look like: {{section-monklet-latest-post|name="our-blog"}}
Visit Links
This monklet displays a row of banners from a link list (Content > Link Lists > Visit Links), and each link within the list represents a column. The description field of the link displays in the column area and the url and name are used to populate the button.
Within the monklet, the "find" parameter is used to specify which link list to use: {{section-monklet-visit-links|find="visit-links"}}
Note: The description field of the link list will display as paragraph text. If you would like to have a full html section content for a specific column, you can do so by creating a section with the desired content. Once created you will place the slug of the section in the corresponding link description field with curly braces. If you create a section labeled "Column 1 Section" the link description field should contain the slug as {{column-1-section}}.
The default homepage is setup using this second option. There is a section created for each of the columns (see below) so that full HTML can be used for the content in each one.
Within the description field of the link list items is the slug version of the cooresponding section title (see below), so that the content for the column pulls from a section as opposed to directly in the description field.
Church Map
Included in the Next Visit portion of the homepage is the Church Map monklet, which displays a map with marker from a specific church entry (People > Churches). Note: you must use the find inline parameter to define which church entry pull from.
You can see a monklet example here: {{section-monklet-church-map|find="church-name"}}
For the default homepage setup, this monklet is setup in the "Home Visit - Column 3" section.