The Group Finder Widget is used in tandem with the Group Details Widget. Use both to help people find the group that works for them. See the Quick Start Guide to get the Group Finder Widget up and running ASAP.
Ready to get started? See the Quick Start Guide to get both Widgets up and running.
If the shared script hasn't been added to your website, add it to
your desired webpage. Be sure to replace "{your platform domain}" in the following code with your church's base MP URL.
<script id="MPWidgets" src="https://{your platform domain}/widgets/dist/MPWidgets.js"></script>
Create a webpage on your website that will display your Group Finder Widget or identify the page on your website where it will be displayed.
Add the Group Finder Widget to your church website by placing this snippet of code in the body of your chosen webpage, modifying the required attributes discussed below.
<mpp-group-finder
targeturl="/group-details">
</mpp-group-finder>
targeturl="https://ministyplatform.com/group-details"
targeturl="group-details"
Recommended URLs
The easiest way to set up interaction between the finder and detail Widgets is to use querystring parameters to identify Groups. To use this method, specify a target Url (with or without a trailing slash). The Group Finder Widget will then append a querystring and Group ID to the target Url. For example, for the targeturl "/group-details" the link to Group 25 would look like this:
https://ministryplatform.com/group-details?id=25
Advanced Routing Options
If you prefer to use more advanced routing, you can use URLs like the one shown below. This may be an option if the querystring method does not integrate well with your CMS. If you choose to go this route:
For example, for the targeturl "/group-details/" the link to Group 25 would look like this:
https://ministryplatform.com/group-details/25
countgroupinquiries="true"
showfullgroups="true"
showfuturegroups="true"
showsuggestagroupbutton="true"
All attributes must be included before the opening Widget tag is closed. Attributes may be listed in any order and should be separated by a space (or other whitespace). Each attribute's value should be wrapped in quote marks.
<mpp-group-finder targeturl="/group-details" countgroupinquiries="true" showfullgroups="true" showsuggestagroupbutton="true"></mpp-group-finder>
Simply fill out the Widget Configurator below, copy your generated Widget, and paste it into your website.
Attach a compelling image to the Group record so it displays in the widget. If there is no image, a stock image displays. The following file formats are supported by browsers and the Platform: bmp, gif, jpg, and png. The widget software crops and focuses on the center of the image according to an ideal ratio of 59/32. The finder images are 800 x 433 intrinsically but resized to fit at 295 x 160. We do not recommend using images with a transparent background; this results in a gray background in the widget.
Groups display in the Group Finder when they meet the following criteria:
Special Note: If a group is both Full and Meets Online, the 'Meets Online' banner will override the 'Full' banner. (This circumstance assumes that the church has configured Full groups to show on the Group Finder.
All Widgets are customizable, so change the button color and update the labels to match YOUR church!
CSS: Every Widget accepts the Custom CSS attribute. Include it before the opening Widget tag is closed to customize your Widgets.
Application Labels: Does your church refer to Communities instead of Neighborhoods? Do you have Sites instead of Campuses? No problem! You can change that by navigating to System Setup > Application Labels. (Note that churches are responsible for all translations if the default is not used.)