�PNG  IHDR22?�� pHYs  �� OiCCPPhotoshop ICC profilexڝSgTS�=���BK���KoR RB���&*! J�!��Q�EEȠ�����Q, � ��!���������{�kּ������>���� �H3Q5� �B�������.@� $p�d!s�#�~<<+"��x� �M��0���B�\���t�8K�@z�B�@F���&S�`�cb�P-`'������{[�!�� e�Dh;��V�EX0fK�9�-0IWfH���� � 0Q��){`�##x��F�W<�+��*x��<�$9E�[-qWW.(�I+6aa�@.�y�2�4���������x����6��_-��"bb���ϫp@�t~��,/��;�m��%�h^ �u��f�@����W�p�~<�5�j>{�-�]c�K'Xt����o��(�h���w��?�G�%�fI�q^D$.Tʳ?�D��*�A��,���� �`6�B$��BB d�r`)��B(�Ͱ*`/�@4�Qh��p.�U�=p�a��(�� A�a!ڈb�X#����!�H�$ ɈQ"K�5H1R�T UH�=r9�\F��;�2����G1���Q=� �C��7�F� �dt1�����r�=�6��Ыhڏ>C�0��3�l0.��B�8, �c˱"� ���V����cϱw�E� 6wB aAHXLXN�H� $4� 7 �Q�'"��K�&���b21�XH,#��/{�C�7$�C2'��I��T��F�nR#�,��4H#���dk�9�, +ȅ����3��!�[ �b@q��S�(R�jJ��4�e�2AU��Rݨ�T5�ZB���R�Q��4u�9̓IK�����hh�i��t�ݕN��W���G���w ��Ljg(�gw��L�Ӌ�T071���oUX*�*|�� �J�&�*/T����ު U�U�T��^S}�FU3S� Ԗ�U��P�SSg�;���g�oT?�~Y��Y�L�OC�Q��_�� c�x,!k ��u�5�&���|v*�����=���9C3J3W�R�f?�q��tN �(���~���)�)�4L�1e\k����X�H�Q�G�6������E�Y��A�J'\'Gg����S�Sݧ �M=:��.�k���Dw�n��^��Lo��y���}/�T�m���G X� $� �<�5qo</���QC]�@C�a�a�ᄑ��<��F�F�i�\�$�m�mƣ&&!&KM�M�RM��)�;L;L���͢�֙5�=1�2��כ߷`ZxZ,����eI��Z�Yn�Z9Y�XUZ]�F���%ֻ�����N�N���gð�ɶ�����ۮ�m�}agbg�Ů��}�}��= ���Z~s�r:V:ޚΜ�?}����/gX���3��)�i�S��Ggg�s�󈋉K��.�>.���Ƚ�Jt�q]�z���������ۯ�6�i�ܟ�4�)�Y3s���C�Q��? ��0k߬~OCO�g��#/c/�W�װ��w��a�>�>r��>�<7�2�Y_�7��ȷ�O�o�_��C#�d�z����%g��A�[��z|!��?:�e����A���AA�������!h�쐭!��Α�i�P~���a�a��~ '���W�?�p�X�1�5w��Cs�D�D�Dޛg1O9�-J5*>�.j<�7�4�?�.fY��X�XIlK9.*�6nl������� �{�/�]py�����.,:�@L�N8��A*��%�w%� y��g"/�6ш�C\*N�H*Mz�쑼5y$�3�,幄'���L Lݛ:��v m2=:�1����qB�!M��g�g�fvˬe����n��/��k���Y- �B��TZ(�*�geWf�͉�9���+��̳�ې7�����ᒶ��KW-X潬j9�������(�x��oʿ�ܔ���Ĺd�f�f���-�[����n �ڴ �V����E�/��(ۻ��C���<��e����;?T�T�T�T6��ݵa��n��{��4���[���>ɾ�UUM�f�e�I���?�������m]�Nmq����#�׹���=TR��+�G�����w- 6 U����#pDy��� �� :�v�{���vg/jB��F�S��[b[�O�>����z�G��499�?r����C�d�&����ˮ/~�����јѡ�򗓿m|������������x31^�V���w�w��O�| (�h���SЧ��������c3-� cHRMz%������u0�`:�o�_�F5IDATx��ytUս�?�;���fN$$��@B�!�k��� -*�gE���j�O�kQ�ʠ`U�B_ �AÐ0%�Ȕ�@r3ޛ;߳��$�@��v����^�s����������$��ߢ !�W��5�̱'-٘������4�>�Rƫ$�G��0U�H}�_ _� #��k�MJ/=�9Du *ڲ�k�PQ;0��j|�*�$�^컂脛y���>�z×� B��� ��(�:$�ʔ_�6��C!B����MVx��a��ζyY����j��ƋY2�9�F�{r��r�딟F��Q��hY6��� x��[l��RC��������nt@��;P��3��� F�w��7��:�P���ɋ'���mj���Bƪ�$�Q�L��y��߷g��\���z����v5�p�v$�v櫻�`6~K �Y�X����,�:��"�o�e0II"(��,������l_�C���/4�+f�E�!q��:����u����c��樼.UE�@� �]K�W���$-�h]�JG���Dz)�`��.�A/ ���mᏣc�3jK� �!�>���$�Q�!�_�? \�C2(E �M$Z I{�U���s�ǣ���=��@Բe ޻��W�����@ �w����}�9v,)��.}*|"�s��di���,���G�]W�AC�������|<����[��ߕ������K�*�G nߴ!��‹��J�!��6(L�a)��Am��������;adf��:�xm��nh�;֦I��(���o�C~ډa?�=��s����h��E������xp����)���_���t��W�����´;8���`dz=(��@@�+,�;�`�fhl��XȌ�3,uI�~z(J����� �ZX�A����H'�À�㜦�82|��a�n�z2��I���� ���EY�h�ε<�0�q�{��C��v�˅��?"@��χ�x�WS+��N�~�KQ�J�8ل�� _.W��� !TU{�����,��"�� �;�������HI S� ��))�o�1�H�D� ���� (� ;����"Ҕ��,���� �F=���O��&�Ph>�`���y��߲ &S��P�<��'��1s�1cĂ�N����2)����@�u��tv��<�+�-&�����h��[!FSG���' � z z0��<����8d&�����E0�,��<��"!P�b4��� �{S�����X����.�囤���T��hEF��X�q0"-<����h���]�Py*����F⩍��@v�˂�Y08�� .q��a��s����(!<̫1�3�L�H��7sYW�`��qtu�\7��?�@�Y�� %Ka�x�GZ�*W�P��y�����N0r9��Z�c�%���q,��k�����!!,��>���IB��� �x1�Xu�Y���v-���ֺ��N������JP��a�2`�e5��w��u;�6�i���̃��(K���ťa��(l51��JL��O'%���]���ٖ뿉!��{*�p+f ���i8��D�ȑ���ܩ�M��V��ӟz��x�7Z�1i}�^͜���6e����x��)u�d�ˏ�V�eG�\�X1�����=n�U'�~Y����L�\,�(d!x ,�:�TW8� M`r���@��r+v�Q0��>^;˴�VbF��('����� �*O��i��j�Ӆ����^�S3&� ���{������.ی�� N;��NU%d0�Ce\r"�C�b��&t7N�7��� �ȪD�[%l�۪�$��'m?�A9tI�9>��NVL ��� 6v~M�����ъ�B���0����9$&=ώm��W�0���L���&��E���f�f��'+�9��hv��7,���M��6�D�&�^� �����8 D֮�����o��k^z��O��hP�8q�5d*��YVq3�{��������#LX4�?��jP=3�~�؅c�ݰ�̱�ұ��8̲��2�G�����j��έ�9��w7���U�X�w�85C��?!I&���o&����L���I#�^�eV�,�^t5�k� �xs˛\��U�8��."���{���ǵ�l4��ݼ�;��r"���G�/~���gJV�N糦��ZZ^k+NN�D��I$�=OE�z����|*�*{��%k���G��>�`9��b;�s���8,�qs��c��.b��q�%�>r��n�R�Ƨ�%�,�A��le#�8���}; 21�0�b�&�QX�f���q�00����$>�h�N�'�a3��A���/�r ��L5�8�GԲ'�����w;��c#�q1���h$*��V^�k��QĽ�b:i������� ����H F#�_���,��]g����Ը����`RUU���� ��"�qD���>-��ϤI�~��3�̴�����NZ[[555�eeek7�m����YF#[��Đ��R��i��L�H�r ��@��J-�Pŝ��_|�-��6y��ks�V�U~��6���w.����(��0A� 4��f��� /���C�xŊ�ٳ����z=6�����rg���mKo��o�/����a�g���?'9%9��P��斓��~���L{�� �H��{AW��B��$����v�1b�&Mb�ر��ر#�0`�`xMBp! )Z�Nmo�mZ�g�}�eذaWTVV ���'99��C5��&�&+5�bT>|8��PUUETT����&���t��~TE%��'������b�tEGG;RSS�S�N�v��ѯ��t����u1@�ޚ"f��͈���r'L�Ph��m��ƌ�74o��`�x�q�P���NRSS�X,�����l&&&��MFFA!-��`��ҷ�n��Yuu�����x<I�LB%����KԒ50�!�3�bz�����ʸKL���;---�l6[��`��������Ȏ;�����egg4��!D�T��jWujyZ��������K����%����p�^���X,6��sV=�ܖ����6�3�X ���4ҿ��A2�&����_k�;d�� �VfOIEND�B`� 0x0x
0x0x
PHP 8.1.31
Preview: class-wp-community-events.php Size: 18.21 KB
/var/www/weelorum_com_usr/data/www/weelorum.com/wp-admin/includes/class-wp-community-events.php
<?php
/**
 * Administration: Community Events class.
 *
 * @package WordPress
 * @subpackage Administration
 * @since 4.8.0
 */

/**
 * Class WP_Community_Events.
 *
 * A client for api.wordpress.org/events.
 *
 * @since 4.8.0
 */
#[AllowDynamicProperties]
class WP_Community_Events {
	/**
	 * ID for a WordPress user account.
	 *
	 * @since 4.8.0
	 *
	 * @var int
	 */
	protected $user_id = 0;

	/**
	 * Stores location data for the user.
	 *
	 * @since 4.8.0
	 *
	 * @var false|array
	 */
	protected $user_location = false;

	/**
	 * Constructor for WP_Community_Events.
	 *
	 * @since 4.8.0
	 *
	 * @param int        $user_id       WP user ID.
	 * @param false|array $user_location {
	 *     Stored location data for the user. false to pass no location.
	 *
	 *     @type string $description The name of the location
	 *     @type string $latitude    The latitude in decimal degrees notation, without the degree
	 *                               symbol. e.g.: 47.615200.
	 *     @type string $longitude   The longitude in decimal degrees notation, without the degree
	 *                               symbol. e.g.: -122.341100.
	 *     @type string $country     The ISO 3166-1 alpha-2 country code. e.g.: BR
	 * }
	 */
	public function __construct( $user_id, $user_location = false ) {
		$this->user_id       = absint( $user_id );
		$this->user_location = $user_location;
	}

	/**
	 * Gets data about events near a particular location.
	 *
	 * Cached events will be immediately returned if the `user_location` property
	 * is set for the current user, and cached events exist for that location.
	 *
	 * Otherwise, this method sends a request to the w.org Events API with location
	 * data. The API will send back a recognized location based on the data, along
	 * with nearby events.
	 *
	 * The browser's request for events is proxied with this method, rather
	 * than having the browser make the request directly to api.wordpress.org,
	 * because it allows results to be cached server-side and shared with other
	 * users and sites in the network. This makes the process more efficient,
	 * since increasing the number of visits that get cached data means users
	 * don't have to wait as often; if the user's browser made the request
	 * directly, it would also need to make a second request to WP in order to
	 * pass the data for caching. Having WP make the request also introduces
	 * the opportunity to anonymize the IP before sending it to w.org, which
	 * mitigates possible privacy concerns.
	 *
	 * @since 4.8.0
	 * @since 5.5.2 Response no longer contains formatted date field. They're added
	 *              in `wp.communityEvents.populateDynamicEventFields()` now.
	 *
	 * @param string $location_search Optional. City name to help determine the location.
	 *                                e.g., "Seattle". Default empty string.
	 * @param string $timezone        Optional. Timezone to help determine the location.
	 *                                Default empty string.
	 * @return array|WP_Error A WP_Error on failure; an array with location and events on
	 *                        success.
	 */
	public function get_events( $location_search = '', $timezone = '' ) {
		$cached_events = $this->get_cached_events();

		if ( ! $location_search && $cached_events ) {
			return $cached_events;
		}

		// Include an unmodified $wp_version.
		require ABSPATH . WPINC . '/version.php';

		$api_url                    = 'http://api.wordpress.org/events/1.0/';
		$request_args               = $this->get_request_args( $location_search, $timezone );
		$request_args['user-agent'] = 'WordPress/' . $wp_version . '; ' . home_url( '/' );

		if ( wp_http_supports( array( 'ssl' ) ) ) {
			$api_url = set_url_scheme( $api_url, 'https' );
		}

		$response       = wp_remote_get( $api_url, $request_args );
		$response_code  = wp_remote_retrieve_response_code( $response );
		$response_body  = json_decode( wp_remote_retrieve_body( $response ), true );
		$response_error = null;

		if ( is_wp_error( $response ) ) {
			$response_error = $response;
		} elseif ( 200 !== $response_code ) {
			$response_error = new WP_Error(
				'api-error',
				/* translators: %d: Numeric HTTP status code, e.g. 400, 403, 500, 504, etc. */
				sprintf( __( 'Invalid API response code (%d).' ), $response_code )
			);
		} elseif ( ! isset( $response_body['location'], $response_body['events'] ) ) {
			$response_error = new WP_Error(
				'api-invalid-response',
				$response_body['error'] ?? __( 'Unknown API error.' )
			);
		}

		if ( is_wp_error( $response_error ) ) {
			return $response_error;
		} else {
			$expiration = false;

			if ( isset( $response_body['ttl'] ) ) {
				$expiration = $response_body['ttl'];
				unset( $response_body['ttl'] );
			}

			/*
			 * The IP in the response is usually the same as the one that was sent
			 * in the request, but in some cases it is different. In those cases,
			 * it's important to reset it back to the IP from the request.
			 *
			 * For example, if the IP sent in the request is private (e.g., 192.168.1.100),
			 * then the API will ignore that and use the corresponding public IP instead,
			 * and the public IP will get returned. If the public IP were saved, though,
			 * then get_cached_events() would always return `false`, because the transient
			 * would be generated based on the public IP when saving the cache, but generated
			 * based on the private IP when retrieving the cache.
			 */
			if ( ! empty( $response_body['location']['ip'] ) ) {
				$response_body['location']['ip'] = $request_args['body']['ip'];
			}

			/*
			 * The API doesn't return a description for latitude/longitude requests,
			 * but the description is already saved in the user location, so that
			 * one can be used instead.
			 */
			if ( $this->coordinates_match( $request_args['body'], $response_body['location'] ) && empty( $response_body['location']['description'] ) ) {
				$response_body['location']['description'] = $this->user_location['description'];
			}

			/*
			 * Store the raw response, because events will expire before the cache does.
			 * The response will need to be processed every page load.
			 */
			$this->cache_events( $response_body, $expiration );

			$response_body['events'] = $this->trim_events( $response_body['events'] );

			return $response_body;
		}
	}

	/**
	 * Builds an array of args to use in an HTTP request to the w.org Events API.
	 *
	 * @since 4.8.0
	 *
	 * @param string $search   Optional. City search string. Default empty string.
	 * @param string $timezone Optional. Timezone string. Default empty string.
	 * @return array The request args.
	 */
	protected function get_request_args( $search = '', $timezone = '' ) {
		$args = array(
			'number' => 5, // Get more than three in case some get trimmed out.
			'ip'     => self::get_unsafe_client_ip(),
		);

		/*
		 * Include the minimal set of necessary arguments, in order to increase the
		 * chances of a cache-hit on the API side.
		 */
		if ( empty( $search ) && isset( $this->user_location['latitude'], $this->user_location['longitude'] ) ) {
			$args['latitude']  = $this->user_location['latitude'];
			$args['longitude'] = $this->user_location['longitude'];
		} else {
			$args['locale'] = get_user_locale( $this->user_id );

			if ( $timezone ) {
				$args['timezone'] = $timezone;
			}

			if ( $search ) {
				$args['location'] = $search;
			}
		}

		// Wrap the args in an array compatible with the second parameter of `wp_remote_get()`.
		return array(
			'body' => $args,
		);
	}

	/**
	 * Determines the user's actual IP address and attempts to partially
	 * anonymize an IP address by converting it to a network ID.
	 *
	 * Geolocating the network ID usually returns a similar location as the
	 * actual IP, but provides some privacy for the user.
	 *
	 * $_SERVER['REMOTE_ADDR'] cannot be used in all cases, such as when the user
	 * is making their request through a proxy, or when the web server is behind
	 * a proxy. In those cases, $_SERVER['REMOTE_ADDR'] is set to the proxy address rather
	 * than the user's actual address.
	 *
	 * Modified from https://stackoverflow.com/a/2031935/450127, MIT license.
	 * Modified from https://github.com/geertw/php-ip-anonymizer, MIT license.
	 *
	 * SECURITY WARNING: This function is _NOT_ intended to be used in
	 * circumstances where the authenticity of the IP address matters. This does
	 * _NOT_ guarantee that the returned address is valid or accurate, and it can
	 * be easily spoofed.
	 *
	 * @since 4.8.0
	 *
	 * @return string|false The anonymized address on success; the given address
	 *                      or false on failure.
	 */
	public static function get_unsafe_client_ip() {
		$client_ip = false;

		// In order of preference, with the best ones for this purpose first.
		$address_headers = array(
			'HTTP_CLIENT_IP',
			'HTTP_X_FORWARDED_FOR',
			'HTTP_X_FORWARDED',
			'HTTP_X_CLUSTER_CLIENT_IP',
			'HTTP_FORWARDED_FOR',
			'HTTP_FORWARDED',
			'REMOTE_ADDR',
		);

		foreach ( $address_headers as $header ) {
			if ( array_key_exists( $header, $_SERVER ) ) {
				/*
				 * HTTP_X_FORWARDED_FOR can contain a chain of comma-separated
				 * addresses. The first one is the original client. It can't be
				 * trusted for authenticity, but we don't need to for this purpose.
				 */
				$address_chain = explode( ',', $_SERVER[ $header ] );
				$client_ip     = trim( $address_chain[0] );

				break;
			}
		}

		if ( ! $client_ip ) {
			return false;
		}

		$anon_ip = wp_privacy_anonymize_ip( $client_ip, true );

		if ( '0.0.0.0' === $anon_ip || '::' === $anon_ip ) {
			return false;
		}

		return $anon_ip;
	}

	/**
	 * Test if two pairs of latitude/longitude coordinates match each other.
	 *
	 * @since 4.8.0
	 *
	 * @param array $a The first pair, with indexes 'latitude' and 'longitude'.
	 * @param array $b The second pair, with indexes 'latitude' and 'longitude'.
	 * @return bool True if they match, false if they don't.
	 */
	protected function coordinates_match( $a, $b ) {
		if ( ! isset( $a['latitude'], $a['longitude'], $b['latitude'], $b['longitude'] ) ) {
			return false;
		}

		return $a['latitude'] === $b['latitude'] && $a['longitude'] === $b['longitude'];
	}

	/**
	 * Generates a transient key based on user location.
	 *
	 * This could be reduced to a one-liner in the calling functions, but it's
	 * intentionally a separate function because it's called from multiple
	 * functions, and having it abstracted keeps the logic consistent and DRY,
	 * which is less prone to errors.
	 *
	 * @since 4.8.0
	 *
	 * @param array $location Should contain 'latitude' and 'longitude' indexes.
	 * @return string|false Transient key on success, false on failure.
	 */
	protected function get_events_transient_key( $location ) {
		$key = false;

		if ( isset( $location['ip'] ) ) {
			$key = 'community-events-' . md5( $location['ip'] );
		} elseif ( isset( $location['latitude'], $location['longitude'] ) ) {
			$key = 'community-events-' . md5( $location['latitude'] . $location['longitude'] );
		}

		return $key;
	}

	/**
	 * Caches an array of events data from the Events API.
	 *
	 * @since 4.8.0
	 *
	 * @param array     $events     Response body from the API request.
	 * @param int|false $expiration Optional. Amount of time to cache the events. Defaults to false.
	 * @return bool true if events were cached; false if not.
	 */
	protected function cache_events( $events, $expiration = false ) {
		$set              = false;
		$transient_key    = $this->get_events_transient_key( $events['location'] );
		$cache_expiration = $expiration ? absint( $expiration ) : HOUR_IN_SECONDS * 12;

		if ( $transient_key ) {
			$set = set_site_transient( $transient_key, $events, $cache_expiration );
		}

		return $set;
	}

	/**
	 * Gets cached events.
	 *
	 * @since 4.8.0
	 * @since 5.5.2 Response no longer contains formatted date field. They're added
	 *              in `wp.communityEvents.populateDynamicEventFields()` now.
	 *
	 * @return array|false An array containing `location` and `events` items
	 *                     on success, false on failure.
	 */
	public function get_cached_events() {
		$transient_key = $this->get_events_transient_key( $this->user_location );
		if ( ! $transient_key ) {
			return false;
		}

		$cached_response = get_site_transient( $transient_key );
		if ( isset( $cached_response['events'] ) ) {
			$cached_response['events'] = $this->trim_events( $cached_response['events'] );
		}

		return $cached_response;
	}

	/**
	 * Adds formatted date and time items for each event in an API response.
	 *
	 * This has to be called after the data is pulled from the cache, because
	 * the cached events are shared by all users. If it was called before storing
	 * the cache, then all users would see the events in the localized data/time
	 * of the user who triggered the cache refresh, rather than their own.
	 *
	 * @since 4.8.0
	 * @deprecated 5.5.2 No longer used in core.
	 *
	 * @param array $response_body The response which contains the events.
	 * @return array The response with dates and times formatted.
	 */
	protected function format_event_data_time( $response_body ) {
		_deprecated_function( __METHOD__, '5.5.2' );

		if ( isset( $response_body['events'] ) ) {
			foreach ( $response_body['events'] as $key => $event ) {
				$timestamp = strtotime( $event['date'] );

				/*
				 * The `date_format` option is not used because it's important
				 * in this context to keep the day of the week in the formatted date,
				 * so that users can tell at a glance if the event is on a day they
				 * are available, without having to open the link.
				 */
				/* translators: Date format for upcoming events on the dashboard. Include the day of the week. See https://www.php.net/manual/datetime.format.php */
				$formatted_date = date_i18n( __( 'l, M j, Y' ), $timestamp );
				$formatted_time = date_i18n( get_option( 'time_format' ), $timestamp );

				if ( isset( $event['end_date'] ) ) {
					$end_timestamp      = strtotime( $event['end_date'] );
					$formatted_end_date = date_i18n( __( 'l, M j, Y' ), $end_timestamp );

					if ( 'meetup' !== $event['type'] && $formatted_end_date !== $formatted_date ) {
						/* translators: Upcoming events month format. See https://www.php.net/manual/datetime.format.php */
						$start_month = date_i18n( _x( 'F', 'upcoming events month format' ), $timestamp );
						$end_month   = date_i18n( _x( 'F', 'upcoming events month format' ), $end_timestamp );

						if ( $start_month === $end_month ) {
							$formatted_date = sprintf(
								/* translators: Date string for upcoming events. 1: Month, 2: Starting day, 3: Ending day, 4: Year. */
								__( '%1$s %2$d–%3$d, %4$d' ),
								$start_month,
								/* translators: Upcoming events day format. See https://www.php.net/manual/datetime.format.php */
								date_i18n( _x( 'j', 'upcoming events day format' ), $timestamp ),
								date_i18n( _x( 'j', 'upcoming events day format' ), $end_timestamp ),
								/* translators: Upcoming events year format. See https://www.php.net/manual/datetime.format.php */
								date_i18n( _x( 'Y', 'upcoming events year format' ), $timestamp )
							);
						} else {
							$formatted_date = sprintf(
								/* translators: Date string for upcoming events. 1: Starting month, 2: Starting day, 3: Ending month, 4: Ending day, 5: Year. */
								__( '%1$s %2$d – %3$s %4$d, %5$d' ),
								$start_month,
								date_i18n( _x( 'j', 'upcoming events day format' ), $timestamp ),
								$end_month,
								date_i18n( _x( 'j', 'upcoming events day format' ), $end_timestamp ),
								date_i18n( _x( 'Y', 'upcoming events year format' ), $timestamp )
							);
						}

						$formatted_date = wp_maybe_decline_date( $formatted_date, 'F j, Y' );
					}
				}

				$response_body['events'][ $key ]['formatted_date'] = $formatted_date;
				$response_body['events'][ $key ]['formatted_time'] = $formatted_time;
			}
		}

		return $response_body;
	}

	/**
	 * Prepares the event list for presentation.
	 *
	 * Discards expired events, and makes WordCamps "sticky." Attendees need more
	 * advanced notice about WordCamps than they do for meetups, so camps should
	 * appear in the list sooner. If a WordCamp is coming up, the API will "stick"
	 * it in the response, even if it wouldn't otherwise appear. When that happens,
	 * the event will be at the end of the list, and will need to be moved into a
	 * higher position, so that it doesn't get trimmed off.
	 *
	 * @since 4.8.0
	 * @since 4.9.7 Stick a WordCamp to the final list.
	 * @since 5.5.2 Accepts and returns only the events, rather than an entire HTTP response.
	 * @since 6.0.0 Decode HTML entities from the event title.
	 *
	 * @param array $events The events that will be prepared.
	 * @return array The response body with events trimmed.
	 */
	protected function trim_events( array $events ) {
		$future_events = array();

		foreach ( $events as $event ) {
			/*
			 * The API's `date` and `end_date` fields are in the _event's_ local timezone, but UTC is needed so
			 * it can be converted to the _user's_ local time.
			 */
			$end_time = (int) $event['end_unix_timestamp'];

			if ( time() < $end_time ) {
				// Decode HTML entities from the event title.
				$event['title'] = html_entity_decode( $event['title'], ENT_QUOTES, 'UTF-8' );

				array_push( $future_events, $event );
			}
		}

		$future_wordcamps = array_filter(
			$future_events,
			static function ( $wordcamp ) {
				return 'wordcamp' === $wordcamp['type'];
			}
		);

		$future_wordcamps    = array_values( $future_wordcamps ); // Remove gaps in indices.
		$trimmed_events      = array_slice( $future_events, 0, 3 );
		$trimmed_event_types = wp_list_pluck( $trimmed_events, 'type' );

		// Make sure the soonest upcoming WordCamp is pinned in the list.
		if ( $future_wordcamps && ! in_array( 'wordcamp', $trimmed_event_types, true ) ) {
			array_pop( $trimmed_events );
			array_push( $trimmed_events, $future_wordcamps[0] );
		}

		return $trimmed_events;
	}

	/**
	 * Logs responses to Events API requests.
	 *
	 * @since 4.8.0
	 * @deprecated 4.9.0 Use a plugin instead. See #41217 for an example.
	 *
	 * @param string $message A description of what occurred.
	 * @param array  $details Details that provide more context for the
	 *                        log entry.
	 */
	protected function maybe_log_events_response( $message, $details ) {
		_deprecated_function( __METHOD__, '4.9.0' );

		if ( ! WP_DEBUG_LOG ) {
			return;
		}

		error_log(
			sprintf(
				'%s: %s. Details: %s',
				__METHOD__,
				trim( $message, '.' ),
				wp_json_encode( $details )
			)
		);
	}
}

Directory Contents

Dirs: 0 × Files: 108
Name Size Perms Modified Actions
admin-filters.php
7.85 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
admin.php
3.54 KB lrw-r--r-- 2022-11-16 04:52:24
Edit Download
ajax-actions.php
149.19 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
bookmark.php
11.40 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
BreadcrumbsRippers.php
1.65 KB lrw-r--r-- 2025-05-20 12:00:00
Edit Download
class-automatic-upgrader-skin.php
3.58 KB lrw-r--r-- 2023-08-09 04:35:48
Edit Download
class-bulk-plugin-upgrader-skin.php
2.53 KB lrw-r--r-- 2024-07-17 01:21:13
Edit Download
class-bulk-theme-upgrader-skin.php
2.60 KB lrw-r--r-- 2024-07-17 01:21:13
Edit Download
class-bulk-upgrader-skin.php
6.50 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-core-upgrader.php
14.84 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-custom-background.php
21.20 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-custom-image-header.php
48.03 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-file-upload-upgrader.php
4.07 KB lrw-r--r-- 2024-07-17 01:21:13
Edit Download
class-ftp-pure.php
5.30 KB lrw-r--r-- 2019-11-01 14:57:02
Edit Download
class-ftp-sockets.php
8.28 KB lrw-r--r-- 2022-08-22 15:30:43
Edit Download
class-ftp.php
26.70 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-language-pack-upgrader-skin.php
2.80 KB lrw-r--r-- 2024-07-17 01:21:13
Edit Download
class-language-pack-upgrader.php
15.16 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-pclzip.php
192.08 KB lrw-r--r-- 2025-09-28 15:01:49
Edit Download
class-plugin-installer-skin.php
11.67 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-plugin-upgrader-skin.php
3.20 KB lrw-r--r-- 2023-08-09 04:35:48
Edit Download
class-plugin-upgrader.php
22.70 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-theme-installer-skin.php
12.67 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-theme-upgrader-skin.php
4.08 KB lrw-r--r-- 2024-04-04 04:45:29
Edit Download
class-theme-upgrader.php
26.16 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-walker-category-checklist.php
4.97 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-walker-nav-menu-checklist.php
5.65 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-walker-nav-menu-edit.php
13.96 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-ajax-upgrader-skin.php
4.09 KB lrw-r--r-- 2023-08-09 04:35:48
Edit Download
class-wp-application-passwords-list-table.php
6.79 KB lrw-r--r-- 2024-04-04 04:45:29
Edit Download
class-wp-automatic-updater.php
60.45 KB lrw-r--r-- 2026-02-01 17:41:08
Edit Download
class-wp-comments-list-table.php
33.80 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-community-events.php
18.21 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-debug-data.php
70.27 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-filesystem-base.php
23.84 KB lrw-r--r-- 2024-04-04 04:45:29
Edit Download
class-wp-filesystem-direct.php
18.17 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-filesystem-ftpext.php
22.73 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-filesystem-ftpsockets.php
18.06 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-filesystem-ssh2.php
22.84 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-importer.php
7.64 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-internal-pointers.php
4.49 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-links-list-table.php
9.29 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-list-table-compat.php
1.46 KB lrw-r--r-- 2020-11-14 16:54:08
Edit Download
class-wp-list-table.php
51.84 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-media-list-table.php
26.40 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-ms-sites-list-table.php
22.23 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-ms-themes-list-table.php
29.52 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-ms-users-list-table.php
15.32 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-plugin-install-list-table.php
24.39 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-plugins-list-table.php
56.75 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-post-comments-list-table.php
1.42 KB lrw-r--r-- 2022-11-02 04:48:20
Edit Download
class-wp-posts-list-table.php
63.46 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-privacy-data-export-requests-list-table.php
5.43 KB lrw-r--r-- 2022-08-22 15:30:43
Edit Download
class-wp-privacy-data-removal-requests-list-table.php
5.58 KB lrw-r--r-- 2023-11-08 04:28:29
Edit Download
class-wp-privacy-policy-content.php
31.90 KB lrw-r--r-- 2026-02-01 17:41:08
Edit Download
class-wp-privacy-requests-table.php
14.44 KB lrw-r--r-- 2026-02-01 17:41:08
Edit Download
class-wp-screen.php
36.56 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-site-health-auto-updates.php
14.00 KB lrw-r--r-- 2025-09-28 15:01:49
Edit Download
class-wp-site-health.php
128.17 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-site-icon.php
6.26 KB lrw-r--r-- 2024-04-04 04:45:29
Edit Download
class-wp-terms-list-table.php
20.58 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-theme-install-list-table.php
15.33 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-themes-list-table.php
10.10 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-upgrader-skin.php
6.90 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-upgrader-skins.php
1.44 KB lrw-r--r-- 2019-10-08 17:19:04
Edit Download
class-wp-upgrader.php
47.23 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
class-wp-users-list-table.php
18.56 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
comment.php
6.08 KB lrw-r--r-- 2026-02-01 17:41:08
Edit Download
continents-cities.php
20.06 KB lrw-r--r-- 2022-11-02 04:48:20
Edit Download
credits.php
5.70 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
dashboard.php
68.73 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
deprecated.php
40.77 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
edit-tag-messages.php
1.44 KB lrw-r--r-- 2021-12-07 12:20:02
Edit Download
error_log
5.00 KB lrw-r--r-- 2024-11-06 13:32:14
Edit Download
export.php
25.37 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
file.php
95.62 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
image-edit.php
42.96 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
image.php
44.11 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
import.php
6.46 KB lrw-r--r-- 2024-11-13 02:20:26
Edit Download
list-table.php
3.71 KB lrw-r--r-- 2022-11-02 04:48:20
Edit Download
media.php
117.12 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
menu.php
9.41 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
meta-boxes.php
65.29 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
misc.php
45.35 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
ms-admin-filters.php
1.27 KB lrw-r--r-- 2022-11-02 04:48:20
Edit Download
ms-deprecated.php
3.68 KB lrw-r--r-- 2022-11-02 04:48:20
Edit Download
ms.php
33.45 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
nav-menu.php
47.98 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
network.php
26.40 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
noop.php
1.12 KB lrw-r--r-- 2023-11-08 04:28:29
Edit Download
options.php
4.14 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
plugin-install.php
38.13 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
plugin.php
91.09 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
post.php
80.33 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
privacy-tools.php
32.66 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
revision.php
16.24 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
schema.php
44.51 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
screen.php
6.24 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
taxonomy.php
8.28 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
template.php
97.35 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
theme-install.php
6.83 KB lrw-r--r-- 2024-04-04 04:45:29
Edit Download
theme.php
46.42 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
translation-install.php
10.82 KB lrw-r--r-- 2024-11-13 02:20:26
Edit Download
update-core.php
71.07 KB lrw-r--r-- 2026-06-07 20:00:03
Edit Download
update.php
34.03 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
upgrade.php
113.96 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
user.php
23.39 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
widgets.php
10.30 KB lrw-r--r-- 2026-06-07 20:00:04
Edit Download
If ZipArchive is unavailable, a .tar will be created (no compression).
© 2026 0xNothings — Secure File Manager. All rights reserved. Built with ❤️ & Tailwind x Dark UI
Upload
https://weelorum.com/post-sitemap.xml 2026-06-12T09:08:42+00:00 https://weelorum.com/page-sitemap.xml 2026-07-23T13:01:23+00:00 https://weelorum.com/portfolio-sitemap.xml 2026-06-22T17:36:07+00:00 https://weelorum.com/category-sitemap.xml 2026-06-12T09:08:42+00:00 https://weelorum.com/post_tag-sitemap.xml 2026-01-27T20:15:41+00:00 https://weelorum.com/portfolio_technology-sitemap.xml 2026-03-01T20:04:38+00:00 https://weelorum.com/portfolio_industry-sitemap.xml 2026-03-01T20:04:38+00:00 https://weelorum.com/portfolio_service-sitemap.xml 2026-03-01T20:04:38+00:00 https://weelorum.com/author-sitemap.xml 2026-02-22T16:40:15+00:00