+ 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.
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.
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.
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.
Category icons can be found under My Calendar > Categories. Category Editor > Category Icon.
My Calendar: Click the ? to have a popup show a list of icons.
Click the Help link (blue circled ?) to show a list of available icons that can be added to a category.
My Calendar > Categories > ? > Icon List.
Go through the list and note the name of the icon you would like to use. Close the popup.
In the Category Icon field begin to write the name of the icon. E.g. anchor. Select the icon. We will see the full name anchor.svg show in the Category Icon field.
Category Icon drop down.
After having clicked Add Category. If the Category Settings – “Hide Category icons” is not checked then we will see the icons in the Category List.
My Calendar > Categories – Category List and Category Settings.
Icons will be seen on the frontend in the calendar and in the categories below the calendar. E.g anchor icon.
Showing icons in the frontend calendar view.
The icon is also seen in the single event view.
Frontend single event view. Icon seen next to title.
To hide the icon click the checkbox for “Hide Category Icons”. Seen in the Category Settings section.
Scripts is located under My Calendar > Design > Scripts.
My Calendar > Design > Scripts
Disabling scripts will break calendar interactions. This feature is intended for advanced users who wish to provide their own custom scripting.
Script Manager
Insert scripts on these pages (comma separated post IDs) Find the ID for the WordPress page the calendar is on and add it into the field. This will restrict scripts from loading on other pages.
Disable Grid JS
Disable the event popup in the calendar and automatically show the popup containing an event. One can not click the red circle with an x in it to close it.
Disable List JS
Show the List but the dates in the list are not clickable. (The + sign is not seen.)
Disable Mini JS
Mini calendar. Disables popup interactions in the mini calendar view.
Disable AJAX
Navigating the calendar (e.g., previous/next links, selecting a month, etc.), requires a new page load rather than dynamically navigating within the same page.
Choose a theme and click the Preview Stylesheet link that will be seen under the drop down. These are the themes that currently can be selected.
twentytwentytwo.css
Adds support for modal views.
Twenty Twenty Two
twentytwentyone.css
twentytwenty.css
A more minimal design theme than twentyeighteen.css, but still a full layout. New default them with 3.2.0.
My Calendar > Design > Style Editor – twentytwenty.css
When you upgrade My Calendar, your current stylesheet is retained. You can restore your stylesheet to a default stylesheet at any time, and can always compare your current version of the stylesheet to the version included with the plugin, to see if any changes have been made
Store your styles in a custom directory and protect it from being overwritten when updating the plugin. If the directory exists /wp-content/plugins/my-calendar-custom/styles/ and contains stylesheets, those stylesheets will be added to the list of available styles to work with.
twentyeighteen.css
An updated version of twentyfifteen.css, it supports any combination and order of navigation elements, unlike previous themes. Default theme with version 3.0.0.
My Calendar > Design > Style Editor – twentyeighteen.css
Deprecated styles
dark.css
light.css
refresh.css
my-calendar.css
twentyfourteen.css
twentyfifteen.css
Several of the older stylesheets were deprecated in version 3.4.0, and are no longer available to be selected in the plug-in. The stylesheets can be found in the GitHub repository for My Calendar, but if you choose to use them from your custom stylesheet directory you will probably need to customize them.
CSS Style Options
Load CSS only on selected pages
If you only want to load the theme CSS on specific WordPress post ID’s. Add the ID’s into the text field. One way to find the Post ID is by right clicking inside the browser and selecting Inspect (Element) and HTML and CSS areas should show up on the bottom. At the top inside the HTML area one will be able to see postid-(and a number). This postid number would then go into the “Apply CSS on these pages” field.
Disable My Calendar CSS
This will disable the default My Calendar Stylesheet so that you can use your own Stylesheet. Add a custom directory to store your various customizations. In /wp-content/plugins/my-calendar-custom/styles.
Example. In the plugins directory I made “my-calendar-custom” folder and inside another folder “styles”. I went to my-calendar plugin, located the styles folder and duplicated twentytwentyone.css stylesheet into my custom styles folder. I gave the stylesheet a new name “custom-calendar.css”.
In the Design > Style Editor section I clicked the checkbox “Disable My Calendar CSS” and at the bottom of the page clicked “Save Changes”. Refreshed the page. Clicked the “Select My Calendar Theme” drop down and noticed my custom calendar visible at the top of the list. (Refresh a couple of times if you have not seen your own custom stylesheet show in the drop down list.)
My Calendar > Design > Style Editor – custom stylesheet
I selected my custom-calendar.css, clicked “Choose Style” button and noticed the following screen.
CSS variables can be changed, and you can also add new variables to be used in your stylesheet. To view default themes again. Uncheck “Disable My Calendar CSS” checkbox and click “Save Changes”. Then select one of the default themes and click “Choose Style”.
Edit a My Calendar stylesheet.
One can modify any of the theme stylesheets.
In the following example I added the comment /* My test */ to the twentytwenty.css stylesheet. I then clicked the “Save Changes” button. The following notification came up.
Clicking the text link “Compare Your Stylesheet with latest installed version of My Calendar.” Will show a comparison between the Current (in use) and the Latest (from plugin). Showing the adjustment I made in the Current (in use) column.
My Calendar > Design > Style Editor – Curren and Latest
Clicking the checkbox – “Reset stylesheet to match core version” and then the “Reset Styles” button will revert the stylesheet back to the Latest (from plugin) version.
Clicking “Return to editing” will keep the change that has been made.
CSS Variables
CSS or custom variables were introduced in twentyeighteen.css, and are not present in earlier stylesheets. Only twentyeighteen.css, twentytwenty.css or newer stylesheets contain CSS variables. Modify the primary, secondary and highlighted colors used throughout the calendar. One can also add additional CSS variables.
Accessible Color Combinations overview. Shows which colors are accessible with each other and meets the (WCAG) Web Content Accessibility Guidelines.
My Calendar > Design > Style Editor – CSS Variables
An example showing how the CSS Variables are used in the calendar. I am experimenting with the twentytwentyone.css stylesheet.
Above the primary light (white) and primary dark (black) colors have been added to the background color, text color and border bottom. A variable can be added in any place and as many times as the specific variable is needed. We can also create additional CSS variables along with selecting the color to be used.
Templates is located under My Calendar > Design > Templates.
My Calendar > Design > Templates
Template Editor
Core Templates
My Calendar > Design > Templates – Core Templates and Custom Templates
The core templates will display event details and appear in five places:
grid The main grid calendar. The content that appears in the popup window.
list The list view calendar.
mini The mini view calendar.
details (single event) The single event view, or details page.
The core templates are not in use by default. These are simplified models of what is possible. If you only want to make a minor change to the default template, you can edit the specific template and enable it to put it into use. If you wish to revert to the original output, turn off the template.
You can place a template file in your theme directory and reference it from the My Calendar shortcode. If you have a template file called “template.txt” in your theme directory, it would be referenced as [my_calendar template="template.txt"] in your shortcode.
To enable a core template. Click the template name. Example: I clicked the grid template name and the grid template code became visible so that I could modify the code. To use the template I would need to click the checkbox “Use this template” (above the code section) and click the Update Template button (below the code section).
After clicking to “Use this template” and clicking the Update Template button. We will be able to see the grid enabled.
My Calendar > Design > Templates – enabled grid.
Frontend view of the grid popup. (your before and after grid popup views will likely be different than the examples I show below.)
Before enabling grid view:
My Calendar > Design > Templates – before enabling grid template. Frontend view.
After enabling grid view:
My Calendar > Design > Templates – after enabling grid template. Frontend view.
It clearly shows the difference between disabled and enabled grid view.
Core template code.
Click the code of each core template and see how these are built. It will make it easier to build your own template if you base it on one of the below core templates.
Core Template: grid: used in the details popup in the main calendar view.
Click “Add Custom Template” button to create a blank template. We will see this section:
My Calendar > Design > Templates – Add Custom Template
Add a Template Description and code and click the “Add Template” button.
After saving the custom template we will see it listed with a template key. The template key is used as a reference to this template in almost any template attribute. This is an easier and more flexible way to manage templates used in shortcodes.
Using Custom Templates
Custom template list
After creating a custom template, you can use the template key in place of the template anywhere you would normally add a template. You can use the key in shortcodes or in widgets.
Below the list of Event and Location tags seen in the Design > Templates screen. A Template preview will display to show the enabled core templates or custom template.
Here is an example with the enabled the grid view template.
My Calendar > Design > Templates – Template Preview: Grid
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
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
Featured Image
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.
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.
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.
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.
Menu items
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 toEvent 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.
Get Support is located under My Calendar > Help > Get Support. Here is an example of what the screen can look like.
My Calendar > Help > Get Support
Sometimes support will ask you to copy the system information to make it easier to figure out where an error might be. As there might be a plugin or theme or other conflict. Looking through the system information gives a quick overview of the environment the My Calendar plugin is used in.
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.
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 —
My Calendar has two primary methods for displaying events: Shortcodes and Widgets.
Shortcodes are small pieces of code intended to be placed in posts or pages. Some examples of using shortcodes are, adding a standard grid-format calendar, a list-formatted calendar, showing the events for the month, the week, or the day. Continue reading below to learn more about shortcodes.
Widgets are a convenient method to add information to sidebars and footer areas. Using widgets one can display a version of the calendar formatted for small spaces (the “mini” calendar), a list of upcoming events, a list of events happening today, or a specific single event. To learn more about widgets read our My Calendar widget documentation.
Shortcodes
Located on the bottom of the default “My Calendar” page is the My Calendar Display Options meta boxes. (Click the top right arrow of the meta boxes to view the options.)
Meta boxes. My Calendar page – Display Options
Main Calendar Shortcode
The default shortcode for displaying My Calendar.
[my_calendar]
The above my calendar code is actually the same as this code:
Categories to display. Location filter type by All locations, Location Name, City, State, Postal Code, Country or Region. Location filter values. Search keyword. – Only events that use the keyword will be visible in the calendar.
Navigation
Navigation keywords that can be used separated by commas in the “Navigation above calendar” and “Navigation below calendar” fields.
toggle – Switch between list and grid views timeframe – Toggle between day, week, and month view jump – Jump to any other month/year nav – Primary Previous/Next Buttons calendar – The calendar key – Categories print – Link to printable view feeds – iCal Subscription Links exports – iCal Subscription Links locations – Location (dropdown) categories – Categories (dropdown) access – Access (dropdown) search – Search
The attributes will show up in the order they are listed. To remove the navigation add “none”. My Calendar will show the defaults if no attributes are added. Defaults can be configured in the Settings > Output screen.
Author & Host Filters
Limit by Author. Limit by Host.
Formatting & Timeframe
Format by Default, Grid, List or Mini. Time Segment by Default, Month, Next Month, Week or Day. Months to show in list view.
Initial Date Shown
Select the start date of events going forward. Year by Default or the next 5 years. Month by Default or a specific month. Day by Default or from 1 to 31.
The shortcode: Above calendar: A toggle between list/grid view along with nav previous/next navigation arrows. Below calendar: a print icon and key categories. Format: Changed the default grid to list. Time: The calendar is seen in a week view.
The result which includes two events is seen on the frontend of the site.
Shortcode displayed on frontend
Reset Shortcode button Go back to the backend and click the “Reset Shortcode” button (to the right of the Shortcode field) and refresh the browser window to see the Shortcode field reset.
Read about the Shortcode Generator. Next: My Calendar > Shortcodes.
You can also get to this Quick Start Guide in the WordPress backend by going to Help -> Getting Started. It is meant to quickly give you the basics on how to use the My Calendar plugin.
After having activated My Calendar plugin a new default “My Calendar” page will automatically be created. The Calendar Page Location can be changed through the Settings > General screen.
Quick Start Guide – My Calendar > Settings > General – Calendar Page Location.
Go to My Calendar page and notice at the bottom the My Calendar Display Options (click the arrow to open). This is a way to quickly set the default of how your calendar will look on the frontend. Here you can explore various views and what is seen. Go to My Calendar Display Options documentation to learn more about these options.
Display Settings is located under My Calendar > Settings > Display.
Main Display Settings: view titles, fields shown in different views.
Grid
Event title (Grid) {time}: {title}
Example with adding in the word “Event Title” into the Event title (Grid) field. I added shortcode: {time} Event Title: {title}
Frontend view:
My Calendar > Settings > Text > Event title (Grid). Frontend view.
Single
Event title (Single) {title}
Example with adding in the word “Event Single Title: ” into the Event title (Single) field. I added the shortcode: Event Single Title: {title}
Frontend view:
My Calendar > Settings > Text > Event Title (Single). Frontend view.
List
Event title (List) {title}
Example with adding in the word “Event List Title” into the Event title (List). I added the shortcode: Event List Title: {title}
Frontend view:
My Calendar > Settings > Text > Event title (List). Frontend view.
These are the changes I made:
My Calendar > Settings > Text – Templating fields.
Event Display Fields
The series of check boxes gives you the ability to display or hide a variety of different fields directly in the frontend for Single Event, Calendar Popup/List View, and Mini Calendar Popup.
Settings for Single Event, Main View (Popup or List) and Mini Calendar Popup.
Choose fields to show in the various frontend views. Adjusting the templates can override these settings. Unclicking/Unsetting all the values will bring back the default values.
Single Event
My Calendar > Settings > Display – Event Display Fields – Single Event
Default frontend fields for the Single Event.
My Calendar > Settings > Display – Event Display Fields – Single Event. (Theme: Twenty Twenty One.)
Main View (Popup or List)
My Calendar > Settings > Display – Event Display Fields – Main View (Popup or List)
Default frontend view for the Main View: Popup.
My Calendar > Settings > Display – Event Display – Main View – Popup. (Theme: Twenty Twenty One.)
Default frontend view for the Main View: List.
My Calendar > Settings > Display – Event Display Fields – Main View – List (Theme: Twenty Twenty One.)
Mini Calendar Popup
My Calendar > Settings > Display – Event Display Fields – Mini Calendar Popup
Default frontend view for the Mini Calendar Popup.
My Calendar > Settings > Display – Event Display Fields – Mini Calendar Popup. (Theme: Twenty Twenty One.)
Clicking the event the Mini Calendar Popup.
My Calendar > Settings > Display – Event Display Fields – Mini Calendar Popup is open. (Theme: Twenty Twenty One.)
Calendar Navigation
Update calendar layout Define a default layout for calendars. Use the arrow icons to move fields up or down or use drag and drop to rearrange the order these are seen in. Click the eye to hide fields. These settings will be overridden if you customize the field settings in the My Calendar shortcodes.
My Calendar > Display > Calendar Links and Update calendar layout
Default Frontend view containing one event:
My Calendar > Settings > Display. Viewing default calendar layout on frontend. (Theme: Twenty Twenty One.)
View Options
How many months of events to show at a time: Sets how many months will be shown at one time by the main calendar shortcode in list, grid, and mini view. Also configurable via the shortcode.
Grid Options
Calendar Links
Open links as a pop-up Opens a pop-up card and one can click “Read more” to continue to the single event view.
Open event links in single event view Bypasses the pop-up card and goes straight to the single event. Improves performance with large numbers of events.
Disable calendar links This option will disable all event links in the main calendar. Useful for a minimal-information view.
Mobile View: Adjusts how the calendar will be rendered on mobile devices. It can switch to list view, switch to mini calendar view, or have no change.
Show Weekends on Calendar: If enabled, Saturday and Sunday (weekend days) will be included in the calendar grid.
List Options
Show the first event’s title and the number of events that day next to the date. In the list view, the toggle to expand events for a day is normally just the current date. Use this to show more information.
Show all event titles next to the date. Instead of just showing the first event, show all event titles for the date.
Mini Calendar Options
Target link for mini calendar dates – This URL is the destination you want links from the mini calendar to use.
Link action for mini calendar: Event pop-up, daily view page (above), in-page anchor on main calendar page (list), in-page anchor on main calendar page (grid).
My Calendar > Settings > Display – Grid Options – List Options – Mini Calendar Options.
General Settings is located under My Calendar > Settings > General.
My Calendar > Settings > General
My Calendar Management
Calendar Page Location
“My Calendar” is the title automatically added to the page that is created to display the calendar. You can edit this page as a normal page at Pages > All Pages.
Default sort order for Admin Events List
The Events screen columns can be ordered by Event ID, Title, Date/Time, Author, Category and Location. One can also directly reorder the Event list by clicking the column headings on the Events screen.
Default sort direction
Descending (Z-A) or Ascending (A-Z).
Use Pretty Permalinks for Events
Checkbox clicked: for Pretty Permalinks will show a similar slug to this example. https://example.com/mc-events/a-new-event/?mc_id=1
Website name / events base / event title / event ID.
Checkbox not clicked: not showing pretty permalinks will show a similar slug to this example. https://example.com/my-calendar/?mc_id=1
It will not use the events base in the slug.
With pretty permalinks enabled, single event views are rendered using your theme’s single.php template file. Otherwise, single event views are rendered by the My Calendar shortcode on your calendar page.
Go to Settings > Permalinks to change the base URL for events and locations.
My Calendar WordPress plugin. Setting Permalinks for Events and Locations.
The following example in changing mc-events to concerts with pretty permalinks activated: https://example.com/concerts/a-new-event/?mc_id=4
Advanced section
Get data (events, categories and locations) from a remote database.
This option allows you to share data between multiple sites if they all need matching calendars.
It requires you to enable remote database access on the source site as a hosting option in the hosting control panel or by contacting your host.
Once you enable the option, you will need to add code to your theme’s functions.php file to make the remote connection work.
function mc_remote_db() {
$mcdb = new wpdb('DB_USER','DB_PASSWORD','DB_NAME','DB_ADDRESS');
return $mcdb;
}
Replace the above placeholders with the host-site database information. The two sites must have the same WordPress table prefix. While this option is enabled, you may not enter or edit events through this installation.
Enabling a remote data connection will disable Adding and Managing Events, Locations, and Categories, as all that data will be drawn from the remote database. Scripts, settings, and styles are still managed from the local installation.
Example: You own two movie theaters, and they show the same movies at the same times. Rather than enter every event twice, you can remotely access the database for theater 1 so that both theaters display exactly the same event information. The two sites can have completely different designs, and show calendars in different ways, but share the same events.
Enable external API
Enable to acquire custom event data in JSON, CSV, or iCal (.ics). When you enable the External API, the URL for requests to your API will be displayed. This API does not use the WordPress REST API.
Check this option prior to uninstalling My Calendar to also delete all event data.
Delete plugin settings on uninstall
Check this option prior to uninstalling if you wish to delete all the settings you have configured.
Import & Export Settings
Exporting your settings will allow you to download a JSON file with your site’s current settings. You can then import those settings again after making changes or into another site.
There’s a JSON copy of the My Calendar default settings available as defaults.json in the root of the My Calendar plugin directory.
Settings on other screens
Settings > Permalinks: Events permalink slug (mc-events) Settings > Permalinks: Location permalink slug (mc-locations) Settings > General: First day of the week
My Calendar: Setting Permalinks for Events and Locations.
General WordPress settings
There are two important settings controlled outside the plugin: the time zone events are displayed in and the day of the week the calendar starts on. These options are set from the WordPress general settings: Dashboard > Settings > General.
Calendar Input Settings is located under My Calendar > Settings > Input.
My Calendar > Settings > Input
Calendar Input Fields
Event editing fields to show Restrict your event authors from using certain fields, or reduce the number of fields you see when creating or editing events, use these options to remove the fields you do not plan to use.
Example: Uncheck Categories and Event Location. Click Save Input Settings. Go to create a new (add) Event or open an existing event. Notice Categories and Event Location inputs have been removed. This will remove Categories and Event Locations for all users.
An alternative method is to use Screen Options in the Add Event or existing event screen to hide fields. Example: Categories and Event Location for all events. This will remove Categories and Event Locations just for my user.
Event: Screen Options. Event editing fields to show.
Notice the two different approaches. Output Settings will removes a field for all users. Screen Options removes it just for yourself.
Location Controls
With Location Controls we can define the values one can select when adding a new location. Save custom values to change location text fields into dropdowns. One field per line. Format: saved_value,Displayed Value
We can add adjustments to the following Input Settings Location Controls Fields:
Name of Location.
City
State/Province
Postal Code
Region
Country
Changing any of the above name/value pairs will also change the name (value) seen in the Location fields, but does not change previously saved data.
Here is an example: Adding Montana – MT, Minnesota – MN and Maine – ME to the location controls for State/Province.
My Calendar > Settings > Input > Location Controls
The Add New Location screen. We will see a dropdown in the State/Province field. Because of the above adjustment.
My Calendar > Add New Location > State/Province drop down
Being able to control the Location Controls gives us the opportunity to finetune the setup when adding a new location. As we can limit various fields one is able to insert.
Calendar Notifications Settings is located under My Calendar > Settings > Notifications.
My Calendar > Settings > Notifications
It can be useful for notifications to be sent out when new events are submitted or created by lower-level subscribers, as these events might need administrative approval to be posted to the calendar.
Calendar Email Settings
Email Notifications
Send Email Notifications when new events are added.
Send HTML email If you select this option you can include your complete HTML template within the Message Body Field.
Notification messages are sent to: If you wish to send notifications to multiple email addresses, you can enter them separated by commas.
My Calendar Pro version The plugin will send notifications when events are submitted from the public interface. Those are a separate set of messages. Both notifications will be sent; but they do not need to be sent to the same person.
Notification messages are sent from: BCC on notifications (one per line):
Email subject – subject line of email Message Body – message sent (template tags available.)
Calendar Permissions Settings is located under My Calendar > Settings > Permissions.
My Calendar > Settings > Permissions
My Calendar Permissions
Permissions in My Calendar are granular, so you can provide user roles with access only to specific portions of My Calendar. It supports custom roles, as well, so you can grant permissions to any role you create or that is created by a membership plugin.
The administrator role has all capabilities, and you can not remove these in My Calendar.
Event Editing Permissions
Add Events: Grants users access to enter new events as drafts
Approve Events: Grants users the ability to publish events added by other users.
Publish Events: Grants the ability to publish your own events.
Manage Events: Grants full access to editing and publishing events.
Text Settings is located under My Calendar > Settings > Text.
Text Settings
My Calendar gives control over a number of text fields via this section of settings. These are not the only elements of text that can be controlled; almost any element of event and date output can be modified.
Templating
In My Calendar 3.4.0, templating settings were moved to the ‘Display’ tab.
Main Calendar View
My Calendar > Settings > Text > Main Calendar View
My Calendar provides adjustable forward and backward navigation link text.
Previous events link – Previous Next events link – Next
Here is an example of adding {date} to Previous {date} and Next {date} to indicate what month and year is being navigated to.
The frontend will show the Previous and Next links along with the month and year.
My Calendar > Settings Text > Previous and Next with Date shortcode. Frontend view.
Week view caption.
The default caption is “Week of” and the date.
Week view. It only supports the template tag for {date}. Here is an example of adding {date} and the words “Week view caption” to the Week view caption field. This is the template I set: Week view caption {date}. On the frontend we can see the caption followed by Monday’s date.
My Calendar > Settings Text > Week View Caption. Frontend view.
We can also adjust the date format by adding this shortcode: {date format=""} Example F j,Y so we get Week view caption {date format="F j, Y"} the result would be:
My Calendar > Settings Text > Week View Caption date format. Frontend view.
The bottom of the Text settings we get an overview of the Date/Time Formats.
Extended caption.
Extended caption. Add text if you want additional information than month and year in your calendar heading. Here is an example of adding the words “This is the extended caption” to the calendar heading.
My Calendar > Settings Text > Extended caption. Frontend view.
Single Event View
My Calendar > Settings > Text > Single Event View
Label for all-day events All day can be changed in two places. Through the Text settings or when creating a new event or editing an event.
Changing it through Text settings will change all of the “Label for all-day events” labels. Changing it while creating an event or editing an event will only change the label for the individual event.
Hosted by Hosted by Posted by Posted by Buy tickets Buy tickets Event Accessibility Heading Event Accessibility View full calendar View full calendar Read more text Read more
Here is an example of a single event where one can see most of the text that can be modified.
My Calendar > Settings > Text > various options. Frontend view.
More Information text More information Browser tab title element template {title} » {date}
Date/Time formats
Primary Date Format F j, Y Time Format g:i a Month Format (calendar headings) Date in grid mode, week view M j, ‘y
Date formats
F = month M = first 3 letters of the month j = day Y = Year
Time formats
g = hour i = minutes a = am/pm
For additional information: Date formats use syntax from the PHP date() function. See the My Calendar documentation for more information about Event Template tags.
Shortcodes is located under My Calendar > Shortcodes. Main, Upcoming and Today.
Main
The general Calendar. Will show the default calendar view based on the selections in the Main tab screen. You can also go directly to the backend My Calendar page and modify the shortcodes seen on the bottom in the meta boxes.
[my_calendar]My Calendar > Shortcodes > Main
Content Filters
Categories to display. Select All or specific categories to display. Location filter type. Select a specific location area to filter by. Location values. Fill in a specific value. Search keyword. Shows events containing a specific keyword.
Navigation
Navigation keywords that can be used separated by commas in the “Navigation above calendar” and “Navigation below calendar” fields.
toggle – Switch between list and grid views timeframe – Toggle between day, week, and month view jump – Jump to any other month/year nav – Primary Previous/Next Buttons calendar – The calendar key – Categories print – Link to printable view feeds – iCal Subscription Links exports – iCal Subscription Links locations – Location (dropdown) categories – Categories (dropdown) access – Access (dropdown) search – Search
The attributes will show up in the order they are listed. To remove all navigation add “none”. My Calendar will show the default settings if no attributes are added. Defaults can be configured in the Settings > Display screen.
Author & Host Filters
Limit by Author. Limit by Host.
Formatting & Timeframe
Format. Choose from Grid, List or Mini. Time Segment. Month, Next Month, Week, Day Months to show in list view. Select the amount of months to be seen in list view.
Initial Date Shown
Select the start date of events going forward. Year. By Default or the next 5 years. Month. By Default or a specific month. Day. By Default or from 1 to 31.
Upcoming
Upcoming events you can show events coming up in the future, or include past events.
Widgets are located under Appearance > Widgets or in the Appearance > Customize > Widgets section.
Widgets do not provide different functionality than shortcode functions, but they do make it easier to implement secondary calendars.
Block Widgets
Block widgets are used in the Core Editor (Gutenberg).
Appearance > Widgets. Add widget blocks by clicking the top left blue square with a + in it to open the block inserter. (The blue square changes to black when open.) The block inserter area looks like this.
Block Widgets
Widget overview
Widgets are pictured using the block widget interface, but are also available in the classic widget interface.
My Calendar: Today’s Events
Today’s Events
My Calendar: Upcoming Events
Upcoming Events
My Calendar: Mini Calendar
My Calendar: Mini Calendar block widget
My Calendar: Simple Event Search
Simple Event Search
My Calendar: Event Filters
Event Filters
Appearance > Customize Have the same block widgets as are seen in the Widgets screen. Here is an example using the My Calendar: Mini Calendar.
