WP_Community_Events::get_events( string $location_search = '', string $timezone = '' ): array|WP_Error

91	public function get_events( $location_search = '', $timezone = '' ) {92		$cached_events = $this->get_cached_events();93 94		if ( ! $location_search && $cached_events ) {95			return $cached_events;96		}97 98		// Include an unmodified $wp_version.99		require ABSPATH . WPINC . '/version.php';100 101		$api_url                    = 'http://api.wordpress.org/events/1.0/';102		$request_args               = $this->get_request_args( $location_search, $timezone );103		$request_args['user-agent'] = 'WordPress/' . $wp_version . '; ' . home_url( '/' );104 105		if ( wp_http_supports( array( 'ssl' ) ) ) {106			$api_url = set_url_scheme( $api_url, 'https' );107		}108 109		$response       = wp_remote_get( $api_url, $request_args );110		$response_code  = wp_remote_retrieve_response_code( $response );111		$response_body  = json_decode( wp_remote_retrieve_body( $response ), true );112		$response_error = null;113 114		if ( is_wp_error( $response ) ) {115			$response_error = $response;116		} elseif ( 200 !== $response_code ) {117			$response_error = new WP_Error(118				'api-error',119				/* translators: %d: Numeric HTTP status code, e.g. 400, 403, 500, 504, etc. */120				sprintf( __( 'Invalid API response code (%d).' ), $response_code )121			);122		} elseif ( ! isset( $response_body['location'], $response_body['events'] ) ) {123			$response_error = new WP_Error(124				'api-invalid-response',125				$response_body['error'] ?? __( 'Unknown API error.' )126			);127		}128 129		if ( is_wp_error( $response_error ) ) {130			return $response_error;131		} else {132			$expiration = false;133 134			if ( isset( $response_body['ttl'] ) ) {135				$expiration = $response_body['ttl'];136				unset( $response_body['ttl'] );137			}138 139			/*140			 * The IP in the response is usually the same as the one that was sent141			 * in the request, but in some cases it is different. In those cases,142			 * it's important to reset it back to the IP from the request.143			 *144			 * For example, if the IP sent in the request is private (e.g., 192.168.1.100),145			 * then the API will ignore that and use the corresponding public IP instead,146			 * and the public IP will get returned. If the public IP were saved, though,147			 * then get_cached_events() would always return `false`, because the transient148			 * would be generated based on the public IP when saving the cache, but generated149			 * based on the private IP when retrieving the cache.150			 */151			if ( ! empty( $response_body['location']['ip'] ) ) {152				$response_body['location']['ip'] = $request_args['body']['ip'];153			}154 155			/*156			 * The API doesn't return a description for latitude/longitude requests,157			 * but the description is already saved in the user location, so that158			 * one can be used instead.159			 */160			if ( $this->coordinates_match( $request_args['body'], $response_body['location'] ) && empty( $response_body['location']['description'] ) ) {161				$response_body['location']['description'] = $this->user_location['description'];162			}163 164			/*165			 * Store the raw response, because events will expire before the cache does.166			 * The response will need to be processed every page load.167			 */168			$this->cache_events( $response_body, $expiration );169 170			$response_body['events'] = $this->trim_events( $response_body['events'] );