WP Manifestindependent plugin directory
manifest / events / upcoming-calendar-events

Upcoming Calendar Events

Build a small WordPress plugin called "Upcoming Calendar Events" that displays upcoming events from a Google Calendar on the front-end of a WordPress site.

by Plugin Developer · github.com/varind3r/upcoming-calendar-events · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/varind3r/upcoming-calendar-events/archive/refs/heads/main.zip

Readme

Upcoming Calendar Events

A lightweight WordPress plugin that displays upcoming events from a Google Calendar using a shortcode and AJAX rendering.

Features

  • Admin settings page under Settings -> Calendar Events
  • Google API key configuration
  • Cache duration and default event count settings
  • Shortcode [upcoming_events] with support for count, days_ahead, show_description, and google_calendar_id
  • Cache stored in WordPress transients and invalidated on settings save
  • AJAX-powered frontend rendering with graceful error handling

Installation

  1. Copy the upcoming-calendar-events folder into wp-content/plugins/.
  2. Run composer install from the plugin folder:
    cd wp-content/plugins/upcoming-calendar-events
composer install
  3. Activate the plugin from the WordPress admin Plugins screen.

Setup

  1. Go to Settings -> Calendar Events in the WordPress admin.
  2. Enter your Google API key in the API key field.
  3. Set the cache duration in minutes (default is 60).
  4. Set the default number of events to display (default is 5).
  5. Click Save and validate to store the settings and verify the API key.

Usage

Add the shortcode to a page or post:

[upcoming_events count="10" days_ahead="30" show_description="true" google_calendar_id="something@group.calendar.google.com"]

Required shortcode attributes:

  • days_ahead - mandatory numeric number of days ahead to show events for
  • google_calendar_id - mandatory Google Calendar ID

Optional shortcode attributes:

  • count - number of events to show; if omitted, the plugin uses the default count from settings
  • show_description - true or false; defaults to false

Google API Key and Calendar ID

  1. Create or select a project in the Google Cloud Console.
  2. Enable the Google Calendar API.
  3. Create an API key under APIs & Services -> Credentials.
  4. Use that API key in the plugin settings page.
  5. Get the calendar ID from Google Calendar settings under Integrate calendar.
  6. Use a public or shared calendar ID such as something@group.calendar.google.com.
  7. Do not use an OAuth client ID/secret for this plugin.

Architecture

  • upcoming-calendar-events.php - plugin bootstrap and Composer autoload.
  • src/Plugin.php - main plugin orchestrator.
  • src/Admin/Settings.php - admin menu, settings page, validation, and cache refresh.
  • src/Frontend/Shortcode.php - shortcode registration and AJAX placeholder output.
  • src/Frontend/AjaxRenderer.php - AJAX endpoint for rendering events.
  • src/Api/GoogleCalendarClient.php - Google Calendar API client.
  • src/Cache/CacheManager.php - transient-based caching and cache-key management.

Read the full README on GitHub →