', ], ]; $tec_events_display_fields += $tec_events_general_form_end; /** * Filter to determine if the Events Templates should be displayed in the settings. * * @since 6.4.0 * * @param bool $should_display Whether the Events Templates should be displayed. */ $tec_events_should_display_events_templates = apply_filters( 'tec_events_should_display_events_template_setting', ! tec_is_full_site_editor() ); // Insert Basic Template settings. $tec_events_display_template_settings = [ 'tribe-events-calendar-display-template-title' => [ 'type' => 'html', 'html' => '

' . _x( 'Calendar Template', 'Template display settings section header', 'the-events-calendar' ) . '

', ], 'stylesheetOption' => [ 'type' => 'html' ], 'stylesheet_mode' => [ 'type' => 'radio', 'label' => __( 'Default stylesheet used for events templates', 'the-events-calendar' ), 'default' => 'tribe', 'options' => [ 'skeleton' => __( 'Skeleton Styles', 'the-events-calendar' ) . '

' . __( 'Only includes enough css to achieve complex layouts like calendar and week view.', 'the-events-calendar' ) . '

', 'tribe' => __( 'Default Styles', 'the-events-calendar' ) . '

' . __( 'A fully designed and styled theme for your events pages.', 'the-events-calendar' ) . '

', ], 'validation_type' => 'options', ], 'tribeEventsTemplate' => [ 'type' => 'dropdown', 'label' => __( 'Events template', 'the-events-calendar' ), 'tooltip' => __( 'Choose a page template to control the appearance of your calendar and event content.', 'the-events-calendar' ), 'validation_type' => 'options', 'size' => 'small', 'default' => 'default', 'options' => $template_options, 'conditional' => $tec_events_should_display_events_templates, ], ]; $tec_events_display_fields += $tec_events_display_template_settings; // Insert Basic Display settings. $tec_events_display_template = [ 'tribe-events-calendar-display-title' => [ 'type' => 'html', 'html' => '

' . _x( 'Calendar Display', 'Calendar display settings section header', 'the-events-calendar' ) . '

', ], 'stylesheetOption' => [ 'type' => 'html' ], 'tribeEnableViews' => [ 'type' => 'checkbox_list', 'label' => __( 'Enable event views', 'the-events-calendar' ), 'tooltip' => $tribe_enable_views_tooltip, 'default' => array_keys( tribe( Manager::class )->get_publicly_visible_views() ), 'options' => array_map( static function ( $view ) { return tribe( Manager::class )->get_view_label_by_class( $view ); }, tribe( Manager::class )->get_publicly_visible_views( false ) ), 'validation_type' => 'options_multi', ], 'viewOption' => [ 'type' => 'dropdown', 'label' => __( 'Default view', 'the-events-calendar' ), 'validation_type' => 'not_empty', 'size' => 'small', 'default' => 'month', 'options' => array_map( static function ( $view ) { return tribe( Manager::class )->get_view_label_by_class( $view ); }, tribe( Manager::class )->get_publicly_visible_views() ), ], 'monthEventAmount' => [ 'type' => 'text', 'label' => __( 'Month view events per day', 'the-events-calendar' ), 'tooltip' => sprintf( /* Translators: %s: URL to knowledgebase. */ __( 'Change the default 3 events per day in month view. To impose no limit, you may specify -1. Please note there may be performance issues if you allow too many events per day. Read more.', 'the-events-calendar' ), 'https://evnt.is/rh' ), 'validation_type' => 'int', 'size' => 'small', 'default' => '3', ], 'postsPerPage' => [ 'type' => 'text', 'label' => esc_html__( 'Number of events to show per page', 'the-events-calendar' ), 'tooltip' => $posts_per_page_tooltip, 'size' => 'small', 'default' => tribe_events_views_v2_is_enabled() ? 12 : get_option( 'posts_per_page' ), 'validation_type' => 'positive_int', ], 'showComments' => [ 'type' => 'checkbox_bool', 'label' => esc_html__( 'Show comments', 'the-events-calendar' ), 'tooltip' => esc_html__( 'Enable comments on event pages.', 'the-events-calendar' ), 'default' => false, 'validation_type' => 'boolean', ], 'tribeDisableTribeBar' => [ 'type' => 'checkbox_bool', 'label' => __( 'Disable the event search bar', 'the-events-calendar' ), 'tooltip' => __( 'Hide the search field on all views.', 'the-events-calendar' ), 'default' => false, 'validation_type' => 'boolean', ], ]; $tec_events_display_fields += $tec_events_display_template; $sample_date = strtotime( 'January 15 ' . gmdate( 'Y' ) ); $end_time_options = [ 'single-event' => esc_html_x( 'Single event page', 'The option to remove end times for the single event page view.', 'the-events-calendar' ), 'day' => esc_html_x( 'Day view', 'The option to remove end times for day view.', 'the-events-calendar' ), 'list' => esc_html_x( 'List view', 'The option to remove end times for list view.', 'the-events-calendar' ), 'month' => esc_html_x( 'Month view', 'The option to remove end times for month view.', 'the-events-calendar' ), ]; /** * Allow other plugins to add their views to the control. * * @since 6.4.1 * * @param array $end_time_options The list of views where the end time can be removed. */ $end_time_options = apply_filters( 'tec_events_display_remove_event_end_time_options', $end_time_options ); // Date Format Settings. $tec_events_date_fields = [ 'tribeEventsDateFormatSettingsTitle' => [ 'type' => 'html', 'html' => '

' . esc_html_x( 'Date & Time', 'Date and Time settings section header', 'the-events-calendar' ) . '

', ], 'tribeEventsDateFormatExplanation' => [ 'type' => 'html', 'html' => '

' . sprintf( /* Translators: %1$s: PHP date function, %2$s: URL to WP knowledgebase. */ __( 'The following three fields accept the date format options available to the PHP %1$s function. Learn how to make your own date format here.', 'the-events-calendar' ), 'date()', 'https://wordpress.org/support/article/formatting-date-and-time/' ) . '

', ], 'dateWithYearFormat' => [ 'type' => 'text', 'label' => esc_html__( 'Date with year format', 'the-events-calendar' ), 'tooltip' => sprintf( /* Translators: %1$s: Example date with year format. */ esc_html__( 'Enter the format to use for displaying dates with the year. Used when showing an event from a future year. Example: %1$s', 'the-events-calendar' ), gmdate( tribe_get_option( 'dateWithYearFormat', get_option( 'date_format', 'F j, Y' ) ), $sample_date ) ), 'default' => get_option( 'date_format' ), 'size' => 'medium', 'validation_type' => 'not_empty', ], 'dateWithoutYearFormat' => [ 'type' => 'text', 'label' => esc_html__( 'Date without year format', 'the-events-calendar' ), 'tooltip' => sprintf( /* Translators: %1$s: Example date without year format. */ esc_html__( 'Enter the format to use for displaying dates without a year. Used when showing an event from the current year. Example: %1$s', 'the-events-calendar' ), gmdate( tribe_get_option( 'dateWithoutYearFormat', 'F j' ), $sample_date ) ), 'default' => 'F j', 'size' => 'medium', 'validation_type' => 'not_empty', ], 'monthAndYearFormat' => [ 'type' => 'text', 'label' => esc_html__( 'Month and year format', 'the-events-calendar' ), 'tooltip' => sprintf( /* Translators: %1$s: Example month and year format. */ esc_html__( 'Enter the format to use for dates that show a month and year only. Used on month view. Example: %1$s', 'the-events-calendar' ), gmdate( tribe_get_option( 'monthAndYearFormat', 'F Y' ), $sample_date ) ), 'default' => 'F Y', 'size' => 'medium', 'validation_type' => 'not_empty', ], 'datepickerFormat' => [ 'type' => 'dropdown', 'label' => esc_html__( 'Compact date format', 'the-events-calendar' ), 'tooltip' => esc_html__( 'Select the date format used for elements with minimal space, such as in datepickers.', 'the-events-calendar' ), 'default' => 1, 'options' => [ '0' => gmdate( 'Y-m-d', $sample_date ), '1' => gmdate( 'n/j/Y', $sample_date ), '2' => gmdate( 'm/d/Y', $sample_date ), '3' => gmdate( 'j/n/Y', $sample_date ), '4' => gmdate( 'd/m/Y', $sample_date ), '5' => gmdate( 'n-j-Y', $sample_date ), '6' => gmdate( 'm-d-Y', $sample_date ), '7' => gmdate( 'j-n-Y', $sample_date ), '8' => gmdate( 'd-m-Y', $sample_date ), '9' => gmdate( 'Y.m.d', $sample_date ), '10' => gmdate( 'm.d.Y', $sample_date ), '11' => gmdate( 'd.m.Y', $sample_date ), ], 'validation_type' => 'options', ], 'dateTimeSeparator' => [ 'type' => 'text', 'label' => esc_html__( 'Date time separator', 'the-events-calendar' ), 'tooltip' => esc_html__( 'Enter the separator that will be placed between the date and time, when both are shown.', 'the-events-calendar' ), 'default' => ' @ ', 'size' => 'small', 'validation_type' => 'html', ], 'timeRangeSeparator' => [ 'type' => 'text', 'label' => esc_html__( 'Time range separator', 'the-events-calendar' ), 'tooltip' => esc_html__( 'Enter the separator that will be used between the start and end time of an event.', 'the-events-calendar' ), 'default' => ' - ', 'size' => 'small', 'validation_type' => 'html', ], 'multiDayCutoff' => [ 'type' => 'dropdown', 'label' => esc_html__( 'End of day cutoff', 'the-events-calendar' ), 'tooltip' => __( "Have an event that runs past midnight? Select a time after that event's end to avoid showing the event on the next day's calendar.", 'the-events-calendar' ), 'validation_type' => 'options', 'size' => 'small', 'default' => date_i18n( $site_time_format, strtotime( '12:00 am' ) ), 'options' => [ '00:00' => date_i18n( $site_time_format, strtotime( '12:00 am' ) ), '01:00' => date_i18n( $site_time_format, strtotime( '01:00 am' ) ), '02:00' => date_i18n( $site_time_format, strtotime( '02:00 am' ) ), '03:00' => date_i18n( $site_time_format, strtotime( '03:00 am' ) ), '04:00' => date_i18n( $site_time_format, strtotime( '04:00 am' ) ), '05:00' => date_i18n( $site_time_format, strtotime( '05:00 am' ) ), '06:00' => date_i18n( $site_time_format, strtotime( '06:00 am' ) ), '07:00' => date_i18n( $site_time_format, strtotime( '07:00 am' ) ), '08:00' => date_i18n( $site_time_format, strtotime( '08:00 am' ) ), '09:00' => date_i18n( $site_time_format, strtotime( '09:00 am' ) ), '10:00' => date_i18n( $site_time_format, strtotime( '10:00 am' ) ), '11:00' => date_i18n( $site_time_format, strtotime( '11:00 am' ) ), ], ], 'remove_event_end_time' => [ 'type' => 'checkbox_list', 'label' => esc_html__( 'Remove event end time', 'the-events-calendar' ), 'tooltip' => sprintf( // Dev note: This string is multi-line to remove the need for a line break tag. __( /* Translators: %1$s - opening italics tag, %2$s - opening anchor tag, %3$s - closing anchor tag, %4$s - closing italics tag */ 'When one of these boxes is checked, the end time will no longer display for events that end on the same day when viewing the specified view. %1$s Source: %2$s Remove the Event End Time in Views %3$s%4$s', 'the-events-calendar', ), '', '', '', '', ), 'options' => $end_time_options, 'validation_type' => 'options_multi', 'can_be_empty' => true, ], ]; $tec_events_display_fields += $tec_events_date_fields; $is_missing_event_tickets_plus = ! defined( 'EVENT_TICKETS_PLUS_FILE' ); $should_hide_upsell = tec_should_hide_upsell(); // Insert Currency settings. $tec_events_display_currency = [ 'tribe-events-currency-title' => [ 'type' => 'html', 'html' => '

' . esc_html_x( 'Currency', 'Currency settings section header', 'the-events-calendar' ) . '

', ], 'tec-tickets-infobox-start' => [ 'type' => 'html', 'html' => '', 'conditional' => $is_missing_event_tickets_plus && ! $should_hide_upsell, ], 'defaultCurrencySymbol' => [ 'type' => 'text', 'label' => esc_html__( 'Default currency symbol', 'the-events-calendar' ), 'tooltip' => esc_html__( 'Set the default currency symbol for event costs. Note that this only impacts future events, and changes made will not apply retroactively.', 'the-events-calendar' ), 'validation_type' => 'textarea', 'size' => 'small', 'default' => '$', ], 'defaultCurrencyCode' => [ 'type' => 'text', 'label' => esc_html__( 'Default currency code', 'the-events-calendar' ), 'tooltip' => esc_html__( 'Set the default currency ISO-4217 code for event costs. This is a three-letter code and is mainly used for data/SEO purposes.', 'the-events-calendar' ), 'validation_type' => 'textarea', 'size' => 'small', 'default' => 'USD', 'attributes' => [ 'minlength' => 3, 'maxlength' => 3, 'placeholder' => __( 'USD', 'the-events-calendar' ), ], ], 'reverseCurrencyPosition' => [ 'type' => 'checkbox_bool', 'label' => esc_html__( 'Currency symbol follows value', 'the-events-calendar' ), 'tooltip' => esc_html__( 'The currency symbol normally precedes the value. Enabling this option positions the symbol after the value.', 'the-events-calendar' ), 'default' => false, 'validation_type' => 'boolean', ], ]; $tec_events_display_fields += $tec_events_display_currency; // Insert Map settings. $tec_events_display_maps = [ 'tribe-google-maps-settings-title' => [ 'type' => 'html', 'html' => '

' . esc_html_x( 'Maps', 'Map settings section header', 'the-events-calendar' ) . '

', ], 'tec-maps-infobox-start' => [ 'type' => 'html', 'html' => '', ], 'embedGoogleMaps' => [ 'type' => 'checkbox_bool', 'label' => esc_html__( 'Enable Maps', 'the-events-calendar' ), 'tooltip' => esc_html__( 'Check to enable maps for events and venues.', 'the-events-calendar' ), 'default' => true, 'class' => 'google-embed-size', 'validation_type' => 'boolean', ], 'embedGoogleMapsZoom' => [ 'type' => 'text', 'label' => esc_html__( 'Google Maps default zoom level', 'the-events-calendar' ), 'tooltip' => esc_html__( '0 = zoomed out; 21 = zoomed in.', 'the-events-calendar' ), 'size' => 'small', 'default' => 10, 'class' => 'google-embed-field', 'validation_type' => 'number_or_percent', ], ]; $tec_events_display_fields += $tec_events_display_maps; // Insert Advanced Template settings. $tec_events_display_advanced = [ 'tribe-events-advanced-settings-title' => [ 'type' => 'html', 'html' => '

' . esc_html_x( 'Additional Content', 'Additional content settings section header', 'the-events-calendar' ) . '

', ], 'tribeEventsBeforeHTML' => [ 'type' => 'wysiwyg', 'label' => esc_html__( 'Add HTML before event content', 'the-events-calendar' ), 'tooltip' => esc_html__( 'If you are familiar with HTML, you can add additional code before the event template. Some themes may require this to help with styling or layout.', 'the-events-calendar' ), 'validation_type' => 'html', ], 'tribeEventsAfterHTML' => [ 'type' => 'wysiwyg', 'label' => esc_html__( 'Add HTML after event content', 'the-events-calendar' ), 'tooltip' => esc_html__( 'If you are familiar with HTML, you can add additional code after the event template. Some themes may require this to help with styling or layout.', 'the-events-calendar' ), 'validation_type' => 'html', ], ]; $tec_events_display_fields += $tec_events_display_advanced; // Close the form content wrapper. $tec_events_display_fields += [ 'tribe-form-content-end' => [ 'type' => 'html', 'html' => '