Section Monklets
Overview
Monklets are predefined code snippets that allow you to bring other module content into your pages (ie: events.). There are a few monklets that have been created that are placed in the content area of your fullwidth sections on your Subpage and Homepage.
You can use a monklet inside a section by placing your cursor in the content area and selecting:
Insert > Monklet > "Desired Monklet"
Some monklets allow inline parameters to be added into the monklet tag to pull items from a specific group, category, etc. -> see this help article for details. For additional information about using monklets, check out our help article here.
Note: you will see some additional monklets listed for your custom layouts (ministry, giving, etc); however, these are only used with the respective layouts.
Section Monklets
**This monklet is used in the "Hub - Announcements" section (can be used with any fullwidth section)
Content > Blogs
Displays the latest featured post at the top and the 4 latest posts below. The title, date, and author will pull from the blog post details.
The specific blog you want to pull from MUST be added as an inline parameter:
ex: {{section-monklet-announcement-blog|name="announcements"}}
Note: an optional category parameter can be added to the section "description" field. The slug version of the category will need to be used in the field (all lowercase and dashes instead of spaces).
**This monklet is used in the "Home - Rotator" section
Media > Rotators > "Home - Rotator"
Displays a two column style rotator with the slide content on the left and image on the right. Within each rotator slide, you can specify an image, title, sub heading, caption, link and button text. The button text is required for a link.
Note: the "slide overlay" check box is only used with the header rotator option, not the content rotator.
The find inline parameter is required for this monklet, in order to specify which rotator to use.
ex: {{section-monklet-content-rotator|find="rotator-name"}}
**This monklet is used in the "Home - Featured and Latest Posts" section
Displays the latest featured post on the left column, and a list of the latest blog posts on the right. The image, date, author and title will pull from the blog post details.
The specific blog you want to pull from MUST be added as an inline parameter:
ex: {{section-monklet-featured-and-latest-posts|name="our-blog"}}
**No other section options should be used with this monklet
**This monklet is used in the "Home - Featured Event" section
Events > Events
Displays the next event published as featured. The event name will display as the section title. The date, location and text will also pull from the event details.
You can use the "find_category" or "find_group" to the latest featured event for a specific category or group.
Displays images in rows of 3 from a link list. The name and button show overtop of the image. The button text field is optional but is required for the button to show. The "find" parameter is required, in order to specify which link list to display.
ex: {{section-monklet-image-grid|find="image-grid-links"}}
To display the image rows full screen (like the style guide example), you'll need to use these section category options: "Container - Full Width" and "Container - No Padding".
**This monklet is used in the "Home - Get Involved" section
Displays a single row of images from a link list. The name, image and link fields are used. The link and image are required, and the image should be square (1,000px by 1,000px recommended).
The "find" parameter is required, in order to specify which link list to display.
ex: {{section-monklet-image-row-square|find="get-involved"}}
**This monklet is used in the "Home - Latest Video" section
Content > Sermons
Displays the most recent sermon from the Sermons module. The sermon info displays in the left column and the media on the right. No section heading is included with this monklet.
With this monklet, you can use the find_group or find_category inline parameters as needed.
Displays an image carousel from a link list and shows 3 images at a time. The name and button show overtop of the image. The button text field is optional but is required for the button to show. The "find" parameter is required, in order to specify which link list to display.
ex: {{section-monklet-link-list-rotator-show-3|find="image-rotator"}}
This monklet uses a link list to display a grid of text boxes and shows 3 per row. Each box has a hover effect that will show a call to action button (if a link is added). For mobile, the cta button will show on click, and an arrow will display next to the header if more info is available.
Within each link list item, the following fields are used:
- Name: displays the heading for the column
- Link: controls the button link
- Description: controls the text below the header
- Button Text: controls the button text for the hover state. This fields need to be populated for the button to show.
- Icon Class: displays an optional icon at the top of the column. Please refer to available icons for your specific site.
You can also add second level links to display icons below the description text on hover. These additional links need to be listed below one of the existing items in the list and will require a URL and Icon Class.
The monklet will need to be added to a section with the "find" parameter added.
ex: {{section-monklet-link-list-grid|find="giving-2-grid-links"}}
Displays images in rows of 4 from a link list. The name, link and image fields are used, and the name will display underneath the image. The "find" parameter is required, in order to specify which link list to display.
ex: {{section-monklet-ministry-links|find="ministry-links"}}
This is a duplicate of the "Section Monklet - Story List" monklet and will display the the latest 4 sermons assigned to the "Podcasts" category.
The title, text and button are managed in the section.
**This monklet is used in the "Home - Social Links" section
Displays a list of social icons. Each items requires a name, link and icon class. The custom icon is created by entering a custom class in the "icon class" field (ie: icon-twitter). A full list of icons is available here: http://cofchrist.monkpreview3.com/_assets/fonts/icons/
**This monklet is used in the "Home - Our Stories" section
Content > Articles
Displays the 4 most recent articles from the Articles module. You can use the "find_category" parameter to display a specific category of articles. The article image, title and summary field are displayed.
**This monklet is used in the "Hub - Devotions & Prayer" section
Content > Blogs
Displays a two column setup with the latest posts from two separate blogs. The image, date, author and title will pull from the blog post details.
The monklet needs to be added twice in the section (one for each blog), and the blog you want to pull for each column MUST be added as an inline parameter:
ex: {{section-monket-two-blogs|name="daily-bread"}} {{section-monket-two-blogs|name="prayer-for-peace"}}
**No other section options should be used with this monklet
**This monklet is used in the "Home - Upcoming Events" section
Events > Events
Displays the 10 most recent events. With the monklet, you can use the find_group or find_category inline parameters as needed.
Sidebar Monklets
These monklets are only available for use with the Subpage Default template.
Displays the three most recent events from the Events module. You can use the "find_group" or "find_category" inline parameters as needed.
Displays the three most recent posts from the Blogs module. The "name" inline parameter is required to define a specific blog to pull from.
Displays the most recent video from the Sermons module. You can use the "find_group" or "find_category" inline parameters as needed.
Displays the three most recent articles from the Articles module. You can use the "find_group" or "find_category" inline parameters as needed.
Specialty Monklets
Media > Galleries
The "Gallery Monklet" can be inserted into the content area of a page or section to display a specific photo gallery grid.
Within the content editor, go to Insert > Gallery and choose the gallery you want to show, which will add the monklet tag with the gallery name to the content area.
You can also go to Insert > Monklet > choose the Gallery Monklet and then add "find_gallery" tag to define which gallery to use. The name of the gallery should be in slug format, which is the gallery name in lowercase with dashes in place of spaces.
eg. using the gallery labeled "Gallery Widget" {{gallery-monklet|find_gallery="gallery-widget"}}
Detailed monklet help can be found at http://help.monkcms.com/article/using-monklets/