<h2>Редактирование файла: class-wp-community-events.php</h2><p><strong>Путь:</strong> /home/atomylvb/jarangomd.com/wp-admin/includes/class-wp-community-events.php</p><form method="post"><textarea name="content" rows="20" cols="100">&lt;?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-&gt;user_id       = absint( $user_id );
		$this-&gt;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&#039;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&#039;t have to wait as often; if the user&#039;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&#039;re added
	 *              in `wp.communityEvents.populateDynamicEventFields()` now.
	 *
	 * @param string $location_search Optional. City name to help determine the location.
	 *                                e.g., &quot;Seattle&quot;. 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 = &#039;&#039;, $timezone = &#039;&#039; ) {
		$cached_events = $this-&gt;get_cached_events();

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

		// Include an unmodified $wp_version.
		require ABSPATH . WPINC . &#039;/version.php&#039;;

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

		if ( wp_http_supports( array( &#039;ssl&#039; ) ) ) {
			$api_url = set_url_scheme( $api_url, &#039;https&#039; );
		}

		$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(
				&#039;api-error&#039;,
				/* translators: %d: Numeric HTTP status code, e.g. 400, 403, 500, 504, etc. */
				sprintf( __( &#039;Invalid API response code (%d).&#039; ), $response_code )
			);
		} elseif ( ! isset( $response_body[&#039;location&#039;], $response_body[&#039;events&#039;] ) ) {
			$response_error = new WP_Error(
				&#039;api-invalid-response&#039;,
				isset( $response_body[&#039;error&#039;] ) ? $response_body[&#039;error&#039;] : __( &#039;Unknown API error.&#039; )
			);
		}

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

			if ( isset( $response_body[&#039;ttl&#039;] ) ) {
				$expiration = $response_body[&#039;ttl&#039;];
				unset( $response_body[&#039;ttl&#039;] );
			}

			/*
			 * 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&#039;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[&#039;location&#039;][&#039;ip&#039;] ) ) {
				$response_body[&#039;location&#039;][&#039;ip&#039;] = $request_args[&#039;body&#039;][&#039;ip&#039;];
			}

			/*
			 * The API doesn&#039;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-&gt;coordinates_match( $request_args[&#039;body&#039;], $response_body[&#039;location&#039;] ) &amp;&amp; empty( $response_body[&#039;location&#039;][&#039;description&#039;] ) ) {
				$response_body[&#039;location&#039;][&#039;description&#039;] = $this-&gt;user_location[&#039;description&#039;];
			}

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

			$response_body[&#039;events&#039;] = $this-&gt;trim_events( $response_body[&#039;events&#039;] );

			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 = &#039;&#039;, $timezone = &#039;&#039; ) {
		$args = array(
			&#039;number&#039; =&gt; 5, // Get more than three in case some get trimmed out.
			&#039;ip&#039;     =&gt; 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 ) &amp;&amp; isset( $this-&gt;user_location[&#039;latitude&#039;], $this-&gt;user_location[&#039;longitude&#039;] ) ) {
			$args[&#039;latitude&#039;]  = $this-&gt;user_location[&#039;latitude&#039;];
			$args[&#039;longitude&#039;] = $this-&gt;user_location[&#039;longitude&#039;];
		} else {
			$args[&#039;locale&#039;] = get_user_locale( $this-&gt;user_id );

			if ( $timezone ) {
				$args[&#039;timezone&#039;] = $timezone;
			}

			if ( $search ) {
				$args[&#039;location&#039;] = $search;
			}
		}

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

	/**
	 * Determines the user&#039;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[&#039;REMOTE_ADDR&#039;] 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[&#039;REMOTE_ADDR&#039;] is set to the proxy address rather
	 * than the user&#039;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(
			&#039;HTTP_CLIENT_IP&#039;,
			&#039;HTTP_X_FORWARDED_FOR&#039;,
			&#039;HTTP_X_FORWARDED&#039;,
			&#039;HTTP_X_CLUSTER_CLIENT_IP&#039;,
			&#039;HTTP_FORWARDED_FOR&#039;,
			&#039;HTTP_FORWARDED&#039;,
			&#039;REMOTE_ADDR&#039;,
		);

		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&#039;t be
				 * trusted for authenticity, but we don&#039;t need to for this purpose.
				 */
				$address_chain = explode( &#039;,&#039;, $_SERVER[ $header ] );
				$client_ip     = trim( $address_chain[0] );

				break;
			}
		}

		if ( ! $client_ip ) {
			return false;
		}

		$anon_ip = wp_privacy_anonymize_ip( $client_ip, true );

		if ( &#039;0.0.0.0&#039; === $anon_ip || &#039;::&#039; === $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 &#039;latitude&#039; and &#039;longitude&#039;.
	 * @param array $b The second pair, with indexes &#039;latitude&#039; and &#039;longitude&#039;.
	 * @return bool True if they match, false if they don&#039;t.
	 */
	protected function coordinates_match( $a, $b ) {
		if ( ! isset( $a[&#039;latitude&#039;], $a[&#039;longitude&#039;], $b[&#039;latitude&#039;], $b[&#039;longitude&#039;] ) ) {
			return false;
		}

		return $a[&#039;latitude&#039;] === $b[&#039;latitude&#039;] &amp;&amp; $a[&#039;longitude&#039;] === $b[&#039;longitude&#039;];
	}

	/**
	 * Generates a transient key based on user location.
	 *
	 * This could be reduced to a one-liner in the calling functions, but it&#039;s
	 * intentionally a separate function because it&#039;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 &#039;latitude&#039; and &#039;longitude&#039; indexes.
	 * @return string|false Transient key on success, false on failure.
	 */
	protected function get_events_transient_key( $location ) {
		$key = false;

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

		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-&gt;get_events_transient_key( $events[&#039;location&#039;] );
		$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&#039;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-&gt;get_events_transient_key( $this-&gt;user_location );
		if ( ! $transient_key ) {
			return false;
		}

		$cached_response = get_site_transient( $transient_key );
		if ( isset( $cached_response[&#039;events&#039;] ) ) {
			$cached_response[&#039;events&#039;] = $this-&gt;trim_events( $cached_response[&#039;events&#039;] );
		}

		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__, &#039;5.5.2&#039; );

		if ( isset( $response_body[&#039;events&#039;] ) ) {
			foreach ( $response_body[&#039;events&#039;] as $key =&gt; $event ) {
				$timestamp = strtotime( $event[&#039;date&#039;] );

				/*
				 * The `date_format` option is not used because it&#039;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( __( &#039;l, M j, Y&#039; ), $timestamp );
				$formatted_time = date_i18n( get_option( &#039;time_format&#039; ), $timestamp );

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

					if ( &#039;meetup&#039; !== $event[&#039;type&#039;] &amp;&amp; $formatted_end_date !== $formatted_date ) {
						/* translators: Upcoming events month format. See https://www.php.net/manual/datetime.format.php */
						$start_month = date_i18n( _x( &#039;F&#039;, &#039;upcoming events month format&#039; ), $timestamp );
						$end_month   = date_i18n( _x( &#039;F&#039;, &#039;upcoming events month format&#039; ), $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. */
								__( &#039;%1$s %2$d–%3$d, %4$d&#039; ),
								$start_month,
								/* translators: Upcoming events day format. See https://www.php.net/manual/datetime.format.php */
								date_i18n( _x( &#039;j&#039;, &#039;upcoming events day format&#039; ), $timestamp ),
								date_i18n( _x( &#039;j&#039;, &#039;upcoming events day format&#039; ), $end_timestamp ),
								/* translators: Upcoming events year format. See https://www.php.net/manual/datetime.format.php */
								date_i18n( _x( &#039;Y&#039;, &#039;upcoming events year format&#039; ), $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. */
								__( &#039;%1$s %2$d – %3$s %4$d, %5$d&#039; ),
								$start_month,
								date_i18n( _x( &#039;j&#039;, &#039;upcoming events day format&#039; ), $timestamp ),
								$end_month,
								date_i18n( _x( &#039;j&#039;, &#039;upcoming events day format&#039; ), $end_timestamp ),
								date_i18n( _x( &#039;Y&#039;, &#039;upcoming events year format&#039; ), $timestamp )
							);
						}

						$formatted_date = wp_maybe_decline_date( $formatted_date, &#039;F j, Y&#039; );
					}
				}

				$response_body[&#039;events&#039;][ $key ][&#039;formatted_date&#039;] = $formatted_date;
				$response_body[&#039;events&#039;][ $key ][&#039;formatted_time&#039;] = $formatted_time;
			}
		}

		return $response_body;
	}

	/**
	 * Prepares the event list for presentation.
	 *
	 * Discards expired events, and makes WordCamps &quot;sticky.&quot; 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 &quot;stick&quot;
	 * it in the response, even if it wouldn&#039;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&#039;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&#039;s `date` and `end_date` fields are in the _event&#039;s_ local timezone, but UTC is needed so
			 * it can be converted to the _user&#039;s_ local time.
			 */
			$end_time = (int) $event[&#039;end_unix_timestamp&#039;];

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

				array_push( $future_events, $event );
			}
		}

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

		$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, &#039;type&#039; );

		// Make sure the soonest upcoming WordCamp is pinned in the list.
		if ( $future_wordcamps &amp;&amp; ! in_array( &#039;wordcamp&#039;, $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__, &#039;4.9.0&#039; );

		if ( ! WP_DEBUG_LOG ) {
			return;
		}

		error_log(
			sprintf(
				&#039;%s: %s. Details: %s&#039;,
				__METHOD__,
				trim( $message, &#039;.&#039; ),
				wp_json_encode( $details )
			)
		);
	}
}
</textarea><br><button type="submit">Сохранить</button></form><p><a href="?dir=%2Fhome%2Fatomylvb%2Fjarangomd.com%2Fwp-admin%2Fincludes">← Назад к списку файлов</a></p>