+ __( 'Can I have more than one calendar?', 'tribe-common' ),
+ 'answer' => __( 'No, but you can use event categories or tags to display certain events like having...', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1arh',
+ ],
+ [
+ 'question' => __( 'What do I get with Events Calendar Pro?', 'tribe-common' ),
+ 'answer' => __( 'Events Calendar Pro runs alongside The Events Calendar and enhances...' ),
+ 'link' => 'https://evnt.is/1arj',
+ ],
+ [
+ 'question' => __( 'How do I sell tickets to events?', 'tribe-common' ),
+ 'answer' => __( 'Use our free Event Tickets plugin to get started with tickets and RSVPs.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1ark',
+ ],
+ [
+ 'question' => __( 'Where can I find a list of available shortcodes?', 'tribe-common' ),
+ 'answer' => __( 'Our plugins include many shortcodes that do everything from embedding the calendar...', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1arl',
+ ],
+ ] );
+
+ return $faqs;
+ }
+
+ /**
+ * Defines calendar extensions and displays them in the UI.
+ *
+ * @since 4.14.2
+ *
+ * @return array of extensions which are displayed on the calendar and community tab of the in-app help page.
+ */
+ public function get_calendar_extensions() {
+ $extensions = apply_filters( 'tec_help_calendar_extensions', [
+ [
+ 'title' => __( 'Calendar widget areas', 'tribe-common' ),
+ 'description' => __( 'This extension creates a useful variety of WordPress widget areas (a.k.a. sidebars).', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1arc',
+ 'product-slug' => 'the-events-calendar',
+ ],
+ [
+ 'title' => __( 'Event block patterns', 'tribe-common' ),
+ 'description' => __( 'This extension adds a set of block patterns for events to the WordPress block editor.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1ard',
+ 'product-slug' => 'the-events-calendar',
+ ],
+ [
+ 'title' => __( 'Alternative photo view', 'tribe-common' ),
+ 'description' => __( 'This extension replaces photo view with a tiled grid of cards featuring event images.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1are',
+ 'product-slug' => 'events-calendar-pro',
+ ],
+ [
+ 'title' => __( 'The Events Calendar Tweaks', 'tribe-common' ),
+ 'description' => __( 'This extension is a collection of tweaks and snippets for The Events Calendar.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1arg',
+ 'product-slug' => 'the-events-calendar',
+ ],
+ ] );
+
+ return $extensions;
+ }
+
+ /**
+ * Defines calendar products.
+ *
+ * @since 4.14.2
+ *
+ * @return array of products which are displayed on the calendar tab of the in-app help page.
+ */
+ public function get_calendar_products() {
+ $calendar_products = apply_filters( 'tec_help_calendar_products', [
+ 'events-calendar-pro',
+ 'tribe-filterbar',
+ 'event-aggregator',
+ 'event-automator',
+ 'events-virtual',
+ ] );
+
+ return $calendar_products;
+ }
+
+ /**
+ * Defines ticketing frequently asked questions and displays them in the UI.
+ *
+ * @since 4.14.2
+ *
+ * @return array of FAQs which are displayed on the ticketing tab of the in-app help page.
+ */
+ public function get_ticketing_faqs() {
+ $faqs = apply_filters( 'tec_help_ticketing_faqs', [
+ [
+ 'question' => __( 'How Do I create events with Tickets or RSVP’s?', 'tribe-common' ),
+ 'answer' => __( 'We’ve put together a video tutorial showing how to create events with Tickets using our plugins. Click on the link in the link in the title to learn more.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1art',
+ ],
+ [
+ 'question' => __( 'How Do I Set Up E-Commerce Plugins for Selling Tickets?', 'tribe-common' ),
+ 'answer' => __( 'You can sell tickets using our built-in e-commerce option, or upgrade to Event Tickets Plus to use ecommerce plugins such as WooCommerce.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1arq',
+ ],
+ [
+ 'question' => __( 'Can I have a seating chart associated with my tickets?', 'tribe-common' ),
+ 'answer' => __( 'Yes! You can easily accomplish this task using the stock options and multiple ticket types available with Event Tickets.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1arr',
+ ],
+ [
+ 'question' => __( 'How do I process refunds for tickets?', 'tribe-common' ),
+ 'answer' => __( 'When it comes to paid tickets, these orders can be refunded through the e-commerce platform in use.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1ars',
+ ],
+ ] );
+
+ return $faqs;
+ }
+
+ /**
+ * Defines ticketing extensions and displays them in the UI.
+ *
+ * @since 4.14.2
+ *
+ * @return array of extensions which are displayed on the ticketing tab of the in-app help page.
+ */
+ public function get_ticketing_extensions() {
+ $extensions = apply_filters( 'tec_help_ticketing_extensions', [
+ [
+ 'title' => __( 'Ticket Email Settings', 'tribe-common' ),
+ 'description' => __( 'Adds a new settings panel in Events > Settings that gives more control over the ticket and rsvp emails that are sent to attendees after registration.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1arx',
+ 'product-slug' => 'event-tickets',
+ ],
+ [
+ 'title' => __( 'Per Event Check In API', 'tribe-common' ),
+ 'description' => __( 'This extension shows a meta box with an API key on each Event with Ticket/RSVP.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1arw',
+ 'product-slug' => 'event-tickets',
+ ],
+ [
+ 'title' => __( 'Add Event & Attendee Info to WooCommerce Order Details', 'tribe-common' ),
+ 'description' => __( 'Displays the information collected by “attendee meta fields” in the WooCommerce order screens as well.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1arv',
+ 'product-slug' => 'event-tickets',
+ ],
+ [
+ 'title' => __( 'Organizer Notification Email', 'tribe-common' ),
+ 'description' => __( 'This extension will send an email to event organizers whenever a user registers for their event.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1aru',
+ 'product-slug' => 'event-tickets',
+ ],
+ ] );
+
+ return $extensions;
+ }
+
+ /**
+ * Defines ticketing products.
+ *
+ * @since 4.14.2
+ *
+ * @return array of products which are displayed on the ticketing tab of the in-app help page.
+ */
+ public function get_ticketing_products() {
+ $ticketing_products = apply_filters( 'tec_help_ticketing_products', [
+ 'event-tickets',
+ 'event-tickets-plus',
+ 'tribe-eventbrite',
+ 'promoter',
+ ] );
+
+ return $ticketing_products;
+ }
+
+ /**
+ * Defines community extensions and displays them in the UI.
+ *
+ * @since 4.14.2
+ *
+ * @return array of extensions which are displayed on the community tab of the in-app help page.
+ */
+ public function get_community_extensions() {
+ $extensions = apply_filters( 'tec_help_ticketing_extensions', [
+ [
+ 'title' => __( 'Add Cost Currency Symbol', 'tribe-common' ),
+ 'description' => __( 'This extension allows you to set default currency symbols for your users to choose from instead of having a plain text field.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1arn',
+ 'product-slug' => 'community-events',
+ ],
+ [
+ 'title' => __( 'Add Google Maps Display and Link Options', 'tribe-common' ),
+ 'description' => __( 'This extension adds the “Show Google Maps” and “Show Google Maps Link” checkboxes when creating a new Venue.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1arm',
+ 'product-slug' => 'community-events',
+ ],
+ [
+ 'title' => __( 'Hide Others’ Organizers and Venues', 'tribe-common' ),
+ 'description' => __( 'This extension allows you to hide the Organizers and Venues that a visitor has not created from the Community Events submission form.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1aro',
+ 'product-slug' => 'community-events',
+ ],
+ [
+ 'title' => __( 'Display Custom HTML', 'tribe-common' ),
+ 'description' => __( 'This extension allows you to add custom HTML content to the top of the Community Events submission form.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1arp',
+ 'product-slug' => 'community-events',
+ ],
+ ] );
+
+ return $extensions;
+ }
+
+ /**
+ * Defines community products.
+ *
+ * @since 4.14.2
+ *
+ * @return array of products which are displayed on the community tab of the in-app help page.
+ */
+ public function get_community_products() {
+ $community_products = apply_filters( 'tec_help_ticketing_products', [
+ 'events-community',
+ 'events-community-tickets',
+ ] );
+
+ return $community_products;
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Helpers.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Helpers.php
new file mode 100644
index 000000000..7f1d832b2
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Helpers.php
@@ -0,0 +1,193 @@
+doing_ajax() ) {
+ return false;
+ }
+
+ // Avoid Notices by checking the object type of WP_Screen
+ if ( ! $this->is_wp_screen() ) {
+ return false;
+ }
+
+ $defaults = apply_filters( 'tribe_is_post_type_screen_post_types', Tribe__Main::get_post_types() );
+
+ // Match any Post Type from Tribe
+ if ( is_null( $post_type ) && in_array( $current_screen->post_type, $defaults ) ) {
+ return true;
+ }
+
+ // Match any of the post_types set
+ if ( ! is_scalar( $post_type ) && in_array( $current_screen->post_type, (array) $post_type ) ) {
+ return true;
+ }
+
+ // Match a specific Post Type
+ if ( $current_screen->post_type === $post_type ) {
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Matcher for administration pages that are from Tribe the easier way
+ *
+ * @param string|array|null $id What will be checked to see if we return true or false
+ *
+ * @return boolean
+ */
+ public function is_screen( $id = null ) {
+ global $current_screen;
+
+ // Not in the admin we don't even care
+ if ( ! is_admin() ) {
+ return false;
+ }
+
+ // Doing AJAX? bail.
+ if ( tribe( 'context' )->doing_ajax() ) {
+ return false;
+ }
+
+ // Avoid Notices by checking the object type of WP_Screen.
+ if ( ! $this->is_wp_screen() ) {
+ return false;
+ }
+
+ // Match any screen from Tribe.
+ if ( is_null( $id ) && false !== strpos( $current_screen->id, 'tribe' ) ) {
+ return true;
+ }
+
+ // Match any screen from TEC.
+ if ( is_null( $id ) && false !== strpos( $current_screen->id, 'tec' ) ) {
+ return true;
+ }
+
+ // Match any of the pages set
+ if ( ! is_scalar( $id ) && in_array( $current_screen->id, (array) $id ) ) {
+ return true;
+ }
+
+ // Match a specific page.
+ if ( $current_screen->id === $id ) {
+ return true;
+ }
+
+ // Match any post type page in the supported post types.
+ $defaults = apply_filters( 'tribe_is_post_type_screen_post_types', Tribe__Main::get_post_types() );
+ if ( in_array( $current_screen->post_type, $defaults ) ) {
+ return true;
+ }
+ return false;
+
+ }
+
+ /**
+ * Matcher for administration pages action
+ *
+ * @param string|array|null $action What will be checked to see if we return true or false
+ *
+ * @return boolean
+ */
+ public function is_action( $action = null ) {
+ global $current_screen;
+
+ // Not in the admin we don't even care
+ if ( ! is_admin() ) {
+ return false;
+ }
+
+ // Doing AJAX? bail.
+ if ( tribe( 'context' )->doing_ajax() ) {
+ return false;
+ }
+
+ // Avoid Notices by checking the object type of WP_Screen
+ if ( ! $this->is_wp_screen() ) {
+ return false;
+ }
+
+ // Match any of the pages set
+ if ( ! is_scalar( $action ) && in_array( $current_screen->action, (array) $action ) ) {
+ return true;
+ }
+
+ // Match a specific page
+ if ( $current_screen->action === $action ) {
+ return true;
+ }
+
+ return false;
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Live_Date_Preview.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Live_Date_Preview.php
new file mode 100644
index 000000000..9b53e99bc
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Live_Date_Preview.php
@@ -0,0 +1,68 @@
+ Settings > Display admin screen.
+ */
+class Tribe__Admin__Live_Date_Preview {
+ protected $target_fields = [
+ 'dateWithYearFormat',
+ 'dateWithoutYearFormat',
+ 'monthAndYearFormat',
+ 'weekDayFormat',
+ ];
+
+ /**
+ * Static Singleton Holder
+ *
+ * @var self
+ */
+ protected static $instance;
+
+ /**
+ * Static Singleton Factory Method
+ *
+ * @return self
+ */
+ public static function instance() {
+ return self::$instance ? self::$instance : self::$instance = new self;
+ }
+
+ /**
+ * Adds live date previews to the display settings tab (nothing is setup unless
+ * the user is actually on that tab).
+ */
+ public function __construct() {
+ add_action( 'tribe_settings_after_do_tabs', [ $this, 'listen' ] );
+ }
+
+ /**
+ * If the user looking at the Display settings tab, adds live date preview facilities.
+ */
+ public function listen() {
+ // We are only interested in the "Display" tab
+ if ( 'display' !== Tribe__Settings::instance()->currentTab ) {
+ return;
+ }
+
+ /**
+ * Add or remove fields which should have live date/time preview facilities.
+ *
+ * @var array $target_fields
+ */
+ $this->target_fields = (array) apply_filters( 'tribe_settings_date_preview_fields', $this->target_fields );
+
+ add_filter( 'tribe_field_div_end', [ $this, 'setup_date_previews' ], 10, 2 );
+
+ // We are still before `admin_enqueue_scripts` making it safe to use `tribe_asset`
+ tribe_asset( Tribe__Main::instance(), 'tribe-date-live-refresh', 'admin-date-preview.js', [ 'jquery' ], 'admin_enqueue_scripts' );
+ }
+
+ public function setup_date_previews( $html, $field ) {
+ // Not one of the fields we're interested in? Return without modification
+ if ( ! in_array( $field->id, $this->target_fields ) ) {
+ return $html;
+ }
+
+ $preview = esc_html( date_i18n( $field->value ) );
+ return " $preview $html";
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Date_Based.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Date_Based.php
new file mode 100644
index 000000000..79780d00c
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Date_Based.php
@@ -0,0 +1,378 @@
+tec_is_active = $tribe_dependency->is_plugin_active( 'Tribe__Events__Main' );
+ $this->et_is_active = $tribe_dependency->is_plugin_active( 'Tribe__Tickets__Main' );
+
+ $now = Dates::build_date_object( 'now', 'UTC' );
+ $notice_start = $this->get_start_time();
+ $notice_end = $this->get_end_time();
+ $extension_date = $this->get_extension_time();
+
+ // If we have an extension date defined.
+ if ( ! empty( $this->get_extension_time() ) ) {
+ // If the sale has started and
+ if (
+ $notice_start <= $now
+ && $notice_end < $now
+ && $now < $extension_date
+ ) {
+ add_filter( "tribe_{$this->slug}_notice_end_date", function() {
+ return $this->get_extension_time();
+ });
+ }
+ }
+
+ $this->hook();
+ }
+
+ /**
+ * Register the various Marketing notices.
+ *
+ * @since 4.14.2
+ */
+ public function hook() {
+ $this->hook_notice();
+ }
+
+ /**
+ * Register the notice.
+ *
+ * @since 4.14.2
+ */
+ public function hook_notice() {
+ tribe_notice(
+ $this->slug,
+ [ $this, "display_notice" ],
+ [
+ 'type' => 'tribe-banner',
+ 'dismiss' => 1,
+ 'priority' => -1,
+ 'wrap' => false,
+ ],
+ [ $this, "should_display" ]
+ );
+ }
+
+ /**
+ * HTML for the notice.
+ *
+ * @since 4.14.2
+ *
+ * @return string The HTML string to be displayed.
+ */
+ abstract function display_notice();
+
+ /**
+ * Function to get and filter the screens the notice is displayed on.
+ *
+ * @since 4.15.4
+ *
+ * @return array List of allowed screens.
+ */
+ public function get_screens() {
+ $screens = $this->screens;
+
+ /**
+ * Allows filtering of the screens for all date-based notices.
+ *
+ * @since 4.15.4
+ *
+ * @param array $screens The current list of allowed screens.
+ * @param string $slug The slug for the current notice.
+ *
+ * @return array $screens The modified list of allowed screens.
+ */
+ $screens = apply_filters(
+ 'tec_date_based_notice_get_screens',
+ $screens,
+ $this->slug
+ );
+
+ /**
+ * Allows filtering of the screens for a specific date-based notice.
+ *
+ * @since 4.15.4
+ *
+ * @param array $screens The current list of allowed screens.
+ *
+ * @return array $screens The modified list of allowed screens.
+ */
+ $screens = apply_filters(
+ "tec_date_based_notice_get_screens_{$this->slug}",
+ $screens
+ );
+
+ return $screens;
+ }
+
+ /**
+ * Whether the notice should display.
+ *
+ * @since 4.14.2
+ *
+ * @return boolean $should_display Whether the notice should display or not.
+ */
+ public function should_display() {
+ // If upsells have been manually hidden, respect that.
+ if ( tec_should_hide_upsell() ) {
+ return false;
+ }
+
+ $current_screen = get_current_screen();
+
+ $screens = $this->get_screens();
+
+ // If not a valid screen, don't display.
+ if ( empty( $current_screen->id ) || ! in_array( $current_screen->id, $screens, true ) ) {
+ return false;
+ }
+
+ $now = Dates::build_date_object( 'now', 'UTC' );
+ $notice_start = $this->get_start_time();
+ $notice_end = $this->get_end_time();
+
+ $should_display = $notice_start <= $now && $now < $notice_end;
+
+
+ /**
+ * Allow filtering of whether the notice should display.
+ *
+ * @since 4.14.2
+ *
+ * @param boolean $should_display Whether the notice should display.
+ * @param Tribe__Admin__Notice_Date_Based $notice The notice object.
+ */
+ return apply_filters( "tribe_{$this->slug}_notice_should_display", $should_display, $this );
+ }
+
+ /**
+ * Unix time for notice start.
+ *
+ * @since 4.14.2
+ *
+ * @return \Tribe\Utils\Date_I18n - Date Object
+ */
+ public function get_start_time() {
+ $date = Dates::build_date_object( $this->start_date, 'UTC' );
+ if ( $this->start_time !== null ) {
+ $date = $date->setTime( $this->start_time, 0 );
+ }
+
+ /**
+ * Allow filtering of the start date DateTime object,
+ * to allow for things like "the day before" ( $date->modify( '-1 day' ) ) and such.
+ *
+ * @since 4.14.2
+ *
+ * @param \DateTime $date Date object for the notice start.
+ */
+ $date = apply_filters( "tribe_{$this->slug}_notice_start_date", $date, $this );
+
+ return $date;
+ }
+
+ /**
+ * Unix time for notice end.
+ *
+ * @since 4.14.2
+ *
+ * @return \Tribe\Utils\Date_I18n - Date Object
+ */
+ public function get_end_time() {
+ $date = Dates::build_date_object( $this->end_date, 'UTC' );
+ if ( $this->end_time !== null ) {
+ $date = $date->setTime( $this->end_time, 0 );
+ }
+
+ /**
+ * Allow filtering of the end date DateTime object,
+ * to allow for things like "the day after" ( $date->modify( '+1 day' ) ) and such.
+ *
+ * @since 4.14.2
+ *
+ * @param \DateTime $date Date object for the notice end.
+ */
+ $date = apply_filters( "tribe_{$this->slug}_notice_end_date", $date, $this );
+
+ return $date;
+ }
+
+
+
+ /**
+ * Unix time for notice extension end.
+ *
+ * @since 4.15.4
+ *
+ * @return int $end_time The date & time the notice should stop displaying, as a Unix timestamp.
+ */
+ public function get_extension_time() {
+ if ( $this->extension_date === null ) {
+ return null;
+ }
+
+ $date = Dates::build_date_object( $this->extension_date, 'UTC' );
+
+ if ( $this->extension_time !== null ) {
+ $date = $date->setTime( $this->extension_time, 0 );
+ }
+
+ /**
+ * Allow filtering of the extension date DateTime object,
+ * to allow for things like "the day after" ( $date->modify( '+1 day' ) ) and such.
+ *
+ * @since 4.14.2
+ *
+ * @param \DateTime $date Date object for the notice end.
+ */
+ $date = apply_filters( "tribe_{$this->slug}_notice_extension_date", $date, $this );
+
+ return $date;
+ }
+
+ /**
+ * Gets the template instance used to setup the rendering of the page.
+ *
+ * @since 4.14.7
+ *
+ * @return \Tribe__Template
+ */
+ public function get_template() {
+ if ( empty( $this->template ) ) {
+ $this->template = new \Tribe__Template();
+ $this->template->set_template_origin( \Tribe__Main::instance() );
+ $this->template->set_template_folder( 'src/admin-views' );
+ $this->template->set_template_context_extract( true );
+ $this->template->set_template_folder_lookup( false );
+ }
+
+ return $this->template;
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Marketing.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Marketing.php
new file mode 100644
index 000000000..add054cb8
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Marketing.php
@@ -0,0 +1,190 @@
+tec_is_active = $tribe_dependency->is_plugin_active( 'Tribe__Events__Main' );
+ $this->et_is_active = $tribe_dependency->is_plugin_active( 'Tribe__Tickets__Main' );
+ }
+
+ /**
+ * Register the various Marketing notices.
+ *
+ * @since 4.7.23
+ */
+ public function hook() {
+ $this->black_friday_hook_notice();
+ }
+
+ /**
+ * Register the Black Friday notice.
+ *
+ * @since 4.12.14
+ */
+ public function black_friday_hook_notice() {
+
+ tribe_notice(
+ 'black-friday',
+ [ $this, 'black_friday_display_notice' ],
+ [
+ 'type' => 'tribe-banner',
+ 'dismiss' => 1,
+ 'priority' => -1,
+ 'wrap' => false,
+ ],
+ [ $this, 'black_friday_should_display' ]
+ );
+ }
+
+ /**
+ * Unix time for Monday of Thanksgiving week @ 11am UTC. (11am UTC is 6am EST).
+ *
+ * @since 4.12.14
+ *
+ * @return int
+ */
+ public function get_black_friday_start_time() {
+ $date = Dates::build_date_object( 'fourth Thursday of November ' . date( 'Y' ), 'UTC' );
+ $date = $date->modify( '-3 days' );
+ $date = $date->setTime( 11, 0 );
+
+ $start_time = $date->format( 'U' );
+
+ /**
+ * Allow filtering of the Black Friday sale start date, mainly for testing purposes.
+ *
+ * @since 4.12.14
+ *
+ * @param int $bf_start_date Unix time for the Monday of Thanksgiving week @ 6am UTC.
+ */
+ return apply_filters( 'tribe_black_friday_start_time', $start_time );
+ }
+
+ /**
+ * Unix time for Dec 1 @ 5am UTC. (5am UTC is 12am EST).
+ *
+ * @since 4.12.14
+ *
+ * @return int
+ */
+ public function get_black_friday_end_time() {
+ $date = Dates::build_date_object( 'December 1st', 'UTC' );
+ $date = $date->setTime( 5, 0 );
+
+ $end_time = $date->format( 'U' );
+
+ /**
+ * Allow filtering of the Black Friday sale end date, mainly for testing purposes.
+ *
+ * @since 4.12.14
+ *
+ * @param int $bf_end_date Unix time for Dec 1 @ 6am UTC.
+ */
+ return apply_filters( 'tribe_black_friday_end_time', $end_time );
+ }
+ /**
+ * Whether the Black Friday notice should display.
+ *
+ * Unix times for Monday of Thanksgiving week @ 6am UTC and Dec 1 2020 @ 6am UTC.
+ * 6am UTC is midnight for TheEventsCalendar.com, which uses the America/Los_Angeles time zone.
+ *
+ * @since 4.12.14
+ *
+ * @return boolean
+ */
+ public function black_friday_should_display() {
+ // If upsells have been manually hidden, respect that.
+ if ( tec_should_hide_upsell() ) {
+ return false;
+ }
+
+ $now = Dates::build_date_object( 'now', 'UTC' )->format( 'U' );
+ $bf_sale_start = $this->get_black_friday_start_time();
+ $bf_sale_end = $this->get_black_friday_end_time();
+
+ $current_screen = get_current_screen();
+
+ $screens = [
+ 'tribe_events_page_tribe-app-shop', // App shop.
+ 'events_page_tribe-app-shop', // App shop.
+ 'tribe_events_page_tribe-common', // Settings & Welcome.
+ 'tribe_events_page_tec-events-settings', // New Settings & Welcome.
+ 'events_page_tribe-common', // Settings & Welcome.
+ 'toplevel_page_tribe-common', // Settings & Welcome.
+ ];
+
+ // If not a valid screen, don't display.
+ if ( empty( $current_screen->id ) || ! in_array( $current_screen->id, $screens, true ) ) {
+ return false;
+ }
+
+ return $bf_sale_start <= $now && $now < $bf_sale_end;
+ }
+
+ /**
+ * HTML for the Black Friday notice.
+ *
+ * @since 4.12.14
+ *
+ * @return string
+ */
+ public function black_friday_display_notice() {
+ Tribe__Assets::instance()->enqueue( [ 'tribe-common-admin' ] );
+
+ $current_screen = get_current_screen();
+
+ $icon_url = Tribe__Main::instance()->plugin_url . 'src/resources/images/icons/sale-burst.svg';
+ $cta_url = 'https://evnt.is/bf' . date( 'Y' );
+ $screens = [
+ 'tribe_events_page_tribe-common',
+ 'tribe_events_page_tec-events-settings',
+ 'events_page_tribe-common',
+ 'toplevel_page_tribe-common',
+ ];
+
+ // If we are on the settings page or a welcome page, change the Black Friday URL.
+ if (
+ ! empty( $current_screen->id )
+ && in_array( $current_screen->id, $screens )
+ ) {
+ if ( isset( $_GET['welcome-message-the-events-calendar'] ) || isset( $_GET['welcome-message-event-tickets' ] ) ) {
+ $cta_url .= 'welcome';
+ } else {
+ $cta_url .= 'settings';
+ }
+ }
+
+ ob_start();
+
+ include Tribe__Main::instance()->plugin_path . 'src/admin-views/notices/tribe-bf-general.php';
+
+ return ob_get_clean();
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Marketing/Black_Friday.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Marketing/Black_Friday.php
new file mode 100644
index 000000000..ddcb17f0d
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Marketing/Black_Friday.php
@@ -0,0 +1,72 @@
+enqueue( [ 'tribe-common-admin' ] );
+
+ // Set up template variables.
+ $template_args = [
+ 'icon_url' => \Tribe__Main::instance()->plugin_url . 'src/resources/images/icons/sale-burst.svg',
+ 'cta_url' => 'https://evnt.is/1aqi',
+ 'end_date' => $this->get_end_time()->format_i18n( 'F jS' ),
+ ];
+
+ // Get the Black Friday notice content.
+ $content = $this->get_template()->template( 'notices/tribe-bf-general', $template_args, false );
+
+ return $content;
+ }
+
+ /**
+ * Unix time for notice start.
+ *
+ * @since 4.14.2
+ *
+ * @return \Tribe\Utils\Date_I18n - Date Object
+ */
+ public function get_start_time() {
+ $date = parent::get_start_time();
+ $date = $date->modify( '-3 days' );
+
+ return $date;
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Marketing/End_Of_Year_Sale.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Marketing/End_Of_Year_Sale.php
new file mode 100644
index 000000000..30de2a3c3
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Marketing/End_Of_Year_Sale.php
@@ -0,0 +1,66 @@
+ \Tribe__Main::instance()->plugin_url . 'src/resources/images/marketing/eoy-sale-2021.svg',
+ 'cta_url' => 'https://evnt.is/1a-x',
+ ];
+
+ // Get the sale notice content.
+ $content = $this->get_template()->template( 'notices/end-of-year-sale', $template_args, false );
+
+ return $content;
+ }
+
+ /**
+ * Unix time for notice end.
+ *
+ * @since 4.14.9
+ *
+ * @return \Tribe\Utils\Date_I18n - Date Object
+ */
+ public function get_end_time() {
+ $date = parent::get_end_time();
+ $date = $date->setTime( 23, 59 );
+
+ return $date;
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Marketing/Stellar_Sale.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Marketing/Stellar_Sale.php
new file mode 100644
index 000000000..232e72d60
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Marketing/Stellar_Sale.php
@@ -0,0 +1,82 @@
+enqueue( [ 'tribe-common-admin' ] );
+
+ // Used in the template.
+ $cta_url = 'https://evnt.is/1bcv';
+ $stellar_url = 'https://evnt.is/1bcu';
+ $end_date = $this->get_end_time();
+ $template_args = [
+ 'cta_url' => 'https://evnt.is/1bcv',
+ 'stellar_url' => 'https://evnt.is/1bcu',
+ 'end_date' => $this->get_end_time(),
+ ];
+ $dependency = tribe( \Tribe__Dependency::class );
+
+ if ( $dependency->has_active_premium_plugin() ) {
+ return $this->get_template()->template( 'notices/tribe-stellar-sale-premium', $template_args, false );
+ } else {
+ return $this->get_template()->template( 'notices/tribe-stellar-sale', $template_args, false );
+ }
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Php_Version.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Php_Version.php
new file mode 100644
index 000000000..cfb18e4ee
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Php_Version.php
@@ -0,0 +1,106 @@
+ 'warning',
+ 'dismiss' => 1,
+ 'wrap' => 'p',
+ ],
+ [ $this, 'should_display' ]
+ );
+
+ }
+
+ /**
+ * Return the list of the Tribe active plugins
+ *
+ * @since 4.7.16
+ *
+ * @return string String of items
+ */
+ public function get_active_plugins() {
+
+ $active_plugins = Tribe__Dependency::instance()->get_active_plugins();
+
+ foreach ( $active_plugins as $active_plugin ) {
+
+ if ( ! $active_plugin['path'] ) {
+ continue;
+ }
+
+ $plugin_data = get_plugin_data( $active_plugin['path'] );
+ $plugins[] = $plugin_data['Name'];
+
+ }
+
+ return $this->implode_with_grammar( $plugins );
+
+ }
+
+ /**
+ * Implodes a list items using 'and' as the final separator and a comma everywhere else
+ *
+ * @param array $items List of items to implode
+ * @since 4.7.16
+ *
+ * @return string String of items
+ */
+ public function implode_with_grammar( $items ) {
+
+ $separator = _x( ', ', 'separator used in a list of items', 'tribe-common' );
+ $conjunction = _x( ' and ', 'the final separator in a list of two or more items', 'tribe-common' );
+ $output = $last_item = array_pop( $items );
+
+ if ( $items ) {
+ $output = implode( $separator, $items ) . $conjunction . $last_item;
+ }
+
+ return $output;
+ }
+
+ /**
+ * We only want to display notices for users
+ * who are in PHP < 5.6
+ *
+ * @since 4.7.16
+ *
+ * @return boolean
+ */
+ public function should_display() {
+ // Bail if the user is not admin or can manage plugins
+ if ( ! current_user_can( 'activate_plugins' ) ) {
+ return false;
+ }
+
+ return version_compare( PHP_VERSION, '7.4.0' ) < 0;
+ }
+
+ /**
+ * HTML for the PHP notice
+ *
+ * @since 4.7.16
+ *
+ * @return string
+ */
+ public function display_notice() {
+ /* Translators: %1$s list of plugins, %2$s current PHP version, %3$s open anchor html link for read more, %4$s open anchor html link for read more */
+ $text = _x(
+ 'Starting February 2023, %1$s will require PHP 7.4 or later. Currently, your site is using PHP version %2$s. Please update to a newer version. %3$sRead more%4$s.',
+ 'Message notifying users they need to upgrade PHP',
+ 'tribe-common'
+ );
+
+ $plugins = $this->get_active_plugins();
+
+ return sprintf( $text, $plugins, PHP_VERSION, '', '' );
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Plugin_Download.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Plugin_Download.php
new file mode 100644
index 000000000..5efd1e234
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Plugin_Download.php
@@ -0,0 +1,164 @@
+plugin_path = $plugin_path;
+
+ tribe_notice(
+ plugin_basename( $plugin_path ),
+ [ $this, 'show_inactive_plugins_alert' ]
+ );
+ }
+
+ /**
+ * Add a required plugin to the notice
+ *
+ * @since 4.8.3 Method introduced.
+ * @since 4.9 Added $version and $addon parameters.
+ * @since 4.9.12 Add $has_pue_notice param
+ * @since 4.9.17 Appended "+" to all version numbers to indicate "or any later version".
+ *
+ * @param string $name Name of the required plugin
+ * @param null $thickbox_url Download or purchase URL for plugin from within /wp-admin/ thickbox
+ * @param bool $is_active Indicates if the plugin is installed and active or not
+ * @param string $version Optional version number of the required plugin
+ * @param bool $addon Indicates if the plugin is an add-on for The Events Calendar or Event Tickets
+ * @param bool $has_pue_notice Indicates that we need to change the messaging due to expired key.
+ */
+ public function add_required_plugin( $name, $thickbox_url = null, $is_active = null, $version = null, $addon = false, $has_pue_notice = false ) {
+ $this->plugins_required[ $name ] = [
+ 'name' => $name,
+ 'thickbox_url' => $thickbox_url,
+ 'is_active' => $is_active,
+ 'version' => $version ? $version . '+' : null,
+ 'addon' => $addon,
+ 'has_pue_notice' => $has_pue_notice,
+ ];
+ }
+
+ /**
+ * Echoes the admin notice, attach to admin_notices
+ *
+ * @see \Tribe__Admin__Notice__Plugin_Download::add_required_plugin()
+ *
+ * @since 4.9.17 Altered the notice to remove "latest version" verbiage since "+" is now added to the version numbers.
+ */
+ public function show_inactive_plugins_alert() {
+ if ( ! current_user_can( 'activate_plugins' ) ) {
+ return;
+ }
+
+ $plugin_data = get_plugin_data( $this->plugin_path );
+ $req_plugins = [];
+
+ if ( empty( $this->plugins_required ) ) {
+ return;
+ }
+
+ // Make sure Thickbox is available and consistent appearance regardless of which admin page we're on
+ add_thickbox();
+
+ $has_pue_notices = false;
+
+ foreach ( $this->plugins_required as $req_plugin ) {
+ $item = $req_plugin['name'];
+ $version = empty( $req_plugin['version'] ) ? '' : ' (' . str_replace( '-dev', '', $req_plugin['version'] ) . ')';
+
+ if ( ! empty( $req_plugin['thickbox_url'] ) ) {
+ $item = sprintf(
+ '%3$s%4$s',
+ esc_attr( $req_plugin['thickbox_url'] ),
+ esc_attr( $req_plugin['name'] ),
+ esc_html( $item ),
+ esc_html( $version )
+ );
+ }
+
+ if ( false === $req_plugin['is_active'] ) {
+ $item = sprintf(
+ '%1$s',
+ $item
+ );
+ }
+
+ if ( ! empty( $req_plugin['addon'] ) ) {
+ $plugin_name[] = $req_plugin['name'];
+ }
+
+ $req_plugins[] = $item;
+
+ // If any of the items has PUE notice we will warn the user.
+ if ( $req_plugin['has_pue_notice'] ) {
+ $has_pue_notices = true;
+ }
+ }
+
+ // If empty then add in the default name.
+ if ( empty( $plugin_name[0] ) ) {
+ $plugin_name[] = $plugin_data['Name'];
+ }
+
+ $allowed_html = [
+ 'strong' => [],
+ 'a' => [ 'href' => [] ],
+ ];
+
+ $plugin_names_clean_text = wp_kses( $this->implode_with_grammar( $plugin_name ), $allowed_html );
+ $req_plugin_names_clean_text = wp_kses( $this->implode_with_grammar( $req_plugins ), $allowed_html );
+
+ $notice_html_content = '
' . esc_html__( 'To begin using %2$s, please install (or upgrade) and activate %3$s.', 'tribe-common' ) . '
';
+
+ $read_more_link = '' . esc_html__( 'Read more', 'tribe-common' ) . '.';
+ $pue_notice_text = esc_html__( 'There’s a new version of %1$s available, but your license is expired. You’ll need to renew your license to get access to the latest version. If you plan to continue using your current version of the plugin(s), be sure to use a compatible version of The Events Calendar. %2$s', 'tribe-common' );
+ $pue_notice_html = '
',
+ esc_attr( sanitize_title( $plugin_data['Name'] ) ),
+ $plugin_names_clean_text,
+ $req_plugin_names_clean_text
+ );
+ }
+
+ /**
+ * Implodes a list of items with proper grammar.
+ *
+ * If only 1 item, no grammar. If 2 items, just conjunction. If 3+ items, commas with conjunction.
+ *
+ * @param array $items List of items to implode
+ *
+ * @return string String of items
+ */
+ public function implode_with_grammar( $items ) {
+ $separator = _x( ', ', 'separator used in a list of items', 'tribe-common' );
+ $conjunction = _x( ' and ', 'the final separator in a list of two or more items', 'tribe-common' );
+ $output = $last_item = array_pop( $items );
+
+ if ( $items ) {
+ $output = implode( $separator, $items );
+
+ if ( 1 < count( $items ) ) {
+ $output .= $separator;
+ }
+
+ $output .= $conjunction . $last_item;
+ }
+
+ return $output;
+ }
+
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Plugin_Upgrade_Notice.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Plugin_Upgrade_Notice.php
new file mode 100644
index 000000000..819d85ba5
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Plugin_Upgrade_Notice.php
@@ -0,0 +1,239 @@
+current_version = $current_version;
+ $this->plugin_path = $plugin_path;
+
+ add_action( "in_plugin_update_message-$plugin_path", [ $this, 'maybe_run' ] );
+ }
+
+ /**
+ * Test if there is a plugin upgrade notice and displays it if so.
+ *
+ * Expects to fire during "in_plugin_update_message-{plugin_path}", therefore
+ * this should only run if WordPress has detected that an upgrade is indeed
+ * available.
+ */
+ public function maybe_run() {
+ $this->test_for_upgrade_notice();
+
+ if ( $this->upgrade_notice ) {
+ $this->display_message();
+ }
+ }
+
+ /**
+ * Tests to see if an upgrade notice is available.
+ */
+ protected function test_for_upgrade_notice() {
+ $cache_key = $this->cache_key();
+ $this->upgrade_notice = get_transient( $cache_key );
+
+ if ( false === $this->upgrade_notice ) {
+ $this->discover_upgrade_notice();
+ }
+
+ set_transient( $cache_key, $this->upgrade_notice, $this->cache_expiration() );
+ }
+
+ /**
+ * Returns a cache key unique to the current plugin path and version, that
+ * still fits within the 45-char limit of regular WP transient keys.
+ *
+ * @return string
+ */
+ protected function cache_key() {
+ return 'tribe_plugin_upgrade_notice-' . hash( 'crc32b', $this->plugin_path . $this->current_version );
+ }
+
+ /**
+ * Returns the period of time (in seconds) for which to cache plugin upgrade messages.
+ *
+ * @return int
+ */
+ protected function cache_expiration() {
+ /**
+ * Number of seconds to cache plugin upgrade messages for.
+ *
+ * Defaults to one day, which provides a decent balance between efficiency savings
+ * and allowing for the possibility that some upgrade messages may be changed or
+ * rescinded.
+ *
+ * @var int $cache_expiration
+ */
+ return (int) apply_filters( 'tribe_plugin_upgrade_notice_expiration', DAY_IN_SECONDS, $this->plugin_path );
+ }
+
+ /**
+ * Looks at the current stable plugin readme.txt and parses to try and find the first
+ * available upgrade notice relating to a plugin version higher than this one.
+ *
+ * By default, WP SVN is the source.
+ */
+ protected function discover_upgrade_notice() {
+ /**
+ * The URL for the current plugin readme.txt file.
+ *
+ * @var string $url
+ * @var string $plugin_path
+ */
+ $readme_url = apply_filters( 'tribe_plugin_upgrade_readme_url',
+ $this->form_wp_svn_readme_url(),
+ $this->plugin_path
+ );
+
+ if ( ! empty( $readme_url ) ) {
+ $response = wp_safe_remote_get( $readme_url );
+ }
+
+ if ( ! empty( $response ) && ! is_wp_error( $response ) ) {
+ $readme = $response['body'];
+ }
+
+ if ( ! empty( $readme ) ) {
+ $this->parse_for_upgrade_notice( $readme );
+ $this->format_upgrade_notice();
+ }
+
+ /**
+ * The upgrade notice for the current plugin (may be empty).
+ *
+ * @var string $upgrade_notice
+ * @var string $plugin_path
+ */
+ return apply_filters( 'tribe_plugin_upgrade_notice',
+ $this->upgrade_notice,
+ $this->plugin_path
+ );
+ }
+
+ /**
+ * Forms the expected URL to the trunk readme.txt file as it is on WP SVN
+ * or an empty string if for any reason it cannot be determined.
+ *
+ * @return string
+ */
+ protected function form_wp_svn_readme_url() {
+ $parts = explode( '/', $this->plugin_path );
+ $slug = empty( $parts[0] ) ? '' : $parts[0];
+ return esc_url( "https://plugins.svn.wordpress.org/$slug/trunk/readme.txt" );
+ }
+
+ /**
+ * Given a standard Markdown-format WP readme.txt file, finds the first upgrade
+ * notice (if any) for a version higher than $this->current_version.
+ *
+ * @param string $readme
+ * @return string
+ */
+ protected function parse_for_upgrade_notice( $readme ) {
+ $in_upgrade_notice = false;
+ $in_version_notice = false;
+ $readme_lines = explode( "\n", $readme );
+
+ foreach ( $readme_lines as $line ) {
+ // Once we leave the Upgrade Notice section (ie, we encounter a new section header), bail
+ if ( $in_upgrade_notice && 0 === strpos( $line, '==' ) ) {
+ break;
+ }
+
+ // Look out for the start of the Upgrade Notice section
+ if ( ! $in_upgrade_notice && preg_match( '/^==\s*Upgrade\s+Notice\s*==/i', $line ) ) {
+ $in_upgrade_notice = true;
+ }
+
+ // Also test to see if we have left the version specific note (ie, we encounter a new sub heading or header)
+ if ( $in_upgrade_notice && $in_version_notice && 0 === strpos( $line, '=' ) ) {
+ break;
+ }
+
+ // Look out for the first applicable version-specific note within the Upgrade Notice section
+ if ( $in_upgrade_notice && ! $in_version_notice && preg_match( '/^=\s*\[?([0-9\.]{3,})\]?\s*=/', $line, $matches ) ) {
+ // Is this a higher version than currently installed?
+ if ( version_compare( $matches[1], $this->current_version, '>' ) ) {
+ $in_version_notice = true;
+ }
+ }
+
+ // Copy the details of the upgrade notice for the first higher version we find
+ if ( $in_upgrade_notice && $in_version_notice ) {
+ $this->upgrade_notice .= $line . "\n";
+ }
+ }
+ }
+
+ /**
+ * Convert the plugin version header and any links from Markdown to HTML.
+ */
+ protected function format_upgrade_notice() {
+ // Convert [links](http://...) to tags
+ $this->upgrade_notice = preg_replace(
+ '/\[([^\]]*)\]\(([^\)]*)\)/',
+ '${1}',
+ $this->upgrade_notice
+ );
+
+ // Convert =4.0= headings to
',
+ $this->upgrade_notice
+ );
+ }
+
+ /**
+ * Render the actual upgrade notice.
+ *
+ * Please note if plugin-specific styling is required for the message, you can
+ * use an ID generated by WordPress for one of the message's parent elements
+ * which takes the form "{plugin_name}-update". Example:
+ *
+ * #the-events-calendar-update .tribe-plugin-update-message { ... }
+ */
+ public function display_message() {
+ $notice = wp_kses_post( $this->upgrade_notice );
+ echo "
$notice
";
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Service_Provider.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Service_Provider.php
new file mode 100644
index 000000000..72ad60246
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/Service_Provider.php
@@ -0,0 +1,66 @@
+hooks();
+ }
+
+ /**
+ * Set up hooks for classes.
+ *
+ * @since 4.14.2
+ */
+ private function hooks() {
+ add_action( 'tribe_plugins_loaded', [ $this, 'plugins_loaded'] );
+ }
+
+ /**
+ * Setup for things that require plugins loaded first.
+ *
+ * @since 4.14.2
+ */
+ public function plugins_loaded() {
+ tribe( 'pue.notices' );
+ tribe( 'admin.notice.php.version' );
+ tribe( WP_Version::class );
+
+ if ( defined( 'TRIBE_HIDE_MARKETING_NOTICES' ) ) {
+ return;
+ }
+
+ tribe( Marketing\Stellar_Sale::class );
+ tribe( Marketing\Black_Friday::class );
+ // EOY Sale disabled for 2022
+ // tribe( Marketing\End_Of_Year_Sale::class );
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/WP_Version.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/WP_Version.php
new file mode 100644
index 000000000..8c3137957
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notice/WP_Version.php
@@ -0,0 +1,87 @@
+ 'warning',
+ 'dismiss' => 1,
+ 'priority' => -1,
+ 'wrap' => 'p',
+ ],
+ [ $this, 'wp_version_57_should_display' ]
+ );
+ }
+
+ /**
+ * Whether the WordPress 5.7 notice should display.
+ *
+ * @since 4.12.17
+ *
+ * @return boolean
+ */
+ public function wp_version_57_should_display() {
+ global $wp_version, $current_screen;
+
+ $screens = [
+ 'tribe_events_page_tribe-app-shop', // App shop.
+ 'events_page_tribe-app-shop', // App shop.
+ 'tribe_events_page_tribe-common', // Settings & Welcome.
+ 'tribe_events_page_tec-events-settings', // New Settings & Welcome.
+ 'events_page_tribe-common', // Settings & Welcome.
+ 'toplevel_page_tribe-common', // Settings & Welcome.
+ ];
+
+ // If not a valid screen, don't display.
+ if ( empty( $current_screen->id ) || ! in_array( $current_screen->id, $screens, true ) ) {
+ return false;
+ }
+
+ $wp_version_min_version_required = '5.8';
+ $common_version_required = '4.12.18-dev';
+
+ return
+ version_compare( Common::VERSION, $common_version_required, '<' )
+ && version_compare( $wp_version, $wp_version_min_version_required, '<' );
+ }
+
+ /**
+ * HTML for the WordPress 5.7 notice.
+ *
+ * @since 4.12.17
+ *
+ * @see https://evnt.is/wp5-7
+ *
+ * @return string
+ */
+ public function wp_version_57_display_notice() {
+ global $wp_version;
+ $is_wp_57 = version_compare( $wp_version, '5.7-beta', '>=' );
+ $html = '';
+
+ if ( $is_wp_57 ) {
+ $html .= esc_html__( 'You are using WordPress 5.7 which included a major jQuery update that may cause compatibility issues with past versions of The Events Calendar, Event Tickets and other plugins.', 'tribe-common' );
+ } else {
+ $html .= esc_html__( 'WordPress 5.7 includes a major jQuery update that may cause compatibility issues with past versions of The Events Calendar, Event Tickets and other plugins.', 'tribe-common' );
+ }
+ $html .= ' ' . esc_html__( 'Read more.', 'tribe-common' ) . '';
+
+ return $html;
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notices.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notices.php
new file mode 100644
index 000000000..f1a2965b4
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Notices.php
@@ -0,0 +1,821 @@
+doing_ajax() ) {
+ return;
+ }
+
+ // Hook the actual rendering of notices
+ add_action( 'current_screen', [ $this, 'hook' ], 20 );
+
+ // Add our notice dismissal script
+ tribe_asset(
+ Tribe__Main::instance(),
+ 'tribe-notice-dismiss',
+ 'notice-dismiss.js',
+ [ 'jquery' ],
+ null,
+ [
+ 'groups' => 'tec-admin-notices',
+ ]
+ );
+ }
+
+ /**
+ * This will happen on the `current_screen` and will hook to the correct actions and display the notices
+ *
+ * @since 4.3
+ *
+ * @return void
+ */
+ public function hook() {
+ $transients = $this->get_transients();
+
+ foreach ( $transients as $slug => $transient ) {
+ if ( $this->transient_notice_expired( $slug ) ) {
+ continue;
+ }
+ list( $html, $args, $expire ) = $transients[ $slug ];
+ $this->register( $slug, $html, $args );
+ }
+
+ foreach ( $this->notices as $notice ) {
+ if ( ! $this->showing_notice( $notice->slug ) ) {
+ continue;
+ }
+
+ add_action( $notice->action, $notice->callback, $notice->priority );
+ }
+ }
+
+ /**
+ * This will allow the user to Dismiss the Notice using JS.
+ *
+ * We will dismiss the notice without checking to see if the slug was already
+ * registered (via a call to exists()) for the reason that, during dismissal
+ * ajax request, some valid notices may not have been registered yet.
+ *
+ * @since 4.3
+ *
+ * @return void
+ */
+ public function maybe_dismiss() {
+ if ( empty( $_GET[ self::$meta_key ] ) ) {
+ wp_send_json( false );
+ }
+
+ $slug = sanitize_key( $_GET[ self::$meta_key ] );
+
+ // Send a JSON answer with the status of dismissal
+ wp_send_json( $this->dismiss( $slug ) );
+ }
+
+ /**
+ * Allows a Magic to remove the Requirement of creating a callback
+ *
+ * @since 4.3
+ *
+ * @param string $name Name of the method used to create the slug of the notice.
+ * @param array $arguments Which arguments were used, normally empty.
+ *
+ * @return string
+ */
+ public function __call( $name, $arguments ) {
+ // Transform from Method name to Notice number
+ $slug = preg_replace( '/render_/', '', $name, 1 );
+
+ if ( ! $this->exists( $slug ) ) {
+ return false;
+ }
+
+ $notice = $this->get( $slug );
+
+ if (
+ empty( $notice->active_callback )
+ || (
+ is_callable( $notice->active_callback )
+ && true == call_user_func( $notice->active_callback )
+ )
+ ) {
+ $content = $notice->content;
+ $wrap = isset( $notice->wrap ) ? $notice->wrap : false;
+
+ if ( is_array( $content ) && isset( $content[0] ) && $content[0] instanceof __PHP_Incomplete_Class ) {
+ // From a class that no longer exists (e.g. the plugin is not active), clean and bail.
+ $this->remove( $slug );
+ $this->remove_transient( $slug );
+
+ return false;
+ }
+
+ if ( is_callable( $content ) ) {
+ $content = call_user_func_array( $content, [ $notice ] );
+ }
+
+ if ( empty( $content ) ) {
+ // There is nothing to render, let's avoid the empty notice frame.
+ return false;
+ }
+
+ tribe_asset_enqueue_group( 'tec-admin-notices' );
+
+ // Return the rendered HTML.
+ $html = $this->render( $slug, $content, false, $wrap );
+
+ // Remove the notice and the transient (if any) since it's been rendered.
+ $this->remove( $slug );
+ $this->remove_transient( $slug );
+
+ return $html;
+ }
+
+ return false;
+ }
+
+ /**
+ * This is a helper to actually print the Message
+ *
+ * @since 4.3
+ *
+ * @param string $slug The name of the notice.
+ * @param string $content The content of the notice.
+ * @param boolean $return Echo or return the content.
+ * @param string|bool $wrap An optional HTML tag to wrap the content.
+ *
+ * @return bool|string
+ */
+ public function render( $slug, $content = null, $return = true, $wrap = false ) {
+ if ( ! $this->exists( $slug ) ) {
+ return false;
+ }
+
+ // Bail if we already rendered
+ if ( $this->is_rendered( $slug ) ) {
+ if ( $this->is_rendered_html( $slug, $content ) && ! $return ) {
+ echo $content;
+ }
+
+ return false;
+ }
+
+ $notice = $this->get( $slug );
+ $this->notices[ $slug ]->is_rendered = true;
+
+ $classes = [ 'tribe-dismiss-notice', 'notice' ];
+ $classes[] = sanitize_html_class( 'notice-' . $notice->type );
+ $classes[] = sanitize_html_class( 'tribe-notice-' . $notice->slug );
+
+ if ( $notice->dismiss ) {
+ $classes[] = 'is-dismissible';
+ }
+
+ if ( $notice->inline ) {
+ $classes[] = 'inline';
+ }
+
+ // Prevents Empty Notices
+ if ( empty( $content ) ) {
+ return false;
+ }
+
+ if ( is_string( $wrap ) ) {
+ $content = sprintf( '<%1$s>' . $content . '', $wrap );
+ }
+
+ $html = sprintf( '
%s
', implode( ' ', $classes ), $notice->slug, $content );
+ tribe_asset_enqueue_group( 'tec-admin-notices' );
+
+ if ( ! $return ) {
+ echo $html;
+ }
+
+ return $html;
+ }
+
+ /**
+ * This is a helper to print the message surrounded by `p` tags.
+ *
+ * @since 4.3
+ *
+ * @param string $slug The name of the notice.
+ * @param string $content The content of the notice.
+ * @param boolean $return Echo or return the content.
+ *
+ * @return boolean|string
+ */
+ public function render_paragraph( $slug, $content = null, $return = true ) {
+ return $this->render( $slug, $content, $return, 'p' );
+ }
+
+ /**
+ * Checks if a given notice is rendered
+ *
+ * @since 4.7.10
+ *
+ * @param string $slug Which notice to check.
+ *
+ * @return boolean
+ */
+ public function is_rendered( $slug ) {
+ if ( ! $this->exists( $slug ) ) {
+ return false;
+ }
+
+ $notice = $this->get( $slug );
+
+ return isset( $notice->is_rendered ) ? $notice->is_rendered : false;
+ }
+
+ /**
+ * Checks if a given string is a notice rendered
+ *
+ * @since 4.7.10
+ *
+ * @param string $slug Which notice to check.
+ * @param string $html Which html string we are check.
+ *
+ * @return boolean
+ */
+ public function is_rendered_html( $slug, $html ) {
+ if ( ! $this->exists( $slug ) ) {
+ return false;
+ }
+
+ $search = sprintf( 'data-ref="%s"', $slug );
+
+ return false !== strpos( $html, $search );
+ }
+
+ /**
+ * Checks if a given user has dismissed a given notice.
+ *
+ * @since 4.13.0
+ *
+ * @param string $slug The name of the notice.
+ * @param int|null $user_id The user ID.
+ *
+ * @return boolean
+ */
+ public function has_user_dismissed( $slug, $user_id = null ) {
+
+ if ( is_null( $user_id ) ) {
+ $user_id = get_current_user_id();
+ }
+
+ $dismissed_notices = get_user_meta( $user_id, self::$meta_key );
+
+ if ( ! is_array( $dismissed_notices ) ) {
+ return false;
+ }
+
+ if ( ! in_array( $slug, $dismissed_notices ) ) {
+ return false;
+ }
+
+ $notice = $this->get( $slug );
+ if (
+ is_object( $notice )
+ && $notice->recurring
+ && $this->should_recurring_notice_show( $slug, $user_id )
+ ) {
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * Checks if a given user has dismissed a given notice.
+ *
+ * @since 4.3
+ * @deprecated 4.13.0 Deprecated in favor of correcting the typo.
+ *
+ * @param string $slug The Name of the Notice
+ * @param int|null $user_id The user ID
+ *
+ * @return boolean
+ */
+ public function has_user_dimissed( $slug, $user_id = null ) {
+ return $this->has_user_dismissed( $slug, $user_id );
+ }
+
+ /**
+ * Gets the last Dismissal for a given notice slug and user.
+ *
+ * @since 4.13.0
+ *
+ * @param string $slug Slug of the notice to look for.
+ * @param int|null $user_id Which user? If null will default to current user.
+ *
+ * @return false|\Tribe\Utils\Date_I18n
+ */
+ public function get_last_dismissal( $slug, $user_id = null ) {
+ if ( is_null( $user_id ) ) {
+ $user_id = get_current_user_id();
+ }
+
+ $dismissed_time = get_user_meta( $user_id, static::$meta_key_time_prefix . $slug, true );
+
+ if ( ! is_numeric( $dismissed_time ) ) {
+ return false;
+ }
+
+ return Dates::build_date_object( $dismissed_time );
+ }
+
+ /**
+ * Determines if a given notice needs to be re-displayed in case of recurring notice.
+ *
+ * @since 4.13.0
+ *
+ * @param string $slug Slug of the notice to look for.
+ * @param int|null $user_id Which user? If null will default to current user.
+ *
+ * @return false|\Tribe\Utils\Date_I18n
+ */
+ public function should_recurring_notice_show( $slug, $user_id = null ) {
+ $notice = $this->get( $slug );
+ if ( ! is_object( $notice ) ) {
+ return false;
+ }
+
+ if ( ! $notice->recurring || ! $notice->recurring_interval ) {
+ return false;
+ }
+
+ if ( is_null( $user_id ) ) {
+ $user_id = get_current_user_id();
+ }
+
+ $interval = Dates::interval( $notice->recurring_interval );
+ $last_dismissal = $this->get_last_dismissal( $slug, $user_id );
+ if ( ! $last_dismissal ) {
+ return false;
+ }
+
+ $next_dismissal = $last_dismissal->add( $interval );
+ $now = Dates::build_date_object( 'now' );
+
+ if ( $now >= $next_dismissal ) {
+ delete_user_meta( $user_id, self::$meta_key, $slug );
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * A Method to actually add the Meta value telling that this notice has been dismissed
+ *
+ * @since 4.3
+ *
+ * @param string $slug The Name of the Notice
+ * @param int|null $user_id The user ID
+ *
+ * @return boolean
+ */
+ public function dismiss( $slug, $user_id = null ) {
+ if ( is_null( $user_id ) ) {
+ $user_id = get_current_user_id();
+ }
+
+ // If this user has dismissed we don't care either
+ if ( $this->has_user_dismissed( $slug, $user_id ) ) {
+ return true;
+ }
+
+ update_user_meta( $user_id, static::$meta_key_time_prefix . $slug, time() );
+
+ return add_user_meta( $user_id, self::$meta_key, $slug, false );
+ }
+
+ /**
+ * Removes the User meta holding if a notice was dismissed
+ *
+ * @param string $slug The Name of the Notice
+ * @param int|null $user_id The user ID
+ *
+ * @return boolean
+ */
+ public function undismiss( $slug, $user_id = null ) {
+ if ( is_null( $user_id ) ) {
+ $user_id = get_current_user_id();
+ }
+
+ // If this user has dismissed we don't care either
+ if ( ! $this->has_user_dismissed( $slug, $user_id ) ) {
+ return false;
+ }
+
+ return delete_user_meta( $user_id, self::$meta_key, $slug );
+ }
+
+ /**
+ * Undismisses the specified notice for all users.
+ *
+ * @since 4.3
+ *
+ * @param string $slug
+ *
+ * @return int
+ */
+ public function undismiss_for_all( $slug ) {
+ $user_query = new WP_User_Query( [
+ 'meta_key' => self::$meta_key,
+ 'meta_value' => $slug,
+ ] );
+
+ $affected = 0;
+
+ foreach ( $user_query->get_results() as $user ) {
+ if ( $this->undismiss( $slug, $user->ID ) ) {
+ $affected ++;
+ }
+ }
+
+ return $affected;
+ }
+
+ /**
+ * Register a Notice and attach a callback to the required action to display it correctly
+ *
+ * @since 4.3
+ *
+ * @param string $slug Slug to save the notice
+ * @param callable|string $callback A callable Method/Function to actually display the notice
+ * @param array $arguments Arguments to Setup a notice
+ * @param callable|null $active_callback An optional callback that should return bool values
+ * to indicate whether the notice should display or not.
+ *
+ * @return stdClass
+ */
+ public function register( $slug, $callback, $arguments = [], $active_callback = null ) {
+ // Prevent weird stuff here
+ $slug = sanitize_key( $slug );
+
+ $defaults = [
+ 'callback' => null,
+ 'content' => null,
+ 'action' => 'admin_notices',
+ 'priority' => 10,
+ 'expire' => false,
+ 'dismiss' => false,
+ 'inline' => false,
+ 'recurring' => false,
+ 'recurring_interval' => null,
+ 'type' => 'error',
+ 'is_rendered' => false,
+ 'wrap' => false,
+ ];
+
+ $defaults['callback'] = [ $this, 'render_' . $slug ];
+ $defaults['content'] = $callback;
+
+ if ( is_callable( $active_callback ) ) {
+ $defaults['active_callback'] = $active_callback;
+ }
+
+ // Merge Arguments
+ $notice = (object) wp_parse_args( $arguments, $defaults );
+
+ // Enforce this one
+ $notice->slug = $slug;
+
+ // Clean these
+ $notice->priority = absint( $notice->priority );
+ $notice->expire = (bool) $notice->expire;
+ $notice->recurring = (bool) $notice->recurring;
+
+ if ( ! is_callable( $notice->dismiss ) ) {
+ $notice->dismiss = (bool) $notice->dismiss;
+ }
+ if ( ! is_callable( $notice->inline ) ) {
+ $notice->inline = (bool) $notice->inline;
+ }
+
+ // Set the Notice on the array of notices
+ $this->notices[ $slug ] = $notice;
+
+ // Return the notice Object because it might be modified
+ return $notice;
+ }
+
+ /**
+ * Create a transient Admin Notice easily.
+ *
+ * A transient admin notice is a "fire-and-forget" admin notice that will display once registered and
+ * until dismissed (if dismissible) without need, on the side of the source code, to register it on each request.
+ *
+ * @since 4.7.7
+ *
+ * @param string $slug Slug to save the notice
+ * @param string $html The notice output HTML code
+ * @param array $arguments Arguments to Setup a notice
+ * @param int $expire After how much time (in seconds) the notice will stop showing.
+ *
+ * @return stdClass Which notice was registered
+ */
+ public function register_transient( $slug, $html, $arguments = [], $expire = null ) {
+ $notices = $this->get_transients();
+ $notices[ $slug ] = [ $html, $arguments, time() + $expire ];
+ $this->set_transients( $notices );
+ }
+
+ /**
+ * Removes a transient notice based on its slug.
+ *
+ * @since 4.7.7
+ *
+ * @param string $slug
+ */
+ public function remove_transient( $slug ) {
+ $notices = $this->get_transients();
+ unset( $notices[ $slug ] );
+ $this->set_transients( $notices );
+ }
+
+ /**
+ * Removes a notice based on its slug.
+ *
+ * @since 4.3
+ *
+ * @param string $slug
+ *
+ * @return bool
+ */
+ public function remove( $slug ) {
+ if ( ! $this->exists( $slug ) ) {
+ return false;
+ }
+
+ unset( $this->notices[ $slug ] );
+
+ return true;
+ }
+
+ /**
+ * Gets the configuration for the Notices
+ *
+ * @since 4.3
+ *
+ * @param string $slug
+ *
+ * @return object|array|null
+ */
+ public function get( $slug = null ) {
+ if ( is_null( $slug ) ) {
+ return $this->notices;
+ }
+
+ // Prevent weird stuff here
+ $slug = sanitize_key( $slug );
+
+ if ( ! empty( $this->notices[ $slug ] ) ) {
+ // I want to avoid modifying the registered value.
+ $notice = $this->notices[ $slug ];
+
+ if ( is_callable( $notice->inline ) ) {
+ $notice->inline = call_user_func( $notice->inline, $notice );
+ }
+
+ if ( is_callable( $notice->dismiss ) ) {
+ $notice->dismiss = call_user_func( $notice->dismiss, $notice );
+ }
+
+ return $notice;
+ }
+
+ return null;
+ }
+
+ /**
+ * Checks if a given notice exists
+ *
+ * @since 4.3
+ *
+ * @param string $slug
+ *
+ * @return bool
+ */
+ public function exists( $slug ) {
+ return is_object( $this->get( $slug ) ) ? true : false;
+ }
+
+ /**
+ * Returns an array of registered transient notices.
+ *
+ * @since 4.7.7
+ *
+ * @return array An associative array in the shape [ => [ , , ] ]
+ */
+ protected function get_transients() {
+ $cached = tribe( 'cache' )['transient_admin_notices'];
+
+ if ( false !== $cached ) {
+ return $cached;
+ }
+
+ $transient = self::$transient_notices_name;
+ $notices = get_transient( $transient );
+ $notices = is_array( $notices ) ? $notices : [];
+
+ if ( $this->did_prune_transients ) {
+ $this->did_prune_transients = true;
+ foreach ( $notices as $key => $notice ) {
+ list( $html, $args, $expire_at ) = $notice;
+
+ if ( $expire_at < time() ) {
+ unset( $notices[ $key ] );
+ }
+ }
+ }
+
+ tribe( 'cache' )['transient_admin_notices'] = $notices;
+
+ return $notices;
+ }
+
+ /**
+ * Updates/sets the transient notices transient.
+ *
+ * @since 4.7.7
+ *
+ * @param array $notices An associative array in the shape [ => [ , , ] ]
+ */
+ protected function set_transients( $notices ) {
+ $transient = self::$transient_notices_name;
+ set_transient( $transient, $notices, MONTH_IN_SECONDS );
+ }
+
+ /**
+ * Checks whether a specific transient admin notices is being shown or not, depending on its expiration and
+ * dismissible status.
+ *
+ *
+ * @since 4.11.1
+ *
+ * @param string|array $slug The slug, or slugs, of the transient notices to check. This is the same slug used
+ * to register the transient notice in the `tribe_transient_notice` function or the
+ * `Tribe__Admin__Notices::register_transient()` method.
+ *
+ * @return bool Whether the transient notice is showing or not.
+ */
+ public function showing_transient_notice( $slug ) {
+ $transient_notices = (array) $this->get_transients();
+
+ return isset( $transient_notices[ $slug ] )
+ && ! $this->has_user_dismissed( $slug )
+ && ! $this->transient_notice_expired( $slug );
+ }
+
+ /**
+ * Checks whether a transient notice expired or not.
+ *
+ * @since 4.11.1
+ *
+ * @param string|array $slug The slug, or slugs, of the transient notices to check. This is the same slug used
+ * to register the transient notice in the `tribe_transient_notice` function or the
+ * `Tribe__Admin__Notices::register_transient()` method.
+ *
+ * @return bool Whether the transient notice is expired or not.
+ */
+ protected function transient_notice_expired( $slug ) {
+ $transients = (array) $this->get_transients();
+
+ if ( ! isset( $transients[ $slug ] ) ) {
+ return true;
+ }
+
+ list( $html, $args, $expire ) = $transients[ $slug ];
+ if ( $expire < time() ) {
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Checks whether a notice is being shown or not; the result takes the notice callback and dismissible status into
+ * account.
+ *
+ * @since 4.11.1
+ *
+ * @param string|array $slug The slug, or slugs, of the transient notices to check. This is the same slug used
+ * to register the transient notice in the `tribe_transient_notice` function or the
+ * `Tribe__Admin__Notices::register_transient()` method.
+ *
+ * @return bool Whether the notice is showing or not.
+ */
+ public function showing_notice( $slug ) {
+ if ( ! isset( $this->notices[ $slug ] ) ) {
+ return false;
+ }
+
+ $notice = $this->notices[ $slug ];
+ if ( $notice->dismiss && $this->has_user_dismissed( $notice->slug ) ) {
+ return false;
+ }
+
+ if (
+ ! empty( $notice->active_callback )
+ && is_callable( $notice->active_callback )
+ && false == call_user_func( $notice->active_callback )
+ ) {
+ return false;
+ }
+
+ return true;
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Pages.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Pages.php
new file mode 100644
index 000000000..3a05e4f84
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Pages.php
@@ -0,0 +1,309 @@
+
+ */
+ private $pages = [];
+
+ /**
+ * Get registered pages.
+ *
+ * @since 4.15.0
+ *
+ * @return array $pages {
+ * Array containing the registered pages.
+ *
+ * @type array $page_id {
+ * @type string id Id to reference the page.
+ * @type array title Page title. Used in menus and breadcrumbs.
+ * @type string|null parent Parent ID. Null for new top level page.
+ * @type string path Path for this page, full path in app context; ex /analytics/report
+ * @type string capability Capability needed to access the page.
+ * @type string icon Icon. Dashicons helper class, base64-encoded SVG, or 'none'.
+ * @type int position Menu item position.
+ * @type int order Navigation item order.
+ * @type callable callback The function to be called to output the content for the page.
+ * }
+ * }
+ */
+ public function get_pages() {
+ /**
+ * Filters the list of registered TEC admin pages.
+ *
+ * @since 4.15.0
+ *
+ * @param array $pages {
+ * Array containing the registered pages to be filtered
+ *
+ * @type array $page_id {
+ * @type string id Id to reference the page.
+ * @type array title Page title. Used in menus and breadcrumbs.
+ * @type string|null parent Parent ID. Null for new top level page.
+ * @type string path Path for this page, full path in app context; ex /analytics/report
+ * @type string capability Capability needed to access the page.
+ * @type string icon Icon. Dashicons helper class, base64-encoded SVG, or 'none'.
+ * @type int position Menu item position.
+ * @type int order Navigation item order.
+ * @type callable callback The function to be called to output the content for the page.
+ * }
+ * }
+ */
+ $pages = apply_filters( 'tec_admin_pages', $this->pages );
+
+ return $pages;
+ }
+
+ /**
+ * Adds a page to `tec-admin`.
+ *
+ * @since 4.15.0
+ *
+ * @param array $options {
+ * Array describing the page.
+ *
+ * @type string id Id to reference the page.
+ * @type string title Page title. Used in menus and breadcrumbs.
+ * @type string|null parent Parent ID. Null for new top level page.
+ * @type string path Path for this page, full path in app context; ex /analytics/report
+ * @type string capability Capability needed to access the page.
+ * @type string icon Icon. Dashicons helper class, base64-encoded SVG, or 'none'.
+ * @type int position Menu item position.
+ * @type int order Navigation item order.
+ * @type callable callback The function to be called to output the content for the page.
+ * }
+ *
+ * @return string $page The resulting page's hook_suffix.
+ *
+ */
+ public function register_page( $options = [] ) {
+ $defaults = [
+ 'id' => null,
+ 'parent' => null,
+ 'title' => '',
+ 'capability' => self::get_capability(),
+ 'path' => '',
+ 'icon' => '',
+ 'position' => null,
+ 'callback' => [ __CLASS__, 'render_page' ],
+ ];
+
+ $options = wp_parse_args( $options, $defaults );
+
+ if ( is_null( $options['parent'] ) ) {
+ $page = add_menu_page(
+ $options['title'],
+ $options['title'],
+ $options['capability'],
+ $options['path'],
+ $options['callback'],
+ $options['icon'],
+ $options['position']
+ );
+ } else {
+ $page = add_submenu_page(
+ $options['parent'],
+ $options['title'],
+ $options['title'],
+ $options['capability'],
+ $options['path'],
+ $options['callback']
+ );
+ }
+
+ $this->connect_page( $options );
+
+ return $page;
+ }
+
+ /**
+ * Get the current page.
+ *
+ * @since 4.15.0
+ *
+ * @return string|boolean Current page or false if not registered with this controller.
+ */
+ public function get_current_page() {
+ if ( is_null( $this->current_page ) ) {
+ $this->determine_current_page();
+ }
+
+ return $this->current_page;
+ }
+
+ /**
+ * Determine the current page.
+ *
+ * @since 4.15.0
+ *
+ * @return string|boolean Current page or false if not registered with this controller.
+ */
+ public function determine_current_page() {
+ $current_screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
+
+ if ( is_null( $current_screen ) ) {
+ $this->current_page = tribe_get_request_var( 'page' );
+ return $this->current_page;
+ }
+
+ $this->current_page = $current_screen->id;
+
+ return $this->current_page;
+ }
+
+ /**
+ * Connect an existing page to wp-admin.
+ *
+ * @since 4.15.0
+ *
+ * @param array $options {
+ * Array describing the page.
+ *
+ * @type string id Id to reference the page.
+ * @type string|array title Page title. Used in menus and breadcrumbs.
+ * @type string|null parent Parent ID. Null for new top level page.
+ * @type string path Path for this page. E.g. admin.php?page=wc-settings&tab=checkout
+ * @type string capability Capability needed to access the page.
+ * @type string icon Icon. Dashicons helper class, base64-encoded SVG, or 'none'.
+ * @type int position Menu item position.
+ * }
+ */
+ public function connect_page( $options = [] ) {
+ if ( ! is_array( $options['title'] ) ) {
+ $options['title'] = array( $options['title'] );
+ }
+
+ /**
+ * Filter the options when connecting or registering a page.
+ *
+ * @param array $options {
+ * Array describing the page.
+ *
+ * @type string id Id to reference the page.
+ * @type string|array title Page title. Used in menus and breadcrumbs.
+ * @type string|null parent Parent ID. Null for new top level page.
+ * @type string screen_id The screen ID that represents the connected page. (Not required for registering).
+ * @type string path Path for this page. E.g. admin.php?page=wc-settings&tab=checkout
+ * @type string capability Capability needed to access the page.
+ * @type string icon Icon. Dashicons helper class, base64-encoded SVG, or 'none'.
+ * @type int position Menu item position.
+ * @type boolean js_page If this is a JS-powered page.
+ * }
+ */
+ $options = apply_filters( 'tec_admin_pages_connect_page_options', $options );
+
+ $this->pages[ $options['id'] ] = $options;
+ }
+
+ /**
+ * Get the capability.
+ *
+ * @param string $capability The capability required for a TEC page to be displayed to the user.
+ *
+ * @since 4.15.0
+ *
+ * @return string The capability required for a TEC page to be displayed to the user.
+ */
+ public static function get_capability( $capability = 'manage_options' ) {
+ /**
+ * Filters the default capability for Tribe admin pages.
+ *
+ * @param string $capability The capability required for a TEC page to be displayed to the user.
+ *
+ * @todo: We'll need to deprecate this one in favor of the one below.
+ */
+ $capability = apply_filters( 'tribe_common_event_page_capability', $capability );
+
+ /**
+ * Filters the default capability for TEC admin pages.
+ *
+ * @param string $capability The capability required for a TEC page to be displayed to the user.
+ *
+ * @since 4.15.0
+ */
+ $capability = apply_filters( 'tec_admin_pages_capability', $capability );
+
+ return $capability;
+ }
+
+ /**
+ * Define if is a `tec` admin page (registered).
+ *
+ * @since 4.15.0
+ *
+ * @param string $page_id The ID of the page to check if is a `tec` admin page.
+ *
+ * @return boolean True if is a `tec` admin page, false otherwise.
+ */
+ public function is_tec_page( $page_id = '' ) {
+ return in_array( $page_id, array_keys( $this->pages ), true );
+ }
+
+ /**
+ * Get pages with tabs.
+ * @since 4.15.0
+ *
+ * @param array $pages The list of pages with tabs.
+ * @return array $pages The list of pages with tabs, filtered.
+ */
+ public function get_pages_with_tabs( $pages = [] ) {
+ /**
+ * Filters the pages with tabs.
+ *
+ * @param array $pages Pages with tabs.
+ *
+ * @since 4.15.0
+ */
+ return apply_filters(
+ 'tec_admin_pages_with_tabs',
+ $pages
+ );
+ }
+
+ /**
+ * Check if the current page has tabs.
+ *
+ * @since 4.15.0
+ *
+ * @param string $page The page slug.
+ * @return boolean True if the page has tabs, false otherwise.
+ */
+ public function has_tabs( $page = '' ) {
+ if ( empty( $page ) ) {
+ $page = $this->get_current_page();
+ }
+
+ return in_array( $page, $this->get_pages_with_tabs() );
+ }
+
+ /**
+ * Generic page.
+ *
+ * @since 4.15.0
+ */
+ public static function render_page() {
+ ?>
+
+ should_setup_pages() ) {
+ return;
+ }
+
+ $page_title = esc_html__( 'Troubleshooting', 'tribe-common' );
+ $menu_title = esc_html__( 'Troubleshooting', 'tribe-common' );
+
+ $capability = $this->get_required_capability();
+
+ $where = Tribe__Settings::instance()->get_parent_slug();
+
+ $this->admin_page = add_submenu_page(
+ $where,
+ $page_title,
+ $menu_title,
+ $capability,
+ static::MENU_SLUG,
+ [
+ $this,
+ 'do_menu_page',
+ ]
+ );
+ }
+
+ /**
+ * Gets the required capability for the troubleshooting page.
+ *
+ * @since 4.14.2
+ *
+ * @return string Which capability we required for the troubleshooting page.
+ */
+ public function get_required_capability() {
+ /**
+ * Allows third party filtering of capability required to see the Troubleshooting page.
+ *
+ * @since 4.14.2
+ *
+ * @param string $capability Which capability we are using as the one required for the
+ * troubleshooting page.
+ * @param static $troubleshooting The current instance of the class that handles this page.
+ */
+ $capability = apply_filters( 'tec_troubleshooting_capability', 'install_plugins', $this );
+ return $capability;
+ }
+
+ /**
+ * Hooked to admin_body_class to add a class for troubleshooting page.
+ *
+ * @since 4.15.0
+ *
+ * @param string $classes a space separated string of classes to be added to body.
+ *
+ * @return string $classes a space separated string of classes to be added to body.
+ */
+ public function admin_body_class( $classes ) {
+ if ( ! $this->is_current_page() ) {
+ return $classes;
+ }
+
+ $classes .= ' tec-troubleshooting';
+ return $classes;
+ }
+
+ /**
+ * Adds the troubleshooting menu to the the WP admin bar under events.
+ *
+ * @since 4.14.2
+ *
+ */
+ public function add_toolbar_item() {
+ $capability = $this->get_required_capability();
+
+ if ( ! current_user_can( $capability ) ) {
+ return;
+ }
+
+ global $wp_admin_bar;
+
+ $wp_admin_bar->add_menu( [
+ 'id' => 'tec-troubleshooting',
+ 'title' => esc_html__( 'Troubleshooting', 'tribe-common' ),
+ 'href' => Tribe__Settings::instance()->get_url( [ 'page' => static::MENU_SLUG ] ),
+ 'parent' => 'tribe-events-settings-group',
+ ] );
+ }
+
+ /**
+ * Checks if the current page is the troubleshooting page.
+ *
+ * @since 4.14.2
+ *
+ * @return boolean returns true if the current page is the troubleshooting page.
+ */
+ public function is_current_page() {
+ if ( ! Tribe__Settings::instance()->should_setup_pages() || ! did_action( 'admin_menu' ) ) {
+ return false;
+ }
+
+ if ( is_null( $this->admin_page ) ) {
+ _doing_it_wrong(
+ __FUNCTION__,
+ 'Function was called before it is possible to accurately determine what the current page is.',
+ '4.5.6'
+ );
+ return false;
+ }
+
+ global $current_screen;
+
+ $troubleshooting_pages = [
+ 'tribe_events_page_tec-troubleshooting',
+ 'tickets_page_tec-tickets-troubleshooting',
+ ];
+
+ return in_array( $current_screen->id, $troubleshooting_pages );
+ }
+
+ /**
+ * Renders the Troubleshooting page.
+ *
+ * @since 4.14.2
+ *
+ */
+ public function do_menu_page() {
+ tribe_asset_enqueue( 'tribe-admin-help-page' );
+ $main = Tribe__Main::instance();
+ include_once Tribe__Main::instance()->plugin_path . 'src/admin-views/troubleshooting.php';
+ }
+
+ /**
+ * This method checks if there are any active issues that need to be flagged.
+ *
+ * @since 4.14.2
+ *
+ * @return boolean returns true if there are any active issues.
+ */
+ public function is_any_issue_active() {
+ $issues = $this->get_issues_found();
+ $active_issues = wp_list_pluck( $issues, 'active' );
+ return in_array( true, $active_issues );
+ }
+
+ /**
+ * Checks if any active TEC plugins require an update.
+ *
+ * @since 4.14.2
+ *
+ * @return boolean returns true is any of the plugins requires an update.
+ */
+ public function is_any_tec_plugin_out_of_date() {
+ $current = get_site_transient( 'update_plugins' );
+ $plugins = [];
+ if ( defined( 'TRIBE_EVENTS_FILE' ) ) {
+ $plugins[] = TRIBE_EVENTS_FILE;
+ }
+ if ( defined( 'EVENTS_CALENDAR_PRO_FILE' ) ) {
+ $plugins[] = EVENTS_CALENDAR_PRO_FILE;
+ }
+ if ( defined( 'EVENT_TICKETS_PLUS_FILE' ) ) {
+ $plugins[] = EVENT_TICKETS_PLUS_FILE;
+ }
+ if ( defined( 'EVENTS_VIRTUAL_FILE' ) ) {
+ $plugins[] = EVENTS_VIRTUAL_FILE;
+ }
+ if ( defined( 'EVENT_TICKETS_MAIN_PLUGIN_FILE' ) ) {
+ $plugins[] = EVENT_TICKETS_MAIN_PLUGIN_FILE;
+ }
+ if ( defined( 'TRIBE_EVENTS_FILTERBAR_FILE' ) ) {
+ $plugins[] = TRIBE_EVENTS_FILTERBAR_FILE;
+ }
+ if ( defined( 'EVENTS_COMMUNITY_TICKETS_FILE' ) ) {
+ $plugins[] = EVENTS_COMMUNITY_TICKETS_FILE;
+ }
+ if ( defined( 'EVENTS_COMMUNITY_FILE' ) ) {
+ $plugins[] = EVENTS_COMMUNITY_FILE;
+ }
+ if ( defined( 'EVENTBRITE_PLUGIN_FILE' ) ) {
+ $plugins[] = EVENTBRITE_PLUGIN_FILE;
+ }
+ if ( defined( 'TRIBE_APM_FILE' ) ) {
+ $plugins[] = TRIBE_APM_FILE;
+ }
+ if ( defined( 'IMAGE_WIDGET_PLUS_DIR' ) ) {
+ $plugins[] = IMAGE_WIDGET_PLUS_DIR;
+ }
+ $plugins = array_map( static function( $file ) {
+ $file = \str_replace( WP_PLUGIN_DIR . '/', '', $file );
+ return $file;
+ }, $plugins );
+
+ foreach ( $plugins as $file ) {
+ if ( ! isset( $current->response[ $file ] ) ) {
+ continue;
+ }
+ $response = $current->response[ $file ];
+ if ( ! empty( $response->new_version ) ) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ /**
+ * Checks if any of the issues defined are active.
+ *
+ * @since 4.14.2
+ *
+ * @param string $slug the slug of active issue.
+ *
+ * @return boolean returns a boolean value for each individual issue depending on whether it is active or not.
+ */
+ public function is_active_issue( $slug ) {
+ if ( 'timezone' === $slug ) {
+ return Timezones::is_utc_offset( Timezones::wp_timezone_string() );
+ }
+ if ( 'geolocation' === $slug && class_exists( 'Tribe__Events__Google__Maps_API_Key' ) ) {
+ $key = \tribe_get_option( 'google_maps_js_api_key', false );
+ return empty( $key ) || Tribe__Events__Google__Maps_API_Key::$default_api_key === $key ;
+ }
+ if ( 'out-of-date' === $slug ) {
+ return $this->is_any_tec_plugin_out_of_date();
+ }
+ return false;
+ }
+
+ /**
+ * Displays issues found in the UI.
+ *
+ * @since 4.14.2
+ *
+ * @return array of issues which are displayed on the troubleshooting page.
+ */
+ public function get_issues_found() {
+ $issues_found = apply_filters( 'tec_help_troubleshooting_issues_found', [
+ [
+ 'title' => __( 'Site time zone uses UTC', 'tribe-common' ),
+ 'description' => __( 'When using The Events Calendar, we highly recommend that you use a geographic timezone such as "America/Los_Angeles" and avoid using a UTC timezone offset such as “UTC+9”. Choosing a UTC timezone for your site or individual events may cause problems when importing events or with Daylight Saving Time. Go to your the General WordPress settings to adjust your site timezone.', 'tribe-common' ),
+ 'more_info' => 'http://evnt.is/1ad3',
+ 'resolve_text' => __( 'Adjust your timezone', 'tribe-common' ),
+ 'fix' => '/wp-admin/options-general.php',
+ 'active' => $this->is_active_issue( 'timezone' ),
+ ],
+ [
+ 'title' => __( 'Install max has been reached', 'tribe-common' ),
+ 'description' => __( 'License keys can only be used on a limited number of sites, which varies depending on your license level. You\'ll need to remove the license from one or more other site\'s in order to use it on this one.', 'tribe-common' ),
+ 'more_info' => 'https://evnt.is/1aqz',
+ 'resolve_text' => __( 'Manage your licenses', 'tribe-common' ),
+ 'fix' => 'https://evnt.is/1aq-',
+ 'active' => $this->is_active_issue( 'install-max' ),
+ ],
+ [
+ 'title' => __( 'Default Google Maps API key', 'tribe-common' ),
+ 'description' => __( 'The Events Calendar comes with an API key for basic maps functionality. If you’d like to use more advanced features like custom map pins, dynamic map loads, or Events Calendar Pro\'s Location Search and advanced Map View, you’ll need to get your own Google Maps API key and add it to Events > Settings > Integrations', 'tribe-common' ),
+ 'more_info' => 'https://evnt.is/1aqx',
+ 'resolve_text' => __( 'Enter a custom API key', 'tribe-common' ),
+ 'fix' => '/wp-admin/edit.php?page=tec-events-settings&tab=addons&post_type=tribe_events#tribe-field-google_maps_js_api_key',
+ 'active' => $this->is_active_issue( 'geolocation' ),
+ ],
+ [
+ 'title' => __( 'Plugin(s) are out of date', 'tribe-common' ),
+ 'description' => __( 'It\'s important to use the most recent versions of our plugins so that you have access to the latest features, bug fixes, and security updates. Plugin functionality can be comprimised if your site is running outdated or mis-matched versions.', 'tribe-common' ),
+ 'more_info' => 'https://evnt.is/1aqy',
+ 'resolve_text' => __( 'Check for updates', 'tribe-common' ),
+ 'fix' => '/wp-admin/update-core.php',
+ 'active' => $this->is_active_issue( 'out-of-date' ),
+ ],
+ ] );
+
+ return $issues_found;
+ }
+
+ /**
+ * Defines common troubleshooting issues and displays them in the UI.
+ *
+ * @since 4.14.2
+ *
+ * @return array of common issues which are displayed on the troubleshooting page.
+ */
+ public function get_common_issues() {
+ $common_issues = apply_filters( 'tec_help_troubleshooting_issues', [
+ [
+ 'issue' => __( 'Common Error Messages', 'tribe-common' ),
+ 'solution' => __( 'Here’s an overview of %s and what they mean.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1as0',
+ 'link_label' => 'common error messages',
+ ],
+ [
+ 'issue' => __( 'My calendar doesn’t look right.', 'tribe-common' ),
+ 'solution' => __( 'This can happen when other plugins try to improve performance. %s.' ),
+ 'link' => 'https://theeventscalendar.com/knowledgebase/k/troubleshooting-the-most-common-installation-issues/#layout-issue',
+ 'link_label' => 'More info',
+ ],
+ [
+ 'issue' => __( 'I installed the calendar and it crashed my site.', 'tribe-common' ),
+ 'solution' => __( '%s and other common installation issues.', 'tribe-common' ),
+ 'link' => 'https://theeventscalendar.com/knowledgebase/k/troubleshooting-the-most-common-installation-issues/#fatal-errors',
+ 'link_label' => 'Find solutions to this',
+ ],
+ [
+ 'issue' => __( 'I keep getting “Page Not Found” on events.', 'tribe-common' ),
+ 'solution' => __( 'There are a few %s to resolve and prevent 404 errors.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1as2',
+ 'link_label' => 'things you can do',
+ ],
+ ] );
+
+ return $common_issues;
+ }
+
+ /**
+ * Fired to display notices in the admin pages where the method is called.
+ *
+ * @since 4.14.2
+ *
+ * @param string $page the page which the action is being applied.
+ *
+ */
+ public function admin_notice( $page ) {
+ do_action( 'tec_admin_notice_area', $page );
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Upsell_Notice/Main.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Upsell_Notice/Main.php
new file mode 100644
index 000000000..5f220d0e5
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Upsell_Notice/Main.php
@@ -0,0 +1,97 @@
+template = new \Tribe__Template();
+ $this->template->set_template_origin( \Tribe__Main::instance() );
+ $this->template->set_template_folder( 'src/admin-views/notices/upsell' );
+ $this->template->set_template_context_extract( true );
+ $this->template->set_template_folder_lookup( false );
+ }
+
+ return $this->template;
+ }
+
+ /**
+ * Checks if upsell should be rendered.
+ *
+ * @since 4.14.17
+ *
+ * @return boolean
+ */
+ private function should_render() {
+ if ( function_exists( 'tec_should_hide_upsell' ) ) {
+ return ! tec_should_hide_upsell();
+ }
+ if ( defined( 'TRIBE_HIDE_UPSELL' ) ) {
+ return ! tribe_is_truthy( TRIBE_HIDE_UPSELL );
+ }
+ return true;
+ }
+
+ /**
+ * Render upsell notice.
+ *
+ * @since 4.14.17
+ *
+ * @param array $args Array of arguments that will ultimately be sent to the template.
+ * @param bool $echo Whether or not to echo the HTML. Defaults to true.
+ *
+ * @return string HTML of upsell notice.
+ */
+ public function render( $args, $echo = true ) {
+ // Check if upsell should be rendered.
+ if ( ! $this->should_render() ) {
+ return;
+ }
+
+ // Default args for the container.
+ $args = wp_parse_args( $args, [
+ 'classes' => [],
+ 'text' => '',
+ 'link_target' => '_blank',
+ 'icon_url' => tribe_resource_url( 'images/icons/circle-bolt.svg', false, null, \Tribe__Main::instance() ),
+ 'link' => [],
+ ] );
+
+ // Default args for the link.
+ $args['link'] = wp_parse_args( $args['link'], [
+ 'classes' => [],
+ 'text' => '',
+ 'url' => '',
+ 'target' => '_blank',
+ 'rel' => 'noopener noreferrer',
+ ] );
+
+ $template = $this->get_template();
+ return $template->template( 'main', $args, $echo );
+ }
+}
\ No newline at end of file
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Upsell_Notice/README.md b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Upsell_Notice/README.md
new file mode 100644
index 000000000..aa0b1012e
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Upsell_Notice/README.md
@@ -0,0 +1,65 @@
+# Upsell Notices
+
+To add an upsell notice, use the following code:
+
+```
+tribe( \Tribe\Admin\Upsell_Notice\Main::class )->render( [
+ 'text' => 'Text to explain what you are promoting.',
+ 'link' => [
+ 'text' => 'Text for the link.',
+ 'url' => 'https://url.com/to/more/info',
+ ],
+] );
+```
+
+## Customizing the notice container
+
+There are a couple of classes you can add that will display the upsell notice with different styles.
+
+- `.tec-admin__upsell--rounded-corners` - Adds a rounded-corner, light gray background around the entire notice.
+- `.tec-admin__upsell--rounded-corners-text` - Adds a rounded-corner, light gray background around the notice text, only.
+
+Example:
+```
+tribe( \Tribe\Admin\Upsell_Notice\Main::class )->render( [
+ 'classes' => [
+ 'tec-admin__upsell--rounded-corners'
+ ],
+ 'text' => 'Text to explain what you are promoting.',
+ 'link' => [
+ 'text' => 'Text for the link.',
+ 'url' => 'https://url.com/to/more/info',
+ ],
+] );
+```
+
+## Customizing the notice link
+
+Likewise, you can also add these classes to the link array to change the appearance.
+
+- `.tec-admin__upsell-link--dark` - Changes the color to a dark color, instead of the default blue.
+- `.tec-admin__upsell-link--underlined` - Adds an underline to the link text.
+
+You can also change the following attributes of the link:
+
+- `target` - Default is '_blank'.
+- `rel` - Default is 'nofollow noreferrer'.
+
+Example:
+```
+tribe( \Tribe\Admin\Upsell_Notice\Main::class )->render( [
+ 'classes' => [
+ 'tec-admin__upsell--rounded-corners-text'
+ ],
+ 'text' => 'Text to explain what you are promoting.',
+ 'link' => [
+ 'classes' => [
+ 'tec-admin__upsell-link--dark',
+ 'tec-admin__upsell-link--underlined',
+ ],
+ 'text' => 'Text for the link.',
+ 'url' => 'https://url.com/to/more/info',
+ 'target' => '_parent'
+ ],
+] );
+```
\ No newline at end of file
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Wysiwyg.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Wysiwyg.php
new file mode 100644
index 000000000..f2395e0cc
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Admin/Wysiwyg.php
@@ -0,0 +1,143 @@
+name = $name;
+ $this->value = $value;
+ $default_args = [
+ 'teeny' => true,
+ 'wpautop' => true,
+ 'textarea_name' => $name,
+ ];
+ $this->args = wp_parse_args( $args, $default_args );
+ }
+
+ /**
+ * Filters editor buttons.
+ *
+ * @since 5.0.12
+ *
+ * @param array $buttons Array of buttons to include.
+ *
+ * @return array Filtered array of buttons.
+ */
+ public function filter_buttons( $buttons ) {
+ if (
+ empty( $this->args )
+ || ! isset( $this->args['buttons'] )
+ || empty( $this->args['buttons'] )
+ ) {
+ return $buttons;
+ }
+
+ return $this->args['buttons'];
+ }
+
+ /**
+ * Filter 2nd row of buttons.
+ *
+ * @since 5.0.12
+ *
+ * @param array $buttons Array of buttons to include.
+ *
+ * @return array Filtered array of buttons.
+ */
+ public function maybe_filter_buttons_2( $buttons ) {
+ if (
+ empty( $this->args ) ||
+ ! isset( $this->args['buttons_2'] ) ||
+ empty( $this->args['buttons_2'] )
+ ) {
+ return $buttons;
+ }
+
+ return $this->args['buttons_2'];
+ }
+
+ /**
+ * Get HTML of editor.
+ *
+ * @since 5.0.12
+ *
+ * @return string HTML of editor
+ */
+ public function get_html() {
+ // Add button filters.
+ add_filter( 'teeny_mce_buttons', [ $this, 'filter_buttons' ] );
+ add_filter( 'tiny_mce_buttons', [ $this, 'filter_buttons' ] );
+ add_filter( 'mce_buttons', [ $this, 'filter_buttons' ] );
+ add_filter( 'mce_buttons_2', [ $this, 'maybe_filter_buttons_2' ] );
+
+ // Get HTML of editor.
+ ob_start();
+ wp_editor( html_entity_decode( ( $this->value ) ), sanitize_html_class( $this->name ), $this->args );
+ $html = ob_get_clean();
+
+ // Remove button filters.
+ remove_filter( 'teeny_mce_buttons', [ $this, 'filter_buttons' ] );
+ remove_filter( 'tiny_mce_buttons', [ $this, 'filter_buttons' ] );
+ remove_filter( 'mce_buttons', [ $this, 'filter_buttons' ] );
+ remove_filter( 'mce_buttons_2', [ $this, 'maybe_filter_buttons_2' ] );
+
+ return $html;
+ }
+
+ /**
+ * Renders editor HTML.
+ *
+ * @since 5.0.12
+ *
+ * @return void
+ */
+ public function render_html() {
+ echo $this->get_html();
+ }
+
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Ajax/Dropdown.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Ajax/Dropdown.php
new file mode 100644
index 000000000..071d977cf
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Ajax/Dropdown.php
@@ -0,0 +1,340 @@
+ $search Search string from Select2
+ * @param int $page When we deal with pagination
+ * @param array $args Which arguments we got from the Template
+ * @param string $source What source it is
+ *
+ * @return array
+ */
+ public function search_terms( $search, $page, $args, $source ) {
+ $data = [];
+
+ if ( empty( $args['taxonomy'] ) ) {
+ $this->error( esc_attr__( 'Cannot look for Terms without a taxonomy', 'tribe-common' ) );
+ }
+
+ // We always want all the fields so we overwrite it
+ $args['fields'] = isset( $args['fields'] ) ? $args['fields'] : 'all';
+ $args['hide_empty'] = isset( $args['hide_empty'] ) ? $args['hide_empty'] : false;
+
+ if ( ! empty( $search ) ) {
+ if ( ! is_array( $search ) ) {
+ // For older pieces that still use Select2 format.
+ $args['search'] = $search;
+ } else {
+ // Newer SelectWoo uses a new search format.
+ $args['search'] = $search['term'];
+ }
+ }
+
+ // On versions older than 4.5 taxonomy goes as an Param
+ if ( version_compare( $GLOBALS['wp_version'], '4.5', '<' ) ) {
+ $terms = get_terms( $args['taxonomy'], $args );
+ } else {
+ $terms = get_terms( $args );
+ }
+
+ $results = [];
+
+ // Respect the parent/child_of argument if set
+ $parent = ! empty( $args['child_of'] ) ? (int) $args['child_of'] : 0;
+ $parent = ! empty( $args['parent'] ) ? (int) $args['parent'] : $parent;
+
+ if ( empty( $args['search'] ) ) {
+ $this->sort_terms_hierarchically( $terms, $results, $parent );
+ $results = $this->convert_children_to_array( $results );
+ } else {
+ foreach ( $terms as $term ) {
+ // Prep for Select2
+ $term->id = $term->term_id;
+ $term->text = $term->name;
+ $term->breadcrumbs = [];
+
+ if ( 0 !== (int) $term->parent ) {
+ $ancestors = get_ancestors( $term->id, $term->taxonomy );
+ $ancestors = array_reverse( $ancestors );
+ foreach ( $ancestors as $ancestor ) {
+ $ancestor = get_term( $ancestor );
+ $term->breadcrumbs[] = $ancestor->name;
+ }
+ }
+
+ $results[] = $term;
+ }
+ }
+
+ foreach ( $results as $result ) {
+ $result->text = wp_specialchars_decode( wp_kses( $result->text, [] ) );
+ }
+
+ $data['results'] = $results;
+ $data['taxonomies'] = get_taxonomies();
+
+ return $data;
+ }
+
+ /**
+ * Search for Posts using Select2
+ *
+ * @since 4.12.17
+ *
+ * @param string|array $search Search string from Select2.
+ * @param int $page Page we want when we're dealing with pagination.
+ * @param array $args Arguments to pass to the query.
+ * @param string|int $selected Selected item ID.
+ *
+ * @return array An Array of results.
+ */
+ public function search_posts( $search, $page = 1, $args = [], $selected = null ) {
+ if ( ! empty( $search ) ) {
+ if ( is_array( $search ) ) {
+ // Newer SelectWoo uses a new search format.
+ $args['s'] = $search['term']; // post?
+ } else {
+ // For older pieces that still use Select2 format.
+ $args['s'] = $search;
+ }
+ }
+
+ $args['paged'] = $page;
+ $args['update_post_meta_cache'] = false;
+ $args['update_post_term_cache'] = false;
+
+ $results = new WP_Query( $args );
+ $has_pagination = $results->post_count < $results->found_posts;
+
+ return $this->format_posts_for_dropdown( $results->posts, $selected, $has_pagination );
+ }
+
+ /**
+ * Formats a given array of posts to be displayed into the Dropdown.js module with SelectWoo.
+ *
+ * @since 4.12.17
+ *
+ * @param array $posts
+ * @param null|int $selected
+ * @param boolean $pagination
+ *
+ * @return array
+ */
+ public function format_posts_for_dropdown( array $posts, $selected = null, $pagination = false ) {
+ $data = [
+ 'posts' => [],
+ 'pagination' => $pagination,
+ ];
+
+ // Skip when we don't have posts
+ if ( empty( $posts ) ) {
+ return $data;
+ }
+
+ foreach ( $posts as $post ) {
+ if ( ! $post instanceof \WP_Post ) {
+ $post = get_post( $post );
+ }
+
+ // Skip non WP Post Objects.
+ if ( ! $post instanceof \WP_Post ) {
+ continue;
+ }
+
+ // Prep for Select2.
+ $data['posts'][] = [
+ 'id' => $post->ID,
+ 'text' => ! empty( $post->post_title_formatted ) ? $post->post_title_formatted : $post->post_title,
+ 'selected' => ! empty( $selected ) && (int) $post->ID === (int) $selected,
+ ];
+ }
+
+ return $data;
+ }
+
+ /**
+ * Sorts all the Terms for Select2 hierarchically.
+ *
+ * @since 4.6
+ *
+ * @param array &$terms Array of Terms from `get_terms`.
+ * @param array &$into Variable where we will store the.
+ * @param integer $parent Used for the recursion.
+ *
+ * @return array
+ */
+ public function sort_terms_hierarchically( &$terms, &$into, $parent = 0 ) {
+ foreach ( $terms as $i => $term ) {
+ if ( $term->parent === $parent ) {
+ // Prep for Select2
+ $term->id = $term->term_id;
+ $term->text = $term->name;
+
+ $into[ $term->term_id ] = $term;
+ unset( $terms[ $i ] );
+ }
+ }
+
+ foreach ( $into as $term ) {
+ $term->children = [];
+ $this->sort_terms_hierarchically( $terms, $term->children, $term->term_id );
+ }
+ }
+
+ /**
+ * Makes sure we have arrays for the JS data for Select2
+ *
+ * @since 4.6
+ *
+ * @param object|array $results The Select2 results
+ *
+ * @return array
+ */
+ public function convert_children_to_array( $results ) {
+ if ( isset( $results->children ) ) {
+ $results->children = $this->convert_children_to_array( $results->children );
+ if ( empty( $results->children ) ) {
+ unset( $results->children );
+ }
+ } else {
+ foreach ( $results as $key => $item ) {
+ $item = $this->convert_children_to_array( $item );
+ }
+ }
+
+ if ( empty( $results ) ) {
+ return [];
+ }
+
+ return array_values( (array) $results );
+ }
+
+ /**
+ * Parses the Params coming from Select2 Search box
+ *
+ * @since 4.6
+ *
+ * @param array $params Params to overwrite the defaults
+ *
+ * @return object
+ */
+ public function parse_params( $params ) {
+ $defaults = [
+ 'search' => null,
+ 'page' => 0,
+ 'args' => [],
+ 'source' => null,
+ ];
+
+ $arguments = wp_parse_args( $params, $defaults );
+
+ // Return Object just for the sake of making it simpler to read
+ return (object) $arguments;
+ }
+
+ /**
+ * The default Method that will route all the AJAX calls from our Dropdown AJAX requests
+ * It is like a Catch All on `wp_ajax_tribe_dropdown` and `wp_ajax_nopriv_tribe_dropdown`
+ *
+ * @since 4.6
+ *
+ * @return void
+ */
+ public function route() {
+ // Push all POST params into a Default set of data
+ $args = $this->parse_params( empty( $_POST ) ? [] : $_POST );
+
+ if ( empty( $args->source ) ) {
+ $this->error( esc_attr__( 'Missing data source for this dropdown', 'tribe-common' ) );
+ }
+
+ // Define a Filter to allow external calls to our Select2 Dropdowns.
+ $filter = sanitize_key( 'tribe_dropdown_' . $args->source );
+ if ( has_filter( $filter ) ) {
+ $data = apply_filters( $filter, [], $args->search, $args->page, $args->args, $args->source );
+ } else {
+ $data = call_user_func_array( [ $this, $args->source ], array_values( (array) $args ) );
+ }
+
+ // If we've got a empty dataset we return an error.
+ if ( empty( $data ) ) {
+ $this->error( esc_attr__( 'Empty data set for this dropdown', 'tribe-common' ) );
+ } else {
+ $this->success( $data );
+ }
+ }
+
+ /**
+ * Prints a success message and ensures that we don't hit bugs on Select2
+ *
+ * @since 4.6
+ *
+ * @param array $data
+ *
+ * @return void
+ */
+ private function success( $data ) {
+ // We need a Results item for Select2 Work
+ if ( ! isset( $data['results'] ) ) {
+ $data['results'] = [];
+ }
+
+ wp_send_json_success( $data );
+ }
+
+ /**
+ * Prints an error message and ensures that we don't hit bugs on Select2
+ *
+ * @since 4.6
+ *
+ * @param string $message
+ *
+ * @return void
+ */
+ private function error( $message ) {
+ $data = [
+ 'message' => $message,
+ 'results' => [],
+ ];
+
+ wp_send_json_error( $data );
+ }
+
+ /**
+ * Avoid throwing fatals or notices on sources that are invalid
+ *
+ * @since 4.6
+ *
+ * @param string $name
+ * @param mixed $arguments
+ *
+ * @return void
+ */
+ public function __call( $name, $arguments ) {
+ $message = __( 'The "%s" source is invalid and cannot be reached on "%s" instance.', 'tribe-common' );
+
+ return $this->error( sprintf( $message, $name, __CLASS__ ) );
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Ajax/Operations.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Ajax/Operations.php
new file mode 100644
index 000000000..09b54ae99
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Ajax/Operations.php
@@ -0,0 +1,22 @@
+register_assets();
+ }
+
+ /**
+ * Adds the page to the admin menu
+ */
+ public function add_menu_page() {
+ if ( ! Tribe__Settings::instance()->should_setup_pages() ) {
+ return;
+ }
+
+ $page_title = esc_html__( 'Event Add-Ons', 'tribe-common' );
+ $menu_title = esc_html__( 'Event Add-Ons', 'tribe-common' );
+ $capability = apply_filters( 'tribe_events_addon_page_capability', 'install_plugins' );
+
+ $where = Tribe__Settings::instance()->get_parent_slug();
+
+ $this->admin_page = add_submenu_page(
+ $where,
+ $page_title,
+ $menu_title,
+ $capability,
+ self::MENU_SLUG,
+ [
+ $this,
+ 'do_menu_page',
+ ]
+ );
+ }
+
+ /**
+ * Adds a link to the shop app to the WP admin bar
+ */
+ public function add_toolbar_item() {
+
+ $capability = apply_filters( 'tribe_events_addon_page_capability', 'install_plugins' );
+
+ // prevent users who cannot install plugins from seeing addons link
+ if ( current_user_can( $capability ) ) {
+ global $wp_admin_bar;
+
+ $wp_admin_bar->add_menu( [
+ 'id' => 'tribe-events-app-shop',
+ 'title' => esc_html__( 'Event Add-Ons', 'tribe-common' ),
+ 'href' => Tribe__Settings::instance()->get_url( [ 'page' => self::MENU_SLUG ] ),
+ 'parent' => 'tribe-events-settings-group',
+ ] );
+ }
+ }
+
+ /**
+ * Registers the plugin assets
+ */
+ protected function register_assets() {
+ tribe_assets(
+ Tribe__Main::instance(),
+ [
+ [ 'tribe-app-shop-css', 'app-shop.css' ],
+ [ 'tribe-app-shop-js', 'app-shop.js', [ 'jquery' ] ],
+ ],
+ 'admin_enqueue_scripts',
+ [
+ 'conditionals' => [ $this, 'is_current_page' ],
+ ]
+ );
+ }
+
+ /**
+ * Checks if the current page is the app shop
+ *
+ * @since 4.5.7
+ *
+ * @return bool
+ */
+ public function is_current_page() {
+ if ( ! Tribe__Settings::instance()->should_setup_pages() || ! did_action( 'admin_menu' ) ) {
+ return false;
+ }
+
+ if ( is_null( $this->admin_page ) ) {
+ _doing_it_wrong(
+ __FUNCTION__,
+ 'Function was called before it is possible to accurately determine what the current page is.',
+ '4.5.6'
+ );
+ return false;
+ }
+
+ return Tribe__Admin__Helpers::instance()->is_screen( $this->admin_page );
+ }
+
+ /**
+ * Renders the Shop App page
+ */
+ public function do_menu_page() {
+ $main = Tribe__Main::instance();
+ $products = $this->get_all_products();
+ $bundles = $this->get_bundles();
+ $extensions = $this->get_extensions();
+ $stellar_brands = $this->get_stellar_brands();
+ include_once Tribe__Main::instance()->plugin_path . 'src/admin-views/app-shop.php';
+ }
+
+ /**
+ * Gets all products from the API
+ *
+ * @return array|WP_Error
+ */
+ private function get_all_products() {
+ $all_products = tribe( 'plugins.api' )->get_products();
+
+ $products = [
+ 'the-events-calendar' => (object) $all_products['the-events-calendar'],
+ 'events-calendar-pro' => (object) $all_products['events-calendar-pro'],
+ 'events-virtual' => (object) $all_products['events-virtual'],
+ 'event-aggregator' => (object) $all_products['event-aggregator'],
+ 'event-automator' => (object) $all_products['event-automator'],
+ 'event-tickets' => (object) $all_products['event-tickets'],
+ 'event-tickets-plus' => (object) $all_products['event-tickets-plus'],
+ 'promoter' => (object) $all_products['promoter'],
+ 'tribe-filterbar' => (object) $all_products['tribe-filterbar'],
+ 'events-community' => (object) $all_products['events-community'],
+ 'events-community-tickets' => (object) $all_products['events-community-tickets'],
+ 'tribe-eventbrite' => (object) $all_products['tribe-eventbrite'],
+ 'image-widget-plus' => (object) $all_products['image-widget-plus'],
+ ];
+
+ return $products;
+ }
+
+ /**
+ * Gets product bundles
+ *
+ * @return array|WP_Error
+ */
+ private function get_bundles() {
+ $bundles = [
+ (object) [
+ 'title' => __( 'Events Marketing Bundle', 'tribe-common' ),
+ 'logo' => 'images/logo/bundle-event-marketing.svg',
+ 'link' => 'https://evnt.is/1aj3',
+ 'discount' => __( 'Save over 20%', 'tribe-common' ),
+ 'description' => __( 'Ticket sales, attendee management, and email marketing for your events', 'tribe-common' ),
+ 'includes' => [
+ 'events-calendar-pro',
+ 'event-tickets-plus',
+ 'promoter',
+ ],
+ ],
+ (object) [
+ 'title' => __( 'Event Importer Bundle', 'tribe-common' ),
+ 'logo' => 'images/logo/bundle-event-importer.svg',
+ 'link' => 'https://evnt.is/1aj2',
+ 'discount' => __( 'Save over 25%', 'tribe-common' ),
+ 'description' => __( 'Fill your calendar with events from across the web, including Google Calendar, Meetup, and more.', 'tribe-common' ),
+ 'includes' => [
+ 'events-calendar-pro',
+ 'tribe-filterbar',
+ 'event-aggregator'
+ ],
+ ],
+ (object) [
+ 'title' => __( 'Virtual Events Marketing Bundle', 'tribe-common' ),
+ 'logo' => 'images/logo/bundle-virtual-events.svg',
+ 'link' => 'http://evnt.is/ve-bundle',
+ 'discount' => __( 'Save over 20%', 'tribe-common' ),
+ 'description' => __( 'Streamline your online events and increase revenue.', 'tribe-common' ),
+ 'includes' => [
+ 'events-calendar-pro',
+ 'event-tickets-plus',
+ 'events-virtual',
+ 'promoter',
+ ],
+ 'features' => [
+ __( 'Sell tickets and earn revenue for online events', 'tribe-common' ),
+ __( 'Zoom integration', 'tribe-common' ),
+ __( 'Automated emails optimized for virtual events', 'tribe-common' ),
+ __( 'Add recurring events', 'tribe-common' ),
+ ],
+ ],
+ (object) [
+ 'title' => __( 'Community Manager Bundle', 'tribe-common' ),
+ 'logo' => 'images/logo/bundle-community-manager.svg',
+ 'link' => 'https://evnt.is/1aj4',
+ 'discount' => __( 'Save over 20%', 'tribe-common' ), /* code review: fix this */
+ 'description' => __( 'Handle event submissions with ticket sales and everything you need to build a robust community.', 'tribe-common' ),
+ 'includes' => [
+ 'event-tickets-plus',
+ 'events-community',
+ 'events-community-tickets',
+ 'tribe-filterbar',
+ ],
+ ],
+ (object) [
+ 'title' => __( 'Ultimate Bundle', 'tribe-common' ),
+ 'logo' => 'images/logo/bundle-ultimate.svg',
+ 'link' => 'https://evnt.is/1aj5',
+ 'discount' => __( 'Save over 20%', 'tribe-common' ), /* code review: fix this */
+ 'description' => __( 'All of our premium events management plugins at a deep discount.', 'tribe-common' ),
+ 'includes' => [
+ 'events-calendar-pro',
+ 'event-tickets-plus',
+ //'events-virtual', // not yet added to the bundle
+ 'events-community',
+ 'events-community-tickets',
+ 'tribe-filterbar',
+ 'event-aggregator',
+ 'tribe-eventbrite',
+ //'promoter', // not yet added to the bundle
+ ],
+ ],
+
+ ];
+
+ return $bundles;
+ }
+
+ /**
+ * Gets product extensions
+ *
+ * @return array|WP_Error
+ */
+ private function get_extensions() {
+ $extensions = [
+ (object) [
+ 'title' => __( 'Website URL CTA', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1aj6',
+ 'image' => 'images/shop/extension-web-url-cta.jpg',
+ 'description' => __( 'Create a strong call-to-action for attendees to "Join Webinar" instead of only sharing a website address.', 'tribe-common' ),
+ ],
+ (object) [
+ 'title' => __( 'Link Directly to Webinar', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1aj7',
+ 'image' => 'images/shop/extension-link-to-webinar.jpg',
+ 'description' => __( 'When users click on the event title, they’ll be taken right to the source of your event, offering a direct route to join.', 'tribe-common' ),
+ ],
+ (object) [
+ 'title' => __( 'Events Happening Now', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1aj8',
+ 'image' => 'images/shop/extension-events-happening-now.jpg',
+ 'description' => __( 'Use this shortcode to display events that are currently in progress, like webinars and livestreams.', 'tribe-common' ),
+ ],
+ (object) [
+ 'title' => __( 'Custom Venue Links', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1aj9',
+ 'image' => 'images/shop/extension-custom-venue-links.jpg',
+ 'description' => __( 'Turn the venue name for your event into a clickable URL — a great way to link directly to a venue’s website or a virtual meeting.', 'tribe-common' ),
+ ],
+ (object) [
+ 'title' => __( 'Adjust Label', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1aja',
+ 'image' => 'images/shop/extension-change-label.jpg',
+ 'description' => __( 'Change "Events" to "Webinars," or "Venues" to "Livestream," or "Organizers" to "Hosts." Tailor your calendar for virtual events and meetings.', 'tribe-common' ),
+ ],
+ (object) [
+ 'title' => __( 'Reach Attendees', 'tribe-common' ),
+ 'link' => 'https://evnt.is/1ajc',
+ 'image' => 'images/shop/extension-advanced-options.jpg',
+ 'description' => __( 'From registration to attendance history, view every step of the event lifecycle with this HubSpot integration.', 'tribe-common' ),
+ ],
+ ];
+
+ return $extensions;
+ }
+
+ /**
+ * Gets Stellar brands
+ *
+ * @return array|WP_Error
+ */
+ private function get_stellar_brands() {
+ $stellar_brands = [
+ (object) [
+ 'image' => 'images/shop/stellar-learndash-cta.jpg',
+ 'logo' => 'images/shop/stellar-learndash-logo.png',
+ 'title' => __( 'The online course platform created by e-learning experts.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/learndash',
+ 'linktext' => __( 'Add Courses', 'tribe-common' ),
+ 'description' => __( 'Trusted to power learning programs for major universities, startups, entrepreneurs, and bloggers worldwide.', 'tribe-common' ),
+ ],
+ (object) [
+ 'image' => 'images/shop/stellar-ithemes-cta.jpg',
+ 'logo' => 'images/shop/stellar-ithemes-logo.png',
+ 'title' => __( 'Foundational favorites: iThemes Security and Developer Toolkit.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/ithemes',
+ 'linktext' => __( 'Add Security', 'tribe-common' ),
+ 'description' => __( 'iThemes Security, the WordPress security plugin that’s easy to use. Built with performance in mind.', 'tribe-common' ),
+ ],
+ (object) [
+ 'image' => 'images/shop/stellar-rcp-cta.jpg',
+ 'logo' => 'images/shop/stellar-rcp-logo.png',
+ 'title' => __( 'Built with developers in mind.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/rcp',
+ 'linktext' => __( 'Add Content Restriction', 'tribe-common' ),
+ 'description' => __( 'Restrict Content Pro is flexible, easy to extend, and chock full of action hooks and filters, making it easy to modify and tweak to your specific needs.', 'tribe-common' ),
+ ],
+ (object) [
+ 'image' => 'images/shop/stellar-kadence-cta.jpg',
+ 'logo' => 'images/shop/stellar-kadence-logo.png',
+ 'title' => __( 'Build better WordPress websites with Kadence.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/kadencewp',
+ 'linktext' => __( 'Add Starter Templates', 'tribe-common' ),
+ 'description' => __( 'Kadence lets you unlock your creativity in the WordPress Block Editor with expertly designed blocks, a robust theme, and a massive library of starter templates.', 'tribe-common' ),
+ ],
+ (object) [
+ 'image' => 'images/shop/stellar-iconic-cta.jpg',
+ 'logo' => 'images/shop/stellar-iconic-logo.png',
+ 'title' => __( 'Sales-boosting WooCommerce plugins.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/iconic',
+ 'linktext' => __( 'Add Commerce Tools', 'tribe-common' ),
+ 'description' => __( 'Easy-to-use WooCommerce plugins work perfectly together, with any theme. Create a fast and profitable eCommerce store without any technical knowledge.
+ ', 'tribe-common' ),
+ ],
+ (object) [
+ 'image' => 'images/shop/stellar-give-cta.jpg',
+ 'logo' => 'images/shop/stellar-give-logo.png',
+ 'title' => __( 'The best WordPress donation plugin.', 'tribe-common' ),
+ 'link' => 'https://evnt.is/givewp',
+ 'linktext' => __( 'Add Donations', 'tribe-common' ),
+ 'description' => __( 'GiveWP makes it easy to raise money online with donation forms, donor databases, and fundraising reporting.', 'tribe-common' ),
+ ],
+ ];
+
+ return $stellar_brands;
+ }
+
+ /**
+ * Static Singleton Factory Method
+ *
+ * @return Tribe__App_Shop
+ */
+ public static function instance() {
+ if ( ! isset( self::$instance ) ) {
+ $className = __CLASS__;
+ self::$instance = new $className;
+ }
+
+ return self::$instance;
+ }
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Asset/Data.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Asset/Data.php
new file mode 100644
index 000000000..2dd995734
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Asset/Data.php
@@ -0,0 +1,67 @@
+objects[ $object_name ] = $data;
+ }
+
+ /**
+ * Outputs the
+ * @internal
+ */
+ public function render_json() {
+ if ( empty( $this->objects ) ) {
+ return;
+ }
+
+ echo '';
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Asset/Factory.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Asset/Factory.php
new file mode 100644
index 000000000..fee20c577
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Asset/Factory.php
@@ -0,0 +1,56 @@
+get_asset_class_name( $name );
+
+ // `Jquery_Resize` to `Tribe__Asset__Jquery_Resize`
+ $full_class_name = $this->get_asset_full_class_name( $class_name );
+
+ return class_exists( $full_class_name ) ? new $full_class_name() : false;
+ }
+
+ protected function get_asset_class_name( $name ) {
+ // `jquery-resize` to `Jquery_Resize`
+ $class_name = str_replace( ' ', '_', ucwords( str_replace( '-', ' ', $name ) ) );
+
+ return $class_name;
+ }
+
+ /**
+ * @param string $class_name
+ *
+ * @return string
+ */
+ private function get_asset_full_class_name( $class_name ) {
+ // `Jquery_Resize` to `Tribe__Asset__Jquery_Resize`
+ $full_class_name = $this->get_asset_class_name_prefix() . $class_name;
+
+ return $full_class_name;
+ }
+
+ /**
+ * @return string
+ */
+ protected function get_asset_class_name_prefix() {
+ return 'Tribe__Asset__';
+ }
+
+ /**
+ * @return Tribe__Asset__Factory
+ */
+ public static function instance() {
+ static $instance;
+
+ if ( ! $instance ) {
+ $instance = new self;
+ }
+
+ return $instance;
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Assets.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Assets.php
new file mode 100644
index 000000000..a9cb962b8
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Assets.php
@@ -0,0 +1,949 @@
+get( $handle ) ) {
+ return (string) $tag;
+ }
+
+ // Bail when not dealing with JS assets.
+ if ( 'js' !== $asset->type ) {
+ return (string) $tag;
+ }
+
+ // Only go forward if there is any print before or after.
+ if ( empty( $asset->print_before ) && empty( $asset->print_after ) ) {
+ return (string) $tag;
+ }
+
+ $before = '';
+ if ( ! empty( $asset->print_before ) ) {
+ $before = (string) ( is_callable( $asset->print_before ) ? call_user_func( $asset->print_before, $asset ) : $asset->print_before );
+ }
+
+ $after = '';
+ if ( ! empty( $asset->print_after ) ) {
+ $after = (string) ( is_callable( $asset->print_after ) ? call_user_func( $asset->print_after, $asset ) : $asset->print_after );
+ }
+
+ $tag = $before . (string) $tag . $after;
+
+ return $tag;
+ }
+
+ /**
+ * Handles adding localization data, when attached to `script_loader_tag` which allows dependencies to load in their
+ * localization data as well.
+ *
+ * @since 4.13.0
+ *
+ * @param string $tag Tag we are filtering.
+ * @param string $handle Which is the ID/Handle of the tag we are about to print.
+ *
+ * @return string Script tag with the localization variable HTML attached to it.
+ */
+ public function filter_add_localization_data( $tag, $handle ) {
+ // Only filter for own filters.
+ if ( ! $asset = $this->get( $handle ) ) {
+ return $tag;
+ }
+
+ // Bail when not dealing with JS assets.
+ if ( 'js' !== $asset->type ) {
+ return $tag;
+ }
+
+ // Only localize on JS and if we have data.
+ if ( empty( $asset->localize ) ) {
+ return $tag;
+ }
+
+ global $wp_scripts;
+
+ // Makes sure we have an Array of Localize data.
+ if ( is_object( $asset->localize ) ) {
+ $localization = [ $asset->localize ];
+ } else {
+ $localization = (array) $asset->localize;
+ }
+
+ /**
+ * Check to ensure we haven't already localized it before.
+ *
+ * @since 4.5.8
+ */
+ foreach ( $localization as $localize ) {
+ if ( in_array( $localize->name, $this->localized ) ) {
+ continue;
+ }
+
+ // If we have a Callable as the Localize data we execute it.
+ if ( is_callable( $localize->data ) ) {
+ $localize->data = call_user_func( $localize->data, $asset );
+ }
+
+ wp_localize_script( $asset->slug, $localize->name, $localize->data );
+
+ $this->localized[] = $localize->name;
+ }
+
+ // Fetch the HTML for all the localized data.
+ ob_start();
+ $wp_scripts->print_extra_script( $asset->slug, true );
+ $localization_html = ob_get_clean();
+
+ // After printing it remove data;|
+ $wp_scripts->add_data( $asset->slug, 'data', '' );
+
+ return $localization_html . $tag;
+ }
+
+ /**
+ * Filters the Script tags to attach Async and/or Defer based on the rules we set in our Asset class.
+ *
+ * @since 4.13.0
+ *
+ * @param string $tag Tag we are filtering.
+ * @param string $handle Which is the ID/Handle of the tag we are about to print.
+ *
+ * @return string Script tag with the defer and/or async attached.
+ */
+ public function filter_tag_async_defer( $tag, $handle ) {
+ // Only filter for our own filters.
+ if ( ! $asset = $this->get( $handle ) ) {
+ return $tag;
+ }
+
+ // Bail when not dealing with JS assets.
+ if ( 'js' !== $asset->type ) {
+ return $tag;
+ }
+
+ // When async and defer are false we bail with the tag.
+ if ( ! $asset->defer && ! $asset->async ) {
+ return $tag;
+ }
+
+ $tag_has_async = false !== strpos( $tag, ' async ' );
+ $tag_has_defer = false !== strpos( $tag, ' defer ' );
+ $replacement = '\n"
+ . $tag
+ . "\n";
+ }
+
+ return $tag;
+ }
+
+ /**
+ * After select2 is loaded to the FE we add one scripts after to prevent select2 from breaking.
+ *
+ * @since 4.13.2
+ * @since 4.14.18 Ensure we don't run this in the admin.
+ *
+ * @param string $tag The \n";
+
+ return $tag;
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Autoloader.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Autoloader.php
new file mode 100644
index 000000000..90a01e027
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Autoloader.php
@@ -0,0 +1,297 @@
+register_prefix( 'Tribe__Admin__', $this_dir . '/src/Tribe/admin' );
+ * $autoloader->register_prefix( 'Tribe__Admin__', $this_dir . '/src/Tribe/another-dir' );
+ * $autoloader->register_prefix( 'Tribe__Utils__', $this_dir . '/src/Tribe/another-dir' );
+ *
+ * // register a direct class to path
+ * $autoloader->register_class( 'Tribe__Some_Class', $this_dir . '/some/path/to/Some_Class.php' );
+ *
+ * // register a fallback dir to be searched for the class before giving up
+ * $autoloader->add_fallback_dir( $this_dir . '/all-the-classes' );
+ *
+ * // calls `spl_autoload_register`
+ * $autoloader->register_autoloader();
+ *
+ * // class will be searched in the path
+ * // `/var/www/site/wp-content/plugins/the-events-calendar/src/Tribe/admin/Some_Class.php'
+ * // and
+ * // `/var/www/site/wp-content/plugins/the-events-calendar/src/Tribe/another-dir/Some_Class.php'
+ * $i = new Tribe__Admin__Some_Class();
+ *
+ * // class will be searched in the path
+ * // `/var/www/site/wp-content/plugins/the-events-calendar/utils/some-dir/Some_Util.php'
+ * $i = new Tribe__Utils__Some_Util();
+ *
+ * // class will be searched in the path
+ * // `/var/www/site/wp-content/plugins/the-events-calendar/deprecated/Tribe_DeprecatedClass.php'
+ * $i = new Tribe_DeprecatedClass();
+ */
+ class Tribe__Autoloader {
+
+ /**
+ * @var Tribe__Autoloader
+ */
+ protected static $instance;
+
+ /**
+ * An arrays of arrays each containing absolute paths.
+ *
+ * Paths are stored trimming any trailing `/`.
+ * E.g. `/var/www/tribe-pro/wp-content/plugins/the-events-calendar/src/Tribe`
+ *
+ * @var string[][]
+ */
+ protected $prefixes;
+
+ /**
+ * An array of registered prefixes with unique slugs.
+ *
+ * @var string[]
+ */
+ protected $prefix_slugs;
+
+ /**
+ * The string acting as a directory separator in a class name.
+ *
+ * E.g.: given `__` as `$dir_separator` then `Admin__Metabox__Some_Metabox`
+ * will map to `/Admin/Metabox/SomeMetabox.php`.
+ *
+ * @var string
+ */
+ protected $dir_separator = '__';
+
+ /** @var string[] */
+ protected $fallback_dirs = [];
+
+ /**
+ * @var array
+ */
+ protected $class_paths = [];
+
+ /**
+ * Returns the singleton instance of the class.
+ *
+ * @return Tribe__Autoloader
+ */
+ public static function instance() {
+ if ( ! self::$instance instanceof Tribe__Autoloader ) {
+ self::$instance = new self();
+ }
+
+ return self::$instance;
+ }
+
+ /**
+ * Registers prefixes and root dirs using an array.
+ *
+ * Same as calling `register_prefix` on each one.
+ *
+ * @param array $prefixes_to_root_dirs
+ */
+ public function register_prefixes( array $prefixes_to_root_dirs ) {
+ foreach ( $prefixes_to_root_dirs as $prefix => $root_dir ) {
+ $this->register_prefix( $prefix, $root_dir );
+ }
+ }
+
+ /**
+ * Associates a class prefix to an absolute path.
+ *
+ * @param string $prefix A class prefix, e.g. `Tribe__Admin__`
+ * @param string $root_dir The absolute path to the dir containing
+ * the prefixed classes.
+ * @param string $slug An optional unique slug to associate to the prefix.
+ */
+ public function register_prefix( $prefix, $root_dir, $slug = '' ) {
+ $root_dir = $this->normalize_root_dir( $root_dir );
+
+ // Determine if we need to normalize the $prefix.
+ $is_namespaced = false !== strpos( $prefix, '\\' );
+
+ if ( $is_namespaced ) {
+ // If the prefix is a namespace, then normalize it.
+ $prefix = trim( $prefix, '\\' ) . '\\';
+ }
+
+ if ( ! isset( $this->prefixes[ $prefix ] ) ) {
+ $this->prefixes[ $prefix ] = [];
+ }
+
+ $this->prefixes[ $prefix ][] = $root_dir;
+
+ // Let's make sure we're not adding duplicates.
+ $this->prefixes[ $prefix ] = array_unique( $this->prefixes[ $prefix ] );
+
+ if ( $slug ) {
+ $this->prefix_slugs[ $slug ] = $prefix;
+ }
+ }
+
+ /**
+ * Triggers the registration of the autoload method in the SPL
+ * autoload register.
+ */
+ public function register_autoloader() {
+ spl_autoload_register( [ $this, 'autoload' ] );
+ }
+
+ /**
+ * Includes the file defining a class.
+ *
+ * This is the function that's registered as an autoloader.
+ *
+ * @param string $class
+ */
+ public function autoload( $class ) {
+ $include_path = $this->get_class_path( $class );
+ if ( ! empty( $include_path ) ) {
+ include_once( $include_path );
+ }
+ }
+
+ private function normalize_root_dir( $root_dir ) {
+ return rtrim( $root_dir, '/' );
+ }
+
+ protected function get_prefixed_path( $class ) {
+ foreach ( $this->prefixes as $prefix => $dirs ) {
+ $is_namespaced = false !== strpos( $prefix, '\\' );
+
+ if ( strpos( $class, $prefix ) !== 0 ) {
+ continue;
+ }
+
+ $class_name = str_replace( $prefix, '', $class );
+
+ if ( ! $is_namespaced ) {
+ $class_path_frag = implode( '/', explode( $this->dir_separator, $class_name ) ) . '.php';
+ } else {
+ $class_path_frag = implode( '/', explode( '\\', $class_name ) ) . '.php';
+ }
+
+ foreach ( $dirs as $dir ) {
+ $path = $dir . '/' . $class_path_frag;
+ if ( ! file_exists( $path ) ) {
+ // check if the file exists in lowercase
+ $class_path_frag = strtolower( $class_path_frag );
+ $path = $dir . '/' . $class_path_frag;
+ }
+ if ( ! file_exists( $path ) ) {
+ continue;
+ }
+
+ return $path;
+ }
+ }
+ return false;
+ }
+
+ protected function get_fallback_path( $class ) {
+ foreach ( $this->fallback_dirs as $fallback_dir ) {
+ $include_path = $fallback_dir . '/' . $class . '.php';
+ if ( ! file_exists( $include_path ) ) {
+ // check if the file exists in lowercase
+ $class = strtolower( $class );
+ $include_path = $fallback_dir . '/' . $class . '.php';
+ }
+ if ( ! file_exists( $include_path ) ) {
+ continue;
+ }
+
+ return $include_path;
+ }
+ }
+
+ /**
+ * Gets the absolute path to a class file.
+ *
+ * @param string $class The class name
+ *
+ * @return string Either the absolute path to the class file or an
+ * empty string if the file was not found.
+ */
+ public function get_class_path( $class ) {
+ $prefixed_path = $this->get_prefixed_path( $class );
+ if ( $prefixed_path ) {
+ return $prefixed_path;
+ }
+
+ $class_path = ! empty( $this->class_paths[ $class ] ) ? $this->class_paths[ $class ] :false;
+ if ( $class_path ) {
+ return $class_path;
+ }
+
+ $fallback_path = $this->get_fallback_path( $class );
+
+ return $fallback_path ? $fallback_path : '';
+ }
+
+ /**
+ * Get the registered prefix by slug
+ *
+ * @param string $slug Unique slug for registered prefix.
+ *
+ * @return false|string Either the prefix registered to the
+ * unique slug or false if not found.
+ */
+ public function get_prefix_by_slug( $slug ) {
+ $prefix = false;
+
+ if ( isset( $this->prefix_slugs[ $slug ] ) ) {
+ $prefix = $this->prefix_slugs[ $slug ];
+ }
+
+ return $prefix;
+ }
+
+ /**
+ * Adds a folder to search for classes that were not found among
+ * the prefixed ones.
+ *
+ * This is the method to use to register a directory of deprecated
+ * classes.
+ *
+ * @param string $dir An absolute path dto a dir.
+ */
+ public function add_fallback_dir( $dir ) {
+ if ( in_array( $dir, $this->fallback_dirs ) ) {
+ return;
+ }
+ $this->fallback_dirs[] = $this->normalize_root_dir( $dir );
+ }
+
+ /**
+ * @return string
+ */
+ public function get_dir_separator() {
+ return $this->dir_separator;
+ }
+
+ /**
+ * @param string $dir_separator
+ */
+ public function set_dir_separator( $dir_separator ) {
+ $this->dir_separator = $dir_separator;
+ }
+
+ public function register_class( $class, $path ) {
+ $this->class_paths[ $class ] = $path;
+ }
+ }
+ }
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Cache.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Cache.php
new file mode 100644
index 000000000..3dbf9e83f
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Cache.php
@@ -0,0 +1,646 @@
+get_id( $id, $expiration_trigger );
+
+ /**
+ * Filters the expiration for cache objects to provide the ability
+ * to make non-persistent objects be treated as persistent.
+ *
+ * @since 4.8
+ *
+ * @param int $expiration Cache expiration time.
+ * @param string $id Cache ID.
+ * @param mixed $value Cache value.
+ * @param string|array $expiration_trigger Action that triggers automatic expiration.
+ * @param string $key Unique cache key based on Cache ID and expiration trigger last run time.
+ */
+ $expiration = apply_filters( 'tribe_cache_expiration', $expiration, $id, $value, $expiration_trigger, $key );
+
+ if ( self::NON_PERSISTENT === $expiration ) {
+ $group = 'tribe-events-non-persistent';
+ $expiration = 1;
+
+ // Add so we know what group to use in the future.
+ $this->non_persistent_keys[ $id ] = $id;
+ } else {
+ $group = 'tribe-events';
+ }
+
+ return wp_cache_set( $key, $value, $group, $expiration );
+ }
+
+ /**
+ * @param $id
+ * @param $value
+ * @param int $expiration
+ * @param string|array $expiration_trigger
+ *
+ * @return bool
+ */
+ public function set_transient( $id, $value, $expiration = 0, $expiration_trigger = '' ) {
+ if ( $this->data_size_over_packet_size( $value ) ) {
+ return false;
+ }
+
+ return set_transient( $this->get_id( $id, $expiration_trigger ), $value, $expiration );
+ }
+
+ /**
+ * Get cached data. Optionally set data if not previously set.
+ *
+ * Note: When a default value or callback is specified, this value gets set in the cache.
+ *
+ * @param string $id The key for the cached value.
+ * @param string|array $expiration_trigger Optional. Hook to trigger cache invalidation.
+ * @param mixed $default Optional. A default value or callback that returns a default value.
+ * @param int $expiration Optional. When the default value expires, if it gets set.
+ * @param mixed $args Optional. Args passed to callback.
+ *
+ * @return mixed
+ */
+ public function get( $id, $expiration_trigger = '', $default = false, $expiration = 0, $args = [] ) {
+ $group = isset( $this->non_persistent_keys[ $id ] ) ? 'tribe-events-non-persistent' : 'tribe-events';
+ $value = wp_cache_get( $this->get_id( $id, $expiration_trigger ), $group );
+
+ // Value found.
+ if ( false !== $value ) {
+ return $value;
+ }
+
+ if ( is_callable( $default ) ) {
+ // A callback has been specified.
+ $value = $default( ...$args );
+ } else {
+ // Default is a value.
+ $value = $default;
+ }
+
+ // No need to set a cache value to false since non-existent values return false.
+ if ( false !== $value ) {
+ $this->set( $id, $value, $expiration, $expiration_trigger );
+ }
+
+ return $value;
+ }
+
+ /**
+ * @param string $id
+ * @param string|array $expiration_trigger
+ *
+ * @return mixed
+ */
+ public function get_transient( $id, $expiration_trigger = '' ) {
+ return get_transient( $this->get_id( $id, $expiration_trigger ) );
+ }
+
+ /**
+ * @param string $id
+ * @param string|array $expiration_trigger
+ *
+ * @return bool
+ */
+ public function delete( $id, $expiration_trigger = '' ) {
+ $group = isset( $this->non_persistent_keys[ $id ] ) ? 'tribe-events-non-persistent' : 'tribe-events';
+
+ // Delete from non-persistent keys list.
+ if ( 'tribe-events-non-persistent' === $group ) {
+ unset( $this->non_persistent_keys[ $id ] );
+ }
+
+ return wp_cache_delete( $this->get_id( $id, $expiration_trigger ), $group );
+ }
+
+ /**
+ * @param string $id
+ * @param string|array $expiration_trigger
+ *
+ * @return bool
+ */
+ public function delete_transient( $id, $expiration_trigger = '' ) {
+ return delete_transient( $this->get_id( $id, $expiration_trigger ) );
+ }
+
+ /**
+ * Purge all expired tribe_ transients.
+ *
+ * This uses a modification of the the query from https://core.trac.wordpress.org/ticket/20316
+ *
+ * @since 4.11.0
+ *
+ * @return void Just execute the database SQL no return required.
+ */
+ public function delete_expired_transients() {
+ if ( tribe_get_var( 'has_deleted_expired_transients', false ) ) {
+ return;
+ }
+
+ global $wpdb;
+
+ $time = time();
+
+ $sql = "
+ DELETE
+ a,
+ b
+ FROM
+ {$wpdb->options} a
+ INNER JOIN {$wpdb->options} b
+ ON b.option_name = CONCAT( '_transient_timeout_', SUBSTRING( a.option_name, 12 ) )
+ AND b.option_value < {$time}
+ WHERE
+ a.option_name LIKE '\_transient\_tribe\_%'
+ AND a.option_name NOT LIKE '\_transient\_timeout\_tribe\_%'
+ ";
+
+ /**
+ * Allow third party filtering of the SQL used for deleting expired transients.
+ *
+ * @since 4.11.5
+ *
+ * @param string $sql The SQL we execute to delete all the expired transients.
+ * @param int $time Time we are using to determine what is expired.
+ */
+ $sql = apply_filters( 'tribe_cache_delete_expired_transients_sql', $sql, $time );
+
+ if ( empty( $sql ) ) {
+ return;
+ }
+
+ $wpdb->query( $sql );
+
+ // Set the variable to prevent this call from running twice.
+ tribe_set_var( 'has_deleted_expired_transients', true );
+ }
+
+ /**
+ * Flag if we should delete
+ *
+ * @since 4.11.5
+ *
+ * @param boolean $value If we should delete transients or not on shutdown.
+ *
+ * @return void No return for setting the flag.
+ */
+ public function flag_required_delete_transients( $value = true ) {
+ tribe_set_var( 'should_delete_expired_transients', $value );
+ }
+
+ /**
+ * Runs on hook `shutdown` and will delete transients on the end of the request.
+ *
+ * @since 4.11.5
+ *
+ * @return void No return for action hook method.
+ */
+ public function maybe_delete_expired_transients() {
+ if ( ! tribe_get_var( 'should_delete_expired_transients', false ) ) {
+ return;
+ }
+
+ $this->delete_expired_transients();
+ }
+
+ /**
+ * @param string $key
+ * @param string|array $expiration_trigger
+ *
+ * @return string
+ */
+ public function get_id( $key, $expiration_trigger = '' ) {
+ if ( is_array( $expiration_trigger ) ) {
+ $triggers = $expiration_trigger;
+ } elseif ( 'tribe-events-non-persistent' !== $expiration_trigger && 'tribe-events' !== $expiration_trigger ) {
+ $triggers = array_filter( explode( '|', $expiration_trigger ) );
+ }
+
+ $last = 0;
+ foreach ( $triggers as $trigger ) {
+ // Bail on empty trigger otherwise it creates a `tribe_last_` opt on the DB.
+ if ( empty( $trigger ) ) {
+ continue;
+ }
+
+ $occurrence = $this->get_last_occurrence( $trigger );
+
+ if ( $occurrence > $last ) {
+ $last = $occurrence;
+ }
+ }
+
+ $last = empty( $last ) ? '' : $last;
+ $id = $key . $last;
+ if ( strlen( $id ) > 80 ) {
+ $id = 'tribe_' . md5( $id );
+ }
+
+ return $id;
+ }
+
+ /**
+ * Returns the time of an action last occurrence.
+ *
+ * @since 4.9.14 Changed the return value type from `int` to `float`.
+ * @since 5.0.17 No longer memoizes the first triggered timestamp.
+ *
+ * @param string $action The action to return the time for.
+ *
+ * @return float The time (microtime) an action last occurred, or the current microtime if it never occurred.
+ */
+ public function get_last_occurrence( $action ) {
+ $last_action = (float) get_option( 'tribe_last_' . $action, null );
+
+ if ( ! $last_action ) {
+ $last_action = microtime( true );
+ $this->set_last_occurrence( $action, $last_action );
+ }
+
+ return $last_action;
+ }
+
+ /**
+ * Sets the time (microtime) for an action last occurrence.
+ *
+ * @since 4.9.14 Changed the type of the time stored from an `int` to a `float`.
+ *
+ * @param string $action The action to record the last occurrence of.
+ * @param int|float $timestamp The timestamp to assign to the action last occurrence or the current time (microtime).
+ *
+ * @return boolean IF we were able to set the last occurrence or not.
+ */
+ public function set_last_occurrence( $action, $timestamp = 0 ) {
+ if ( empty( $timestamp ) ) {
+ $timestamp = microtime( true );
+ }
+ $updated = update_option( 'tribe_last_' . $action, (float) $timestamp );
+
+ // For performance reasons we will only expire cache once per request, when needed.
+ if ( $updated ) {
+ $this->flag_required_delete_transients( true );
+ }
+
+ return $updated;
+ }
+
+ /**
+ * Builds a key from an array of components and an optional prefix.
+ *
+ * @param mixed $components Either a single component of the key or an array of key components.
+ * @param string $prefix
+ * @param bool $sort Whether component arrays should be sorted or not to generate the key; defaults to
+ * `true`.
+ *
+ * @return string The resulting key.
+ */
+ public function make_key( $components, $prefix = '', $sort = true ) {
+ $key = '';
+ $components = is_array( $components ) ? $components : [ $components ];
+ foreach ( $components as $component ) {
+ if ( $sort && is_array( $component ) ) {
+ $is_associative = count( array_filter( array_keys( $component ), 'is_numeric' ) ) < count( array_keys( $component ) );
+ if ( $is_associative ) {
+ ksort( $component );
+ } else {
+ sort( $component );
+ }
+ }
+ $key .= maybe_serialize( $component );
+ }
+
+ return $this->get_id( $prefix . md5( $key ) );
+ }
+
+ /**
+ * Whether a offset exists.
+ *
+ * @since 4.11.0
+ * @since 5.0.13 Will check against cache expiration. Previously would give false positive
+ * if expiration had passed but was cached recently. Will now consider null not set.
+ *
+ * @param mixed $offset An offset to check for.
+ *
+ * @return boolean Whether the offset exists in the cache.
+ *@link http://php.net/manual/en/arrayaccess.offsetexists.php
+ *
+ */
+ #[\ReturnTypeWillChange]
+ public function offsetExists( $offset ): bool {
+ $value = $this->get( $offset );
+
+ return $value !== false && $value !== null;
+ }
+
+ /**
+ * Offset to retrieve.
+ *
+ * @link http://php.net/manual/en/arrayaccess.offsetget.php
+ *
+ * @since 4.11.0
+ *
+ * @param mixed $offset The offset to retrieve.
+ *
+ * @return mixed Can return all value types.
+ */
+ #[\ReturnTypeWillChange]
+ public function offsetGet( $offset ) {
+ return $this->get( $offset );
+ }
+
+ /**
+ * Offset to set.
+ *
+ * @since 4.11.0
+ *
+ * @link http://php.net/manual/en/arrayaccess.offsetset.php
+ *
+ * @param mixed $offset The offset to assign the value to.
+ * @param mixed $value The value to set.
+ *
+ * @return void
+ */
+ #[\ReturnTypeWillChange]
+ public function offsetSet( $offset, $value ): void {
+ $this->set( $offset, $value, self::NON_PERSISTENT );
+ }
+
+ /**
+ * Offset to unset.
+ *
+ * @since 4.11.0
+ *
+ * @link http://php.net/manual/en/arrayaccess.offsetunset.php
+ *
+ * @param mixed $offset The offset to unset.
+ *
+ * @return void
+ */
+ #[\ReturnTypeWillChange]
+ public function offsetUnset( $offset ): void {
+ $this->delete( $offset );
+ }
+
+ /**
+ * Removes a group of the cache, for now only `non_persistent` is supported.
+ *
+ * @since 4.14.13
+ *
+ * @return bool
+ */
+ public function reset( $group = 'non_persistent' ) {
+ if ( 'non_persistent' !== $group ) {
+ return false;
+ }
+ $this->non_persistent_keys = [];
+ return true;
+ }
+
+ /**
+ * Warms up the caches for a collection of posts.
+ *
+ * @since 4.10.2
+ *
+ * @param array|int $post_ids A post ID, or a collection of post IDs.
+ * @param bool $update_post_meta_cache Whether to warm-up the post meta cache for the posts or not.
+ */
+ public function warmup_post_caches( $post_ids, $update_post_meta_cache = false ) {
+ if ( empty( $post_ids ) ) {
+ return;
+ }
+
+ $post_ids = (array) $post_ids;
+
+ global $wpdb;
+
+ $already_cached_ids = [];
+ foreach ( $post_ids as $post_id ) {
+ if ( wp_cache_get( $post_id, 'posts' ) instanceof \WP_Post ) {
+ $already_cached_ids[] = $post_id;
+ }
+ }
+
+ $required = array_diff( $post_ids, $already_cached_ids );
+
+ if ( empty( $required ) ) {
+ return;
+ }
+
+ /** @var Tribe__Feature_Detection $feature_detection */
+ $feature_detection = tribe( 'feature-detection' );
+ $limit = $feature_detection->mysql_limit_for_example( 'post_result' );
+
+ /**
+ * Filters the LIMIT that should be used to warm-up post caches and postmeta caches (if the
+ * `$update_post_meta_cache` parameter is `true`).
+ *
+ * Lower this value on less powerful hosts. Return `0` to disable the warm-up completely, and `-1` to remove the
+ * limit (not recommended).
+ *
+ * @since 4.10.2
+ *
+ * @param int $limit The number of posts whose caches will be warmed up, per query.
+ */
+ $limit = (int) apply_filters( 'tribe_cache_warmup_post_cache_limit', min( $limit, count( $post_ids ) ) );
+
+ if ( 0 === $limit ) {
+ // Warmup disabled.
+ return;
+ }
+
+ $buffer = $post_ids;
+ $page = 0;
+
+ do {
+ $limit_clause = $limit < 0 ? sprintf( 'LIMIT %d,%d', $limit * $page, $limit ) : '';
+ $page++;
+ $these_ids = array_splice( $buffer, 0, $limit );
+ $interval = implode( ',', array_map( 'absint', $these_ids ) );
+ $posts_query = "SELECT * FROM {$wpdb->posts} WHERE ID IN ({$interval}) {$limit_clause}";
+ $post_objects = $wpdb->get_results( $posts_query );
+ if ( is_array( $post_objects ) && ! empty( $post_objects ) ) {
+ foreach ( $post_objects as $post_object ) {
+ $post = new \WP_Post( $post_object );
+ wp_cache_set( $post_object->ID, $post, 'posts' );
+ }
+
+ if ( $update_post_meta_cache ) {
+ update_meta_cache( 'post', $these_ids );
+ }
+ }
+ } while ( ! empty( $post_objects ) && is_array( $post_objects ) && count( $post_objects ) < count( $post_ids ) );
+ }
+
+ /**
+ * If NOT using an external object caching system, then check if the size, in bytes, of the data
+ * to write to the database would fit into the `max_allowed_packet` setting or not.
+ *
+ * @since 4.12.14
+ *
+ * @param string|array|object $value The value to check.
+ *
+ * @return bool Whether the data, in its serialized form, would fit into the current database `max_allowed_packet`
+ * setting or not.
+ */
+ public function data_size_over_packet_size( $value ) {
+ if ( wp_using_ext_object_cache() ) {
+ // We cannot know and that is a concern of the external caching system.
+ return false;
+ }
+
+ try {
+ $serialized_value = maybe_serialize( $value );
+ $size = strlen( $serialized_value );
+ } catch ( Exception $e ) {
+ // The underlying function would run into the same issue, bail and do not set the transient.
+ return true;
+ }
+
+ /** @var Tribe__Feature_Detection $feature_detection */
+ $feature_detection = tribe( 'feature-detection' );
+
+ // If the size of the string is above 90% of the database `max_allowed_packet` setting, then it should not be written to the db.
+ return $size > ( $feature_detection->get_mysql_max_packet_size() * .9 );
+ }
+
+ /**
+ * Returns a transient that might have been stored, due ot its size, in chunks.
+ *
+ * @since 4.13.3
+ *
+ * @param string $id The name of the transients to return.
+ * @param string|array $expiration_trigger The transient expiration trigger(s).
+ *
+ * @return false|mixed Either the transient value, joined back into one, or `false` to indicate
+ * the transient was not found or was malformed.
+ */
+ public function get_chunkable_transient( $id, $expiration_trigger = '' ) {
+ $transient = $this->get_id( $id, $expiration_trigger );
+
+ if ( wp_using_ext_object_cache() ) {
+ return get_transient( $transient );
+ }
+
+ $chunks = [];
+ $i = 0;
+ do {
+ $chunk_transient = $transient . '_' . $i++;
+ $chunk = get_transient( $chunk_transient );
+ $chunks[ $chunk_transient ] = (string) $chunk;
+ } while ( ! empty( $chunk ) );
+
+ // Remove any piece of data that was added but is not relevant.
+ $chunks = array_filter( $chunks );
+
+ if ( empty( $chunks ) ) {
+ return false;
+ }
+
+ try {
+ $data = implode( '', $chunks );
+ $is_serialized = preg_match( '/^[aO]:\\d+:/', $data );
+ $unserialized = maybe_unserialize( implode( '', $chunks ) );
+
+ if ( is_string( $unserialized ) && $unserialized === $data && $is_serialized ) {
+ // Something was messed up.
+ return false;
+ }
+
+ return $unserialized;
+ } catch ( Exception $e ) {
+ return false;
+ }
+ }
+
+ /**
+ * Sets a transient in the database with the knowledge that, if too large to be stored in one
+ * DB row, it will be chunked.
+ *
+ * The method will redirect to the `set_transient` function if the site is using object caching.
+ *
+ *
+ * @since 4.13.3
+ *
+ * @param string $id The transient ID.
+ * @param mixed $value The value to store, that could be chunked.
+ * @param int $expiration The transient expiration, in seconds.
+ * @param string|array $expiration_trigger The transient expiration trigger(s).
+ *
+ * @return bool Whether the transient, or the transient chunks, have been stored correctly or not.
+ */
+ public function set_chunkable_transient( $id, $value, $expiration = 0, $expiration_trigger = '' ) {
+ $transient = $this->get_id( $id, $expiration_trigger );
+
+ if ( wp_using_ext_object_cache() ) {
+ return $this->set_transient( $transient, $value, $expiration );
+ }
+
+ $inserted = [];
+ $serialized_value = maybe_serialize( $value );
+ $chunk_size = tribe( 'feature-detection' )->get_mysql_max_packet_size() * 0.9;
+ $chunks = str_split( $serialized_value, $chunk_size );
+ foreach ( $chunks as $i => $chunk ) {
+ $chunk_transient = $transient . '_' . $i;
+
+ $set = set_transient( $chunk_transient, $chunk, $expiration );
+
+ if ( ! $set ) {
+ foreach ( $inserted as $transient_to_delete ) {
+ delete_transient( $transient_to_delete );
+ }
+
+ return false;
+ }
+
+ $inserted[] = $chunk_transient;
+ }
+
+ return true;
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Cache_Listener.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Cache_Listener.php
new file mode 100644
index 000000000..bc428398a
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Cache_Listener.php
@@ -0,0 +1,215 @@
+cache = new Tribe__Cache();
+ }
+
+ /**
+ * Run the init functionality (like add_hooks).
+ *
+ * @return void
+ */
+ public function init() {
+ $this->add_hooks();
+ }
+
+ /**
+ * Add the hooks necessary.
+ *
+ * @return void
+ */
+ private function add_hooks() {
+ add_action( 'save_post', [ $this, 'save_post' ], 0, 2 );
+ add_action( 'updated_option', [ $this, 'update_last_updated_option' ], 10, 3 );
+ add_action( 'updated_option', [ $this, 'update_last_save_post' ], 10, 3 );
+ add_action( 'generate_rewrite_rules', [ $this, 'generate_rewrite_rules' ] );
+ add_action( 'clean_post_cache', [ $this, 'save_post' ], 0, 2 );
+ }
+
+ /**
+ * Run the caching functionality that is executed on save post.
+ *
+ * @param int $post_id The post_id.
+ * @param WP_Post $post The current post object being saved.w
+ */
+ public function save_post( $post_id, $post ) {
+ if ( in_array( $post->post_type, Tribe__Main::get_post_types() ) ) {
+ $this->cache->set_last_occurrence( self::TRIGGER_SAVE_POST );
+ }
+ }
+
+ /**
+ * Run the caching functionality that is executed on saving tribe calendar options.
+ *
+ * @see 'updated_option'
+ *
+ * @param string $option_name Name of the updated option.
+ * @param mixed $old_value The old option value.
+ * @param mixed $value The new option value.
+ */
+ public function update_last_save_post( $option_name, $old_value, $value ) {
+ $triggers = [
+ 'tribe_events_calendar_options' => true,
+ 'permalink_structure' => true,
+ 'rewrite_rules' => true,
+ 'start_of_week' => true,
+ ];
+
+ $triggers = $this->filter_action_last_occurrence_triggers( $triggers, static::TRIGGER_SAVE_POST, func_get_args() );
+
+ if ( ! empty( $triggers[ $option_name ] ) ) {
+ $this->cache->set_last_occurrence( self::TRIGGER_SAVE_POST );
+ }
+ }
+
+ /**
+ * Run the caching functionality that is executed on saving tribe calendar options.
+ *
+ * @see 'updated_option'
+ *
+ * @since 4.11.0
+ *
+ * @param string $option_name Name of the updated option.
+ * @param mixed $old_value The old option value.
+ * @param mixed $value The new option value.
+ */
+ public function update_last_updated_option( $option_name, $old_value, $value ) {
+ $triggers = [
+ 'active_plugins' => true,
+ 'tribe_events_calendar_options' => true,
+ 'permalink_structure' => true,
+ 'rewrite_rules' => true,
+ 'start_of_week' => true,
+ 'sidebars_widgets' => true,
+ 'stylesheet' => true,
+ 'template' => true,
+ 'WPLANG' => true,
+ ];
+
+ $triggers = $this->filter_action_last_occurrence_triggers( $triggers, static::TRIGGER_UPDATED_OPTION, func_get_args() );
+
+ if ( ! empty( $triggers[ $option_name ] ) ) {
+ $this->cache->set_last_occurrence( self::TRIGGER_UPDATED_OPTION );
+ }
+ }
+
+ /**
+ * Filtering for last occurrence triggers.
+ *
+ * @since 4.13.2
+ *
+ * @param array $triggers Which options will trigger this given action last occurrence.
+ * @param string $action Which action this trigger will set.
+ * @param array $args Which arguments from the updated option method.
+ *
+ * @return array
+ */
+ public function filter_action_last_occurrence_triggers( array $triggers = [], $action = '', array $args = [] ) {
+
+ /**
+ * Filters the contents of which options will trigger expiring a given actions cache.
+ *
+ * @since 4.13.2
+ *
+ * @param array $triggers Which options will trigger this given action last occurrence.
+ * @param string $action Which action this trigger will set.
+ * @param array $args Which arguments from the updated option method.
+ */
+ $triggers = apply_filters( 'tribe_cache_last_occurrence_option_triggers', $triggers, $action, $args );
+
+ /**
+ * Filters the contents of which options will trigger expiring a given actions cache.
+ * Allows filtering a specific action.
+ *
+ * @since 4.13.2
+ *
+ * @param array $triggers Which options will trigger this given action last occurrence.
+ * @param string $action Which action this trigger will set.
+ * @param array $args Which arguments from the updated option method.
+ */
+ return (array) apply_filters( "tribe_cache_last_occurrence_option_triggers:{$action}", $triggers, $action, $args );
+ }
+
+ /**
+ * For any hook that doesn't need any additional filtering
+ *
+ * @param $method
+ * @param $args
+ */
+ public function __call( $method, $args ) {
+ $this->cache->set_last_occurrence( $method );
+ }
+
+ /**
+ * Instance method of the cache listener.
+ *
+ * @return Tribe__Cache_Listener
+ */
+ public static function instance() {
+ if ( empty( self::$instance ) ) {
+ self::$instance = self::create_listener();
+ }
+
+ return self::$instance;
+ }
+
+ /**
+ * Create a cache listener.
+ *
+ * @return Tribe__Cache_Listener
+ */
+ private static function create_listener() {
+ $listener = new self();
+ $listener->init();
+
+ return $listener;
+ }
+
+ /**
+ * Run the caching functionality that is executed when rewrite rules are generated.
+ *
+ * @since 4.9.11
+ */
+ public function generate_rewrite_rules() {
+ $this->cache->set_last_occurrence( self::TRIGGER_GENERATE_REWRITE_RULES );
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Changelog_Reader.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Changelog_Reader.php
new file mode 100644
index 000000000..43041367e
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Changelog_Reader.php
@@ -0,0 +1,53 @@
+version_count = (int) $version_count;
+ $this->readme_file = empty( $readme_file ) ? $this->default_readme_file() : $readme_file;
+ }
+
+ protected function default_readme_file() {
+ return dirname( Tribe__Main::instance()->plugin_path ) . '/readme.txt';
+ }
+
+ public function get_changelog() {
+ $contents = $this->extract_changelog_section();
+ $lines = explode( "\n", $contents );
+
+ $sections = [];
+ $current_section = '';
+ foreach ( $lines as $line ) {
+ $line = trim( $line );
+ if ( substr( $line, 0, 1 ) == '=' ) {
+ if ( count( $sections ) >= $this->version_count ) {
+ break;
+ }
+ $header = trim( $line, '= ' );
+ $current_section = esc_html( $header );
+ $sections[ $current_section ] = [];
+ } elseif ( strlen( $line ) > 0 ) {
+ $message = trim( $line, '* ' );
+ $sections[ $current_section ][] = esc_html( $message );
+ }
+ }
+ return $sections;
+ }
+
+ protected function extract_changelog_section() {
+ $contents = $this->get_readme_file_contents();
+ $start = strpos( $contents, '== Changelog ==' );
+ if ( $start === false ) {
+ return '';
+ }
+ $start += 16; // account for the length of the header
+ $end = strpos( $contents, '==', $start );
+ return trim( substr( $contents, $start, $end - $start ) );
+ }
+
+ protected function get_readme_file_contents() {
+ return file_get_contents( $this->readme_file );
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Container.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Container.php
new file mode 100644
index 000000000..56ba83353
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Container.php
@@ -0,0 +1,358 @@
+doSomething();
+ *
+ * Need the class built immediately? Build it and register it:
+ *
+ * tribe_singleton( 'tec.admin.class', new Tribe__Admin__Class() );
+ *
+ * // some code later...
+ *
+ * tribe( 'tec.admin.class' )->doSomething();
+ *
+ * Need a very custom way to build the class? Register a callback:
+ *
+ * tribe_singleton( 'tec.admin.class', array( Tribe__Admin__Class__Factory, 'make' ) );
+ *
+ * // some code later...
+ *
+ * tribe( 'tec.admin.class' )->doSomething();
+ *
+ * Or register the methods that should be called on the object after its construction:
+ *
+ * tribe_singleton( 'tec.admin.class', 'Tribe__Admin__Class', array( 'hook', 'register' ) );
+ *
+ * // some code later...
+ *
+ * // the `hook` and `register` methods will be called on the built instance.
+ * tribe( 'tec.admin.class' )->doSomething();
+ *
+ * The class will be built only once (if passing the class name or a callback function), stored
+ * and the same instance will be returned from that moment on.
+ *
+ * @param string $slug The human-readable and catchy name of the class.
+ * @param string|object|callable $class The full class name or an instance of the class
+ * or a callback that will return the instance of the class.
+ * @param array $after_build_methods An array of methods that should be called on
+ * the built object after the `__construct` method; the methods
+ * will be called only once after the singleton instance
+ * construction.
+ */
+ function tribe_singleton( $slug, $class, array $after_build_methods = null ) {
+ Tribe__Container::init()->singleton( $slug, $class, $after_build_methods );
+ }
+}
+
+if ( ! function_exists( 'tribe_register' ) ) {
+ /**
+ * Registers a class.
+ *
+ * Each call to obtain an instance of this class made using the `tribe( $slug )` function
+ * will return a new instance; the instances are built just in time (if not passing an
+ * object instance, in that case it will work as a singleton) and on the first request.
+ * The container will call the class `__construct` method on the class (if not passing an object
+ * or a callback function) and will try to automagically resolve dependencies.
+ *
+ * Example use:
+ *
+ * tribe_register( 'tec.some', 'Tribe__Some' );
+ *
+ * // some code later...
+ *
+ * // class is built here
+ * $some_one = tribe( 'tec.some' )->doSomething();
+ *
+ * // $some_two !== $some_one
+ * $some_two = tribe( 'tec.some' )->doSomething();
+ *
+ * Need the class built immediately? Build it and register it:
+ *
+ * tribe_register( 'tec.admin.class', new Tribe__Admin__Class() );
+ *
+ * // some code later...
+ *
+ * // $some_two === $some_one
+ * // acts like a singleton
+ * $some_one = tribe( 'tec.some' )->doSomething();
+ * $some_two = tribe( 'tec.some' )->doSomething();
+ *
+ * Need a very custom way to build the class? Register a callback:
+ *
+ * tribe_register( 'tec.some', array( Tribe__Some__Factory, 'make' ) );
+ *
+ * // some code later...
+ *
+ * // $some_two !== $some_one
+ * $some_one = tribe( 'tec.some' )->doSomething();
+ * $some_two = tribe( 'tec.some' )->doSomething();
+ *
+ * Or register the methods that should be called on the object after its construction:
+ *
+ * tribe_singleton( 'tec.admin.class', 'Tribe__Admin__Class', array( 'hook', 'register' ) );
+ *
+ * // some code later...
+ *
+ * // the `hook` and `register` methods will be called on the built instance.
+ * tribe( 'tec.admin.class' )->doSomething();
+ *
+ * @param string $slug The human-readable and catchy name of the class.
+ * @param string|object|callable $class The full class name or an instance of the class
+ * or a callback that will return the instance of the class.
+ * @param array $after_build_methods An array of methods that should be called on
+ * the built object after the `__construct` method; the methods
+ * will be called each time after the instance construction.
+ */
+ function tribe_register( $slug, $class, array $after_build_methods = null ) {
+ Tribe__Container::init()->bind( $slug, $class, $after_build_methods );
+ }
+}
+
+if ( ! function_exists( 'tribe' ) ) {
+ /**
+ * Returns a ready to use instance of the requested class.
+ *
+ * Example use:
+ *
+ * tribe_singleton( 'common.main', 'Tribe__Main');
+ *
+ * // some code later...
+ *
+ * tribe( 'common.main' )->do_something();
+ *
+ * @param string|null $slug_or_class Either the slug of a binding previously registered using `tribe_singleton` or
+ * `tribe_register` or the full class name that should be automagically created or
+ * `null` to get the container instance itself.
+ *
+ * @return mixed|object|Tribe__Container The instance of the requested class. Please note that the cardinality of
+ * the class is controlled registering it as a singleton using `tribe_singleton`
+ * or `tribe_register`; if the `$slug_or_class` parameter is null then the
+ * container itself will be returned.
+ */
+ function tribe( $slug_or_class = null ) {
+ $container = Tribe__Container::init();
+
+ return null === $slug_or_class ? $container : $container->make( $slug_or_class );
+ }
+}
+
+if ( ! function_exists( 'tribe_set_var' ) ) {
+ /**
+ * Registers a value under a slug in the container.
+ *
+ * Example use:
+ *
+ * tribe_set_var( 'tec.url', 'http://example.com' );
+ *
+ * @param string $slug The human-readable and catchy name of the var.
+ * @param mixed $value The variable value.
+ */
+ function tribe_set_var( $slug, $value ) {
+ $container = Tribe__Container::init();
+ $container->setVar( $slug, $value );
+ }
+}
+
+if ( ! function_exists( 'tribe_get_var' ) ) {
+ /**
+ * Returns the value of a registered variable.
+ *
+ * Example use:
+ *
+ * tribe_set_var( 'tec.url', 'http://example.com' );
+ *
+ * $url = tribe_get_var( 'tec.url' );
+ *
+ * @param string $slug The slug of the variable registered using `tribe_set_var`.
+ * @param null $default The value that should be returned if the variable slug
+ * is not a registered one.
+ *
+ * @return mixed Either the registered value or the default value if the variable
+ * is not registered.
+ */
+ function tribe_get_var( $slug, $default = null ) {
+ $container = Tribe__Container::init();
+
+ try {
+ $var = $container->getVar( $slug );
+ } catch ( InvalidArgumentException $e ) {
+ return $default;
+ }
+
+ return $var;
+ }
+}
+
+if ( ! function_exists( 'tribe_unset_var' ) ) {
+ /**
+ * Returns the value of a registered variable.
+ *
+ * Example use:
+ *
+ * tribe_set_var( 'tec.url', 'http://example.com' );
+ *
+ * tribe_unset_var( 'tec.url' );
+ *
+ * @since 4.11.0
+ *
+ * @param string $slug The slug of the variable registered using `tribe_unset_var`.
+ *
+ * @return void
+ */
+ function tribe_unset_var( $slug ) {
+ $container = Tribe__Container::init();
+ try {
+ $container->offsetUnset( $slug );
+ } catch ( Exception $e ) {}
+ }
+}
+
+if ( ! function_exists( 'tribe_isset_var' ) ) {
+ /**
+ * Returns the value of a registered variable.
+ *
+ * Example use:
+ *
+ * tribe_set_var( 'tec.url', 'http://example.com' );
+ *
+ * tribe_isset_var( 'tec.url' );
+ *
+ * @since 4.11.0
+ *
+ * @param string $slug The slug of the variable checked using `tribe_isset_var`.
+ *
+ * @return boolean Either a the given slug exists.
+ */
+ function tribe_isset_var( $slug ) {
+ $container = Tribe__Container::init();
+ return $container->offsetExists( $slug );
+ }
+}
+
+if ( ! function_exists( 'tribe_register_provider' ) ) {
+ /**
+ * Registers a service provider in the container.
+ *
+ * Service providers must implement the `use ServiceProviderInterface` interface or extend
+ * the `ServiceProvider` class.
+ *
+ * @see ServiceProvider
+ * @see ServiceProviderInterface
+ *
+ * @param string $provider_class
+ */
+ function tribe_register_provider( $provider_class ) {
+ $container = Tribe__Container::init();
+
+ if ( $provider_class === 'Tribe\Tickets\Admin\Home\Service_Provider' ) {
+ /**
+ * Prevent binding a poorly located service provider registration in ET pre 5.6.0
+ * and places it after ET Main::bind_implementations().
+ *
+ * @todo: Remove this after TEC 7.5 after enough time has passed.
+ */
+ add_action(
+ 'tribe_tickets_plugin_loaded',
+ static function() use ( $container ) {
+ $container->register( Tribe\Tickets\Admin\Home\Service_Provider::class );
+ }
+ );
+ } else {
+ $container->register( $provider_class );
+ }
+ }
+
+ if ( ! function_exists( 'tribe_callback' ) ) {
+ /**
+ * Returns a lambda function suitable to use as a callback; when called the function will build the implementation
+ * bound to `$classOrInterface` and return the value of a call to `$method` method with the call arguments.
+ *
+ * @since 4.7
+ * @since 4.6.2 Included the $argsN params
+ *
+ * @param string $slug A class or interface fully qualified name or a string slug.
+ * @param string $method The method that should be called on the resolved implementation with the
+ * specified array arguments.
+ * @param mixed [$argsN] (optional) Any number of arguments that will be passed down to the Callback
+ *
+ * @return callable A PHP Callable based on the Slug and Methods passed
+ */
+ function tribe_callback( $slug, $method ) {
+ $container = Tribe__Container::init();
+ $arguments = func_get_args();
+ $is_empty = 2 === count( $arguments );
+
+ if ( $is_empty ) {
+ $callable = $container->callback( $slug, $method );
+ } else {
+ $callback = $container->callback( 'callback', 'get' );
+ $callable = call_user_func_array( $callback, $arguments );
+ }
+
+ return $callable;
+ }
+ }
+
+ if ( ! function_exists( 'tribe_callback_return' ) ) {
+ /**
+ * Returns a tribe_callback for a very simple Return value method
+ *
+ * Example of Usage:
+ *
+ * add_filter( 'admin_title', tribe_callback_return( __( 'Ready to work.' ) ) );
+ *
+ * @since 4.6.2
+ *
+ * @param mixed $value The value to be returned
+ *
+ * @return callable A PHP Callable based on the Slug and Methods passed
+ */
+ function tribe_callback_return( $value ) {
+ return tribe_callback( 'callback', 'return_value', $value );
+ }
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Context.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Context.php
new file mode 100644
index 000000000..04f753a20
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Context.php
@@ -0,0 +1,1655 @@
+ => [ 'read' => , 'write' => ] ].
+ * The key is used to identify the property that will be accessible with the `get` and
+ * 'dangerously_set_global_context' method, e.g. `$context->get( 'event_display', 'list' );`.
+ * The locations is a list of locations the context will search, top to bottom, left to right, to find a value that's
+ * not empty or the default one, here's a list of supported lookup locations:
+ *
+ * request_var - look into $_GET, $_POST, $_PUT, $_DELETE, $_REQUEST.
+ * query_var - get the value from the main WP_Query object query vars.
+ * query_prop - get the value from a property of the main WP_Query object.
+ * tribe_option - get the value from a Tribe option.
+ * option - get the value from a database option.
+ * transient - get the value from a transient.
+ * constant - get the value from a constant, can also be a class constant with ::.
+ * global_var - get the value from a global variable
+ * static_prop - get the value from a class static property, format: `array( $class, $prop )`.
+ * prop - get the value from a tribe() container binding, format `array( $binding, $prop )`.
+ * static_method - get the value from a class static method.
+ * method - get the value calling a method on a tribe() container binding.
+ * func - get the value from a function or a closure.
+ * filter - get the value by applying a filter.
+ * location_func - get the value by applying a callback to the value of a location.
+ *
+ * For each location additional arguments can be specified:
+ * orm_arg - if `false` then the location will never produce an ORM argument, if provided the ORM arg produced bye the
+ * location will have this name.
+ * orm_transform - if provided the value of the location will be obtained by passing it as an argument to a callable.
+ *
+ * As the Context locations increase in number it would be impractical to define them inline here.
+ * The locations will be loaded by the `Tribe__Context::populate_locations` method from the `Context/locations.php`
+ * file.
+ *
+ * @var array
+ */
+ protected static $locations = [];
+
+ /**
+ * A utility static property keeping track of write locations that
+ * will be defined as associative arrays.
+ *
+ * @var array
+ */
+ protected static $associative_locations = [
+ self::TRANSIENT,
+ self::METHOD,
+ self::STATIC_METHOD,
+ self::PROP,
+ self::STATIC_PROP,
+ ];
+
+ /**
+ * Whether the static dynamic locations were set or not.
+ *
+ * @var bool
+ */
+ protected static $did_populate_locations = false;
+
+ /**
+ * A list of override locations to read and write from.
+ *
+ * This list has the same format and options as the static `$locations` property
+ * but allows a context instance to override, or add, read and write locations.
+ *
+ * @var array
+ */
+ protected $override_locations = [];
+
+ /**
+ * Whether the context of the current HTTP request is an AJAX one or not.
+ *
+ * @var bool
+ */
+ protected $doing_ajax;
+
+ /**
+ * Whether the context of the current HTTP request is a Cron one or not.
+ *
+ * @var bool
+ */
+ protected $doing_cron;
+
+ /**
+ * A request-based array cache to store the values fetched by the context.
+ *
+ * @var array
+ */
+ protected $request_cache = [];
+
+ /**
+ * Whether this context should use the default locations or not.
+ * This flag property is set to `false` when a context is obtained using
+ * the `set_locations` method; it will otherwise be set to `true`.
+ *
+ * @var bool
+ */
+ protected $use_default_locations = true;
+
+ /**
+ * An instance of the post state handler.
+ *
+ * @since 5.0.13
+ *
+ * @var Post_Request_Type
+ */
+ protected Post_Request_Type $post_state;
+
+ /**
+ * Tribe__Context constructor.
+ *
+ * since 5.0.13
+ *
+ * @param Post_Request_Type|null $post_state An instance of the post state handler.
+ */
+ public function __construct( Post_Request_Type $post_state = null ) {
+ $this->post_state = $post_state ?: tribe( Post_Request_Type::class );
+ }
+
+ /**
+ * Whether we are currently creating a new post, a post of post type(s) or not.
+ *
+ * @since 4.7.7
+ * @since 5.0.13 Extracted the logic to the `TEC\Common\Context\Post_Request_Type` class.
+ *
+ * @param null $post_type The optional post type to check.
+ *
+ * @return bool Whether we are currently creating a new post, a post of post type(s) or not.
+ */
+ public function is_new_post( $post_type = null ) {
+ return $this->post_state->is_new_post( $post_type );
+ }
+
+ /**
+ * Whether we are currently editing a post(s), post type(s) or not.
+ *
+ * @since 4.7.7
+ * @since 5.0.13 Extracted the logic to the `TEC\Common\Context\Post_Request_Type` class.
+ *
+ * @param null|array|string|int $post_or_type A post ID, post type, an array of post types or post IDs, `null`
+ * to just make sure we are currently editing a post.
+ *
+ * @return bool
+ */
+ public function is_editing_post( $post_or_type = null ): bool {
+ return $this->post_state->is_editing_post( $post_or_type );
+ }
+
+ /**
+ * Helper function to indicate whether the current execution context is AJAX.
+ *
+ * This method exists to allow us test code that behaves differently depending on the execution
+ * context.
+ *
+ * @since 4.7.12
+ * @since 4.9.5 Removed the $doing_ajax parameter.
+ *
+ * @return boolean
+ */
+ public function doing_ajax() {
+ return function_exists( 'wp_doing_ajax' )
+ ? wp_doing_ajax()
+ : defined( 'DOING_AJAX' ) && DOING_AJAX;
+ }
+
+ /**
+ * Checks whether the context of the current HTTP request is a Cron one or not.
+ *
+ * @since 4.7.23
+ * @since 4.9.5 Removed the $doing_cron parameter.
+ *
+ * @return bool Whether the context of the current HTTP request is a Cron one or not.
+ */
+ public function doing_cron() {
+ return function_exists( 'wp_doing_cron' )
+ ? wp_doing_cron()
+ : defined( 'DOING_CRON' ) && DOING_CRON;
+ }
+
+ /**
+ * Gets a value reading it from the location(s) defined in the `Tribe__Context::$props
+ *
+ * @since 4.9.5
+ *
+ * @param string $key The key of the variable to fetch.
+ * @param mixed|null $default The default value to return if not found.
+ * @param bool $force Whether to force the re-fetch of the value from the context or
+ * not; defaults to `false`.
+ *
+ * @return mixed The value from the first location that can provide it or the default
+ * value if not found.
+ */
+ public function get( $key, $default = null, $force = false ) {
+ /**
+ * Filters the value of a context variable skipping all of its logic.
+ *
+ * @since 4.9.5
+ *
+ * @param mixed $value The value for the key before it's fetched from the context.
+ * @param string $key The key of the value to fetch from the context.
+ * @param mixed $default The default value that should be returned if the value is
+ * not set in the context.
+ * @param bool $force Whether to force the re-fetch of the value from the context or
+ * not; defaults to `false`.
+ */
+ $value = apply_filters( "tribe_context_pre_{$key}", null, $key, $default, $force );
+ if ( null !== $value ) {
+ return $value;
+ }
+
+ $value = $default;
+ $locations = $this->get_locations();
+ $found = false;
+
+ if ( ! $force && isset( $this->request_cache[ $key ] ) ) {
+ $value = $this->request_cache[ $key ];
+ } elseif ( ! empty( $locations[ $key ]['read'] ) ) {
+ foreach ( $locations[ $key ]['read'] as $location => $keys ) {
+ $the_value = $this->$location( (array) $keys, $default );
+
+ if ( $default !== $the_value && static::NOT_FOUND !== $the_value ) {
+ $found = true;
+ $value = $the_value;
+ break;
+ }
+ }
+ }
+
+ /**
+ * Filters the value fetched from the context for a key.
+ *
+ * Useful for testing and local override.
+ *
+ * @since 4.9.5
+ *
+ * @param mixed $value The value as fetched from the context.
+ */
+ $value = apply_filters( "tribe_context_{$key}", $value );
+
+ // Only cache if the value was found.
+ if ( $found ) {
+ $this->request_cache[ $key ] = $value;
+ }
+
+ return $value;
+ }
+
+ /**
+ * Alters the context.
+ *
+ * Due to its immutable nature setting values on the context will NOT modify the
+ * context but return a modified clone.
+ * If you need to modify the global context update the location(s) it should read from
+ * and call the `refresh` method.
+ * Example: `$widget_context = tribe_context()->alter( $widget_args );`.
+ *
+ * @since 4.9.5
+ *
+ * @param array $values An associative array of key-value pairs to modify the context.
+ *
+ * @return \Tribe__Context A clone, with modified, values, of the context the method was called on.
+ */
+ public function alter( array $values ) {
+ $clone = clone $this;
+
+ $clone->request_cache = array_merge( $clone->request_cache, $values );
+
+ return $clone;
+ }
+
+ /**
+ * Clears the context cache forcing a re-fetch of the variables from the context.
+ *
+ * @since 4.9.5
+ *
+ * @param string $key An optional specific key to refresh, if passed only this key
+ * will be refreshed.
+ */
+ public function refresh( $key = null ) {
+ if ( null !== $key ) {
+ unset( $this->request_cache[ $key ] );
+ } else {
+ $this->request_cache = [];
+ }
+ }
+
+ /**
+ * Returns the read and write locations set on the context.
+ *
+ * @since 4.9.5
+ *
+ * @return array An array of read and write location in the shape of the `Tribe__Context::$locations` one,
+ * `[ => [ 'read' => , 'write' => ] ]`.
+ */
+ public function get_locations() {
+ $this->populate_locations();
+
+ $locations = $this->use_default_locations
+ ? array_merge( self::$locations, $this->override_locations )
+ : $this->override_locations;
+
+ if ( $this->use_default_locations ) {
+ /**
+ * Filters the locations registered in the Context.
+ *
+ * @since 4.10.2
+ *
+ * @param $locations array An array of read and write location in the shape of the `Tribe__Context::$locations` one,
+ * `[ => [ 'read' => , 'write' => ] ]`.
+ * @param $context Tribe__Context Current instance of the context.
+ */
+ $locations = apply_filters( 'tribe_context_locations', $locations, $this );
+ }
+
+ return $locations;
+ }
+
+ /**
+ * Reads the value from one or more $_REQUEST vars.
+ *
+ * @since 4.9.5
+ *
+ * @param array $request_vars The list of request vars to lookup, in order.
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ protected function request_var( array $request_vars, $default ) {
+ $value = $default;
+
+ foreach ( $request_vars as $request_var ) {
+ $the_value = tribe_get_request_var( $request_var, self::NOT_FOUND );
+ if ( $the_value !== self::NOT_FOUND ) {
+ $value = $the_value;
+ break;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Reads the value from one or more global WP_Query object query variables.
+ *
+ * @since 4.9.5
+ *
+ * @param array $query_vars The list of query vars to look up, in order.
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ protected function query_var( array $query_vars, $default ) {
+ $value = $default;
+
+ global $wp_query;
+
+ if ( ! $wp_query instanceof \WP_Query ) {
+ return $value;
+ }
+
+ foreach ( $query_vars as $query_var ) {
+ $the_value = $wp_query->get( $query_var, self::NOT_FOUND );
+ if ( $the_value !== self::NOT_FOUND ) {
+ $value = $the_value;
+ break;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Reads the value from one or more global WP_Query object properties.
+ *
+ * @since 4.9.5
+ *
+ * @param array $query_props The list of properties to look up, in order.
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ protected function query_prop( array $query_props, $default ) {
+ $value = $default;
+
+ global $wp_query;
+ foreach ( $query_props as $query_prop ) {
+ $the_value = isset( $wp_query->{$query_prop} ) ? $wp_query->{$query_prop} : self::NOT_FOUND;
+ if ( $the_value !== self::NOT_FOUND ) {
+ $value = $the_value;
+ break;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Reads the value from one more more `tribe_option`s.
+ *
+ * @since 4.9.5
+ *
+ * @param array $tribe_options The list of `tribe_option`s to lookup, in order.
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ protected function tribe_option( array $tribe_options, $default ) {
+ $value = $default;
+
+ foreach ( $tribe_options as $option_name ) {
+ $the_value = tribe_get_option( $option_name, self::NOT_FOUND );
+ if ( $the_value !== self::NOT_FOUND ) {
+ $value = $the_value;
+ break;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Reads the value from one or more options.
+ *
+ * @since 4.9.5
+ *
+ * @param array $options The list of options to lookup, in order.
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ protected function option( array $options, $default ) {
+ $value = $default;
+
+ foreach ( $options as $option_name ) {
+ $the_value = get_option( $option_name, self::NOT_FOUND );
+ if ( $the_value !== self::NOT_FOUND ) {
+ $value = $the_value;
+ break;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Reads the value from one or more transients.
+ *
+ * @since 4.9.5
+ *
+ * @param array $transients The list of transients to lookup, in order.
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ protected function transient( array $transients, $default ) {
+ $value = $default;
+
+ foreach ( $transients as $transient ) {
+ $the_value = get_transient( $transient );
+ if ( false !== $the_value ) {
+ $value = $the_value;
+ /*
+ * This will fail when the value is actually `false`.
+ */
+ break;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Reads the value from one or more constants.
+ *
+ * @since 4.9.5
+ *
+ * @param array $constants The list of constants to lookup, in order.
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ protected function constant( array $constants, $default ) {
+ $value = $default;
+
+ foreach ( $constants as $constant ) {
+ $the_value = defined( $constant ) ? constant( $constant ) : self::NOT_FOUND;
+ if ( $the_value !== self::NOT_FOUND ) {
+ $value = $the_value;
+ break;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Reads the value from one or more global variable.
+ *
+ * @since 4.9.5
+ *
+ * @param array $global_vars The list of global variables to look up, in order.
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ protected function global_var( array $global_vars, $default ) {
+ $value = $default;
+
+ foreach ( $global_vars as $var ) {
+ $the_value = isset( $GLOBALS[ $var ] ) ? $GLOBALS[ $var ] : self::NOT_FOUND;
+ if ( $the_value !== self::NOT_FOUND ) {
+ $value = $the_value;
+ break;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Reads the value from one or more class static properties.
+ *
+ * @since 4.9.5
+ *
+ * @param array $classes_and_props An associative array in the shape [ => ].
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ protected function static_prop( array $classes_and_props, $default ) {
+ $value = $default;
+
+ foreach ( $classes_and_props as $class => $prop ) {
+ if ( class_exists( $class ) ) {
+ // PHP 5.2 compat, on PHP 5.3+ $class::$$prop
+ $vars = get_class_vars( $class );
+ $the_value = isset( $vars[ $prop ] ) ? $vars[ $prop ] : self::NOT_FOUND;
+
+ if ( $the_value !== self::NOT_FOUND ) {
+ $value = $the_value;
+ break;
+ }
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Reads the value from one or more properties of implementations bound in the `tribe()` container.
+ *
+ * @since 4.9.5
+ *
+ * @param array $bindings_and_props An associative array in the shape [ => ].
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ protected function prop( array $bindings_and_props, $default ) {
+ $value = $default;
+
+ foreach ( $bindings_and_props as $binding => $prop ) {
+ $the_value = tribe()->offsetExists( $binding ) && property_exists( tribe( $binding ), $prop )
+ ? tribe( $binding )->{$prop}
+ : self::NOT_FOUND;
+
+ if ( $the_value !== self::NOT_FOUND ) {
+ $value = $the_value;
+ break;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Reads the values from one or more static class methods.
+ *
+ * @since 4.9.5
+ *
+ * @param array $classes_and_methods An associative array in the shape [ => ].
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first value that's not equal to the default one, the default value
+ * otherwise.
+ */
+ protected function static_method( array $classes_and_methods, $default ) {
+ $value = $default;
+
+ foreach ( $classes_and_methods as $class => $method ) {
+ $the_value = class_exists( $class ) && method_exists( $class, $method )
+ ? call_user_func( [ $class, $method ] )
+ : self::NOT_FOUND;
+
+ if ( $the_value !== self::NOT_FOUND ) {
+ $value = $the_value;
+ break;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Reads the value from one or more methods called on implementations bound in the `tribe()` container.
+ *
+ * @since 4.9.5
+ *
+ * @param array $bindings_and_methods An associative array in the shape [ => ].
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first value that's not equal to the default one, the default value
+ * otherwise.
+ */
+ protected function method( array $bindings_and_methods, $default ) {
+ $value = $default;
+ $the_value = self::NOT_FOUND;
+
+ foreach ( $bindings_and_methods as $binding => $method ) {
+ if ( tribe()->offsetExists( $binding ) ) {
+ $implementation = tribe( $binding );
+ if ( method_exists( $implementation, $method ) ) {
+ $the_value = $implementation->$method();
+ }
+ }
+
+ if ( $the_value !== self::NOT_FOUND ) {
+ $value = $the_value;
+ break;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Reads the value from one or more functions until one returns a value that's not the default one.
+ *
+ * @since 4.9.5
+ *
+ * @param array $functions An array of functions to call, in order.
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first value that's not equal to the default one, the default value
+ * otherwise.
+ */
+ protected function func( array $functions, $default ) {
+ $value = $default;
+ $the_value = self::NOT_FOUND;
+
+ foreach ( $functions as $function ) {
+ if ( is_callable( $function ) || function_exists( $function ) ) {
+ $the_value = $function();
+ }
+
+ if ( $the_value !== self::NOT_FOUND ) {
+ $value = $the_value;
+ break;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * Modifies the global context using the defined write locations to persist the altered values.
+ *
+ * Please keep in mind this will set the the global context for the whole request and, when the
+ * write location is an option, to the database.
+ * With great power comes great responsibility: think a lot before using this.
+ *
+ * @param array|null $fields An optional whitelist or blacklist of fields to write
+ * depending on the value of the `$whitelist` parameter;
+ * defaults to writing all available fields.
+ * @param bool $whitelist Whether the list of fields provided in the `$fields`
+ * parameter should be treated as a whitelist (`true`) or
+ * blacklist (`false`).
+ *
+ * @since 4.9.5
+ */
+ public function dangerously_set_global_context( array $fields = null, $whitelist = true ) {
+ $locations = $this->get_locations();
+
+ if ( null !== $fields ) {
+ $locations = $whitelist
+ ? array_intersect_key( $locations, array_combine( $fields, $fields ) )
+ : array_diff_key( $locations, array_combine( $fields, $fields ) );
+ }
+
+ /**
+ * Here we intersect with the request cache to only write values we've actually read
+ * or modified. If none of the two happened then there's no need to write anything.
+ */
+ foreach ( array_intersect_key( $this->request_cache, $locations ) as $key => $value ) {
+ if ( ! isset( $locations[ $key ]['write'] ) ) {
+ continue;
+ }
+
+ foreach ( (array) $locations[ $key ]['write'] as $location => $targets ) {
+ $targets = (array) $targets;
+ $write_func = 'write_' . $location;
+
+ foreach ( $targets as $arg_1 => $arg_2 ) {
+ if ( self::FUNC === $location && is_array( $arg_2 ) && is_callable( $arg_2 ) ) {
+ // Handles write functions specified as an array.
+ $location_args = [ $arg_2 ];
+ } else {
+ $location_args = in_array( $location, self::$associative_locations, true )
+ ? [ $arg_1, $arg_2 ]
+ : (array) $arg_2;
+ }
+
+ $args = array_merge( $location_args, [ $value ] );
+
+ call_user_func_array( [ $this, $write_func ], $args );
+ }
+ }
+ }
+ }
+
+ /**
+ * Writes an altered context value to a request var.
+ *
+ * @since 4.9.5
+ *
+ * @param string $request_var The request var to write.
+ * @param mixed $value The value to set on the request var.
+ */
+ protected function write_request_var( $request_var, $value ) {
+ if ( isset( $_REQUEST ) ) {
+ $_REQUEST[ $request_var ] = $value;
+ }
+ if ( isset( $_GET ) ) {
+ $_GET[ $request_var ] = $value;
+ }
+ if ( isset( $_POST ) ) {
+ $_POST[ $request_var ] = $value;
+ }
+ }
+
+ /**
+ * Writes an altered context value to a global WP_Query object properties.
+ *
+ * @since 4.9.5
+ *
+ * @param string $query_prop The global WP_Query object property to write.
+ * @param mixed $value The value to set on the query property.
+ */
+ protected function write_query_prop( $query_prop, $value ) {
+ global $wp_query;
+
+ if ( ! $wp_query instanceof WP_Query ) {
+ return;
+ }
+
+ $wp_query->{$query_prop} = $value;
+ }
+
+ /**
+ * Writes an altered context value to a global WP_Query object query var.
+ *
+ * @since 4.9.5
+ *
+ * @param string $query_var The global WP_Query query var to write.
+ * @param mixed $value The value to set on the query var.
+ */
+ protected function write_query_var( $query_var, $value ) {
+ global $wp_query;
+
+ if ( ! $wp_query instanceof WP_Query ) {
+ return;
+ }
+
+ $wp_query->set( $query_var, $value );
+ }
+
+ /**
+ * Writes an altered context value to a `tribe_option`.
+ *
+ * @since 4.9.5
+ *
+ * @param string $tribe_option The `tribe_option` to write.
+ * @param mixed $value The value to set on the `tribe_option`.
+ */
+ protected function write_tribe_option( $tribe_option, $value ) {
+ tribe_update_option( $tribe_option, $value );
+ }
+
+ /**
+ * Writes an altered context value to an option.
+ *
+ * @since 4.9.5
+ *
+ * @param string $option_name The option to write.
+ * @param mixed $value The value to set on the option.
+ */
+ protected function write_option( $option_name, $value ) {
+ update_option( $option_name, $value );
+ }
+
+ /**
+ * Writes an altered context value to a transient.
+ *
+ * @since 4.9.5
+ *
+ * @param string $transient The transient to write.
+ * @param int $expiration The transient expiration time, in seconds.
+ * @param mixed $value The value to set on the transient.
+ */
+ protected function write_transient( $transient, $expiration, $value ) {
+ set_transient( $transient, $value, $expiration );
+ }
+
+ /**
+ * Writes an altered context value to a constant.
+ *
+ * @since 4.9.5
+ *
+ * @param string $constant The constant to define.
+ * @param mixed $value The value to set on the constant.
+ */
+ protected function write_constant( $constant, $value ) {
+ if ( defined( $constant ) ) {
+ return;
+ }
+ define( $constant, $value );
+ }
+
+ /**
+ * Writes an altered context value to a global var.
+ *
+ * @since 4.9.5
+ *
+ * @param string $global_var The global var to set.
+ * @param mixed $value The value to set on the global_var.
+ */
+ protected function write_global_var( $global_var, $value ) {
+ $GLOBALS[ $global_var ] = $value;
+ }
+
+ /**
+ * Writes an altered context value setting a public static property on a class.
+ *
+ * @since 4.9.5
+ *
+ * @param string $class The class to set the static public property on.
+ * @param string $prop The static public property to set.
+ * @param mixed $value The value to set on the property.
+ */
+ protected function write_static_prop( $class, $prop, $value ) {
+ if ( ! ( class_exists( $class ) && property_exists( $class, $prop ) ) ) {
+ return;
+ }
+
+ $class::$$prop = $value;
+ }
+
+ /**
+ * Writes an altered context value setting a public property on a `tribe()` binding.
+ *
+ * @since 4.9.5
+ *
+ * @param string $binding The container binding to set the public property on.
+ * @param string $prop The public property to set.
+ * @param mixed $value The value to set on the property.
+ */
+ protected function write_prop( $binding, $prop, $value ) {
+ if ( ! tribe()->offsetExists( $binding ) ) {
+ return;
+ }
+
+ $implementation = tribe( $binding );
+
+ if ( ! property_exists( $implementation, $prop ) ) {
+ return;
+ }
+
+ $implementation->{$prop} = $value;
+ }
+
+ /**
+ * Writes an altered context value calling a public static method on a class.
+ *
+ * @since 4.9.5
+ *
+ * @param string $class The class to call the public static method on.
+ * @param string $method The static method to call.
+ * @param mixed $value The value to pass to the public static method.
+ */
+ protected function write_static_method( $class, $method, $value ) {
+ if ( ! class_exists( $class ) ) {
+ return;
+ }
+ call_user_func( [ $class, $method ], $value );
+ }
+
+ /**
+ * Writes an altered context value calling a public method on a `tribe()` binding.
+ *
+ * @since 4.9.5
+ *
+ * @param string $binding The `tribe()` container binding to call the public method on.
+ * @param string $method The method to call.
+ * @param mixed $value The value to pass to the public method.
+ */
+ protected function write_method( $binding, $method, $value ) {
+ if ( ! tribe()->offsetExists( $binding ) ) {
+ return;
+ }
+ call_user_func( [ tribe( $binding ), $method ], $value );
+ }
+
+ /**
+ * Writes an altered context value calling a function or closure.
+ *
+ * @since 4.9.5
+ *
+ * @param callable $func function, closure or callable to call.
+ * @param mixed $value The value to pass to the callable.
+ */
+ protected function write_func( $func, $value ) {
+ if ( ! is_callable( $func ) ) {
+ return;
+ }
+ call_user_func( $func, $value );
+ }
+
+ /**
+ * Adds/replaces read and write locations to a context.
+ *
+ * Locations are merged with an `array_merge` call. To refine the locations get them first with the
+ * `get_locations` method.
+ *
+ * @since 4.9.5
+ *
+ * @param array $locations An array of read and write locations to add to the context.
+ * The array should have the same shape as the static `$locations`
+ * one: `[ => [ 'read' => , 'write' => ] ]`.
+ *
+ *
+ * @return \Tribe__Context A clone of the current context with the additional read and
+ * write locations added.
+ */
+ public function add_locations( array $locations ) {
+ $clone = clone $this;
+ $clone->override_locations = array_merge( $clone->override_locations, $locations );
+
+ return $clone;
+ }
+
+ /**
+ * Sets, replacing them, the locations used by this context.
+ *
+ *
+ * @since 4.9.5
+ *
+ * @param array $locations An array of locations to replace the current ones.
+ * @param bool $use_default_locations Whether the context should use the default
+ * locations defined in the static `$locations`
+ * property or not.
+ *
+ * @return \Tribe__Context A clone of the current context with modified locations.
+ */
+ public function set_locations( array $locations, $use_default_locations = true ) {
+ $clone = clone $this;
+ $clone->override_locations = $locations;
+ $clone->use_default_locations = (bool) $use_default_locations;
+
+ return $clone;
+ }
+
+ /**
+ * Returns an array representation of the context.
+ *
+ * @since 4.9.5
+ *
+ * @return array An associative array of the context keys and values.
+ */
+ public function to_array( ) {
+ $locations = array_keys( array_merge( $this->get_locations(), $this->request_cache ) );
+ $dump = [];
+
+ foreach ( $locations as $location ) {
+ $the_value = $this->get( $location, self::NOT_FOUND );
+
+ if ( self::NOT_FOUND === $the_value ) {
+ continue;
+ }
+
+ $dump[ $location ] = $the_value;
+ }
+
+ return $dump;
+ }
+
+ /**
+ * Returns the current context state in a format suitable to hydrate a Redux-like
+ * store on the front-end.
+ *
+ * This method is a filtered wrapper around the the `Tribe__Context::to_array` method to allow the
+ * customization of the format when producing a store-compatible state.
+ *
+ * @param array|null $fields An optional whitelist or blacklist of fields to include
+ * depending on the value of the `$whitelist` parameter;
+ * defaults to returning all available fields.
+ * @param bool $whitelist Whether the list of fields provided in the `$fields`
+ * parameter should be treated as a whitelist (`true`) or
+ * blacklist (`false`).
+ *
+ * @since 4.9.5
+ *
+ * @return array
+ */
+ public function get_state( array $fields = null, $whitelist = true ) {
+ $state = $this->to_array();
+ $is_global_context = tribe_context() === $this;
+
+ if ( null !== $fields ) {
+ $state = $whitelist
+ ? array_intersect_key( $state, array_combine( $fields, $fields ) )
+ : array_diff_key( $state, array_combine( $fields, $fields ) );
+ }
+
+ /**
+ * Filters the Redux store compatible state produced from the current context.
+ *
+ * @since 4.9.5
+ *
+ * @param array $state The Redux store compatible state produced from the current context.
+ * @param bool $is_global_context Whether the context producing the state is the global one
+ * or a modified clone of it.
+ * @param Tribe__Context The context object producing the state.
+ */
+ $state = apply_filters( 'tribe_context_state', $state, $is_global_context, $this );
+
+ if ( $is_global_context ) {
+ /**
+ * Filters the Redux store compatible state produced from the global context.
+ *
+ * While the `tribe_context_state` filter will apply to all contexts producing a
+ * state this filter will only apply to the global context.
+ *
+ * @since 4.9.5
+ *
+ * @param array $state The Redux store compatible state produced from the global context.
+ * @param Tribe__Context The global context object producing the state.
+ */
+ $state = apply_filters( 'tribe_global_context_state', $state, $this );
+ }
+
+ return $state;
+ }
+
+ /**
+ * Returns an array of ORM arguments generated from the current context values.
+ *
+ * @since 4.9.5
+ *
+ * @param array|null $fields An optional whitelist or blacklist of fields to include
+ * depending on the value of the `$whitelist` parameter;
+ * defaults to returning all available fields.
+ * @param bool $whitelist Whether the list of fields provided in the `$fields`
+ * parameter should be treated as a whitelist (`true`) or
+ * blacklist (`false`).
+ *
+ * @return array A map of ORM fields produced from the context current values.
+ */
+ public function get_orm_args( array $fields = null, $whitelist = true ) {
+ $locations = $this->get_locations();
+ $dump = $this->to_array();
+ $orm_args = [];
+ $is_global_context = tribe_context() === $this;
+
+ foreach ( $dump as $key => $value ) {
+ $alias = isset( $locations[ $key ]['orm_arg'] )
+ ? $locations[ $key ]['orm_arg']
+ : $key;
+
+ if ( false === $alias ) {
+ // Do not provide the variable as an ORM arg.
+ continue;
+ }
+
+ if ( isset( $locations[ $key ]['orm_transform'] ) ) {
+ $value = call_user_func( $locations[ $key ]['orm_transform'], $value );
+ }
+
+ $orm_args[ $alias ] = $value;
+ }
+
+ if ( null !== $fields ) {
+ /*
+ * Only keep wanted fields, the filtering is done on the resolved aliases,
+ * from the perspective of the client code that might ignore the source keys.
+ */
+ $orm_args = $whitelist
+ ? array_intersect_key( $orm_args, array_combine( $fields, $fields ) )
+ : array_diff_key( $orm_args, array_combine( $fields, $fields ) );
+ }
+
+ /**
+ * Filters the ORM arguments produced from the current context.
+ *
+ * @since 4.9.5
+ *
+ * @param array $orm_args The ORM args produced from the current context.
+ * @param bool $is_global_context Whether the context producing the ORM args is the global one
+ * or a modified clone of it.
+ * @param Tribe__Context The context object producing the ORM args.
+ */
+ $orm_args = apply_filters( 'tribe_context_orm_args', $orm_args, $is_global_context, $this );
+
+ if ( $is_global_context ) {
+ /**
+ * Filters the ORM arguments produced from the global context.
+ *
+ * While the `tribe_context_orm_args` filter will apply to all contexts producing ORM
+ * args this filter will only apply to the global context.
+ *
+ * @since 4.9.5
+ *
+ * @param array $orm_args The ORM args produced from the global context.
+ * @param Tribe__Context The global context object producing the ORM args.
+ */
+ $orm_args = apply_filters( 'tribe_global_context_orm_args', $orm_args, $this );
+ }
+
+ return $orm_args;
+ }
+
+ /**
+ * Sets some locations that can only be set at runtime.
+ *
+ * Using a flag locations are added only once per request.
+ *
+ * @since 4.9.8
+ */
+ protected function populate_locations() {
+ if ( static::$did_populate_locations ) {
+ return;
+ }
+
+ // To improve the class readability, and as a small optimization, locations are loaded from a file.
+ static::$locations = include __DIR__ . '/Context/locations.php';
+
+ /**
+ * Filters the locations registered in the Context.
+ *
+ * @since 4.9.8
+ *
+ * @param array $locations An array of locations registered on the Context object.
+ */
+ static::$locations = apply_filters( 'tribe_context_locations', static::$locations, $this );
+
+ static::$did_populate_locations = true;
+ }
+
+ /**
+ * Just dont...
+ * Unless you very specifically know what you are doing **DO NOT USE THIS METHOD**!
+ *
+ * Please keep in mind this will set force the context to repopulate all locations for the whole request, expensive
+ * and very dangerous overall since it could affect all this things we hold dear in the request.
+ *
+ * With great power comes great responsibility: think a lot before using this.
+ *
+ * @since 4.13.0
+ */
+ public function dangerously_repopulate_locations() {
+ static::$did_populate_locations = false;
+ $this->populate_locations();
+ }
+
+ /**
+ * Reads (gets) the value applying one or more filters.
+ *
+ * @since 4.9.8
+ *
+ * @param array $filters The list of filters to apply, in order.
+ * @param mixed $default The default value to return.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ public function filter( array $filters, $default ) {
+ foreach ( $filters as $filter ) {
+ $the_value = apply_filters( $filter, $default );
+ if ( $the_value !== $default ) {
+ return $the_value;
+ }
+ }
+
+ return $default;
+ }
+
+ /**
+ * Reads (gets) the value reading it from a query var parsed from the global `$wp` object.
+ *
+ * @since 4.9.8
+ *
+ * @param array $vars The list of variables to read, in order.
+ * @param mixed $default The default value to return if no variable was parsed.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ public function wp_parsed( array $vars, $default ) {
+ /** @var WP $wp */
+ global $wp;
+
+ if ( ! $wp instanceof WP || empty($wp->query_vars) ) {
+ return $default;
+ }
+
+ return Arr::get_first_set( (array) $wp->query_vars, $vars, $default );
+ }
+
+ /**
+ * Reads (gets) the value reading it from a query var parsed from the query matched by the global `$wp` object.
+ *
+ * @since 4.9.8
+ *
+ * @param array $vars The list of variables to read, in order.
+ * @param mixed $default The default value to return if no variable was parsed.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ public function wp_matched_query( array $vars, $default ) {
+ /** @var WP $wp */
+ global $wp;
+
+ if ( ! $wp instanceof WP || empty( $wp->matched_query ) ) {
+ return $default;
+ }
+
+ parse_str( $wp->matched_query, $query_vars );
+
+ return Arr::get_first_set( (array) $query_vars, $vars, $default );
+ }
+
+ /**
+ * Maps an input array to the corresponding read locations.
+ *
+ * The resulting array can be used as input for the `alter_values` method.
+ * The main use of this method is to leverage the Context knowledge of the read locations, and their types, to
+ * "translate" an array of values to an array of valid read sources. As an example this is useful to "translate"
+ * the locations to an array of query vars:
+ * $input = [ 'event_display' => 'some-view', 'event_date' => '2018-01-03' ];
+ * $query_args = tribe_context()->map_to_read( $input, Tribe__Context::REQUEST_VAR );
+ * $url = add_query_arg( $query_args, home_url() );
+ *
+ * @since 4.9.11
+ *
+ * @param array $input An associative array of values in the shape `[ => ]`;
+ * where `location` is the name of the location registered in the Context
+ * locations.
+ * @param string|array|null $types A white-list of read location types to include in the mapped output;
+ * `null`
+ * means all types are allowed.
+ * @param bool $passthru Whether to pass unknown locations in the output or not; if `false` then
+ * any input key that's not a context location will not appear in the output;
+ * defaults to `false` to remove unknown locations from the output.
+ *
+ * @return array An associative array in the shape `[ => ]`. Since some read
+ * locations could have multiple sources the number of elements in this array will likely NOT be the
+ * same as the number of elements in the input array. When a read location as more than 1 source then
+ * the value will be duplicated, in the output array, to both sources.
+ */
+ public function map_to_read( array $input, $types = null, $passthru = false ) {
+ $mapped = [];
+ $processed = [];
+ $types = null !== $types ? (array) $types : null;
+
+ $locations = $this->get_locations();
+
+ // Take the current read locations
+ foreach ( $locations as $key => $location ) {
+ if ( ! isset( $location['read'], $input[ $key ] ) ) {
+ continue;
+ }
+
+ $processed[] = $key;
+
+ foreach ( $location['read'] as $type => $name ) {
+ if ( null !== $types && ! in_array( $type, $types, true ) ) {
+ continue;
+ }
+
+ foreach ( (array) $name as $destination ) {
+ $mapped[ $destination ] = $input[ $key ];
+ }
+ }
+ }
+
+ if ( $passthru ) {
+ $mapped = array_merge(
+ $mapped,
+ array_diff_key( $input, array_keys( $locations ), array_combine( $processed, $processed ) )
+ );
+ }
+
+ ksort( $mapped );
+
+ return $mapped;
+ }
+
+ /**
+ * Translates sub-locations to their respective location key.
+ *
+ * This method leverages the inherent knowledge of aliases stored in the Context locations to "translate" a
+ * sub-location to its location key.
+ * E.g. assume the `car` location is `read` from the [ 'carriage', 'vehicle', 'transport_mean' ] query var; calling
+ * `$context->populate_aliases( [ 'vehicle' => 'hyunday' ], 'read', Context::QUERY_VAR )` would yield
+ * `[ 'car' => 'hyunday' ]`.
+ *
+ * @since 4.9.12
+ *
+ * @param array $values An associative array of value to use as "masters" to populate the aliases.
+ * @param string $type The type of Context location to use, e.g. `Tribe__Context::QUERY_VAR`.
+ * @param string $direction The direction to use for the location, one of `read` or `write`.
+ *
+ * @return array The original array, merged with the populated values.
+ */
+ public function translate_sub_locations( array $values, $type, $direction = 'read' ) {
+ if ( ! in_array( $direction, [ 'read', 'write' ], true ) ) {
+ throw new \InvalidArgumentException(
+ "Direction must be one of `read` or `write`; `{$direction}` is not valid."
+ );
+ }
+
+ $filled = [];
+ $locations = $this->get_locations();
+ $matching_locations = array_filter( $locations, static function ( $location ) use ( $type, $direction ) {
+ return isset( $location[ $direction ][ $type ] );
+ } );
+
+ foreach ( $matching_locations as $key => $location ) {
+ $entry = (array)$location[ $direction ][ $type ];
+ $found = array_intersect( array_keys( $values ), array_merge( $entry, [ $key ] ) );
+ if ( $found ) {
+ $filled[ $key ] = $values[ reset( $found ) ];
+ }
+ }
+
+ return $filled;
+ }
+
+ /**
+ * Convenience method to get and check if a location has a truthy value or not.
+ *
+ * @since 4.9.18
+ *
+ * @param string $flag_key The location to check.
+ * @param bool $default The default value to return if the location is not set.
+ *
+ * @return bool Whether the location has a truthy value or not.
+ */
+ public function is( $flag_key, $default = false ) {
+ $val = $this->get( $flag_key, $default );
+
+ return ! empty( $val ) || tribe_is_truthy( $val );
+ }
+
+ /**
+ * Reads the value from one callback, passing it the value of another Context location.
+ *
+ * @since 4.9.18
+ *
+ * @param array $location_and_callback An array of two elements: the location key and the callback to call on the
+ * location value. The callback will receive the location value as argument.
+ *
+ * @return mixed The return value of the callback, called on the location value.
+ */
+ public function location_func( array $location_and_callback ) {
+ list( $location, $callback ) = $location_and_callback;
+
+ return $callback( $this->get( $location ) );
+ }
+
+ /**
+ * Checks whether the current request is a REST API one or not.
+ *
+ * @since 4.9.20
+ *
+ * @return bool Whether the current request is a REST API one or not.
+ */
+ public function doing_rest() {
+ return defined( 'REST_REQUEST' ) && REST_REQUEST;
+ }
+
+ /**
+ * Reads the value from one or more global WP_Query object methods.
+ *
+ * @since 4.9.20
+ *
+ * @param array $query_vars The list of query methods to call, in order.
+ * @param mixed $default The default value to return if no method was defined on the global `WP_Query` object.
+ *
+ * @return mixed The first valid value found or the default value.
+ */
+ public function query_method( $methods, $default ) {
+ global $wp_query;
+ $found = $default;
+
+ foreach ( $methods as $method ) {
+ $this_value = $wp_query instanceof WP_Query && method_exists( $wp_query, $method )
+ ? call_user_func( [ $wp_query, $method ] )
+ : static::NOT_FOUND;
+
+ if ( static::NOT_FOUND !== $this_value ) {
+ return $this_value;
+ }
+ }
+
+ return $found;
+ }
+
+ /**
+ * Whether the current request is for a PHP-rendered initial state or not.
+ *
+ * This method is a shortcut to make sure we're not doing an AJAX, REST or Cron request.
+ *
+ * @since 4.9.20
+ *
+ * @return bool Whether the current request is for a PHP-rendered initial state or not.
+ */
+ public function doing_php_initial_state() {
+ return ! $this->doing_rest() && ! $this->doing_ajax() && ! $this->doing_cron();
+ }
+
+ /**
+ * Returns the first key, if there are many, that will be used to read a location.
+ *
+ * The type ar
+ *
+ * @since 4.9.20
+ *
+ * @param string $location The location to get the read key for.
+ * @param string|null $type The type of read location to return the key for; default to `static::REQUEST_VAR`.
+ *
+ * @return string Either the first key for the type of read location, or the input location if not found.
+ */
+ public function get_read_key_for( $location, $type = null ) {
+ $type = $type ?: static::REQUEST_VAR;
+ $locations = $this->get_locations();
+ if ( isset( $locations[ $location ]['read'][ $type ] ) ) {
+ $keys = (array) $locations[ $location ]['read'][ $type ];
+ return reset( $keys );
+ }
+
+ return $location;
+ }
+
+ /**
+ * Safely set the value of a group of locations.
+ *
+ * This method can only augment the context, without altering it; it can only add new values.
+ *
+ * @since 4.10.2
+ *
+ * @param array|string $values The values to set, if not already set or the key of the value to set, requires
+ * the `$value` to be passed.
+ * @param mixed|null $value The value to set for the key, this parameter will be ignored if the `$values_or_key`
+ * parameter is not a string.
+ */
+ public function safe_set( $values_or_key, $value = null ) {
+ $values = func_num_args() === 2
+ ? [ $values_or_key => $value ]
+ : $values_or_key;
+
+ foreach ( $values as $key => $val ) {
+ if ( static::NOT_FOUND !== $this->get( $key, static::NOT_FOUND ) ) {
+ continue;
+ }
+ $this->request_cache[ $key ] = $val;
+ }
+ }
+
+ /**
+ * Whether the current request is one to edit a list of the specified post types or not.
+ *
+ * The admin edit screen for a post type is the one that lists all the posts of that typ,
+ * it has the URL `/wp-admin/edit.php?post_type=`.
+ *
+ * @since 5.0.13
+ * @since 5.0.13 Extracted the logic to the `TEC\Common\Context\Post_Request_Type` class.
+ *
+ * @param string|array $post_type The post type or post types to check.
+ *
+ * @return bool Whether the current request is one to edit a list of the specified post types or not.
+ */
+ public function is_editing_posts_list( $post_type ): bool {
+ return $this->post_state->is_editing_post_list( $post_type );
+ }
+
+ /**
+ * Whether the current request is one to quick edit a single post of the specified post type or not.
+ *
+ * @since 5.0.13
+ *
+ * @param string|array $post_type The post type or post types to check.
+ *
+ * @return bool Whether the current request is one to quick edit a single post of the specified post type or not.
+ */
+ public function is_inline_editing_post( $post_type ): bool {
+ return $this->post_state->is_inline_editing_post( $post_type );
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Context/locations.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Context/locations.php
new file mode 100644
index 000000000..6a433dd97
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Context/locations.php
@@ -0,0 +1,163 @@
+ [
+ 'read' => [
+ Tribe__Context::FUNC => static function () {
+ return get_the_ID();
+ }
+ ],
+ ],
+ 'permalink_structure' => [
+ 'read' => [
+ Tribe__Context::OPTION => [ 'permalink_structure' ],
+ ],
+ ],
+ 'plain_permalink' => [
+ 'read' => [
+ Tribe__Context::LOCATION_FUNC => [
+ 'permalink_structure',
+ static function( $struct ){
+ return empty( $struct );
+ },
+ ],
+ ],
+ ],
+ 'posts_per_page' => [
+ 'read' => [
+ Tribe__Context::REQUEST_VAR => 'posts_per_page',
+ Tribe__Context::OPTION => 'posts_per_page',
+ Tribe__Context::TRIBE_OPTION => [ 'posts_per_page', 'postsPerPage' ],
+ ],
+ 'write' => [
+ Tribe__Context::REQUEST_VAR => 'posts_per_page',
+ ],
+ ],
+ 'is_main_query' => [
+ 'read' => [
+ Tribe__Context::FUNC => static function () {
+ global $wp_query;
+
+ if ( empty( $wp_query ) ) {
+ return false;
+ }
+
+ if ( ! $wp_query instanceof WP_Query ) {
+ return false;
+ }
+
+ return $wp_query->is_main_query();
+ },
+ ],
+ 'write' => [
+ Tribe__Context::FUNC => static function () {
+ global $wp_query, $wp_the_query;
+ $wp_the_query = $wp_query;
+ },
+ ],
+ ],
+ 'paged' => [
+ 'read' => [
+ Tribe__Context::REQUEST_VAR => [ 'paged', 'page' ],
+ Tribe__Context::QUERY_VAR => [ 'paged', 'page' ],
+ ],
+ 'write' => [
+ Tribe__Context::REQUEST_VAR => 'paged',
+ Tribe__Context::QUERY_VAR => 'paged',
+ ],
+ ],
+ 'page' => [
+ 'read' => [
+ Tribe__Context::REQUEST_VAR => [ 'page', 'paged' ],
+ Tribe__Context::QUERY_VAR => [ 'page', 'paged' ],
+ ],
+ 'write' => [
+ Tribe__Context::REQUEST_VAR => 'page',
+ Tribe__Context::QUERY_VAR => 'page',
+ ],
+ ],
+ 'name' => [
+ 'read' => [
+ Tribe__Context::REQUEST_VAR => [ 'name', 'post_name' ],
+ Tribe__Context::WP_PARSED => [ 'name', 'post_name' ],
+ Tribe__Context::QUERY_VAR => [ 'name', 'post_name' ],
+ ],
+ 'write' => [
+ Tribe__Context::REQUEST_VAR => [ 'name', 'post_name' ],
+ Tribe__Context::QUERY_VAR => [ 'name', 'post_name' ],
+ ],
+ ],
+ 'post_type' => [
+ 'read' => [
+ Tribe__Context::FUNC => static function() {
+ $post_type_objs = get_post_types(
+ [
+ 'public' => true,
+ '_builtin' => false,
+ ],
+ 'objects'
+ );
+
+ foreach ( $post_type_objs as $post_type ) {
+ if ( empty( $post_type->query_var ) ) {
+ continue;
+ }
+
+ $url_value = tribe_get_request_var( $post_type->query_var, false );
+ if ( empty( $url_value ) ) {
+ continue;
+ }
+
+ return $post_type->name;
+ }
+
+ return Tribe__Context::NOT_FOUND;
+ },
+ Tribe__Context::QUERY_PROP => 'post_type',
+ Tribe__Context::QUERY_VAR => 'post_type',
+ Tribe__Context::REQUEST_VAR => 'post_type',
+ ],
+ ],
+ 'single' => [
+ 'read' => [ Tribe__Context::QUERY_METHOD => 'is_single' ]
+ ],
+ 'taxonomy' => [
+ 'read' => [
+ Tribe__Context::QUERY_PROP => [ 'taxonomy' ],
+ Tribe__Context::QUERY_VAR => [ 'taxonomy' ],
+ Tribe__Context::REQUEST_VAR => [ 'taxonomy' ],
+ ],
+ ],
+ 'post_tag' => [
+ 'read' => [
+ Tribe__Context::QUERY_PROP => [ 'post_tag', 'tag' ],
+ Tribe__Context::QUERY_VAR => [ 'post_tag', 'tag' ],
+ Tribe__Context::REQUEST_VAR => [ 'post_tag', 'tag' ],
+ ],
+ ],
+ 'bulk_edit' => [
+ 'read' => [
+ Tribe__Context::REQUEST_VAR => [ 'bulk_edit' ],
+ ],
+ ],
+ 'inline_save' => [
+ 'read' => [
+ Tribe__Context::FUNC => [
+ static function () {
+ return tribe_get_request_var( 'action', false ) === 'inline-save'
+ ? true
+ : Tribe__Context::NOT_FOUND;
+ }
+ ],
+ ],
+ ],
+];
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Cost_Utils.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Cost_Utils.php
new file mode 100644
index 000000000..42a112a19
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Cost_Utils.php
@@ -0,0 +1,542 @@
+get_cost_regex(), trim( $cost ) );
+ }
+
+ /**
+ * Returns the regular expression that shold be used to identify a valid
+ * cost string.
+ *
+ * @return string
+ */
+ public function get_cost_regex() {
+ $separators = '[\\' . implode( '\\', $this->get_separators() ) . ']?';
+ $cost_regex = '(' . $separators . '([\d]+)' . $separators . '([\d]*))';
+
+ /**
+ * Filters the regular expression that will be used to identify a valid cost
+ * string.
+ *
+ * @param string $cost_regex
+ *
+ * @deprecated 4.3 Use `tribe_cost_regex` instead
+ */
+ $cost_regex = apply_filters(
+ 'tribe_events_cost_regex', $cost_regex
+ );
+
+ /**
+ * Filters the regular expression that will be used to identify a valid cost
+ * string.
+ *
+ * @param string $cost_regex
+ */
+ $cost_regex = apply_filters( 'tribe_cost_regex', $cost_regex );
+
+ return $cost_regex;
+ }
+
+ /**
+ * Fetch the possible separators
+ *
+ * @return array
+ */
+ public function get_separators() {
+ $separators = [ ',', '.' ];
+
+ /**
+ * Filters the cost string possible separators, those must be only 1 char.
+ *
+ * @param array $separators Defaults to comma (",") and period (".")
+ */
+ return apply_filters( 'tribe_events_cost_separators', $separators );
+ }
+
+ /**
+ * If the cost is "0", call it "Free"
+ *
+ * @param int|float|string $cost Cost to analyze
+ *
+ * @return int|float|string
+ */
+ public function maybe_replace_cost_with_free( $cost ) {
+
+ $cost_with_period = $this->convert_decimal_separator( $cost );
+
+ if (
+ is_numeric( $cost_with_period )
+ && '0.00' === number_format( $cost_with_period, 2, '.', ',' )
+ ) {
+ return esc_html__( 'Free', 'tribe-common' );
+ }
+
+ return $cost;
+ }
+
+ /**
+ * Formats a cost with a currency symbol
+ *
+ * @param int|float|string $cost Cost to format
+ *
+ * return string
+ * @param int|WP_Post $event An event post ID or post object.
+ * @param string $currency_symbol
+ * @param string $currency_position Either "prefix" or "posfix"
+ *
+ * @return float|int|string
+ */
+ public function maybe_format_with_currency( $cost, $event = null, $currency_symbol = null, $currency_position = null ) {
+ // check if the currency symbol is desired, and it's just a number in the field
+ // be sure to account for european formats in decimals, and thousands separators
+ if ( is_numeric( str_replace( $this->get_separators(), '', $cost ) ) ) {
+ $reverse_position = null;
+ // currency_position often gets passed as null or an empty string.
+ if ( ! empty( $currency_position ) ) {
+ $reverse_position = 'prefix' === $currency_position ? false : true;
+ }
+
+ $cost = tribe_format_currency( $cost, $event, $currency_symbol, $reverse_position );
+ }
+
+ return $cost;
+ }
+
+ /**
+ * @param string $original_string_cost A string cost with or without currency symbol,
+ * e.g. `10 - 20`, `Free` or `2$ - 4$`.
+ * @param array|string $merging_cost A single string cost representation to merge or an array of
+ * string cost representations to merge, e.g. ['Free', 10, 20,
+ * 'Donation'] or `Donation`.
+ * @param bool $with_currency_symbol Whether the output should prepend the currency symbol to the
+ * numeric costs or not.
+ * @param array $sorted_mins An array of non numeric price minimums sorted smaller to larger,
+ * e.g. `['Really free', 'Somewhat free', 'Free with 3 friends']`.
+ * @param array $sorted_maxs An array of non numeric price maximums sorted smaller to larger,
+ * e.g. `['Donation min $10', 'Donation min $20', 'Donation min
+ * $100']`.
+ *
+ * @return string|array The merged cost range.
+ */
+ public function merge_cost_ranges( $original_string_cost, $merging_cost, $with_currency_symbol, $sorted_mins = [], $sorted_maxs = [] ) {
+ if ( empty( $merging_cost ) || $original_string_cost === $merging_cost ) {
+ return $original_string_cost;
+ }
+
+ $_merging_cost = array_map(
+ [ $this, 'convert_decimal_separator' ], (array) $merging_cost
+ );
+ $_merging_cost = array_map( [ $this, 'numerize_numbers' ], $_merging_cost );
+ $numeric_merging_cost_costs = array_filter( $_merging_cost, 'is_numeric' );
+
+ $matches = [];
+ preg_match_all(
+ '!\d+(?:([' . preg_quote( $this->_supported_decimal_separators ) . '])\d+)?!', $original_string_cost,
+ $matches
+ );
+ $this->_current_original_cost_separator = empty( $matches[1][0] ) ? '.' : $matches[1][0];
+ $matches[0] = empty( $matches[0] )
+ ? $matches[0]
+ : array_map(
+ [
+ $this,
+ 'convert_decimal_separator',
+ ],
+ $matches[0]
+ );
+
+ $numeric_orignal_costs = empty( $matches[0] ) ? $matches[0] : array_map(
+ 'floatval', $matches[0]
+ );
+
+ $all_numeric_costs = array_filter( array_merge( $numeric_merging_cost_costs, $numeric_orignal_costs ) );
+ $cost_min = $cost_max = false;
+
+ $merging_mins = array_intersect( $sorted_mins, (array) $merging_cost );
+ $merging_has_min = array_search( reset( $merging_mins ), $sorted_mins );
+ $original_has_min = array_search( $original_string_cost, $sorted_mins );
+ $merging_has_min = false === $merging_has_min ? 999 : $merging_has_min;
+ $original_has_min = false === $original_has_min ? 999 : $original_has_min;
+ $string_min_key = min( $merging_has_min, $original_has_min );
+ if ( array_key_exists( $string_min_key, $sorted_mins ) ) {
+ $cost_min = $sorted_mins[ $string_min_key ];
+ } else {
+ $cost_min = empty( $all_numeric_costs ) ? '' : min( $all_numeric_costs );
+ }
+
+ $merging_maxs = array_intersect( $sorted_maxs, (array) $merging_cost );
+ $merging_has_max = array_search( end( $merging_maxs ), $sorted_maxs );
+ $original_has_max = array_search( $original_string_cost, $sorted_maxs );
+ $merging_has_max = false === $merging_has_max ? - 1 : $merging_has_max;
+ $original_has_max = false === $original_has_max ? - 1 : $original_has_max;
+ $string_max_key = max( $merging_has_max, $original_has_max );
+ if ( array_key_exists( $string_max_key, $sorted_maxs ) ) {
+ $cost_max = $sorted_maxs[ $string_max_key ];
+ } else {
+ $cost_max = empty( $all_numeric_costs ) ? '' : max( $all_numeric_costs );
+ }
+
+ $cost = array_filter( [ $cost_min, $cost_max ] );
+
+ if ( $with_currency_symbol ) {
+ $formatted_cost = [];
+ foreach ( $cost as $c ) {
+ $formatted_cost[] = is_numeric( $c ) ? tribe_format_currency( $c ) : $c;
+ }
+ $cost = $formatted_cost;
+ }
+
+ return empty( $cost ) ? $original_string_cost : array_map(
+ [ $this, 'restore_original_decimal_separator' ],
+ $cost
+ );
+ }
+
+ /**
+ * Returns a maximum cost in a list of costs. If an array of costs is not passed in, the array of costs is fetched
+ * via query.
+ *
+ * @param $costs mixed Cost(s) to review for max value
+ *
+ * @return float
+ */
+ public function get_maximum_cost( $costs = null ) {
+ return $this->get_cost_by_func( $costs, 'max' );
+ }
+
+ /**
+ * Returns a particular cost within an array of costs
+ *
+ * @param $costs mixed Cost(s) to review for max value
+ * @param $function string Function to use to determine which cost to return from range. Valid values: max, min
+ *
+ * @return float
+ */
+ protected function get_cost_by_func( $costs = null, $function = 'max' ) {
+ if ( null === $costs ) {
+ $costs = $this->get_all_costs();
+ } else {
+ $costs = (array) $costs;
+ }
+
+ $costs = $this->parse_cost_range( $costs );
+
+ // if there's only one item, we're looking at a single event. If the cost is non-numeric, let's
+ // return the non-numeric cost so that value is preserved
+ if ( 1 === count( $costs ) && ! is_numeric( current( $costs ) ) ) {
+ return current( $costs );
+ }
+
+ // make sure we are only trying to get numeric min/max values
+ $costs = array_filter( $costs, 'is_numeric' );
+
+ if ( empty( $costs ) ) {
+ return 0;
+ }
+
+ switch ( $function ) {
+ case 'min':
+ $cost = $costs[ min( array_keys( $costs ) ) ];
+ break;
+ case 'max':
+ default:
+ $cost = $costs[ max( array_keys( $costs ) ) ];
+ break;
+ }
+
+ // If there isn't anything on the cost just return 0
+ if ( empty( $cost ) ) {
+ return 0;
+ }
+
+ return $cost;
+ }
+
+ /**
+ * Parses a cost into an array of ranges.
+ *
+ * If a range isn't provided, the resulting array will hold a single
+ * value.
+ *
+ * @param string|array $costs A cost string or an array of cost strings.
+ * @param null $max_decimals The maximum number of decimal values that should be returned in the range.
+ * @param bool $sort Whether the returned values should be sorted.
+ *
+ * @return array An associative array of parsed costs in [ => ] format.
+ */
+ public function parse_cost_range( $costs, $max_decimals = null, $sort = true ) {
+ if ( ! is_array( $costs ) && ! is_string( $costs ) ) {
+ return [];
+ }
+
+ // make sure costs is an array
+ $costs = (array) $costs;
+
+ // If there aren't any costs, return a blank array
+ if ( 0 === count( $costs ) ) {
+ return [];
+ }
+
+ // Build the regular expression
+ $price_regex = $this->get_cost_regex();
+ $max = 0;
+
+ foreach ( $costs as &$cost ) {
+ // Get the required parts
+ if ( preg_match_all( '/' . $price_regex . '/', $cost, $matches ) ) {
+ $cost = reset( $matches );
+ } else {
+ $cost = [ $cost ];
+ continue;
+ }
+
+ // Get the max number of decimals for the range
+ if ( count( $matches ) === 4 ) {
+ $decimals = max( array_map( 'strlen', end( $matches ) ) );
+ $max = max( $max, $decimals );
+ }
+ }
+
+ // If we passed max decimals
+ if ( ! is_null( $max_decimals ) ) {
+ $max = max( $max_decimals, $max );
+ }
+
+ $output_costs = [];
+ $costs = call_user_func_array( 'array_merge', array_values( $costs ) );
+
+ foreach ( $costs as $cost ) {
+ $numeric_cost = str_replace( $this->get_separators(), '.', $cost );
+
+ if ( is_numeric( $numeric_cost ) ) {
+ // Creates a Well Balanced Index that will perform good on a Key Sorting method
+ $index = str_replace( [ '.', ',' ], '', number_format( $numeric_cost, $max ) );
+ } else {
+ // Makes sure that we have "index-safe" string
+ $index = sanitize_title( $numeric_cost );
+ }
+
+ // Keep the Costs in a organizable array by keys with the "numeric" value
+ $output_costs[ $index ] = $cost;
+ }
+
+ // Filter keeping the Keys
+ if ( $sort ) {
+ ksort( $output_costs );
+ }
+
+ return (array) $output_costs;
+ }
+
+ /**
+ * Returns a minimum cost in a list of costs. If an array of costs is not passed in, the array of costs is fetched
+ * via query.
+ *
+ * @param $costs mixed Cost(s) to review for min value
+ *
+ * @return float
+ */
+ public function get_minimum_cost( $costs = null ) {
+ return $this->get_cost_by_func( $costs, 'min' );
+ }
+
+ /**
+ * Converts the original decimal separator to ".".
+ *
+ * @param string|int $value
+ *
+ * @return string
+ */
+ protected function convert_decimal_separator( $value ) {
+ return preg_replace( '/[' . preg_quote( $this->_supported_decimal_separators ) . ']/', '.', $value );
+ }
+
+ /**
+ * Restores the decimal separator to its original symbol.
+ *
+ * @param string $value
+ *
+ * @return string
+ */
+ protected function restore_original_decimal_separator( $value ) {
+ return str_replace( '.', $this->_current_original_cost_separator, $value );
+ }
+
+ /**
+ * Extracts int and floats from a numeric "dirty" string like strings that might contain other symbols.
+ *
+ * E.g. "$10" will yield "10"; "23.55$" will yield "23.55".
+ *
+ * @param string|int $value
+ *
+ * @return int|float
+ */
+ protected function numerize_numbers( $value ) {
+ $matches = [];
+
+ $pattern = '/(\\d{1,}([' . $this->_supported_decimal_separators . ']\\d{1,}))/';
+
+ return preg_match( $pattern, $value, $matches ) ? $matches[1] : $value;
+ }
+
+ /**
+ * Parses the currency symbol part of a cost string.
+ *
+ * @param string|array $cost A string cost, a comma separated array of string costs or an array of costs.
+ *
+ * @return false|string Either the inferred currency symbol or `false` if the currency symbol is missing or not consistent.
+ */
+ public function parse_currency_symbol( $cost ) {
+ if ( empty( $cost ) ) {
+ return false;
+ }
+
+ $original_costs = is_array( $cost ) ? $cost : preg_split( '/\\s*,\\s*/', $cost );
+ $costs = $this->parse_cost_range( $original_costs, null, false );
+
+ if ( empty( $costs ) ) {
+ return false;
+ }
+
+ $currency_symbols = [];
+ $i = 0;
+ foreach ( $costs as $string => $value ) {
+ if ( is_numeric( $string ) ) {
+ $currency_symbols[] = trim( str_replace( $value, '', $original_costs[ $i ] ) );
+ if ( end( $currency_symbols ) !== reset( $currency_symbols ) ) {
+ return false;
+ }
+ }
+
+ $i ++;
+ }
+
+ return ! empty( $currency_symbols ) ? reset( $currency_symbols ) : false;
+ }
+
+ /**
+ * Parses the currency symbol position part of a cost string.
+ *
+ * @param string|array $cost A string cost, a comma separated array of string costs or an array of costs.
+ *
+ * @return false|string Either the inferred currency symbol position or `false` if not present or not consistent.
+ */
+ public function parse_currency_position( $cost ) {
+ if ( empty( $cost ) ) {
+ return false;
+ }
+
+ $original_costs = is_array( $cost ) ? $cost : preg_split( '/\\s*,\\s*/', $cost );
+ $currency_symbol = $this->parse_currency_symbol( $original_costs );
+
+ if ( empty( $currency_symbol ) ) {
+ return false;
+ }
+
+ $currency_positions = [];
+ foreach ( $original_costs as $original_cost ) {
+ $currency_symbol_position = strpos( trim( $original_cost ), $currency_symbol );
+ if ( false === $currency_symbol_position ) {
+ continue;
+ }
+
+ $currency_positions[] = 0 === $currency_symbol_position ? 'prefix' : 'postfix';
+ if ( end( $currency_positions ) !== reset( $currency_positions ) ) {
+ return false;
+ }
+ }
+
+ return ! empty( $currency_positions ) ? reset( $currency_positions ) : false;
+ }
+
+ /**
+ * Parses the cost value and current locale to infer decimal and thousands separators.
+ *
+ * The cost values stored in the meta table might not use the same decimal and thousands separator as the current
+ * locale.
+ * To work around this we parse the value assuming the decimal separator will be the last non-numeric symbol,
+ * if any.
+ *
+ * @since 4.9.12
+ *
+ * @param string|int|float $value The cost value to parse.
+ *
+ * @return array An array containing the parsed decimal and thousands separator symbols.
+ */
+ public function parse_separators( $value ) {
+ global $wp_locale;
+ $locale_decimal_point = $wp_locale->number_format['decimal_point'];
+ $locale_thousands_sep = $wp_locale->number_format['thousands_sep'];
+ $decimal_sep = $locale_decimal_point;
+ $thousands_sep = $locale_thousands_sep;
+
+ preg_match_all( '/[\\.,]+/', $value, $matches );
+
+ if ( ! empty( $matches[0] ) ) {
+ $matched_separators = $matches[0];
+ if ( count( array_unique( $matched_separators ) ) > 1 ) {
+ // We have both, the decimal separator will be the last non-numeric symbol.
+ $decimal_sep = end( $matched_separators );
+ $thousands_sep = reset( $matched_separators );
+ } else {
+ /*
+ * We only have one, we can assume it's the decimal separator if it comes before a number of numeric
+ * symbols that is not exactly 3. If there are exactly 3 number after the symbols we fall back on the
+ * locale; we did our best and cannot guess any further.
+ */
+ $frags = explode( end( $matched_separators ), $value );
+ if ( strlen( end( $frags ) ) !== 3 ) {
+ $decimal_sep = end( $matched_separators );
+ $thousands_sep = $decimal_sep === $locale_decimal_point ?
+ $locale_thousands_sep
+ : $locale_decimal_point;
+ }
+ }
+ }
+
+ return [ $decimal_sep, $thousands_sep ];
+ }
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Credits.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Credits.php
new file mode 100644
index 000000000..c87bc1f51
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Credits.php
@@ -0,0 +1,116 @@
+hook();
+ }
+
+ /**
+ * Hook the functionality of this class into the world
+ */
+ public function hook() {
+ add_filter( 'tribe_events_after_html', [ $this, 'html_comment_credit' ] );
+ add_filter( 'admin_footer_text', [ $this, 'rating_nudge' ], 1, 2 );
+ }
+
+ /**
+ * Add credit in HTML page source
+ *
+ * @return void
+ **/
+ public function html_comment_credit( $after_html ) {
+
+ if ( ! class_exists( 'Tribe__Events__Main' ) ) {
+ return $after_html;
+ }
+
+ $html_credit = "\n\n";
+ $after_html .= apply_filters( 'tribe_html_credit', $html_credit );
+ return $after_html;
+ }
+
+ /**
+ * Add ratings nudge in admin footer
+ *
+ * @param $footer_text
+ *
+ * @return string
+ */
+ public function rating_nudge( $footer_text ) {
+ $admin_helpers = Tribe__Admin__Helpers::instance();
+
+ add_filter( 'tribe_tickets_post_types', [ $this, 'tmp_return_tribe_events' ], 99 );
+
+ $review_text_tec = esc_html__( 'Rate %1$sThe Events Calendar%2$s %3$s', 'tribe-common' );
+ $review_url_tec = 'https://wordpress.org/support/plugin/the-events-calendar/reviews/?filter=5';
+
+ $review_text_et = esc_html__( 'If you like %1$sEvent Tickets%2$s please leave us a %3$s. It takes a minute and it helps a lot.', 'tribe-common' );
+ $review_url_et = 'https://wordpress.org/support/plugin/event-tickets/reviews/?filter=5';
+
+ // Only display custom text on Tribe Admin Pages.
+ if ( $admin_helpers->is_screen() || $admin_helpers->is_post_type_screen() ) {
+
+ if ( class_exists( 'Tribe__Events__Main' ) ) {
+ // If we have TEC and ET, split the impressions 50/50.
+ if ( class_exists( 'Tribe__Tickets__Main' ) && wp_rand( 0,1 ) ) {
+ $review_text = $review_text_et;
+ $review_url = $review_url_et;
+ } else {
+ $review_text = $review_text_tec;
+ $review_url = $review_url_tec;
+ }
+ } else {
+ $review_text = $review_text_et;
+ $review_url = $review_url_et;
+ }
+
+ $footer_text = sprintf(
+ $review_text,
+ '',
+ '',
+ '★★★★★'
+ );
+ }
+
+ remove_filter( 'tribe_tickets_post_types', [ $this, 'tmp_return_tribe_events' ], 99 );
+
+ /**
+ * Filters the admin footer text.
+ *
+ * @since 4.15.0
+ *
+ * @param $footer_text The admin footer text.
+ */
+ return apply_filters( 'tec_admin_footer_text', $footer_text );
+ }
+
+ /**
+ * temporary function to filter event types down to only tribe-specific types
+ *
+ * This will limit the request for ratings to only those post type pages
+ */
+ public function tmp_return_tribe_events( $unused_post_types ) {
+ return [ 'tribe_events' ];
+ }
+
+ /**
+ * @var $instance
+ */
+ private static $instance = null;
+
+ /**
+ * @return self
+ */
+ public static function instance() {
+ if ( empty( self::$instance ) ) {
+ self::$instance = new self();
+ }
+
+ return self::$instance;
+ }
+
+}
diff --git a/wp-content/plugins/the-events-calendar/common/src/Tribe/Customizer.php b/wp-content/plugins/the-events-calendar/common/src/Tribe/Customizer.php
new file mode 100644
index 000000000..a153ded51
--- /dev/null
+++ b/wp-content/plugins/the-events-calendar/common/src/Tribe/Customizer.php
@@ -0,0 +1,1073 @@
+is_active() ) {
+ return;
+ }
+
+ /**
+ * Filters the Panel ID, which is also the `wp_option` name for the Customizer settings
+ *
+ * @since 4.4
+ *
+ * @param string $ID
+ * @param self $customizer
+ */
+ $this->ID = apply_filters( 'tribe_customizer_panel_id', 'tribe_customizer', $this );
+
+ // Hook the Registering methods
+ add_action( 'customize_register', [ $this, 'register' ], 15 );
+
+ add_action( 'wp_print_footer_scripts', [ $this, 'print_css_template' ], 15 );
+ add_action( 'customize_controls_print_footer_scripts', [ $this, 'customize_controls_print_footer_scripts' ], 15 );
+
+ // front end styles from customizer
+ add_action( 'tribe_events_pro_widget_render', [ $this, 'inline_style' ], 101 );
+ add_action( 'wp_print_footer_scripts', [ $this, 'shortcode_inline_style' ], 10 );
+ add_action( 'wp_print_footer_scripts', [ $this, 'widget_inline_style' ], 10 );
+
+ /**
+ * Allows filtering the action that will be used to trigger the printing of inline scripts.
+ *
+ * By default inline scripts will be printed on the `wp_enqueue_scripts` action, but other
+ * plugins or later iterations might require inline styles to be printed on other actions.
+ *
+ * @since 4.12.15
+ *
+ * @param string $inline_script_action_handle The handle of the action that will be used to try
+ * and attempt to print inline scripts.
+ */
+ $print_styles_action = apply_filters( 'tribe_customizer_print_styles_action', 'wp_enqueue_scripts' );
+
+ add_action( $print_styles_action, [ $this, 'inline_style' ], 15 );
+
+ add_filter( "default_option_{$this->ID}", [ $this, 'maybe_fallback_get_option' ] );
+ }
+
+ /**
+ * Backwards compatibility for the old Customizer Option Save
+ *
+ * @since 4.4
+ *
+ * @param mixed $sections
+ *
+ * @return mixed
+ */
+ public function maybe_fallback_get_option( $sections ) {
+ // Return if there is something there
+ if ( ! empty( $sections ) ) {
+ return $sections;
+ }
+
+ return get_option( 'tribe_events_pro_customizer', [] );
+ }
+
+ /**
+ * Loads a Section to the Customizer on The Events Calendar's Panel
+ *
+ * @since 4.4
+ *
+ * @param object $section An Object that extends the Abstract `Tribe__Customizer__Section`
+ *
+ * @return bool
+ */
+ public function load_section( $section ) {
+ // You can only add a section if it extends the abstract Section
+ if ( ! is_object( $section ) || ! in_array( 'Tribe__Customizer__Section', class_parents( $section ) ) ) {
+ return false;
+ }
+
+ // Add the Section
+ // Enforces the usage of `$instance->ID`
+ $this->sections_class[ $section->ID ] = $section;
+
+ return true;
+ }
+
+ /**
+ * Fetches all Section Classes
+ *
+ * @since 4.4
+ *
+ * @return array
+ */
+ public function get_loaded_sections() {
+ /**
+ * Allow developers to filter Classes from Customizer Sections
+ *
+ * @deprecated
+ * @since 4.0
+ *
+ * @param array $sections_class
+ * @param self $customizer
+ */
+ $this->sections_class = apply_filters( 'tribe_events_pro_customizer_sections_class', $this->sections_class, $this );
+
+ /**
+ * Allow developers to filter Classes from Customizer Sections
+ *
+ * @since 4.4
+ *
+ * @param array $sections_class
+ * @param self $customizer
+ */
+ $this->sections_class = apply_filters( 'tribe_customizer_sections_class', $this->sections_class, $this );
+
+ return $this->sections_class;
+ }
+
+ /**
+ * Returns the section requested by ID.
+ *
+ * @since 4.13.3
+ *
+ * @param string $id The ID of the desired section.
+ *
+ * @return boolean|Tribe__Customizer__Section The requested section or boolean false if not found.
+ */
+ public function get_section( $id ) {
+ $sections = $this->get_loaded_sections();
+
+ if ( empty( $sections[ $id ] ) ) {
+ return false;
+ }
+
+ return $sections[ $id ];
+ }
+
+ /**
+ * A easy way to check if customize is active
+ *
+ * @since 4.2.2
+ *
+ * @return boolean
+ */
+ public function is_active() {
+ /**
+ * Allows Developers to completely deactivate Events Calendar Customizer
+ *
+ * @deprecated
+ *
+ * @param boolean $is_active
+ */
+ $is_active = apply_filters( 'tribe_events_pro_customizer_is_active', true );
+
+ /**
+ * Allows Developers to completely deactivate Events Calendar Customizer
+ *
+ * @param boolean $is_active
+ */
+ return apply_filters( 'tribe_customizer_is_active', true );
+ }
+
+ /**
+ * A method to easily search on an array
+ *
+ * @since 4.0
+ *
+ * @param array $variable Variable to be searched
+ * @param array $indexes The index that the method will try to retrieve
+ * @param mixed $default If the variable doesn't exist, what is the default
+ *
+ * @return mixed Return the variable based on the index
+ */
+ public static function search_var( $variable = null, $indexes = [], $default = null ) {
+ if ( is_object( $variable ) ) {
+ $variable = (array) $variable;
+ }
+
+ if ( ! is_array( $variable ) ) {
+ return $variable;
+ }
+
+ foreach ( (array) $indexes as $index ) {
+ if ( ! is_array( $variable ) || ! isset( $variable[ $index ] ) ) {
+ $variable = $default;
+ break;
+ }
+
+ $variable = $variable[ $index ];
+ }
+
+ return $variable;
+ }
+
+ /**
+ * Get an option from the database, using index search you can retrieve the full panel, a section or even a setting.
+ *
+ * @since 4.4
+ *
+ * @param array $search Index search, array( 'section_name', 'setting_name' ).
+ * @param mixed $default The default, if the requested variable doesn't exits.
+ *
+ * @return mixed The requested option or the default.
+ */
+ public function get_option( $search = null, $default = null ) {
+ $sections = get_option( $this->ID, $default );
+
+ foreach ( $this->get_loaded_sections() as $section ) {
+ /**
+ * Allow filtering the defaults for each settings to be filtered before the Ghost options to be set
+ *
+ * @deprecated
+ * @since 4.0
+ *
+ * @param array $defaults
+ */
+ $defaults[ $section->ID ] = apply_filters( "tribe_events_pro_customizer_section_{$section->ID}_defaults", [] );
+
+ /**
+ * Allow filtering the defaults for each settings to be filtered before the Ghost options to be set
+ *
+ * @since 4.4
+ *
+ * @param array $defaults
+ */
+ $settings = isset( $sections[ $section->ID ] ) ? $sections[ $section->ID ] : [];
+ $defaults[ $section->ID ] = apply_filters( "tribe_customizer_section_{$section->ID}_defaults", $settings );
+ $sections[ $section->ID ] = wp_parse_args( $settings, $defaults[ $section->ID ] );
+ }
+
+ /**
+ * Allows Ghost Options to be inserted
+ *
+ * @deprecated
+ * @since 4.0
+ *
+ * @param array $sections
+ * @param array $search
+ */
+ $sections = apply_filters( 'tribe_events_pro_customizer_pre_get_option', $sections, $search );
+
+ /**
+ * Allows Ghost Options to be inserted
+ *
+ * @since 4.4
+ *
+ * @param array $sections
+ * @param array $search
+ */
+ $sections = apply_filters( 'tribe_customizer_pre_get_option', $sections, $search );
+
+ // Search on the Array
+ if ( ! is_null( $search ) ) {
+ $option = self::search_var( $sections, $search, $default );
+ } else {
+ $option = $sections;
+ }
+
+ /**
+ * Apply Filters After finding the variable
+ *
+ * @since 4.4
+ *
+ * @param mixed $option
+ * @param array $search
+ * @param array $sections
+ */
+ $option = apply_filters( 'tribe_customizer_get_option', $option, $search, $sections );
+
+ return $option;
+ }
+
+ /**
+ * Check if the option exists, this method is used allow only sections that were saved to be applied.
+ *
+ * @param strings Using the following structure: self::has_option( 'section_name', 'setting_name' );
+ *
+ * @return boolean Whether the option exists in the database
+ */
+ public function has_option() {
+ $search = func_get_args();
+ $option = self::get_option();
+ $real_option = get_option( $this->ID, [] );
+
+ // Get section and Settings based on keys
+ $section = reset( $search );
+ $setting = end( $search );
+
+ if ( empty( $real_option ) || empty( $real_option[ $section ] ) ) {
+ return false;
+ }
+
+ // Search on the Array
+ if ( ! is_null( $search ) ) {
+ $option = self::search_var( $option, $search, null );
+ }
+
+ return ! empty( $option );
+ }
+
+ /**
+ * Add an action for some backwards compatibility.
+ *
+ * @since 4.14.2
+ *
+ * @return void
+ */
+ public function customize_controls_print_footer_scripts() {
+ /**
+ * Allows plugins to hook in and add any scripts they need at the right time.
+ *
+ * @param Tribe__Customizer $customizer The current instance of Tribe__Customizer.
+ */
+ do_action( 'tribe_enqueue_customizer_scripts', $this );
+ }
+
+ /**
+ * Print the CSS for the customizer on `wp_print_footer_scripts`
+ *
+ * @since 4.12.6 Moved the template building code to the `get_styles_scripts` method.
+ *
+ * @return void
+ */
+ public function print_css_template() {
+
+ //Only load in Customizer
+ if ( ! is_customize_preview() ) {
+ return false;
+ }
+
+ echo $this->get_styles_scripts();
+ }
+
+ /**
+ * Print the CSS for the customizer for shortcodes.
+ *
+ * @since 4.12.6
+ */
+ public function shortcode_inline_style() {
+ /**
+ * Whether customizer styles should print for shortcodes or not.
+ *
+ * @since 4.12.6
+ *
+ * @param boolean $should_print Whether the inline styles should be printed on screen.
+ */
+ $should_print = apply_filters( 'tribe_customizer_should_print_shortcode_customizer_styles', false );
+
+ if ( empty( $should_print ) ) {
+ return;
+ }
+
+ $this->inline_style();
+ }
+
+ /**
+ * Print the CSS for the customizer for widgets.
+ *
+ * @since 4.12.14
+ */
+ public function widget_inline_style() {
+ /**
+ * Whether customizer styles should print for widgets or not.
+ *
+ * @since 4.12.14
+ *
+ * @param boolean $should_print Whether the inline styles should be printed on screen.
+ */
+ $should_print = apply_filters( 'tribe_customizer_should_print_widget_customizer_styles', false );
+
+ if ( empty( $should_print ) ) {
+ return;
+ }
+
+ $this->inline_style();
+ }
+
+ /**
+ * Print the CSS for the customizer using wp_add_inline_style
+ *
+ * @since 4.12.15 Added the `$force` parameter to force the print of the style inline.
+ *
+ * @param bool $force Whether to ignore the context to try and print the style inline, or not.
+ */
+ public function inline_style( $force = false ) {
+ // Only load once on front-end.
+ if ( ! $force && ( is_customize_preview() || is_admin() || $this->inline_style ) ) {
+ return false;
+ }
+
+ /**
+ * Use this filter to add more CSS, using Underscore Template style
+ *
+ * @since 4.4
+ *
+ * @link http://underscorejs.org/#template
+ *
+ * @param string $template
+ */
+ $css_template = trim( apply_filters( 'tribe_customizer_css_template', '' ) );
+
+ // If we don't have anything on the customizer don't print empty styles
+ if ( empty( $css_template ) ) {
+ return false;
+ }
+
+ $sheets = [
+ 'tribe-common-full-style',
+ ];
+
+ /**
+ * Allow plugins to add themselves to this list.
+ *
+ * @since 4.12.1
+ *
+ * @param array $sheets An array of sheets to search for.
+ * @param string $css_template String containing the inline css to add.
+ */
+ $sheets = apply_filters( 'tribe_customizer_inline_stylesheets', $sheets, $css_template );
+
+ if ( empty( $sheets ) ) {
+ return false;
+ }
+
+ // Add customizer styles inline with the latest stylesheet that is enqueued.
+ foreach ( array_reverse( $sheets ) as $sheet ) {
+ if ( wp_style_is( $sheet ) ) {
+ $inline_style = wp_strip_all_tags( $this->parse_css_template( $css_template ) );
+
+ /**
+ * Fires before a style is, possibly, printed inline depending on the stylesheet.
+ *
+ * @since 4.12.15
+ *
+ * @param string $sheet The handle of the stylesheet the style will be printed inline for.
+ * @param string $inline_style The inline style contents, as they will be printed on the page.
+ */
+ do_action( 'tribe_customizer_before_inline_style', $sheet, $inline_style );
+
+ // Just print styles if doing 'wp_print_footer_scripts' action.
+ $just_print = (bool) doing_action( 'wp_print_footer_scripts' );
+
+ if ( $just_print ) {
+ printf(
+ "\n",
+ esc_attr( $sheet ),
+ $inline_style
+ );
+ } else {
+ wp_add_inline_style( $sheet, $inline_style );
+ }
+
+ $this->inline_style = true;
+
+ break;
+ }
+ }
+ }
+
+ /**
+ * Replaces the Settings using the Underscore templating strings
+ *
+ * @param string $template The template variable, that we will look to replace the variables
+ * @return string A Valid css after replacing the variables
+ */
+ private function parse_css_template( $template ) {
+ $css = $template;
+ $sections = $this->get_option();
+
+ $search = [];
+ $replace = [];
+
+ foreach ( $sections as $section => $settings ) {
+ if ( ! is_array( $settings ) ) {
+ continue;
+ }
+ foreach ( $settings as $setting => $value ) {
+ $index = [ $section, $setting ];
+
+ // Add search based on Underscore template
+ $search[] = '<%= ' . implode( '.', $index ) . ' %>';
+
+ // Get the Replace value
+ $replace[] = $value;
+ }
+ }
+
+ // Finally Str replace
+ return str_replace( $search, $replace, $css );
+ }
+
+ /**
+ * Method to start setting up the Customizer Section and Fields
+ *
+ * @since 4.0
+ *
+ * @param WP_Customize_Manager $customizer WordPress Customizer variable
+ * @return void
+ */
+ public function register( WP_Customize_Manager $customizer ) {
+ // Set the Customizer on a class variable
+ $this->manager = $customizer;
+
+ /**
+ * Allow users to filter the Panel
+ *
+ * @since 4.4
+ *
+ * @param WP_Customize_Panel $panel
+ * @param Tribe__Customizer $customizer
+ */
+ $this->panel = apply_filters( 'tribe_customizer_panel', $this->register_panel(), $this );
+
+ /**
+ * Filter the Sections within our Panel before they are added to the Customize Manager
+ *
+ * @since 4.4
+ *
+ * @param array $sections
+ * @param Tribe__Customizer $customizer
+ */
+ $this->sections = apply_filters( 'tribe_customizer_pre_sections', $this->sections, $this );
+
+ foreach ( $this->sections as $id => $section ) {
+ $this->sections[ $id ] = $this->register_section( $id, $section );
+
+ /**
+ * Allows people to Register and de-register the method to register more Fields
+ *
+ * @since 4.4
+ * @since 4.12.15 Add Customizer instance as a parameter.
+ *
+ * @param array $section
+ * @param WP_Customize_Manager $manager
+ * @param Tribe__Customizer $customizer The current customizer instance.
+ */
+ do_action( "tribe_customizer_register_{$id}_settings", $this->sections[ $id ], $this->manager, $this );
+ }
+
+ /**
+ * Filter the Sections within our Panel, now using the actual WP_Customize_Section
+ *
+ * @since 4.4
+ *
+ * @param array $sections
+ * @param Tribe__Customizer $customizer
+ */
+ $this->sections = apply_filters( 'tribe_customizer_sections', $this->sections, $this );
+
+ // After everything is done, try to add Selective refresh
+ $this->maybe_selective_refresh();
+ }
+
+ /**
+ * Register the base Panel for Events Calendar Sections to be attached to
+ *
+ * @since 4.0
+ *
+ * @return WP_Customize_Panel
+ */
+ private function register_panel() {
+ $panel = $this->manager->get_panel( $this->ID );
+
+ // If the Panel already exists we leave returning it's instance
+ if ( ! empty( $panel ) ) {
+ return $panel;
+ }
+
+ $panel_args = [
+ 'title' => esc_html__( 'The Events Calendar', 'tribe-common' ),
+ 'description' => esc_html__( 'Use the following panel of your customizer to change the styling of your Calendar and Event pages.', 'tribe-common' ),
+
+ // After `static_front_page`
+ 'priority' => 125,
+ ];
+
+ /**
+ * Filter the Panel Arguments for WP Customize
+ *
+ * @since 4.4
+ *
+ * @param array $args
+ * @param string $ID
+ * @param Tribe__Customizer $customizer
+ */
+ $panel_args = apply_filters( 'tribe_customizer_panel_args', $panel_args, $this->ID, $this );
+
+ // Actually Register the Panel
+ $this->manager->add_panel( $this->ID, $panel_args );
+
+ // Return the Panel instance
+ return $this->manager->get_panel( $this->ID );
+ }
+
+ /**
+ * Returns a URL to the TEC Customizer panel.
+ *
+ * @since 4.14.0
+ *
+ * @return string The URL to the TEC Customizer panel.
+ */
+ public function get_panel_url() {
+ $query['autofocus[panel]'] = 'tribe_customizer';
+ return add_query_arg( $query, admin_url( 'customize.php' ) );
+ }
+
+ /**
+ * Returns an HTML link directly to the (opened) TEC Customizer panel
+ *
+ * @since 4.14.0
+ *
+ * @param string $link_text The (pre)translated text for the link.
+ *
+ * @return string The HTML anchor element, linking to the TEC Customizer panel.
+ * An empty string is returned if missing a parameter.
+ */
+ public function get_panel_link( $link_text ) {
+ if ( empty( $link_text ) || ! is_string( $link_text ) ) {
+ return '';
+ }
+
+ $panel_url = $this->get_panel_url();
+
+ return sprintf(
+ '%2$s',
+ esc_url( $panel_url ),
+ esc_html( $link_text )
+ );
+ }
+
+ /**
+ * Use a "alias" method to register sections to allow users to filter args and the ID
+ *
+ * @since 4.0
+ *
+ * @param string $id The Unique section ID
+ * @param array $args Arguments to register the section
+ *
+ * @link https://codex.wordpress.org/Class_Reference/WP_Customize_Manager/add_section
+ *
+ * @return WP_Customize_Section
+ */
+ public function register_section( $id, $args ) {
+ /**
+ * Filter the Section ID
+ *
+ * @since 4.4
+ *
+ * @param string $section_id
+ * @param Tribe__Customizer $customizer
+ */
+ $section_id = apply_filters( 'tribe_customizer_section_id', $id, $this );
+
+ // Tries to fetch the section
+ $section = $this->manager->get_section( $section_id );
+
+ // If the Panel already exists we leave returning it's instance
+ if ( ! empty( $section ) ) {
+ return $section;
+ }
+
+ /**
+ * Filter the Section arguments, so that developers can filter arguments based on $section_id
+ *
+ * @since 4.4
+ *
+ * @param array $args
+ * @param string $section_id
+ * @param Tribe__Customizer $customizer
+ */
+ $section_args = apply_filters( 'tribe_customizer_section_args', $args, $section_id, $this );
+
+ // Don't allow sections outside of our panel
+ $section_args['panel'] = $this->panel->id;
+
+ // Actually Register the Section
+ $this->manager->add_section( $section_id, $section_args );
+
+ // Return the Section instance
+ return $this->manager->get_section( $section_id );
+ }
+
+ /**
+ * Returns a URL to the a specific TEC Customizer section.
+ *
+ * @since 4.14.0
+ *
+ * @param string $section The slug for the desired section.
+ *
+ * @return string The URL to the TEC Customizer section.
+ */
+ public function get_section_url( $section ) {
+ if ( empty( $section ) ) {
+ return '';
+ }
+
+ $query['autofocus[section]'] = $section;
+ return add_query_arg( $query, admin_url( 'customize.php' ) );
+ }
+
+ /**
+ * Gets the HTML link to a section in the TEC Customizer.
+ *
+ * @since 4.14.0
+ *
+ * @param string $section The section "slug" to link to.
+ * @param string $link_text The text for the link.
+ *
+ * @return string The HTML anchor element, linking to the TEC Customizer section.
+ * An empty string is returned if missing a parameter.
+ */
+ public function get_section_link( $section, $link_text = '' ) {
+ if ( empty( $section ) || empty( $link_text ) || ! is_string($link_text ) ) {
+ return '';
+ }
+
+
+ $panel_url = $this->get_section_url( $section );
+ if ( empty( $panel_url ) ) {
+ return '';
+ }
+
+ return sprintf(
+ '%2$s',
+ esc_url( $panel_url ),
+ esc_html( $link_text )
+ );
+ }
+
+ /**
+ * Build the Setting name using the HTML format for Arrays
+ *
+ * @since 4.0
+ *
+ * @param string $slug The actual Setting name
+ * @param string|WP_Customize_Section $section The section the setting lives in.
+ *
+ * @return string HTML name Attribute name of the setting.
+ */
+ public function get_setting_name( $slug, $section = null ) {
+ $name = ! empty( $this->panel->id ) ? $this->panel->id : '';
+
+ // If there is a section set append it
+ if ( $section instanceof WP_Customize_Section ) {
+ $name .= '[' . $section->id . ']';
+ } elseif ( is_string( $section ) ) {
+ $name .= '[' . $section . ']';
+ }
+
+ // Set the actual setting slug
+ $name .= '[' . esc_attr( $slug ) . ']';
+
+ return $name;
+ }
+
+ /**
+ * Adds a setting field name to the Array of Possible Selective refresh fields
+ *
+ * @since 4.2
+ *
+ * @param string $name The actual Setting name
+ *
+ * @return array The list of existing Settings, the new one included
+ */
+ public function add_setting_name( $name ) {
+ $this->settings[] = $name;
+ return $this->settings;
+ }
+
+ /**
+ * Gets the URL to a specific control/setting in the TEC Customizer.
+ *
+ * @since 4.14.0
+ *
+ * @param string $section The section "slug" to link into.
+ * @param string $setting The setting "slug" to link to.
+ *
+ * @return string The URL to the setting.
+ * An empty string is returned if a parameter is missing or the setting control cannot be found.
+ */
+ public function get_setting_url( $section, $setting ) {
+ // Bail if something is missing.
+ if ( empty( $setting ) || empty( $section ) ) {
+ return '';
+ }
+
+ $control = $this->get_setting_name( $setting, $section );
+
+ if ( empty( $control ) ) {
+ return '';
+ }
+
+ $query['autofocus[control]'] = $control;
+
+ return add_query_arg( $query, admin_url( 'customize.php' ) );
+ }
+
+ /**
+ * Gets the link to the a specific control/setting in the TEC Customizer.
+ *
+ * @since 4.14.0
+ *
+ * @param string $section The section "slug" to link into.
+ * @param string $setting The setting "slug" to link to.
+ * @param string $link_text The translated text for the link.
+ *
+ * @return string The HTML anchor element, linking to the TEC Customizer setting.
+ * An empty string is returned if missing a parameter or the setting control cannot be found.
+ */
+ public function get_setting_link( $section, $setting, $link_text ) {
+ // Bail if something is missing.
+ if ( empty( $setting ) || empty( $section ) || empty( $link_text ) ) {
+ return '';
+ }
+
+ $control_url = $this->get_setting_url( $section, $setting );
+
+ if ( empty( $control_url ) ) {
+ return '';
+ }
+
+ return sprintf(
+ '%2$s',
+ esc_url( $control_url ),
+ esc_html( $link_text )
+ );
+ }
+
+ /**
+ * Using the Previously created CSS element, we not just re-create it every setting change
+ *
+ * @since 4.2
+ *
+ * @return void
+ */
+ public function maybe_selective_refresh() {
+ // Only try to apply selective refresh if it's active
+ if ( ! isset( $this->manager->selective_refresh ) ) {
+ return;
+ }
+
+ foreach ( $this->settings as $name ) {
+ $setting = $this->manager->get_setting( $name );
+
+ // Skip if we don't have that setting then skip it
+ if ( is_null( $setting ) ) {
+ continue;
+ }
+
+ // Skip if we already have that
+ if ( ! is_null( $this->manager->selective_refresh->get_partial( $name ) ) ) {
+ continue;
+ }
+
+ // Remove the Setting
+ // We need this because settings are protected on the WP_Customize_Manager
+ $this->manager->remove_setting( $name );
+
+ // Change the Transport
+ $setting->transport = 'postMessage';
+
+ // Re-add the setting
+ // We need this because settings are protected on the WP_Customize_Manager
+ $this->manager->add_setting( $setting );
+
+ // Add the Partial
+ $this->manager->selective_refresh->add_partial(
+ $name,
+ [
+ 'selector' => '#' . esc_attr( $this->ID . '_css' ),
+ 'render_callback' => [ $this, 'print_css_template' ],
+ ]
+ );
+ }
+ }
+
+ /**
+ * Builds and returns the Customizer CSS template contents.
+ *
+ * The method DOES NOT check if the current context is the one where the Customizer template should
+ * be printed or not; that care is left to the code calling this method.
+ *
+ * @since 4.12.6 Extracted this method from the `print_css_template` one.
+ *
+ * @return string The CSS template contents.
+ */
+ public function get_styles_scripts() {
+ /**
+ * Use this filter to add more CSS, using Underscore Template style.
+ *
+ * @since 4.4
+ *
+ * @param string $template The Customizer template.
+ *
+ * @link http://underscorejs.org/#template
+ */
+ $css_template = trim( apply_filters( 'tribe_customizer_css_template', '' ) );
+
+ // If we don't have anything on the Customizer, then don't print empty styles.
+ if ( empty( $css_template ) ) {
+ return '';
+ }
+
+ // Prepare the customizer scripts.
+ $result = '';
+
+ // Prepare the customizer styles.
+ $result .= '';
+
+ return $result;
+ }
+
+ /**
+ * Inserts link to TEC Customizer section for FSE themes in admin (left) menu.
+ *
+ * @since 4.14.8
+ */
+ public function add_fse_customizer_link() {
+ _deprecated_function( __METHOD__, '4.14.18', 'No replacement. Customizer menu item is preserved as long as we activate it.');
+ // Exit early if the current theme is not a FSE theme.
+ if ( ! tec_is_full_site_editor() ) {
+ return;
+ }
+
+ // Add a link to the TEC panel in the Customizer.
+ add_submenu_page(
+ 'themes.php',
+ _x( 'Customize The Events Calendar', 'Page title for the TEC Customizer section.', 'tribe-common' ),
+ _x( 'Customize The Events Calendar', 'Menu item text for the TEC Customizer section link.', 'tribe-common' ),
+ 'edit_theme_options',
+ esc_url( add_query_arg( 'autofocus[panel]', 'tribe_customizer' , admin_url( 'customize.php' ) ) )
+ );
+ }
+
+ /**
+ * Inserts link to TEC Customizer section for FSE themes in Events > Settings > Display.
+ *
+ * @since 4.14.8
+ *
+ * @param array $settings The existing settings array.
+ *
+ * @return array $settings The modified settings array.
+ */
+ public function add_fse_customizer_link_to_display_tab( $settings ) {
+ _deprecated_function( __METHOD__, '4.14.18', 'No replacement. Customizer link is preserved as long as we activate it.');
+ // Exit early if the current theme is not a FSE theme.
+ if ( ! tec_is_full_site_editor() ) {
+ return $settings;
+ }
+
+ $new_settings = [
+ 'tribe-customizer-section-title' => [
+ 'type' => 'html',
+ 'html' => '
';
+
+ if ( true === $this->tooltip_first ) {
+ $return .= $this->do_tool_tip();
+ // and empty it to avoid it from being printed again
+ $this->tooltip = '';
+ }
+
+ return apply_filters( 'tribe_field_div_start', $return, $this );
+ }
+
+ /**
+ * returns the field's div end
+ *
+ * @return string the field div end
+ */
+ public function do_field_div_end() {
+ $return = $this->do_tool_tip();
+ $return .= '
';
+
+ return apply_filters( 'tribe_field_div_end', $return, $this );
+ }
+
+ /**
+ * returns the field's tooltip/description
+ *
+ * @return string the field tooltip
+ */
+ public function do_tool_tip() {
+ $return = '';
+ if ( $this->tooltip ) {
+ $return = '
' . $this->tooltip . '
';
+ }
+
+ return apply_filters( 'tribe_field_tooltip', $return, $this->tooltip, $this );
+ }
+
+ /**
+ * returns the screen reader label
+ *
+ * @return string the screen reader label
+ */
+ public function do_screen_reader_label() {
+ $return = '';
+ if ( $this->tooltip ) {
+ $return = '';
+ }
+
+ return apply_filters( 'tribe_field_screen_reader_label', $return, $this->tooltip, $this );
+ }
+
+ /**
+ * returns the field's value
+ *
+ * @return string the field value
+ */
+ public function do_field_value() {
+ $return = '';
+ if ( $this->value ) {
+ $return = ' value="' . $this->value . '"';
+ }
+
+ return apply_filters( 'tribe_field_value', $return, $this->value, $this );
+ }
+
+ /**
+ * returns the field's name
+ *
+ * @param bool $multi
+ *
+ * @return string the field name
+ */
+ public function do_field_name( $multi = false ) {
+ $return = '';
+ if ( $this->name ) {
+ if ( $multi ) {
+ $return = ' name="' . $this->name . '[]"';
+ } else {
+ $return = ' name="' . $this->name . '"';
+ }
+ }
+
+ return apply_filters( 'tribe_field_name', $return, $this->name, $this );
+ }
+
+ /**
+ * returns the field's placeholder
+ *
+ * @return string the field value
+ */
+ public function do_field_placeholder() {
+ $return = '';
+ if ( $this->placeholder ) {
+ $return = ' placeholder="' . $this->placeholder . '"';
+ }
+
+ return apply_filters( 'tribe_field_placeholder', $return, $this->placeholder, $this );
+ }
+
+ /**
+ * Return a string of attributes for the field
+ *
+ * @return string
+ **/
+ public function do_field_attributes() {
+ $return = '';
+ if ( ! empty( $this->attributes ) ) {
+ foreach ( $this->attributes as $key => $value ) {
+ $return .= ' ' . $key . '="' . $value . '"';
+ }
+ }
+
+ return apply_filters( 'tribe_field_attributes', $return, $this->name, $this );
+ }
+
+ /**
+ * Return a string of attributes for the fieldset
+ *
+ * @return string
+ **/
+ public function do_fieldset_attributes() {
+ $return = '';
+ if ( ! empty( $this->fieldset_attributes ) ) {
+ foreach ( $this->fieldset_attributes as $key => $value ) {
+ $return .= ' ' . $key . '="' . $value . '"';
+ }
+ }
+
+ return apply_filters( 'tribe_fieldset_attributes', $return, $this->name, $this );
+ }
+
+ /**
+ * generate a heading field
+ *
+ * @return string the field
+ */
+ public function heading() {
+ $field = '
' . $this->label . '
';
+
+ return $field;
+ }
+
+ /**
+ * generate an html field
+ *
+ * @return string the field
+ */
+ public function html() {
+ $field = $this->do_field_label();
+ $field .= $this->html;
+
+ return $field;
+ }
+
+ /**
+ * generate a simple text field
+ *
+ * @return string the field
+ */
+ public function text() {
+ $field = $this->do_field_start();
+ $field .= $this->do_field_label();
+ $field .= $this->do_field_div_start();
+ $field .= 'do_field_name();
+ $field .= $this->do_field_value();
+ $field .= $this->do_field_placeholder();
+ $field .= $this->do_field_attributes();
+ $field .= '/>';
+ $field .= $this->do_screen_reader_label();
+ $field .= $this->do_field_div_end();
+ $field .= $this->do_field_end();
+
+ return $field;
+ }
+
+ /**
+ * generate a textarea field
+ *
+ * @return string the field
+ */
+ public function textarea() {
+ $field = $this->do_field_start();
+ $field .= $this->do_field_label();
+ $field .= $this->do_field_div_start();
+ $field .= 'do_field_name();
+ $field .= $this->do_field_attributes();
+ $field .= '>';
+ $field .= esc_html( stripslashes( $this->value ) );
+ $field .= '';
+ $field .= $this->do_screen_reader_label();
+ $field .= $this->do_field_div_end();
+ $field .= $this->do_field_end();
+
+ return $field;
+ }
+
+ /**
+ * generate a wp_editor field
+ *
+ * @return string the field
+ */
+ public function wysiwyg() {
+ $mce = new Wysiwyg( $this->name, $this->value, $this->settings );
+ $field = $this->do_field_start();
+ $field .= $this->do_field_label();
+ $field .= $this->do_field_div_start();
+ $field .= $mce->get_html();
+ $field .= $this->do_screen_reader_label();
+ $field .= $this->do_field_div_end();
+ $field .= $this->do_field_end();
+
+ return $field;
+ }
+
+ /**
+ * generate a radio button field
+ *
+ * @return string the field
+ */
+ public function radio() {
+ $field = $this->do_field_start();
+ $field .= $this->do_field_label();
+ $field .= $this->do_field_div_start();
+ if ( is_array( $this->options ) ) {
+ foreach ( $this->options as $option_id => $title ) {
+ $field_id = sprintf(
+ '%1$s-%2$s',
+ sanitize_html_class( trim( $this->id ) ),
+ sanitize_html_class( trim( $option_id ) )
+ );
+
+ $field .= '';
+ }
+ } else {
+ $field .= '' . esc_html__( 'No radio options specified', 'tribe-common' ) . '';
+ }
+ $field .= $this->do_field_div_end();
+ $field .= $this->do_field_end();
+
+ return $field;
+ }
+
+ /**
+ * generate a checkbox_list field
+ *
+ * @return string the field
+ */
+ public function checkbox_list() {
+ $field = $this->do_field_start();
+ $field .= $this->do_field_label();
+ $field .= $this->do_field_div_start();
+
+ if ( ! is_array( $this->value ) ) {
+ if ( ! empty( $this->value ) ) {
+ $this->value = [ $this->value ];
+ } else {
+ $this->value = [];
+ }
+ }
+
+ if ( is_array( $this->options ) ) {
+ foreach ( $this->options as $option_id => $title ) {
+ $field .= '';
+ }
+ } else {
+ $field .= '' . esc_html__( 'No checkbox options specified', 'tribe-common' ) . '';
+ }
+ $field .= $this->do_field_div_end();
+ $field .= $this->do_field_end();
+
+ return $field;
+ }
+
+ /**
+ * generate a boolean checkbox field
+ *
+ * @return string the field
+ */
+ public function checkbox_bool() {
+ $field = $this->do_field_start();
+ $field .= $this->do_field_label();
+ $field .= $this->do_field_div_start();
+ $field .= 'do_field_name();
+ $field .= ' value="1" ' . checked( $this->value, true, false );
+ $field .= $this->do_field_attributes();
+ $field .= '/>';
+ $field .= $this->do_screen_reader_label();
+ $field .= $this->do_field_div_end();
+ $field .= $this->do_field_end();
+
+ return $field;
+ }
+
+ /**
+ * generate a dropdown field
+ *
+ * @return string the field
+ */
+ public function dropdown() {
+ $field = $this->do_field_start();
+ $field .= $this->do_field_label();
+ $field .= $this->do_field_div_start();
+ if ( is_array( $this->options ) && ! empty( $this->options ) ) {
+ $field .= 'do_field_name();
+ $field .= " id='{$this->id}-select'";
+ $field .= " class='tribe-dropdown'";
+ if ( empty( $this->allow_clear ) ) {
+ $field .= " data-prevent-clear='true'";
+ }
+ $field .= $this->do_field_attributes();
+ $field .= '>';
+ foreach ( $this->options as $option_id => $title ) {
+ $field .= '';
+ }
+ $field .= '';
+ $field .= $this->do_screen_reader_label();
+ } elseif ( $this->if_empty ) {
+ $field .= '' . (string) $this->if_empty . '';
+ } else {
+ $field .= '' . esc_html__( 'No select options specified', 'tribe-common' ) . '';
+ }
+ $field .= $this->do_field_div_end();
+ $field .= $this->do_field_end();
+
+ return $field;
+ }
+
+ /**
+ * generate a chosen dropdown field - the same as the
+ * regular dropdown but wrapped so it can have the
+ * right css class applied to it
+ *
+ * @deprecated
+ *
+ * @return string the field
+ */
+ public function dropdown_chosen() {
+ $field = $this->dropdown();
+
+ return $field;
+ }
+
+ /**
+ * generate a select2 dropdown field - the same as the
+ * regular dropdown but wrapped so it can have the
+ * right css class applied to it
+ *
+ * @deprecated
+ *
+ * @return string the field
+ */
+ public function dropdown_select2() {
+ $field = $this->dropdown();
+
+ return $field;
+ }
+
+ /**
+ * generate a license key field
+ *
+ * @return string the field
+ */
+ public function license_key() {
+ $field = $this->do_field_start();
+ $field .= $this->do_field_label();
+ $field .= $this->do_field_div_start();
+ $field .= 'do_field_name();
+ $field .= $this->do_field_value();
+ $field .= $this->do_field_attributes();
+ $field .= '/>';
+ $field .= '
 ) . ')
';
+ $field .= '';
+ $field .= $this->do_screen_reader_label();
+ $field .= $this->do_field_div_end();
+ $field .= $this->do_field_end();
+
+ return $field;
+ }
+
+ /**
+ * Generate a color field.
+ *
+ * @since 5.0.0
+ *
+ * @return string The field.
+ */
+ public function color() {
+
+ tribe( Settings::class )->maybe_load_color_field_assets();
+
+ $field = $this->do_field_start();
+ $field .= $this->do_field_label();
+ $field .= $this->do_field_div_start();
+ $field .= '