Quick Start

The Group Details Widget is used in tandem with the Group Finder Widget. Use both to help people find the group that works for them. See the Quick Start Guide to get the Group Detail Widget up and running ASAP.

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 Details Widget or identify the page on your website where it will be displayed.

Add the Group Details 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-details
     returnurl="/groups">
</mpp-group-details>

Widget Configuration

Required attributes must be included for the widget to function.

Return URL: The return URL defines the path back to the Group Finder and is required for the Group Detail Widget to function correctly. It can be a relative or fully qualified url.

<mpp-group-details returnurl="https://www.ministryplatform.com/groups"></mpp-group-details>

<mpp-group-details returnurl="/groups"></mpp-group-details>

Optional attributes may be included to expand the Group Details Widget.

• Inquire About Full Groups: Allows Inquiries to be submitted to Groups that are full. A Group is considered full when the Target Size is met or Group is Full is set to "True". The default is False.
  • Attribute: inquirefullgroups
  • Valid Values: True or False (or empty) 

inquirefullgroups="true"

• Count Group Inquiries: Allows Group Inquiries to be counted towards a Group's Target Size. If the corresponding attribute is set to "True" for Group Finder, set to "True" for Details also. The default is False.
  • Attribute: countgroupinquiries
  • Valid Values: True or False (or empty)

countgroupinquiries="true"

• Inquiry Email Template: Identifies a Message stored in the Platform that will be sent to the individual who submits a Group Inquiry. Empty is the default.
  • Attribute: inquiryemailtemplate
  • Valid Values: Message ID (Note: this is a Message page ID, not a Template page ID) or Empty for unspecified
  • Merge Fields and Snippets: Personalize your message with Merge Fields! Want to get really fancy? Snippets can be used in your Widget messages! All you need to do is add the Domain_GUID and Contact_GUID to the Default Field List of the table on which the record is created by the Widget
    • Open the Domain record and copy the Domain GUID
    • Open the Page record and edit the Default Field List
    • Add Contact_ID_Table.[Contact_GUID] AS [Contact GUID]
    • Add '<DOMAIN GUID HERE IN QUOTES>' AS Domain_GUID
    • Save Default Field List
    • Ensure your snippet includes both the Domain_GUID and Contact_GUID

inquiryemailtemplate="1200"

• Sign Up Email Template: Identifies a Message in the Platform that will be sent to the individual who submits a Group Sign Up. The default is empty.
  • Attribute: signupemailtemplate
  • Valid Values: Message ID (Note: this is a Message page ID, not a Template page ID) or Empty for unspecified

signupemailtemplate="1300"

• Contact New Leaders: Sends a message to both the Group's Primary Contact and anyone in the Group with a Group Role Type of Leader when someone signs up for their Group.
  • Attribute: leadersignupemailtemplate
  • Valid Values: Message ID (Note: this is a Message page ID, not a Template page ID) or Empty for unspecified 

leadersignupemailtemplate="159"

• Map Address Details: Determines whether a full or partial address will be shown based on a Group's "Offsite Meeting Address". Configuring as "True" will display a map along with the full Address. Configuring as "False" will hide the map and display only City, State, and Zip. Note that an Address must have Latitude and Longitude populated to generate a map. The default is empty.
  • Attribute: showfulladdress
  • Valid Values: True or False (or empty) which is the default

showfulladdress="true"

• Hide Contact Tab: Hides the "Contact This Group" tab and the related form.
  • Attribute: hidecontacttab
  • Valid Values: True or False (or empty) which is the default
    

hidecontacttab="true"

• Hide Sign Up Tab: Hides the "Sign Up for This Group" tab and related form.
  • Attribute: hidesignuptab
  • Valid Values: True or False (or empty) which is the default
    

hidesignuptab="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 quotation marks.

<mpp-group-details
     returnurl="https://www.ministryplatform.com/groups"
     inquirefullgroups="true"
     inquiryemailtemplate="1200"
     signupemailtemplate="1300"
     showfulladdress="true"></mpp-group-details>

Platform Configuration

• Groups will appear in the Group Finder and Group Details Widgets whenever they meet the following criteria: 
  • Today's date is less than the End Date (or the End Date is undefined). 
  • Available Online is set to "True."
  • Group belongs to a Group Type where Show on Group Finder is set to "True."
  • Group is Full is set to "False," unless Groups which are full have been configured to appear, which will then show a "Full" banner in the upper left-hand corner of the group card.  Sign up with not be available for full groups.
  • Target Size (if defined) has not been reached. Group Participants always count toward Target Size. Group Inquiries can also be configured to also count toward the target size.
  • If Meets Online bit field set to "True," the Group Details page will have a "Meets Online" indicator tag. 
• Emails sent by the Widget use the From/Reply To Contacts set in the Message template, so review your templates and make sure that your emails are coming from the correct person (and that the right person will be getting the replies).
• When someone inquires or signs up for a Group, the Primary Contact is notified via a Process, so make sure your Group's Primary Contact email is up-to-date.
• When someone signs ups for a group, they are assigned the the Default Group Role found on the Group Type record. Pro tip: Make sure your Default Group Role is set up to help YOU do church YOUR way!

Customization

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: Want to get specific and identify groups as Life Groups, Community Groups, or Small Groups? Want the button to say "Join Group" instead of "Sign up"? No problem! You can change the text that appears above the cards by navigating to System Setup > Application Labels (note that churches are responsible for all translations if the default is not used). Pro Tip: These are just a few of the Application Labels. Be sure to check out System Setup > Application Labels to see all the things you can customize!

• mpp-group-details.signUpButtonText - Label that appears on the sign-up button. Default is "Sign Up".
• mpp-group-details.formInstructions - Instructions on how to submit the form. The default is "Type a message and press the Sign Up button."