Configuring Group Details
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 the appropriate webpage, replacing "example-church.com" with the base URL of your church's website.
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.
Widget Configuration
Required Attributes
- Return URL: This is the URL where the Group Finder is placed on your website.
- Attribute: returnurl
- Valid Value: relative or fully qualified URL
- Examples:
returnurl="https://www.example-church.com/groups" returnurl="/groups"
Optional Attributes
- 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 Yes. The default is false.
- Attribute: inquirefullgroups
- Valid Value: true or false (or empty)
- Example:
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 Value: true or false (or empty)
- Example:
countgroupinquiries="true" 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 Value: Message ID or empty for unspecified.Note: This is a Message page ID, not a Template page.
- Merge Fields and Snippets: Personalize your message with Merge Fields! Want to get really fancy? You can use snippets 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.
- Example:
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 Value: Message ID or empty for unspecified. Note: This is a Message page ID, not a Template page ID.
- Example:
signupemailtemplate="1300"
- Leader Contact Email Template: Identifies a message that will be sent 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 Value: Message ID or empty for unspecified.Note: This is a Message page ID, not a Template page ID.
- Example:
leadersignupemailtemplate="159"
- Show Full Group Address: Determines whether a full or partial address will be shown based on a Group's Offsite Meeting Address. Configuring as Yes will display a map along with the full Address. Configuring as No will hide the map and display only City, State, and Zip Code. An Address must have Latitude and Longitude populated to generate a map. The default is empty.
- Attribute: showfulladdress
- Valid Value: true or false (or empty)
- Example:
showfulladdress="true"
- Hide Contact Tab: Hides the Contact This Group tab and the related form. Default is empty.
- Attribute: hidecontacttab
- Valid Value: true or false (or empty)
- Example:
hidecontacttab="true"
- Hide Sign Up Tab: Hides the Sign Up for This Group tab and related form. Default is empty.
- Attribute: hidesignuptab
- Valid Value: true or false (or empty)
- Example:
hidesignuptab="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.
Configure Your Widget
Fill out the Widget Configurator below, copy your generated widget code, and paste it into your website.
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 Yes.
- Group belongs to a Group Type where Show on Group Finder is set to Yes.
- Group is Full is set to No, 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 Yes, the Group Details page will have a "Meets Online" indicator tag.
Emails sent by the Widget use the From or 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 through 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.