home

MinistryPlatform

RealmRealm AccountingMinistryPlatformGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite
RealmRealm AccountingMinistryPlatformGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite

What would you like to know more about?

Show Contents

thumbnailMinistryPlatform

Configuring Group Finder

Widget Configuration

Required Attributes

  • Target URL: The target URL determines the navigation path to Group Details. When a specific group is selected, the ID is appended to this path.
    • Attribute: targeturl
    • Valid Value: relative or fully qualified URL
    • Examples: 
      targeturl="https://example-church.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://example-church.com/group-details?id=25

Advanced Routing Options

If you prefer to use more advanced routing, you can use different URLs. This may be an option if the querystring method does not integrate well with your CMS. If you choose to go this route:

  • Define a route in your website to support the ID.
  • Use a target URL with or without a trailing slash.

For example, for the targeturl "/group-details/" the link to Group 25 would look like this:

https://example-church.com/group-details/25

Optional Attributes

  • Count Group Inquiries: Allows group inquiries to be counted towards the group's Target Size. Default is false.
    • Attribute: countgroupinquiries
    • Valid Value: true or false (or empty)
    • Example:
      countgroupinquiries="true"
  • Show Full Groups: Allows groups that are full to be displayed. A group is considered full when the Target Size is met or Group is Full is set to Yes. When full groups display, they are marked with a badge. Default is false.
    • Attribute: showfullgroups
    • Valid Value: true or false (or empty)
    • Example:
      showfullgroups="true"
  • Show Future Groups: Determines whether groups with a future Start Date display. Default is true.
    • Attribute: showfuturegroups
    • Valid Value: true (or empty) or false
    • Example:
      showfuturegroups="true"
  • Show Suggest A Group Button: Determines whether authenticated users can see the Suggest a Group button and submit their suggestion information for a new group. Default is false.
    • Attribute: showsuggestagroupbutton
    • Valid Value: true (or empty) or false
    • Example:
      showsuggestagroupbutton="true"

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. An attribute's value should be wrapped in quotation marks.

<mpp-group-finder
     targeturl="/group-details"
     countgroupinquiries="true"
     showfullgroups="true"
     showfuturegroups="true">
</mpp-group-finder>

Configure Your Widget

Fill out the Widget Configurator below, copy your generated widget code, and paste it into your website.

portal
MinistryPlatform

Last updated: November 26, 2024