{"id":5058,"date":"2026-04-24T12:38:43","date_gmt":"2026-04-24T10:38:43","guid":{"rendered":"https:\/\/cevento-plugin.com\/docs\/001-events\/"},"modified":"2026-04-24T12:38:43","modified_gmt":"2026-04-24T10:38:43","slug":"001-events","status":"publish","type":"docs","link":"https:\/\/cevento-plugin.com\/en\/docs\/001-events\/","title":{"rendered":"Event Model"},"content":{"rendered":"\n

To retrieve information about an event, you can use the model class Cevento\\Models\\Event<\/code>.
\nThis class provides various static helper methods for database queries.<\/p>\n

Event Query<\/h2>\n

A single event can be retrieved with the following method:<\/p>\n

$event = Cevento\\Models\\Event::get($event_id);<\/code><\/pre>\n
To query multiple events, you can use the following method:<\/p>\n
$events = Cevento\\Models\\Event::getAll($query_args = []);<\/code><\/pre>\n
Additional filter and sort parameters can be passed via the $query_args<\/code> array.
\nIt expects the standard structure of the parameter for the method WP_Query::parse_query($query_args)<\/code>.
\nA full overview of all possible parameters can be found in the official WordPress documentation<\/a>.<\/p>\n
Event Data Structure<\/h2>\n
Events are returned as associative arrays with the following structure:<\/p>\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Key<\/th>\nType<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
id<\/td>\nInteger<\/td>\nThe ID of the event<\/td>\n<\/tr>\n
title<\/td>\nString<\/td>\nThe name of the event<\/td>\n<\/tr>\n
description<\/td>\nString<\/td>\nThe unformatted description of the event<\/td>\n<\/tr>\n
html_description<\/td>\nString<\/td>\nThe formatted description of the event<\/td>\n<\/tr>\n
fullday<\/td>\nBoolean<\/td>\nWhether the event is all-day<\/td>\n<\/tr>\n
createdAt<\/td>\nDateTime<\/td>\nEvent creation date<\/td>\n<\/tr>\n
startsAt<\/td>\nDateTime<\/td>\nEvent start date and time<\/td>\n<\/tr>\n
endsAt<\/td>\nDateTime<\/td>\nEvent end date and time<\/td>\n<\/tr>\n
bookingEnabled<\/td>\nBoolean<\/td>\nWhether bookings for this event are enabled in the backend. Note:<\/strong> This only refers to the checkbox setting in the event and does not consider available spots or the defined booking period.<\/td>\n<\/tr>\n
bookingForm<\/td>\nInteger, Null<\/td>\nThe ID of the linked booking form<\/td>\n<\/tr>\n
bookingMaxPlaces<\/td>\nInteger<\/td>\nThe maximum number of available spots<\/td>\n<\/tr>\n
bookingStartsAt<\/td>\nDateTime<\/td>\nDate and time when bookings open<\/td>\n<\/tr>\n
bookingEndsAt<\/td>\nDateTime<\/td>\nDate and time when bookings close<\/td>\n<\/tr>\n
address<\/td>\nString<\/td>\nThe event address<\/td>\n<\/tr>\n
addressName<\/td>\nString<\/td>\nThe label\/name of the event location<\/td>\n<\/tr>\n
coordinates<\/td>\nString<\/td>\nThe coordinates of the event location (lat,lng)<\/td>\n<\/tr>\n
bookingConfirmationRequired<\/td>\nBoolean<\/td>\nWhether a booking must be confirmed by an administrator<\/td>\n<\/tr>\n
categories<\/td>\nArray<\/td>\nAll categories linked to the event<\/td>\n<\/tr>\n
url<\/td>\nString<\/td>\nThe link to the single event view<\/td>\n<\/tr>\n
status<\/td>\nString<\/td>\nThe current publication status of the event<\/td>\n<\/tr>\n
dateTime<\/td>\nString<\/td>\nFormatted time interval of the event<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Additional Methods<\/h2>\n
Metadata Queries<\/h3>\n
use \\Cevento\\Models\\Event;\n\n\/\/ Checks if an event is in the future\nEvent::isUpcoming($event_id): bool\n\n\/\/ Returns the formatted time period of an event\nEvent::getDateTime($event_id): string<\/code><\/pre>\n
Booking Queries<\/h3>\n
use \\Cevento\\Models\\Event;\n\n\/\/ Checks if bookings are active for an event\nEvent::isBookingActive($event_id): bool \n\n\/\/ Checks if there are still available spots for the event\nEvent::hasPlacesAvailable($event_id): bool \n\n\/\/ Checks if an event is fully booked\nEvent::isFull($event_id): bool \n\n\/\/ Returns the number of available spots\nEvent::getAvailablePlaces($event_id): int \n\n\/\/ Returns the availability status as a formatted string\nEvent::getAvailablePlacesText($event_id): string<\/code><\/pre>\n\n","protected":false},"featured_media":0,"parent":0,"template":"","meta":{"_acf_changed":false},"thema":[682],"class_list":["post-5058","docs","type-docs","status-publish","hentry","thema-development"],"acf":{"excerpt":"Event Data Structure & Methods","toc":"
    \n
  1. Event Query<\/a><\/li>\n
  2. Event Data Structure<\/a><\/li>\n
  3. Additional Methods<\/a><\/li>\n<\/ol>\n"},"_links":{"self":[{"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/docs\/5058","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"wp:attachment":[{"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/media?parent=5058"}],"wp:term":[{"taxonomy":"thema","embeddable":true,"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/thema?post=5058"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}