WordPress как на ладони
Очень Удобный и Быстрый Хостинг для сайтов на WordPress. Пользуюсь сам и вам рекомендую!
функция не описана

WP_Community_Events::get_events() public WP 4.8.0

Gets data about events near a particular location.

Ищем WP-разработчика! Фулл-тайм, удаленка, хорошая зарплата, соц. пакет. Подробности.
Компания Boosta.

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.

{} Это метод класса: WP_Community_Events{}

Хуков нет.


Массив|WP_Error. A WP_Error on failure; an array with location and events on success.


$WP_Community_Events = new WP_Community_Events();
$WP_Community_Events->get_events( $location_search, $timezone );
City name to help determine the location. e.g., "Seattle".
По умолчанию: empty string
Timezone to help determine the location.
По умолчанию: empty string

Список изменений

С версии 4.8.0 Введена.
С версии 5.5.2 Response no longer contains formatted date field. They're added in wp.communityEvents.populateDynamicEventFields() now.

Код WP_Community_Events::get_events() WP 5.8.1

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(
			/* 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(
			isset( $response_body['error'] ) ? $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.,,
		 * 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;