Moqbo is a WordPress event calendar plugin for managing categorized timed and all-day events. It stores events and categories in site-specific custom database tables, provides administration screens for managing that data, renders frontend calendars through shortcodes, and can expose selected read and write operations through an optional REST API.<\/p>\n\n
[moqbo]<\/code> or [moqbo-getdate]<\/code> respectively<\/li>\n- Optional REST API: Access and create events and categories for programmatic use<\/li>\n<\/ul>\n\n
Requirements<\/h3>\n\n\n- WordPress 6.5 or newer<\/li>\n
- PHP 7.4 or newer<\/li>\n<\/ul>\n\n
Quick Start<\/h3>\n\n\n- Create a category under \"Moqbo > Categories\".<\/li>\n
- Create an event under \"Moqbo > Add Event\".<\/li>\n
- Add
[moqbo]<\/code> to a post or page.<\/li>\n<\/ol>\n\nTo display the next date for a matching event, use [moqbo-getdate name=\"Office Hours\"]<\/code>.<\/p>\n\nAPI Usage<\/h3>\n\n
Moqbo registers WordPress REST API routes under \/wp-json\/moqbo\/v1<\/code>. Enable the API and the required endpoint methods in \"Moqbo > Settings\" before calling the general events or categories endpoints.<\/p>\n\n\nPOST \/events<\/code>: Creates an event.<\/li>\nGET \/events\/{slug}<\/code>: Returns one event by slug.<\/li>\nGET \/events?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD<\/code>: Lists events within the date range. The range can span up to 366 days.<\/li>\nPOST \/categories<\/code>: Creates a category.<\/li>\nGET \/categories<\/code>: Lists categories alphabetically.<\/li>\nGET \/categories\/{slug}<\/code>: Returns one category by slug.<\/li>\n<\/ul>\n\nThe general API has no update or delete endpoints. All date and time values are interpreted in the WordPress site's timezone. Event-list date ranges are inclusive: an event is returned when it overlaps any part of the requested range.<\/p>\n\n
Authentication<\/h4>\n\n
Enabled GET<\/code> endpoints are public by default. When Require token authentication for GET requests<\/code> is enabled, send the configured token as a bearer token. Enabled POST<\/code> endpoints always require that token, regardless of the GET authentication setting.<\/p>\n\nAuthorization: Bearer 0123456789abcdef0123456789abcdef01234567\n<\/code><\/pre>\n\nTokens must be 32 to 255 characters and should only be sent over HTTPS. Set Content-Type: application\/json<\/code> for JSON POST bodies.<\/p>\n\nCategories<\/h4>\n\n
Create a category before creating events that reference it:<\/p>\n\n
POST \/wp-json\/moqbo\/v1\/categories\nContent-Type: application\/json\nAuthorization: Bearer 0123456789abcdef0123456789abcdef01234567\n\n{\n \"name\": \"Meetings\",\n \"slug\": \"meetings\",\n \"color\": \"#2271b1\"\n}\n<\/code><\/pre>\n\nOn success, the endpoint returns 201 Created<\/code> and a Location<\/code> header pointing to \/wp-json\/moqbo\/v1\/categories\/meetings<\/code>:<\/p>\n\n{\n \"name\": \"Meetings\",\n \"slug\": \"meetings\",\n \"color\": \"#2271b1\",\n \"event_count\": 0\n}\n<\/code><\/pre>\n\nThe GET \/wp-json\/moqbo\/v1\/categories<\/code> endpoint returns an array of category objects with the same fields. Category names and slugs must be unique; color<\/code> must be a six-digit hex value such as #2271b1<\/code>.<\/p>\n\nEvents<\/h4>\n\n
Create an event with an existing category_slug<\/code>:<\/p>\n\nPOST \/wp-json\/moqbo\/v1\/events\nContent-Type: application\/json\nAuthorization: Bearer 0123456789abcdef0123456789abcdef01234567\n\n{\n \"name\": \"Team Meeting\",\n \"slug\": \"team-meeting\",\n \"location\": \"Conference Room\",\n \"category_slug\": \"meetings\",\n \"description\": \"Weekly planning meeting.\",\n \"start_at\": \"2026-01-15 09:00:00\",\n \"end_at\": \"2026-01-15 10:00:00\",\n \"all_day\": false\n}\n<\/code><\/pre>\n\nOn success, the endpoint returns 201 Created<\/code> and a Location<\/code> header pointing to \/wp-json\/moqbo\/v1\/events\/team-meeting<\/code>:<\/p>\n\n{\n \"name\": \"Team Meeting\",\n \"slug\": \"team-meeting\",\n \"location\": \"Conference Room\",\n \"category_slug\": \"meetings\",\n \"description\": \"Weekly planning meeting.\",\n \"start_at\": \"2026-01-15 09:00:00\",\n \"end_at\": \"2026-01-15 10:00:00\",\n \"all_day\": false\n}\n<\/code><\/pre>\n\nUse GET \/wp-json\/moqbo\/v1\/events?start_date=2026-01-01&end_date=2026-01-31<\/code> to retrieve matching events. It returns a JSON array of event objects in start-time order; GET \/wp-json\/moqbo\/v1\/events\/team-meeting<\/code> returns one object using the same representation.<\/p>\n\nAll event fields in the request body are required. start_at<\/code> and end_at<\/code> must use YYYY-MM-DD HH:MM:SS<\/code>. Timed events must end after they start. All-day events must start and end at midnight, and their end may equal their start.<\/p>\n\nErrors<\/h4>\n\n
WordPress REST errors are JSON objects. For example, an invalid or missing bearer token returns 401 Unauthorized<\/code>:<\/p>\n\n{\n \"code\": \"moqbo_api_invalid_token\",\n \"message\": \"A valid Moqbo API token is required.\",\n \"data\": {\n \"status\": 401\n }\n}\n<\/code><\/pre>\n\nDisabled routes return 403<\/code>, malformed requests and validation failures return 400<\/code>, and requests for unknown event or category slugs return 404<\/code>.<\/p>\n\nDevelopment<\/h3>\n\n
Frontend development requires Node.js 18 or newer and npm:<\/p>\n\n
npm ci\nnpm run build\n<\/code><\/pre>\n\nAdditional commands:<\/p>\n\n
npm run format\nnpm run zip\n<\/code><\/pre>\n\nThe ZIP command requires WP-CLI with dist-archive<\/code>. Test changes on a clean WordPress installation with WP_DEBUG<\/code> enabled and run the official Plugin Check<\/a> to find any potential issues.<\/p>\n\nLicense<\/h3>\n\n
Moqbo is licensed under the GNU General Public License v3.0 or later<\/a>. Third-party notices are available in third-party-notices.txt<\/code><\/a>.<\/p>","raw_excerpt":"Moqbo is a lightweight calendar for WordPress with event admin, categories, responsive shortcodes, and an optional token-protected REST API.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/nn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/335753","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/nn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/nn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=335753"}],"author":[{"embeddable":true,"href":"https:\/\/nn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kaanlogic"}],"wp:attachment":[{"href":"https:\/\/nn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=335753"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/nn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=335753"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/nn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=335753"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/nn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=335753"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/nn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=335753"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/nn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=335753"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}