Calendar: Developer Hooks

Plugin paths #

gravityview/calendar/scripts/fullcalendar

Modify the FullCalendar core script used.

gravityview/calendar/scripts/fullcalendar/locales_dir_url

Modify the URL to FullCalendar locales. This can be used to point to your own translations.

FullCalendar overrides #

gravityview/calendar/options

Modify all FullCalendar options in an array.

Override the calendar language

Override default calendar locale (automatically set to en , or the language of the current WordPress site):

add_filter('gravityview/calendar/options', function ($calendar_options, $form_id, $feed_id ) {
	$calendar_options['locale'] = 'fr';
	return $calendar_options;
}, 10, 3 );

add_filter('gravityview/calendar/options', function ($calendar_options, $form_id, $feed_id ) {
	$calendar_options['locale'] = 'fr';
	return $calendar_options;
}, 10, 3 );

Display events as a full-width block

Display events as a block, not as a bullet list, on the grid layout, using the eventDisplay setting. In addition to being full-width in the calendar, this allows applying background colors:

add_filter('gravityview/calendar/options', function ($calendar_options, $form_id, $feed_id ) {
	$calendar_options['eventDisplay'] = 'block';
	return $calendar_options;
}, 10, 3 );

add_filter('gravityview/calendar/options', function ($calendar_options, $form_id, $feed_id ) {
	$calendar_options['eventDisplay'] = 'block';
	return $calendar_options;
}, 10, 3 );

To set showNonCurrentDates to false

Here’s an example of modifying the GravityCalendar output to disable showNonCurrentDates , but only for Calendar feed #5:

add_filter( 'gravityview/calendar/options', function ( $calendar_options, $form_id, $feed_id ) {
    // Only modify the setting for Calendar #5
    if( 5 !== $feed_id ) {
        return $calendar_options;
    }

    $calendar_options['showNonCurrentDates'] = false;

    return  $calendar_options;
}, 10, 3 );

add_filter( 'gravityview/calendar/options', function ( $calendar_options, $form_id, $feed_id ) {
    // Only modify the setting for Calendar #5
    if( 5 !== $feed_id ) {
        return $calendar_options;
    }

    $calendar_options['showNonCurrentDates'] = false;

    return  $calendar_options;
}, 10, 3 );

To force times to be displayed in a specific way

The FullCalendar script displays times in a truncated manner on the month grid view. If you want to force times to be displayed with a 2-digit minute, you can with the filter below.

You can find full reference to the date and time formatting options here.

add_filter('gravityview/calendar/options', function ($calendar_options, $form_id, $feed_id ) {
    $calendar_options['eventTimeFormat'] = [
        'hour' => 'numeric',
        'minute' => '2-digit',
        'meridiem' => 'short'
    ];
    return $calendar_options;
}, 10, 3 );

add_filter('gravityview/calendar/options', function ($calendar_options, $form_id, $feed_id ) {
    $calendar_options['eventTimeFormat'] = [
        'hour' => 'numeric',
        'minute' => '2-digit',
        'meridiem' => 'short'
    ];
    return $calendar_options;
}, 10, 3 );

gravityview/calendar/extra_options

Modify extra options used in the plugin’s UI that aren’t standard to FullCalendar.

This is a way to pass additional data to the FullCalendar configuration object in a way that won’t affect initialization. For example, navigateToEvents is a custom calendar option and will throw an error if used to initialize a FullCalendar instance in the UI.

This filter is internal, but you may want to use it for similar reasons.

Rendering & content overrides #

gravityview/calendar/settings/entry_status

Modify the status used to find matching entries. If set to false , no status will be defined, and all entries will be returned.

gravityview/calendar/settings/sort_order

/**
 * Overrides the sort order to be sorted by form field #3 when using Calendar #22
 */
add_filter( 'gravityview/calendar/settings/sort_order', function ( $sort_order, $feed_id, $field_map ) {

    if( 22 !== $feed_id ) {
        return  $sort_order;
    }

    return array(
        'key' => 3,
        'direction' => 'DESC',
    );

}, 10, 3 );

/**
 * Overrides the sort order to be sorted by form field #3 when using Calendar #22
 */
add_filter( 'gravityview/calendar/settings/sort_order', function ( $sort_order, $feed_id, $field_map ) {

    if( 22 !== $feed_id ) {
        return  $sort_order;
    }

    return array(
        'key' => 3,
        'direction' => 'DESC',
    );

}, 10, 3 );

gravityview/calendar/events/source_data

Used to populate the form entries that are displayed in the calendar. You can override by filtering the entries using a priority greater than 10 .

Note: $from_date and $to_date values are created with strtotime() from Start Date and End Date field values. They are false if there was an error parsing the value when creating the timestamp.

Entries are expected in the following format:

array(
    array(
        'title' => 'Event One',
        'start' => '2022-04-12T10:30:00',
        'end'   => '2022-04-12T12:30:00',
        'description' => 'Optional description!',
    ),
    array(
        'title' => 'Event Two',
        'start' => '2022-05-13T10:30:00',
        'end'   => '2012-05-13T12:30:00',
        'description' => 'Description optional!'
    ),
    [...]
)

array(
    array(
        'title' => 'Event One',
        'start' => '2022-04-12T10:30:00',
        'end'   => '2022-04-12T12:30:00',
        'description' => 'Optional description!',
    ),
    array(
        'title' => 'Event Two',
        'start' => '2022-05-13T10:30:00',
        'end'   => '2012-05-13T12:30:00',
        'description' => 'Description optional!'
    ),
    [...]
)

The entries array is parsed by the GV_Extension_Calendar_Feed::calendar_events() method, which transforms the array into the expected calendar format.

gravityview/calendar/events/exclude

Prevent entries from being displayed in the calendar by returning an array of IDs.

Note: If an entry ID is included in this list, it will still be shown if the event is on the “include” list (see the gravityview/calendar/events/include filter).

gravityview/calendar/events/include

Show these events in the calendar.

gravityview/calendar/events/do_shortcodes

Modify whether to process shortcodes in the event title and event description.

gravityview/calendar/shortcode/render/element_attributes

Feed setting filters #

gravityview/calendar/settings/total-event-limit

Modify the total number of events displayed on a calendar.

gravityview/calendar/settings/fields/date

Override the field types shown in the feed configuration when selecting Start Date and End Date.

Allow for text fields to be used in the feed configuration

If you allow entering dates into a text field—not recommended due to inconsistent formatting!—you may want to use the field as the “Start Date” or “End Date” values. The code below will allow that:

/**
 * Add Text fields to the list of fields to display when selecting Start Date and End Date.
 *
 * @param array $field_types
 *
 * @return array Field types, with "text" added.
 */
add_filter( 'gravityview/calendar/settings/fields/date', function ( $field_types ) {

    $field_types[] = 'text';

    return $field_types;
} );

/**
 * Add Text fields to the list of fields to display when selecting Start Date and End Date.
 *
 * @param array $field_types
 *
 * @return array Field types, with "text" added.
 */
add_filter( 'gravityview/calendar/settings/fields/date', function ( $field_types ) {

    $field_types[] = 'text';

    return $field_types;
} );

gravityview/calendar/settings/fields/time

Override the field types shown in the feed configuration when selecting Start Time and End Time.

gravityview/calendar/settings/fields/location

Override the field types shown in the feed configuration when selecting Event Location.

gravityview/calendar/settings/fields/url

Override the field types shown in the feed configuration when selecting Event URL.