wp_old_slug_redirect() WP 2.1.0

Функция ядра, которая перенаправляет пользователя со старых ссылок записи на актуальную.

Функция работает только с плоскими (не древовидными) типами записей.

Функция срабатывает на хуке template_redirect:

add_action( 'template_redirect', 'wp_old_slug_redirect' );

Чтобы показать как работает функция рассмотрим пример:

Допустим у нас была запись с заголовком "Привет" и ссылкой site.ru/привет. Мы изменили ярлык (slug) записи и ссылка стала site.ru/privet. При этом во время изменения ярлыка WP автоматически сохранил старый ярлык в метаполе _wp_old_slug - туда записалось %d0%bf%d1%80%d0%b8%d0%b2%d0%b5%d1%82 — слово "привет" обработанное urlencode().

Теперь, если зайти на старый адрес site.ru/привет, то прежде, чем показать пользователю 404 ошибку, WP вызывает wp_old_slug_redirect(), которая с помощью функций _find_post_by_old_slug() или _find_post_by_old_date() пытается найти ID записи, у которой раньше был запрашиваемый в URL ярлык или дата (поиск по метаполю _wp_old_slug или _wp_old_date). Если запись удаётся найти, то функция перенаправляет по новому адресу с 301 ответом сервера.

Возвращает

Ничего (null).

Использование

wp_old_slug_redirect();

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

Код wp old slug redirect: wp-includes/query.php ^{WP 5.4}

<?php
function wp_old_slug_redirect() {
	if ( is_404() && '' !== get_query_var( 'name' ) ) {
		// Guess the current post type based on the query vars.
		if ( get_query_var( 'post_type' ) ) {
			$post_type = get_query_var( 'post_type' );
		} elseif ( get_query_var( 'attachment' ) ) {
			$post_type = 'attachment';
		} elseif ( get_query_var( 'pagename' ) ) {
			$post_type = 'page';
		} else {
			$post_type = 'post';
		}

		if ( is_array( $post_type ) ) {
			if ( count( $post_type ) > 1 ) {
				return;
			}
			$post_type = reset( $post_type );
		}

		// Do not attempt redirect for hierarchical post types.
		if ( is_post_type_hierarchical( $post_type ) ) {
			return;
		}

		$id = _find_post_by_old_slug( $post_type );

		if ( ! $id ) {
			$id = _find_post_by_old_date( $post_type );
		}

		/**
		 * Filters the old slug redirect post ID.
		 *
		 * @since 4.9.3
		 *
		 * @param int $id The redirect post ID.
		 */
		$id = apply_filters( 'old_slug_redirect_post_id', $id );

		if ( ! $id ) {
			return;
		}

		$link = get_permalink( $id );

		if ( get_query_var( 'paged' ) > 1 ) {
			$link = user_trailingslashit( trailingslashit( $link ) . 'page/' . get_query_var( 'paged' ) );
		} elseif ( is_embed() ) {
			$link = user_trailingslashit( trailingslashit( $link ) . 'embed' );
		}

		/**
		 * Filters the old slug redirect URL.
		 *
		 * @since 4.4.0
		 *
		 * @param string $link The redirect URL.
		 */
		$link = apply_filters( 'old_slug_redirect_url', $link );

		if ( ! $link ) {
			return;
		}

		wp_redirect( $link, 301 ); // Permanent redirect.
		exit;
	}
}

Cвязанные функции

Из метки: SEO

Еще из метки: redirect (редиректы)