MokoDPCalendarAPI/README.md

MokoDPCalendarAPI

A Joomla 5/6 Web Services plugin that exposes DPCalendar events, calendars, and locations through the Joomla REST API (/api/index.php/v1).

Enables AI assistants (via joomla-api-mcp) and external integrations to create, read, update, and delete DPCalendar content programmatically.

Table of Contents

• Background
• Install
• API Endpoints
• Contributing
• License

Background

DPCalendar does not ship with a Web Services plugin. This plugin fills that gap by registering REST API routes for:

• Events — CRUD with date filtering, category scoping, and recurrence support
• Calendars — List and manage calendar categories
• Locations — List and manage event locations

Install

1. Download the latest release ZIP
2. System > Install > Extensions in Joomla admin
3. Upload and install the ZIP
4. System > Manage > Plugins — enable Web Services - DPCalendar

API Endpoints

All endpoints require Authorization: Bearer <token>.

Events

Method	Endpoint	Description
GET	/v1/dpcalendar/events	List events
GET	/v1/dpcalendar/events/{id}	Get event
POST	/v1/dpcalendar/events	Create event
PATCH	/v1/dpcalendar/events/{id}	Update event
DELETE	/v1/dpcalendar/events/{id}	Delete event

Calendars

Method	Endpoint	Description
GET	/v1/dpcalendar/calendars	List calendars
GET	/v1/dpcalendar/calendars/{id}	Get calendar

Locations

Method	Endpoint	Description
GET	/v1/dpcalendar/locations	List locations
GET	/v1/dpcalendar/locations/{id}	Get location
POST	/v1/dpcalendar/locations	Create location
PATCH	/v1/dpcalendar/locations/{id}	Update location
DELETE	/v1/dpcalendar/locations/{id}	Delete location

License

GPL-3.0-or-later — see LICENSE.

Copyright (C) 2026 Moko Consulting hello@mokoconsulting.tech

Maintainers

@jmiller

Revision History

Date	Version	Author	Notes
2026-04-26	1.0.0	jmiller	Initial Web Services plugin for DPCalendar