Event – Add Event

Calendar Add Event is located under My Calendar > Add Event.

When you create a new event in My Calendar, you are creating one primary record in the database, with one start date and time and one set of event details.

My Calendar > Add Event

The Add Event screen is fairly long so that I will be splitting up the sections into smaller parts.

Event title
Event description

Description is the main event content area where you can add text, video, image information about the event.

Event – title and description.

Excerpt

You are able to select to show an excerpt in the event popup or other places. The excerpt is meant to give a short overview of the event.

Event – Excerpt

Categories

Select the General category or create new category/categories for your event by clicking the + Add Categories button.

Event – Categories

Insert the name and click Add Category.

Event – add new category

Defining a Primary Category.

Choosing a primary category sets which icon or category color will be used for an event when multiple categories are assigned.

Event – Primary Category

In the above example, I have added three categories Travel, Spain and Summer. I have to update the event to have these newly created categories show up in the Primary Category drop down.

Event – Selecting Primary Category

I can now select Travel category as the Primary Category for this event. The other categories become secondary.

Date and Time

Start Time and End Time of the event.
Date and End Date (optional) if needed.

Event – Date and Time

Instead of adding a Start and End Time you can click the All day event. Here you can rename the Time label and Hide end time if you choose to do so.

Event – All day event feature

Date and Time + Add Copy

By clicking + Add Copy the add copy screen is seen and one copy of the event is added. Here one can add additional copies of the event, adjusting the date and time as is needed. The result is that all the events are added to an Event Group and connected to each other.

Event – Date and Time + Add Copy.

Click the links for more documentation for + Add Copy or information about Event Groups.

Repetition Pattern

With Repetition Pattern one can create a pattern of how often the single event is repeated. Starting from the first event and ending at the date “Repeat Until” field. I have included a separate documentation page for Repetition Pattern, where you can learn more about getting the most out of this feature.

Event – Repetition Pattern

The featured image is available in the pop-up card and in the single event card. If your theme supports featured images, your theme’s images will take precedence over the My Calendar single event template.

Event – Featured Image

Event Details

Host – The frontend will show an avatar if available and the words: “Hosted by (username)”
More Information – The frontend will show a “More information” link. The text can be changed under Settings > Text.

Event – Event Details

Event Location

Select an event location from the location drop down. (None are seen in the following screenshot, as I have not yet made a location.)

Event – Event Location

For sites with many locations (more than 90), the drop down is replaced with an autocomplete search form.

My Calendar > Add Event > Event Location > Location drop down

Event Location – Add a new location

Click the “+ Add a new location” button to open up the fields to add a new location. The checkbox Copy new location will add the location to the Locations screen.

Event – Event Location Add a new location

Fill in the information you need for your event.

Accessibility

Click the check boxes to select accessible options for your event. These will also be seen on the frontend events screen.

Accessibility features include audio description, ASL interpretation, Deaf-Blind ASL, and many other options.
Event – Accessibility

Registration Settings

Add a link to an URL where users can get tickets for your events. The frontend will by default show a “Buy Tickets” link. Add additional text information related to tickets.

Event – Registration Settings

Check out my plugin My Tickets if you need additional registration or need to sell tickets. It integrates with My Calendar to handle ticket sales.

Next: Events -> My Events -> Click the title of an event to Edit Event.

Add Event – Add Copy

+ Add Copy is located under My Calendar > Add Event > + Add Copy. In the following screenshot we can see the original event and two copies.

My Calendar > Add Event > Date and Time + Add Copy

When clicking the + Add Copy a new copy of the event will automatically be added containing the same Start and End time as in the original event. Make the needed adjustments. Click the bottom + Add Copy to add additional copies of the event.

Above we can see that I have added two copies (duplicates). Using the same time but changing the dates.

Clicking to Cancel an Event Copy will give the option to “Restore” (keeping the event copy) or “Remove” (deleting the copy).

My Calendar > Add Event > Event Copy – Restore or Remove Event Copy.

This is a multi-day event.

Will show multiple events as one event overview on the frontend. If used in relation with Events widget/shortcode or Today’s Events widget/shortcode.

When the rest of the event information has been filled out and you decide to Save Draft or Publish. Here is an example of saving the above original event and the additional two copies. A total of three events are now published.

My Calendar > Add Event (published) > Publishing multiple copies

Here we can choose to View Event (frontend) or Edit Event. Or we might click the Events link seen in the left WordPress menu.

The following documentation shows an example with using + Add Copy and Repetition Pattern.


Add Event – Repetition Pattern

Add Repetition Pattern is located under My Calendar > Add Event > Repetition Pattern.

Add Event screen.

My Calendar > Add Event – Repetition Pattern

Here are some examples of how to use the Repetition Pattern.

Frequency: 1
Period: Daily
Repeat Until: 2021-11-12

My Calendar > Add Event > Repetition Pattern. Period: Daily. Repeat Until 2021-11-12.

The event will be repeated from the initial selected event date of e.g 2021-11-05 and up to 2021-11-12. Resulting in 7 events being seen on the frontend.

My Calendar > Add Event > Repetition Pattern. Period: Daily. Repeat Until 2021-11-12. Frontend.

Changing the Pattern Frequency.

Here is another example. This time I am changing the frequency from 1 to 2.
As the notification says: “Every 2 weeks until 2021-12-04”

My Calendar > Add Event > Repetition Pattern. Period: Weekly. Repeat Until 2021-12-04.

The event is repeated every second week until 4th of December.

My Calendar > Add Event – Frontend shows repeated events.

Edit event screen

After having added a Repetition Pattern in the Add Event screen one can modify the dates in the Edit event screen. Here is an example from earlier when I added a daily event from November 5th until November the 13th. By clicking the View scheduled dates I get an overview of each date the event will be held. I can Delete or Edit en event and even add another date.

My Calendar > Edit Event – Repetition Pattern. View scheduled dates.

This makes it very flexible to use Repetition Pattern in the Add Event screen and then following up in the edit event screen to modify the event dates. One can totally change the repeated dates for the specific event.

Scheduled dates are not seen in the backend as these are linked to one event. The events are only seen in the View scheduled dates in the backend and as regular events in the frontend calendar.

The following documentation shows an example with using + Add Copy and Repetition Pattern.

Event – Add Copy and Repetition Pattern

I will show how to create an event and two copies of the same event.
Events will be seen on Fridays, Saturdays and Sunday from now until December 31st 2021.

Add Event.
Fill in the information you need.

In Date and Time. I filled in the time for the original event and made two copies.

My Calendar > Add Event > Date and Time + Add Copy

In Repetition Pattern.

Frequency: 1. Period: Weekly. Repeat Until: 2021-12-31.

My Calendar > Add Event > Repetition Pattern.

Filled in anything else that I needed.
Published the events. View Event and went to the My Calendar main calendar.

Here is the frontend December calendar view.

Frontend view of my calendar displaying 3 weekly events.

The last weekend was the 26th of December. If I choose to do so I could add another event on Friday the 31st of December.

See the following links for additional information on + Add Copy and Repetition Pattern.

Event – My Events

Event Management is located under My Calendar > Events.

List View

My Calendar > Events – My Events – List View

One can choose between showing the events in a Grid View or in a List View.

Adjust the sort order of the list by clicking the heading titles such as ID, Title, Location, Date/Time, Author or Category.

All (all events),
Published (showing published events),
Drafts (showing draft events),
Trashed and one can also choose to for instance archive older events in the Archived screen.

Bulk actions
Click the checkbox in the ID column of each event to edit multiple events at once.
E.g. Publish, Switch to Draft, Trash, Archive or Delete.

Quick Edit
Hover over an event and see the quick edit links. View, Copy, Delete or Trash an event.

My Calendar > Events (edit event) > Quick Edit

The above is seen for a single event. If there are multiple events associated with each other another option will be seen: Edit Group. This will edit the grouped events. This also bring us to Event Groups.

Grid View

My Calendar: Events – My Events – Grid View

Grid View shows a similar layout to how the frontend shows the My Calendar Grid View. You can filter the events by Categories, Location or Accessibility Services.

Next: Events > Event Groups.

Event – Edit Event

Calendar Edit Event is located under My Calendar > Events. Click an event to edit. The main difference from Add Event to Edit Event is the following top menu items.

My Calendar > Events (Edit Event)

Delete – Delete the event.

Edit Event Post – My Calendar events are managed independently, via the My Calendar event manager. They use a custom post type to manage custom fields. This option makes it possible for custom field managers such as (e.g. Advanced Custom Fields) to add custom data to My Calendar events.

View – View the single event view for this event.

Events – Return to the event management screen.

Event – Event Groups

Calendar Manage Events is located under My Calendar > Events > Event Groups.

My Calendar > Events (quick edit) > Event Groups

Event Groups will also show all the events. This screen makes it possible to group events together or ungrouping specific events.

Click to see: Grouped Events, Ungrouped Events or All.

Ordering can also be done by ID, Group, Title, Location, Date/Time, Author or Category.

Hovering an event that is grouped will show these quick edit options.

My Calendar > Events > Event – Groups – quick edit

Edit Event
Will show a top menu as the following screenshot.

My Calendar > Events (Edit Event)

Edit Group
Editing a group will make adjustments to all the events in the group.

My Calendar > Events > Event Groups – Edit Event Group

Remove checked events from this group

At the top we can remove events from the group. Which means one can edit an event without it affecting the other events in the same group.

Editable fields for the events in this group match.

The following fields seen are used by all the events in the group. Apply changes to:
Check or uncheck specific events you want to adjust.

Selected dates are a single multi-day event.

Clicking the checkbox will create an association for upcoming events creating a visual on the frontend that these are linked.

Location – Add New Location

Add New Location is located under My Calendar > Add New Location.

My Calendar: Add new Location

Add your new location and fill in the information you need.
Remember to click the checkbox for Default Location if this is the address you plan on using most of the time.

Name of Location

Add a name of the location.

Location Address

Address where the event will be held.
Initial Zoom – when using a Google map one can set the initial zoom level.
GPS Coordinates – Set the coordinates of the map.

Location Contact Information

Set the
Phone
Secondary Phone
Location URL

Location Accessibility

Click the checkboxes for the location’s accessibility features. This information will also be seen on the frontend single event view.

Locations

Locations is located under My Calendar > Locations.

Add New and Update location permalinks.
Quick Edit Actions.
Edit Location.
Using a shortcode to view a location.

My Calendar > Locations

Adds a new location.
Clicking the Update location permalinks brings us to the Settings > Permalinks screen. Here we can change the slug part of mc-locations to something else.

My Calendar: Setting Permalinks for Events and Locations.

Quick edit actions.

Using the mouse button to hover over the location will bring up the actions area.

My Calendar: Locations quick edit

One can View, Edit, Set as Default or Delete the location.

View
View will show the (map) location on the frontend of your website. Here is an example where I have added the Google Maps API to Settings > Display > Event Display Fields - Single Event to be able to see the map location.

My Calendar > Locations > View (Frontend)

Edit
Will bring up the Edit Location screen to where one can edit the location.

Set as Default
When creating an event, the location field will be preset to the default location. Strongly advised if you have only one location – location is a required part of Google’s structured data for events.

Delete
Will remove the location.

Edit Location

Clicking to edit Minnesota Orchestra location will show the following screen.
NB! I have also added a Google API key to Settings > Display > Event Display Fields > Single Event so that we will see a location map at the bottom of the Edit Location screen.

My Calendar > Locations > Edit Location

Update GPS Coordinates
Adjusting the location and clicking the Update GPS Coordinates checkbox will update the map along with the rest of the location information on Save Changes.

Using a shortcode to view a location

One can use shortcodes to create a list of Locations.
Example: I made a page which I called Locations list. In it I added the shortcode:
[my_calendar_show_locations sort="country"] This will sort the location list by country. Sorting options are: name, city, state, zip, country and region.

Here is a frontend example of the Locations List page.

My Calendar > Page: Locations List > shortcodes > Frontend

There is also the option to add the shortcode that uses the default “name” sorting option: [my_calendar_show_locations] .

There is also template options for the location shortcode. The location template supports these template tags:
{id}, {label}, {street}, {street2}, {city}, {state}, {postcode}, {region}, {url}, {country}, {longitude}, {latitude}, {zoom}, {phone}, {phone2}

Here is an example:
[my_calendar_show_locations template="{label}, {city}"]

Here is a frontend example of the Locations List page using the above template shortcode.
— Image —

Next: My Calendar > Locations >Add New Location

Categories

Categories is located under My Calendar > Categories.

My Calendar > Categories

Category Editor

Category Name
Add a new category name.

Color
Select a color which will optionally show up in the calendar on the frontend.

Category Icon
Search for an icon. Write two letters or more and see which icons that show up. Here is an example. Click the icon to use it.

My Calendar > Categories – Search for an icon.

Private (logged-in users only)
Click this checkbox if you want to add a category only for logged in users.

Default
The default category is automatically selected when no category is selected for an event.

Holiday
If you have events that stretches over time than clicking Holiday will skip the holidays.

Category List

ID number – The ID number for each category. The ID will for instance be used in a shortcode.
Category Name – The list can be sorted by ID or Name.
Events – shows how many events are using each category.
Private – If Yes, the category is only seen by logged-in users. If No, it will be seen by everyone.
Icon – shows the selected icon (if Hide Category Icons is not checked).
Color – shows the hex color code.

My Calendar > Categories – Category List and Category Settings.

Category Settings

Hide category colors
Hides the color.

Title text color
Will add the color to the title text.

Title background color
will add the color into the event background seen in the calendar.

Hide Category icons
will hide the icon from the Category List as well as on the Calendar on the frontend.

Quick Edit

My Calendar > Categories – Quick Edit

Hovering over a category in the Category List will show quick edit options.

Edit – Editing a category will make it possible to change a name, color, icon if it is Private, Default or Holiday.

Set as Default – Set as Default will make the selected category the default for any event where one has not selected a category.

Delete – Delete category.

To learn more about Category icons see our documentation.