В WordPress функция remove_permastruct() позволяет удалять структуры постоянных ссылок (ЧПУ), которые были добавлены ранее с использованием add_permastruct(). Это может быть полезно, если вы хотите изменить структуру URL для определенных типов записей или просто очистить ненужные структуры.
remove_permastruct( string $name )
Эта функция удаляет ранее добавленную структуру постоянных ссылок. Однако следует помнить, что встроенные структуры (например, для стандартных типов записей) удалить нельзя.
Параметры:
- $name (string, обязательный): Название структуры постоянных ссылок, которую вы хотите удалить.
Возврат значения
Функция ничего не возвращает (null).
Внутреннее устройство
Функция remove_permastruct() использует метод класса WP_Rewrite для удаления структуры:
public function remove_permastruct( $name ) {
unset( $this->extra_permastructs[ $name ] );
}
Использование
Чтобы удалить структуру постоянных ссылок, нужно просто вызвать remove_permastruct() с необходимым параметром. Рассмотрим несколько примеров.
Пример 1: Удаление пользовательской структуры постоянных ссылок
Предположим, вы добавили структуру постоянных ссылок для типа записи movie, которая выглядит следующим образом:
// Добавляем структуру постоянных ссылок
add_permastruct( 'movie', 'movies/%movie%' );
// Удаляем структуру постоянных ссылок
remove_permastruct( 'movie' );
В данном случае вызов remove_permastruct('movie') удалит структуру постоянных ссылок, и URL-адреса для этого типа записи больше не будут формироваться по указанному шаблону.
Пример 2: Удаление структуры для другого типа записи
Допустим, вы создали структуру для типов записей recipe:
// Добавляем структуру постоянных ссылок
add_permastruct( 'recipe', 'recipes/%recipe%' );
// Теперь удаляем её
remove_permastruct( 'recipe' );
Этот код сначала добавляет структуру, а затем удаляет её. После вызова remove_permastruct('recipe'), структура больше не будет существовать, и WordPress не сможет генерировать ссылки в соответствии с этим шаблоном.
Заключение
Функция remove_permastruct() — это полезный инструмент для управления постоянными ссылками в WordPress. Она позволяет легко удалять ненужные структуры, добавленные ранее. Прежде чем использовать эту функцию, убедитесь, что вы полностью понимаете, как это повлияет на ваши URL и логику сайта.