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.
Note: Because the Group Finder and Group Details Widgets work together, they
must be set up at the same time to function correctly. See
Finder Widgets + Details Widgets to learn more about how they interact.
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>
Tip: While not mandatory, this snippet would typically be placed inside a <div> element with the class "container".
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.
Attributes let you customize your Widgets so you can do YOUR church YOUR way! But this Widget has two attributes that don't play well together when they are both set to True. When both of these attributes are set to True, the "Sign-Up" tab switches to
a "Contact This Group" tab but doesn't create a Group Inquiry record. So pick one to set to True and set the other to False (or leave it empty).
- 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"
Related note: The Group Is Full field always overrides the Target Size field. For example, let's say the Target Size is 20 and 15 people have signed up. That group is not considered full. However, if you change Group Is Full to "Yes", the widget will reflect that the Group is full.
- 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"
Note: The message templates are optional. If they are not added, the user will be allowed to inquire (or sign up) for the group and will see this message: "Invalid Email Template. Saving the record is allowed,
however no email notifications will be sent." To prevent this, add the appropriate email template attribute.
- 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>
Configure Your Widget!
Simply fill out the Widget Configurator below, copy your generated Widget, and paste it into your website.