Grouperly on your group's own website
If your group has a website of its own, such as WordPress, Squarespace, Wix or one somebody built, pieces of Grouperly can sit in its pages. You enter an event or a form once, in Grouperly, and your site shows it.
Your group needs a public page first. The pieces show what that page was last published with.
Add the script once
Section titled “Add the script once”In Settings → Public page → On your own site, copy the script and paste it once into your site, in the page’s head or body. Then paste the code for each piece where it should go. The same screen has a preview of every piece.
<grouperly-events group="pack1232"></grouperly-events>group is your group’s page address.
The pieces
Section titled “The pieces”| Piece | Code | What it shows | Plan |
|---|---|---|---|
| Follow | <grouperly-follow> |
A Follow button and how many followers you have | Free |
| Request to join | <grouperly-join> |
A button to ask to join. Nothing while requests to join are off | Free |
| Keep me posted | <grouperly-subscribe> |
A form: an email address, and what they’d like to hear about | Free |
| Coming up | <grouperly-events> |
Your next public events | Free |
| Newsletter | <grouperly-news> |
Your newsletter’s latest posts | Free |
| Alumni | <grouperly-alumni> |
A form for people who used to be in your group | Free |
| Contact us | <grouperly-contact> |
Your Contact us forms. Nothing while Contact us is off | Plus |
Follow and Request to join open Grouperly in a new tab, since they need an account. The forms stay on your site.
Keep me posted
Section titled “Keep me posted”Someone gives their email address, ticks I’m 18 or older, and confirms from an email. Nothing is kept until they confirm. They aren’t asked for a date of birth.
Things to tick. Beside your newsletter, the form offers each recurring event you chose to offer, such as your Pinewood Derby. To offer one, open the recurring event, and under Interested people tick Keep a list… and then Offer it on our page and website. See Interested people.
For a page about one event, you needn’t write the code yourself: on that recurring event, Interested people → Put it on your own site has it ready to copy.
Each page can offer something different:
| Add to the code | What it does |
|---|---|
lists="pinewood-derby" |
Offers only that event, already ticked, with your newsletter as an extra tick. The name is the event’s name in small letters with hyphens. Separate several with commas |
lists="" |
Offers no events: the newsletter alone |
news="off" |
Leaves the newsletter out, for a page about one event |
joining="off" |
Leaves out We’re thinking about joining, which shows only on Grouperly Plus |
<grouperly-subscribe group="pack1232" lists="pinewood-derby"></grouperly-subscribe>If you rename a recurring event, its name in lists changes too.
Every email they get has a link to change what they hear or stop. See Unsubscribe, or get less.
Coming up and Newsletter
Section titled “Coming up and Newsletter”limit="3"sets how many to show. Coming up shows 5 and Newsletter 3 unless you say.series="…"on Coming up shows one recurring event’s dates only.
A calendar to subscribe to. Your public events are also at https://www.grouperly.com/<your address>/calendar.ics. Anyone can add that address to their calendar app, with no account.
For whoever builds your site: the same information is at https://www.grouperly.com/<your address>/data.json, for a site that would rather draw its own calendar. It carries up to 50 events, each with its start, end, time zone and recurring event. Its v is 1, and new fields may be added.
Choose what a public event says
Section titled “Choose what a public event says”You list events publicly for different reasons, and you may not want everything about each one in public, such as exactly where and when children will be. Two choices decide what shows: one on each event, and one for your whole group.
On each event. Open the event, press Edit event, and choose under On the group’s public page:
| Choose | People outside your group see | Good for |
|---|---|---|
| Not shown | Nothing | Events for your members |
| Name, date and time only | The name, date and time, marked Members only, with a link members sign in to open | A glimpse of what you do |
| Full details | The date, time, location and description | Meetings visitors are welcome at |
- To let anyone sign up, choose Full details, then open Share on the event and press Create a link. Coming up then shows Details and sign-up. See An event’s link.
- To invite only some people, create the link and send it yourself. On an event that’s Not shown or Name, date and time only, the link is never published.
- A recurring event’s next date keeps the choice of the one you plan it from, so you don’t set weekly meetings each week. It shows once you plan it.
- Events you listed before this choice existed show full details until you change them.
For your whole group. This sets the most any event shows, even one at Full details.
- Open Settings → Public page.
- Under Public events, untick what no event should show: Date, Time, Location, Description or Link to its sign-up page.
- Press Save. Your page and your site update within a few minutes.
An event’s name always shows. Everything is ticked until you change it.
| You untick | People outside your group see |
|---|---|
| Time | The day only: “Saturday, October 17” |
| Date | The times only: “9:00 – 11:30 AM CDT”. The calendar to subscribe to then has no events |
| Date and Time | Nothing about when |
| Location | No place |
| Description | No description |
| Link to its sign-up page | No link to the event’s own page |
- It’s one choice for everywhere outside your group: Coming up on your site, your group’s page on Grouperly, the calendar to subscribe to, the information for whoever builds your site, and Coming up in the newsletter to followers, prospects and alumni.
- What you leave out isn’t sent at all. It isn’t hidden on the screen and still there underneath.
- Members see every detail in Grouperly, as before.
- An event’s sign-up page says when and where it is to anyone who opens it. If you leave out the date, time or location, untick the link too, unless you want anyone to be able to sign up. You can still send the link to the people you choose.
- A description shows as you wrote it. Check yours don’t say what you’re leaving out.
Contact us
Section titled “Contact us”On Grouperly Plus. See Contact us forms for the forms themselves. On your site:
| Add to the code | What it does |
|---|---|
form="join" |
Shows your joining form. Any form’s short name works: form="popcorn" |
forms="join,question" |
Lets visitors pick among those forms only |
selected="popcorn" |
Starts on that form, and visitors can still change it. So does ?topic=popcorn added to the address of the page on your own site that holds the form. (On Grouperly’s own Contact us page it’s ?form=popcorn) |
source="our Join page" |
Says where the form sits, shown on each prospect it brings |
Alumni
Section titled “Alumni”<grouperly-alumni> is a form for people who used to be in your group. See Alumni who say who they are.
After someone sends a form
Section titled “After someone sends a form”Keep me posted, Contact us and Alumni wait for an email: nothing is kept, and nothing reaches you, until the person confirms it’s them. So once they send the form, it gives way to a yellow box that’s hard to miss, on your own site and on your group’s page alike. The page moves to it, so it’s in view even after a long form. It says:
- what hasn’t happened yet, such as Your message isn’t sent yet or You’re not signed up yet;
- the address the email went to, and that its subject starts with “Confirm”;
- what to press, in the email and then on the page it opens;
- what they’ll miss until they do, such as Pack 1232 won’t get your message;
- where else to look: their spam or junk folder, if nothing comes in a few minutes. The link works for 3 days.
Wrong address? Change it brings the form back, with what they wrote, to fix the address and send it again.
| Form | What they press |
|---|---|
| Contact us | Confirm my message in the email, then Send it on the page it opens |
| Keep me posted | Yes, keep me posted in the email, and again on the page it opens |
| Alumni | Yes, that’s me in the email, and again on the page it opens |
| Next year’s …, on an event’s own page | Yes, tell me in the email, then Yes, keep me posted on the page it opens |
An address that’s on your Keep me posted list already gets no email, so nobody can find out from the form who’s on it. The box says so: unless it’s on Pack 1232’s list already.
The box keeps its own yellow on any site, light or dark, whatever your colours.
Flyers that point at your site
Section titled “Flyers that point at your site”A tracked link from Recruiting can open a page of your own site, and still count. See Links with QR codes.
While a piece has nothing to show
Section titled “While a piece has nothing to show”Anything you put inside an element shows until the piece does, and stays if it never has anything to show: your group has no page yet, Contact us is off, or Grouperly can’t be reached.
<grouperly-contact group="pack1232"> <a href="mailto:info@pack1232.example">Email us</a></grouperly-contact>So a visitor never meets an empty space. For whoever builds your site: the element has data-state="ready" or data-state="empty", and sends a grouperly-ready or grouperly-empty event.
Your colours
Section titled “Your colours”The pieces take your site’s font and text colour. Set their colours in your site’s stylesheet, on the page or on any element around them:
:root { --gp-brand: 0 63 135; --gp-accent: #fdc116; --gp-accent-ink: #002a5c;}| Name | What it colours |
|---|---|
--gp-brand |
Links and outlines, as three numbers for red, green and blue |
--gp-accent |
Buttons. Your brand colour unless you set it |
--gp-accent-ink |
The words on a button. White unless you set it |
If your site has a Content-Security-Policy
Section titled “If your site has a Content-Security-Policy”Most sites don’t. If yours does:
- allow
https://www.grouperly.cominscript-src,connect-srcandstyle-src; - allow
https://app.grouperly.cominconnect-srctoo, for the forms.
The pieces use no inline styles.