���� JFIF



�� �         "" $(4,$&1'-=-157:::#+?D?8C49:7
 7%%77777777777777777777777777777777777777777777777777��  { �
" 

�� 



 �� 5
 
!1AQa"q�2��BR��#b������� 



�� 
�� 
 ? ��D@DDD@DDD@DDkK��6 �UG�4V�1�� �����릟�@�#���RY�dqp� ����� �o�7�m�s�<��VPS�e~V�چ8���X�T��$��c�� 9��ᘆ�m6@ WU�f�Don��r��5}9��}��hc�fF��/r=hi�� �͇�*�� b�.��$0�&te��y�@�A�F�=� P




f�A��a���˪�Œ�É��U|� � 3\�״ H SZ�g46�C��צ�ے �b<���;m����Rpع^��l7��*�����TF�}�\�M���M%�'�����٠ݽ�v� ��!-�����?�N!La��A+[`#���M����'�~oR�?��v^)��=��h����A��X�.���˃����^Ə��ܯsO"B�c>; �e�4��5�k��/CB��.  �J?��;�҈�������������������~�<�VZ�ꭼ2/)Í”jC���ע�V�G�!���!�F������\�� Kj�R�oc�h���:Þ I��1"2�q×°8��Р@ז���_C0�ր
��A��lQ��@纼�!7��F�� �]�sZ B�62r�v�z~�K�7�c��5�.���ӄq&�Z�d�<�kk���T&8�|���I���� Ws}���ǽ�cqnΑ�_���3��|N�-y,��i���ȗ_�\60��
�@��6����D@DDD@DDD@DDD@DDD@DDc�KN66<�c��64=r����� Ď0��h���t&(�hnb[� ?��^��\��â|�,�
/h�\��R��5�? �0�!צ܉-����G����٬��Q�zA���1�����V��� �:R���`�$��ik��H����D4�����#dk����� h�}����7���w%�������*o8wG�Lycu
T�.���ܯ7��I��u^���)��/c�,s�Nq�ۺ�;�ך�YH2���.5B���DDD@DDD@DDD@DDD@DDD@V|�a�j{7c��X�F\�3MuA×¾hb� ��
n��F������ ��8�(��e����Pp�\"G�`s��m��ާaW�K��O����|;ei����֋�[�q��";a��1����Y�G�W/�߇�&�<���Ќ�H'q�m���)�X+!���=�m�ۚ丷~6a^X�)���,�>#&6G���Y��{����"" """ """ """ """ ""��at\/�a�8 �yp%�lhl�n����)��
�i�t��B�������������?�� main_file = $main_file; $this->input = $input ?: new Input(); } /** * Gets the absolute path for a path relative to the plugin directory. * * @since 1.0.0 * * @param string $relative_path Optional. Relative path. Default '/'. * @return string Absolute path. */ public function path( $relative_path = '/' ) { return plugin_dir_path( $this->main_file ) . ltrim( $relative_path, '/' ); } /** * Gets the full URL for a path relative to the plugin directory. * * @since 1.0.0 * * @param string $relative_path Optional. Relative path. Default '/'. * @return string Full URL. */ public function url( $relative_path = '/' ) { return plugin_dir_url( $this->main_file ) . ltrim( $relative_path, '/' ); } /** * Gets the Input instance. * * @since 1.1.2 * * @return Input */ public function input() { return $this->input; } /** * Gets the full URL to an admin screen part of the plugin. * * @since 1.0.0 * * @param string $slug Optional. Plugin admin screen slug. Default 'dashboard'. * @param array $query_args Optional. Additional query args. Default empty array. * @return string Full admin screen URL. */ public function admin_url( $slug = 'dashboard', array $query_args = array() ) { unset( $query_args['page'] ); if ( $this->is_network_mode() ) { $base_url = network_admin_url( 'admin.php' ); } else { $base_url = admin_url( 'admin.php' ); } return add_query_arg( array_merge( array( 'page' => Core\Admin\Screens::PREFIX . $slug ), $query_args ), $base_url ); } /** * Determines whether the plugin is running in network mode. * * @since 1.0.0 * * @return bool True if the plugin is in network mode, false otherwise. */ public function is_network_mode() { // Bail if plugin is not network-active. if ( ! $this->is_network_active() ) { return false; } /** * Filters whether network mode is active in Site Kit. * * This is always false by default since Site Kit does not support a network mode yet. * * @since 1.86.0 * * @param bool $active Whether network mode is active. */ return (bool) apply_filters( 'googlesitekit_is_network_mode', false ); } /** * Gets the cannonical "home" URL. * * Returns the value from the `"googlesitekit_canonical_home_url"` filter. * * @since 1.18.0 * * @return string Cannonical home URL. */ public function get_canonical_home_url() { /** * Filters the canonical home URL considered by Site Kit. * * Typically this is okay to be the unmodified `home_url()`, but certain plugins (e.g. multilingual plugins) * that dynamically modify that value based on context can use this filter to ensure that the URL considered * by Site Kit remains stable. * * @since 1.18.0 * * @param string $home_url The value of `home_url()`. */ return apply_filters( 'googlesitekit_canonical_home_url', home_url() ); } /** * Gets the site URL of the reference site to use for stats. * * @since 1.0.0 * * @return string Reference site URL. */ public function get_reference_site_url() { return $this->filter_reference_url(); } /** * Gets the entity for the current request context. * * An entity in Site Kit terminology is based on a canonical URL, i.e. every * canonical URL has an associated entity. * * An entity may also have a type, a title, and an ID. * * @since 1.7.0 * * @return Entity|null The current entity, or null if none could be determined. */ public function get_reference_entity() { // Support specific URL stats being checked in Site Kit dashboard details view. if ( is_admin() && 'googlesitekit-dashboard' === $this->input()->filter( INPUT_GET, 'page' ) ) { $entity_url_query_param = $this->input()->filter( INPUT_GET, 'permaLink' ); if ( ! empty( $entity_url_query_param ) ) { return $this->get_reference_entity_from_url( $entity_url_query_param ); } } $entity = Entity_Factory::from_context(); return $this->filter_entity_reference_url( $entity ); } /** * Gets the entity for the given URL, if available. * * An entity in Site Kit terminology is based on a canonical URL, i.e. every * canonical URL has an associated entity. * * An entity may also have a type, a title, and an ID. * * @since 1.10.0 * * @param string $url URL to determine the entity from. * @return Entity|null The current entity, or null if none could be determined. */ public function get_reference_entity_from_url( $url ) { // Ensure local URL is used for lookup. $url = str_replace( $this->get_reference_site_url(), untrailingslashit( $this->get_canonical_home_url() ), $url ); $entity = Entity_Factory::from_url( $url ); return $this->filter_entity_reference_url( $entity ); } /** * Gets the permalink of the reference site to use for stats. * * @since 1.0.0 * * @param int|WP_Post $post Optional. Post ID or post object. Default is the global `$post`. * * @return string|false The reference permalink URL or false if post does not exist. */ public function get_reference_permalink( $post = 0 ) { // If post is provided, get URL for that. if ( $post ) { $permalink = get_permalink( $post ); if ( false === $permalink ) { return false; } return $this->filter_reference_url( $permalink ); } // Otherwise use entity detection. $entity = $this->get_reference_entity(); if ( ! $entity || 'post' !== $entity->get_type() ) { return false; } return $entity->get_url(); } /** * Gets the canonical url for the current request. * * @since 1.0.0 * * @return string|false The reference canonical URL or false if no URL was identified. */ public function get_reference_canonical() { $entity = $this->get_reference_entity(); if ( ! $entity ) { return false; } return $entity->get_url(); } /** * Checks whether AMP content is being served. * * @since 1.0.0 * * @return bool True if an AMP request, false otherwise. */ public function is_amp() { if ( is_singular( 'web-story' ) ) { return true; } return function_exists( 'is_amp_endpoint' ) && is_amp_endpoint(); } /** * Gets the current AMP mode. * * @since 1.0.0 * @since 1.108.0 Extracted AMP plugin related logic to `get_amp_mode_from_amp_plugin` function. * * @return bool|string 'primary' if in standard mode, * 'secondary' if in transitional or reader modes, or the Web Stories plugin is active * false if AMP not active, or unknown mode */ public function get_amp_mode() { $amp_mode = $this->get_amp_mode_from_amp_plugin(); if ( false === $amp_mode ) { // If the Web Stories plugin is enabled, consider the site to be running // in Secondary AMP mode. if ( defined( 'WEBSTORIES_VERSION' ) ) { return self::AMP_MODE_SECONDARY; } } return $amp_mode; } /** * Gets the current AMP mode from the AMP plugin. * * @since 1.108.0 * * @return bool|string 'primary' if in standard mode, * 'secondary' if in transitional or reader modes * false if AMP not active, or unknown mode */ private function get_amp_mode_from_amp_plugin() { if ( ! class_exists( 'AMP_Theme_Support' ) ) { return false; } $exposes_support_mode = defined( 'AMP_Theme_Support::STANDARD_MODE_SLUG' ) && defined( 'AMP_Theme_Support::TRANSITIONAL_MODE_SLUG' ) && defined( 'AMP_Theme_Support::READER_MODE_SLUG' ); if ( defined( 'AMP__VERSION' ) ) { $amp_plugin_version = AMP__VERSION; if ( strpos( $amp_plugin_version, '-' ) !== false ) { $amp_plugin_version = explode( '-', $amp_plugin_version )[0]; } $amp_plugin_version_2_or_higher = version_compare( $amp_plugin_version, '2.0.0', '>=' ); } else { $amp_plugin_version_2_or_higher = false; } if ( $amp_plugin_version_2_or_higher ) { $exposes_support_mode = class_exists( 'AMP_Options_Manager' ) && method_exists( 'AMP_Options_Manager', 'get_option' ) && $exposes_support_mode; } else { $exposes_support_mode = class_exists( 'AMP_Theme_Support' ) && method_exists( 'AMP_Theme_Support', 'get_support_mode' ) && $exposes_support_mode; } if ( $exposes_support_mode ) { // If recent version, we can properly detect the mode. if ( $amp_plugin_version_2_or_higher ) { $mode = AMP_Options_Manager::get_option( 'theme_support' ); } else { $mode = AMP_Theme_Support::get_support_mode(); } if ( AMP_Theme_Support::STANDARD_MODE_SLUG === $mode ) { return self::AMP_MODE_PRIMARY; } if ( in_array( $mode, array( AMP_Theme_Support::TRANSITIONAL_MODE_SLUG, AMP_Theme_Support::READER_MODE_SLUG ), true ) ) { return self::AMP_MODE_SECONDARY; } } elseif ( function_exists( 'amp_is_canonical' ) ) { // On older versions, if it is not primary AMP, it is definitely secondary AMP (transitional or reader mode). if ( amp_is_canonical() ) { return self::AMP_MODE_PRIMARY; } return self::AMP_MODE_SECONDARY; } return false; } /** * Checks whether the plugin is network active. * * @since 1.0.0 * * @return bool True if plugin is network active, false otherwise. */ public function is_network_active() { // Determine $network_active property just once per request, to not unnecessarily run this complex logic on every call. if ( null === $this->network_active ) { if ( is_multisite() ) { $network_active_plugins = wp_get_active_network_plugins(); // Consider MU plugins and network-activated plugins as network-active. $this->network_active = strpos( wp_normalize_path( __FILE__ ), wp_normalize_path( WPMU_PLUGIN_DIR ) ) === 0 || in_array( WP_PLUGIN_DIR . '/' . GOOGLESITEKIT_PLUGIN_BASENAME, $network_active_plugins, true ); } else { $this->network_active = false; } } return $this->network_active; } /** * Filters the given entity's reference URL, effectively creating a copy of * the entity with the reference URL accounted for. * * @since 1.15.0 * * @param Entity|null $entity Entity to filter reference ID for, or null. * @return Entity|null Filtered entity or null, based on $entity. */ private function filter_entity_reference_url( Entity $entity = null ) { if ( ! $entity ) { return null; } return new Entity( $this->filter_reference_url( $entity->get_url() ), array( 'type' => $entity->get_type(), 'title' => $entity->get_title(), 'id' => $entity->get_id(), ) ); } /** * Filters the given URL to ensure the reference URL is used as part of it. * * If the site reference URL differs from the home URL (e.g. via filters), * this method performs the necessary replacement. * * @since 1.7.0 * * @param string $url Optional. Input URL. If not provided, returns the plain reference site URL. * @return string URL that starts with the reference site URL. */ private function filter_reference_url( $url = '' ) { $site_url = untrailingslashit( $this->get_canonical_home_url() ); /** * Filters the reference site URL to use for stats. * * This can be used to override the current site URL, for example when using the plugin on a non-public site, * such as in a staging environment. * * @since 1.0.0 * * @param string $site_url Reference site URL, typically the WordPress home URL. */ $reference_site_url = apply_filters( 'googlesitekit_site_url', $site_url ); $reference_site_url = untrailingslashit( $reference_site_url ); // Ensure this is not empty. if ( empty( $reference_site_url ) ) { $reference_site_url = $site_url; } // If no URL given, just return the reference site URL. if ( empty( $url ) ) { return $reference_site_url; } // Replace site URL with the reference site URL. if ( $reference_site_url !== $site_url ) { $url = str_replace( $site_url, $reference_site_url, $url ); } return $url; } /** * Calls the WordPress core functions to get the locale and return it in the required format. * * @since 1.32.0 * * @param string $context Optional. Defines which WordPress core locale function to call. * @param string $format Optional. Defines the format the locale is returned in. * @return string Locale in the required format. */ public function get_locale( $context = 'site', $format = 'default' ) { // Get the site or user locale. if ( 'user' === $context ) { $wp_locale = get_user_locale(); } else { $wp_locale = get_locale(); } // Return locale in the required format. if ( 'language-code' === $format ) { $code_array = explode( '_', $wp_locale ); return $code_array[0]; } elseif ( 'language-variant' === $format ) { $variant_array = explode( '_', $wp_locale ); $variant_string = implode( '_', array_slice( $variant_array, 0, 2 ) ); return $variant_string; } return $wp_locale; } }