Smart Calendar allows you to display events from either a Microsoft Calendar or an .ics URL on your WordPress site. The plugin provides a simple shortcode that you can use in your posts or pages to display calendar events.

Activate Your Plugin

1. Go to the Plugins Page
2. Activate the Smart Calendar plugin

Configuration

ICS URL

To use an ICS URL, you simply need the URL to the .ics file. No additional configuration is required.

Usage

Shortcode

Use the [calendar_events_microsoft] shortcode to display calendar events on your site.

Available Attributes

• ics_url - (Required for ICS) The URL to the .ics file

• max_events - (Optional) The maximum number of events to display (default: 10)

• per_page - (Optional) The number of events to display per page/slide (default: 3)

• scrollable - (Optional) Whether to enable carousel functionality ('true' or 'false', default: 'false')

• arrows_position - (Optional) The position of the navigation arrows ('top', 'center', or 'bottom', default: 'center')

• custom_navigation - (Optional) Whether to use custom navigation buttons ('true' or 'false', default: 'false') 

  • This option overrides the arrows_position option by disabling the default navigation arrows.

Examples

Display Events From an ICS URL

[calendar_events_microsoft ics_url="https://example.com/calendar.ics" max_events="5"]

Display events with carousel functionality:

[calendar_events_microsoft ics_url="https://example.com/calendar.ics" scrollable="true" per_page="3" arrows_position="bottom" max_events="12"]

Features

• Display events from Microsoft Calendar

• Display events from ICS URL

• Limit the number of events displayed

• Carousel functionality for scrollable event display

• Customisable navigation arrows position

• Option for custom navigation buttons

• Configurable number of events per page/slide

Finding Your ICS URL

For Outlook.com or Outlook for Microsoft 365 (web interface):

1. Go to your Outlook Calendar: Open your web browser and go to Outlook.com or log in to your Microsoft 365 account and navigate to your Calendar.

2. Access Settings: Click on the Settings gear icon (usually in the top right corner).

    

3. View all Outlook settings: At the bottom of the settings pane, click on "View all Outlook settings."

    

4. Navigate to Shared Calendars: In the settings window, go to "Calendar" on the left, then select "Shared calendars."

    

5. Publish a calendar: Under the "Publish a calendar" section, you'll see a dropdown menu.

    

6. Select the calendar: Choose the calendar you want to publish (e.g., "Calendar" or any other custom calendar you've created).

    

7. Choose permissions: Select the level of detail you want to share (e.g., "Can view all details" if you want to share all event information, or "Can view when I'm busy" for just free/busy times).

    

8. Click "Publish": After selecting the permissions, click the "Publish" button.

    

9. Copy the ICS link: Outlook will then display two links: an HTML link and an ICS link. You'll want to copy the ICS link. This is the URL you can use to subscribe to your calendar in other applications.

To find an ICS (iCalendar) URL for a Google Calendar, you'll need to use the Google Calendar web interface. Here's how:

For Google Calendar:

1. Open Google Calendar: Go to calendar.google.com in your web browser and sign in to your Google account.

2. Access Calendar Settings:

   • On the left sidebar, under "My calendars," hover over the calendar you want to get the ICS URL for.

   • Click the three vertical dots (⋮) that appear next to the calendar name.

   • From the menu, select "Settings and sharing."

3. Navigate to Integrate Calendar:

   • On the left-hand side of the settings page, scroll down and click on "Integrate calendar."

      

4. Find the ICS URL:

• In the "Integrate calendar" section, you'll see a few different links.

• Look for the section titled "Public address in iCal format.". This is the ICS URL you're looking for.

  • This is for sharing your calendar publicly (e.g., embedding it on a website).

• Click the "Copy to clipboard" icon next to the "Secret address in iCal format" to copy the URL.