CONTACT USBack to MinistryPlatform Site
Your Knowledge Base has moved to the new Help Center.  Check out the release notes for details. And don't forget to update your bookmarks and in-house documentation before May 28.

Configuring My Groups

 

Quick Start

Want to let people see their Groups on your website ASAP? See Quick Start to get the My Groups Widget up and running in just a few steps.

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. See Enabling Widgets for more information about the shared script. 

<script id="MPWidgets" src="https://{your platform domain}/widgets/dist/MPWidgets.js"></script>

Create a webpage on your website that will display your My Groups Widget or identify the page on your website where it will be displayed.

Add the My Groups Widget to your church website by placing this snippet of code in the body of your chosen webpage.

<mpp-my-groups></mpp-my-groups>
Tip: While not mandatory, this snippet would typically be placed inside a <div> element with the class "container."

Widget Configuration

This widget is only available to Users who have authenticated via the Login Widget. New Users will also have the opportunity to create an account through the Login flow. If desired, the page containing this Widget could be added as a navigation item in the Login menu, making it available only after authentication. See Login Configuration for information about extending the drop-down menu.

Optional Attributes

Optional attributes may also be defined to expand or restrict Widget behavior.

  • Hide GroupLife: Hides GroupLife button.  When set to False, MyGroups displays GroupLife button for authenticated Group Leaders.
    • Attribute: hide grouplife
    • Valid Values: True or False (or empty)
hidegrouplife="true"
Configure Your Widget!

Simply fill out the Widget Configurator below, copy your generated Widget, and paste it into your website.

Update Configuration Parameters

Setting Name
My Value
Description

Preview & Copy

Platform Configuration

The My Groups Widget shows information from the Group record. Groups will display in the My Groups Widget when they meet the following criteria:

  • The authenticated User is currently part of the Group.
  • Today's date is before the End Date or the End Date is undefined.
  • Available Online is set to "Yes".

If Meets Online is set to "Yes", the card will be identified by a badge in the upper left-hand corner.

If an image is attached to the Group record, it will display on the card, so add a picture of the group doing something fun together! If no image is attached, a stock image will be used. Images can be added to use as the main Event image by attaching as a file to the group record via the Platform. File formats supported both by browsers and the Platform are: bmp, gif, jpg, and png. The widget software will crop and focus on the center of the image according to an ideal ratio of 59/32.

Customization

Want to customize the My Groups Widget? You can do that!

CSS: Every Widget accepts the Custom CSS attribute. Include it before the opening Widget tag is closed and customize backgrounds, button colors, and more! See Customize Widget Appearance to learn more.

Application Labels: Want to get specific and identify groups as Life Groups, Community Groups, or Small Groups? No problem! You can change the text that displays above the cards by navigating to System Setup > Application Labels. (Note that you are responsible for all translations if the default is not used.)

  • mpp-my-groups.pageTitle: Label that displays on the top of the My Groups page. Default is "My Groups".