🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!

Gravity Forms Calendar Event Publisher Premium Add-on Setup Guide

Updated 8 min read Gravity Forms Integrations A–Z
On this page
  1. What you need
  2. Install and activate
  3. A form that makes events
  4. The feed
  5. Status of the new event
  6. Event fields
  7. Options
  8. What happens when the form is sent
  9. Draft events
  10. Published events
  11. One event per entry
  12. Merge tags
  13. For developers
  14. Privacy and security
  15. Troubleshooting
  16. Questions
  17. Do I need My Calendar Pro?
  18. Can a form edit or delete an event later?
  19. Does it work with repeating events?
  20. What time zone is used?
  21. What happens if my license expires?

The Gravity Forms Calendar Event Publisher Premium Add-on turns a Gravity Forms submission into an event on your calendar. A visitor, a member of staff or a partner fills in a normal Gravity Forms form, and the add-on creates the event in the free My Calendar plugin: title, description, dates and times, category, venue, links, image, even a repeat pattern. You decide whether the new event goes live at once or waits as a draft for you to check.

It is a Gravity Forms feed add-on, so it works the way every other feed does: you add a feed to a form, map the form fields, set a condition if you want one, and save. Nothing is installed on the public side. The calendar that your visitors see is the one My Calendar already draws.

What you need

  • WordPress 6.5 or newer and PHP 7.4 or newer.
  • Gravity Forms 2.9 or newer. The add-on is tested with Gravity Forms 3.1.2 on PHP 8.3 and Gravity Forms 2.9.8 on PHP 7.4.
  • The free My Calendar plugin from the WordPress plugin directory, tested with version 3.8.10. The paid My Calendar Pro is not needed.
  • An active license key for this add-on.

If Gravity Forms or My Calendar is missing, the add-on shows a notice in the WordPress admin and does nothing else. Your forms keep working and keep saving entries.

Install and activate

  1. Install and activate My Calendar and Gravity Forms, then this add-on.
  2. Open Forms → Settings → Calendar Event Publisher and enter your license key.
  3. Open the form that should create events, go to Settings → Calendar Event Publisher and add a feed.
  4. Map the form fields to the event (see below), choose the status, and save.

A form that makes events

Any form can do it. A typical form asks for a title, a description, a start date and time, an end date and time, a category, the venue and a link. Every one of these is optional except the title and the start date. A form can be as short as two fields.

A Gravity Forms event form filled in with a title, description, dates, times, a category, a saved venue and a link
The public form: a visitor describes the event, the add-on does the rest.

The feed

Open Settings → Calendar Event Publisher in the form and press Add New. The feed has three parts.

The Calendar Event Publisher feed settings: status, the form fields mapped to each part of the event, category, venue and repeat options
The feed: choose which form field fills which part of the event.

Status of the new event

Draft keeps the event out of the public calendar until you open it in My Calendar and publish it. Published at once puts it on the calendar the moment the form is sent. Draft is the default. The status is a setting of the feed, never something a visitor can choose, so a public form cannot publish an event on its own unless you have decided that it may.

Event fields

For each part of the event, choose the form field that holds it:

  • Event title and Start date are required. Without them the entry is saved and a note on the entry says why no event was made.
  • Description and Short description. Plain text becomes paragraphs; a safe set of HTML is kept and scripts are removed.
  • End date, Start time, End time. A date field and a time field work, and so does one text field that holds both, like 2027-03-05 18:30. A missing end date is the start date. A missing end time is one hour after the start, which is the My Calendar default. An end before the start is refused.
  • All-day event: any field whose value is yes, true, 1 or on makes the event all day.
  • Category: the name or the ID of a My Calendar category. A multi select or a set of checkboxes can give several.
  • Saved location: the name or the ID of a venue that is already in My Calendar.
  • New location fields: name, street, second street line, city, state, postcode, country and phone. They make a new venue when no saved venue was chosen.
  • More information link, Tickets link and Registration information: web addresses are checked and only http and https addresses are kept.
  • Repeat until: a date at which a repeating event stops.
  • Event image: a Gravity Forms file upload. The picture is copied into the media library and becomes the featured image, so deleting the entry never breaks the event.

Options

  • Category when the form gives none: used when the field is empty or the name is not found.
  • Missing categories: tick it to create a category that does not exist yet.
  • A new location with a name that already exists: by default the saved venue is reused, so five forms from the same hall do not make five halls. Choose Save another location to keep them apart.
  • Repeat the event: does not repeat, every day, every weekday, every week, every two weeks, every month on the same date, every month on the same weekday, or every year. Frequency sets every second or third time. Number of repeats is used when no Repeat until date is given; empty lets My Calendar choose its own span.
  • Author for visitors who are not signed in, and Host. A signed-in user is always the author of the events they send.

The feed has a Condition like any Gravity Forms feed. Use it to create an event only when a box is ticked, or only for one choice of a drop-down.

What happens when the form is sent

The add-on reads the entry, checks the dates, matches the category and the venue, and hands the values to My Calendar in the same way My Calendar does when it imports events from a file. My Calendar saves the event, its dates, its categories and the event page. Then the add-on writes three things on the entry: the event ID, a note, and the status.

Open the entry and the Calendar event box shows the title, the first date, whether it is a draft or published, a link to edit it in My Calendar and, for a published event, a link to the event page. The same entry note records that the event was created. If something was not found, for example a venue name that does not exist, the note says so and nothing is made up.

Draft events

Drafts appear in the My Calendar events list with the word Draft after the title, and the author shows as a public submitter when the visitor was not signed in. They are not on the public calendar, and their address shows no event to visitors. Open one, check it, and publish it from My Calendar.

Published events

A published event is on the calendar and has its own page straight away.

The month view of the calendar in August 2027 with events from the form in three category colors
Events published from the form, on the calendar, in their category colors.

One event per entry

An entry makes one event. If a feed runs again for the same entry, for example when you resend it, the add-on sees the event ID on the entry, makes nothing and adds a note. Deleting an entry does not delete its event.

Merge tags

  • {mycal_event_id}: the My Calendar event ID.
  • {mycal_event_url}: the public address of the event, empty for a draft.
  • {mycal_edit_url}: the address of the edit screen, for the notification that tells your team to review a draft.
  • {mycal_event_state}: draft or published.

A common use is a notification to your staff with the subject New event to review and the edit link in the message. The tags are filled when the notification is sent.

For developers

  • gfxmycal_create_event( $values ) creates an event from plain values and returns the event ID, the post ID, the status, the public address and the edit address, or an error. The keys are title, content, short, begin, time, end, endtime, all_day, categories, recur, every, repeats, link, tickets, registration, image, location_id, location, host, author and approved.
  • The filter gfxmycal_event_values changes the values before the event is made, and gfxmycal_event_post changes the array that is handed to My Calendar.
  • The action gfxmycal_event_created runs after the event was saved, with the result and the values.
  • The entry meta keys are gfxmycal_event_id, gfxmycal_event_post and gfxmycal_event_status. The event ID is also a column you can show and filter in the Gravity Forms entry list.

Privacy and security

The add-on contacts no outside service and adds no database table. The status, category rules and author come from the feed, not from the visitor. Web addresses are limited to http and https, text is cleaned before it is saved, and the My Calendar spam check, which would send the text to a third party when an anti-spam service is active, is not used because Gravity Forms has already accepted the entry. Use the Gravity Forms spam tools, a honeypot or a CAPTCHA on a public form.

Troubleshooting

  • No event was made: open the entry and read the note. The usual reasons are an empty title, a start date that is not a date, or an end before the start.
  • The feed settings are empty: check the license key and that My Calendar is active.
  • The event is not on the calendar: it is a draft. Publish it in My Calendar or set the feed to Published at once.
  • The wrong venue was used: a typed venue name that matches a saved venue reuses it. Turn that off in the feed options.
  • The category is wrong: the name must match a My Calendar category, in any letter case. Otherwise the feed default is used.

Questions

Do I need My Calendar Pro?

No. The add-on works with the free My Calendar plugin. Pro has its own public form; this add-on lets you use a Gravity Forms form instead, with all its fields, conditions and notifications.

Can a form edit or delete an event later?

No. A feed creates events. You edit and delete them in My Calendar.

Does it work with repeating events?

Yes. Choose the pattern in the feed. My Calendar builds the dates of the series from the first date.

What time zone is used?

The times are saved as typed, the same way My Calendar saves them when you type them in its own editor, in the time zone of the site.

What happens if my license expires?

Forms keep working and entries keep being saved. No new events are created, and the events that already exist stay as they are.

Still need help?

Our support team answers tickets every day, usually within a few hours.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr