Добавление базы категорий в URL для произвольного типа записей/таксономии
Я разрабатываю систему типа LMS в WordPress, управляемую с помощью Custom Post types
.
Тип записи называется Lessons
(со слагом courses
) и имеет одну custom taxonomy
(категорию) под названием courses
.
Структура URL домена сейчас отображается как:
domain.example/courses/lesson-name
.
Я хочу, чтобы она стала:
domain.example/courses/[course-name{category}]/lesson-name
или по сути:
/[cpt]/%category%/%postname%/
вот плагин, который я написал и который сейчас управляет CPTs
.
function rflms_post_type() {
$labels = array(
'name' => _x( 'Уроки', 'Post Type General Name', 'text_domain' ),
'singular_name' => _x( 'Урок', 'Post Type Singular Name', 'text_domain' ),
'menu_name' => __( 'Уроки', 'text_domain' ),
'parent_item_colon' => __( 'Родительский продукт:', 'text_domain' ),
'all_items' => __( 'Все уроки', 'text_domain' ),
'view_item' => __( 'Просмотреть урок', 'text_domain' ),
'add_new_item' => __( 'Добавить новый урок', 'text_domain' ),
'add_new' => __( 'Новый урок', 'text_domain' ),
'edit_item' => __( 'Редактировать урок', 'text_domain' ),
'update_item' => __( 'Обновить урок', 'text_domain' ),
'search_items' => __( 'Поиск уроков', 'text_domain' ),
'not_found' => __( 'Уроков не найдено', 'text_domain' ),
'not_found_in_trash' => __( 'В корзине уроков не найдено', 'text_domain' ),
);
$args = array(
'label' => __( 'Уроки', 'text_domain' ),
'description' => __( 'Ссылающиеся уроки', 'text_domain' ),
'labels' => $labels,
'hierarchical' => false,
'public' => true,
'show_ui' => true,
'show_in_menu' => true,
'show_in_nav_menus' => true,
'show_in_admin_bar' => true,
'supports' => array('premise-member-access', 'title', 'editor', 'author', 'thumbnail', 'excerpt', 'comments'),
'menu_position' => 5,
'menu_icon' => null,
'can_export' => true,
'has_archive' => true,
'exclude_from_search' => false,
'publicly_queryable' => true,
'capability_type' => 'post',
'rewrite' => array('slug' => 'courses'),
);
register_post_type( 'lessons', $args );
// Подключение к действию 'init'
}
add_action( 'init', 'rflms_post_type', 0 );
// Регистрация пользовательской таксономии
function custom_taxonomy() {
$labels = array(
'name' => _x( 'Курсы', 'Taxonomy General Name', 'text_domain' ),
'singular_name' => _x( 'Курс', 'Taxonomy Singular Name', 'text_domain' ),
'menu_name' => __( 'Курсы', 'text_domain' ),
'all_items' => __( 'Все курсы', 'text_domain' ),
'parent_item' => __( 'Родительский курс', 'text_domain' ),
'parent_item_colon' => __( 'Родительский курс:', 'text_domain' ),
'new_item_name' => __( 'Название нового курса', 'text_domain' ),
'add_new_item' => __( 'Добавить новый курс', 'text_domain' ),
'edit_item' => __( 'Редактировать курс', 'text_domain' ),
'update_item' => __( 'Обновить курс', 'text_domain' ),
'separate_items_with_commas' => __( 'Разделяйте курсы запятыми', 'text_domain' ),
'search_items' => __( 'Поиск курсов', 'text_domain' ),
'add_or_remove_items' => __( 'Добавить или удалить курсы', 'text_domain' ),
'choose_from_most_used' => __( 'Выбрать из часто используемых курсов', 'text_domain' ),
);
$args = array(
'labels' => $labels,
'hierarchical' => true,
'public' => true,
'show_ui' => true,
'show_admin_column' => true,
'show_in_nav_menus' => true,
'show_tagcloud' => false,
'rewrite' => array('slug' => 'courses'),
);
register_taxonomy( 'course', 'lessons', $args );
}
// Подключение к действию 'init'
add_action( 'init', 'custom_taxonomy', 0 );

Измените правила перезаписи (rewrite), чтобы добавить переменную запроса для курса:
'rewrite' => array('slug' => 'courses/%course%')
Затем добавьте фильтр post_type_link
, чтобы вставить выбранный курс в постоянную ссылку:
function wpa_course_post_link( $post_link, $id = 0 ){
$post = get_post($id);
if ( is_object( $post ) ){
$terms = wp_get_object_terms( $post->ID, 'course' );
if( $terms ){
return str_replace( '%course%' , $terms[0]->slug , $post_link );
}
}
return $post_link;
}
add_filter( 'post_type_link', 'wpa_course_post_link', 1, 3 );
Также существуют плагины, такие как Custom Post Type Permalinks, которые могут сделать это за вас.

Спасибо, я ценю ваш быстрый ответ. Это полностью логично. Мне интересно, куда именно нужно вставлять фильтр post_type_link? Можно ли просто добавить его в самый конец документа?

вам нужно сбросить rewrite правила, посетите страницу настроек постоянных ссылок.

также обратите внимание, что у вас может возникнуть конфликт, если таксономия и тип записи используют одинаковый слаг.

Сейчас у меня правильно формируются постоянные ссылки, но они не выполняются корректно (получается мягкая 404 ошибка). Какие рекомендации у вас есть, чтобы это исправить? Я знаю о сбросе правил перезаписи постоянных ссылок. Просто нажмите 'сохранить', и файл обновится (у меня nginx, поэтому это контролируется в файле nginx.conf)

Не работает для переведенных записей на многоязычном сайте (например, при использовании WPML).

У меня отображается главная страница при новом URL. Нужно использовать add_rewrite_rule() как в ответе @Floris, чтобы это заработало. Также учтите, что страницы архивов перестают работать - я получаю 404 для /my-post-type и для /my-post-type/my-category

Моё решение состояло из трёх частей. В моём случае тип записи называется trainings
.
- Добавить
'rewrite' => array('slug' => 'trainings/%cat%')
в функциюregister_post_type
. - Изменить ярлык (slug) для динамической категории.
- "Прослушивать" новый динамический URL и загружать соответствующий шаблон.
Вот как можно динамически изменить постоянную ссылку для определённого типа записи. Добавьте в functions.php
:
function vx_soon_training_post_link( $post_link, $id = 0 ) {
$post = get_post( $id );
if ( is_object( $post ) ) {
$terms = wp_get_object_terms( $post->ID, 'training_cat' );
if ( $terms ) {
return str_replace( '%cat%', $terms[0]->slug, $post_link );
}
}
return $post_link;
}
add_filter( 'post_type_link', 'vx_soon_training_post_link', 1, 3 );
...а вот как загрузить соответствующий шаблон для нового динамического URL. Добавьте в functions.php
:
function archive_rewrite_rules() {
add_rewrite_rule(
'^training/(.*)/(.*)/?$',
'index.php?post_type=trainings&name=$matches[2]',
'top'
);
//flush_rewrite_rules(); // использовать только один раз
}
add_action( 'init', 'archive_rewrite_rules' );
Всё! Не забудьте обновить постоянные ссылки, сохранив их снова в админке. Или используйте функцию flush_rewrite_rules()
.

Решение найдено!
Для создания иерархических постоянных ссылок (ЧПУ) для пользовательского типа записей установите плагин Custom Post Type Permalinks(https://wordpress.org/plugins/custom-post-type-permalinks/).
Обновите регистрацию типа записи. У меня тип записи называется Help Center.
function help_centre_post_type(){
register_post_type('helpcentre', array(
'labels' => array(
'name' => __('Центр помощи'),
'singular_name' => __('Центр помощи'),
'all_items' => __('Просмотреть записи'),
'add_new' => __('Новая запись'),
'add_new_item' => __('Новый материал Центра помощи'),
'edit_item' => __('Редактировать материал'),
'view_item' => __('Просмотреть материал'),
'search_items' => __('Искать в Центре помощи'),
'no_found' => __('Материалы не найдены'),
'not_found_in_trash' => __('В корзине нет материалов')
),
'public' => true,
'publicly_queryable'=> true,
'show_ui' => true,
'query_var' => true,
'show_in_nav_menus' => false,
'capability_type' => 'page',
'hierarchical' => true,
'rewrite'=> [
'slug' => 'help-center',
"with_front" => false
],
"cptp_permalink_structure" => "/%help_centre_category%/%post_id%-%postname%/",
'menu_position' => 21,
'supports' => array('title','editor', 'thumbnail'),
'has_archive' => true
));
flush_rewrite_rules();
}
add_action('init', 'help_centre_post_type');
А так регистрируется таксономия
function themes_taxonomy() {
register_taxonomy(
'help_centre_category',
'helpcentre',
array(
'label' => __( 'Категории' ),
'rewrite'=> [
'slug' => 'help-center',
"with_front" => false
],
"cptp_permalink_structure" => "/%help_centre_category%/",
'hierarchical' => true,
'public' => true,
'show_ui' => true,
'show_admin_column' => true,
'show_in_nav_menus' => true,
'query_var' => true
)
);
}
add_action( 'init', 'themes_taxonomy');
Эта строка обеспечивает работу ЧПУ:
"cptp_permalink_structure" => "/%help_centre_category%/%post_id%-%postname%/",
Вы можете удалить %post_id%
и оставить /%help_centre_category%/%postname%/"
Не забудьте сбросить постоянные ссылки в админ-панели.

Вам необходимо обновить строку, где вы регистрируете пользовательский тип записи с помощью функции register_post_type
.
'rewrite' => array('slug' => 'courses/%cat%')
Для динамического изменения постоянных ссылок (permalink) типа записи добавьте этот код в файл functions.php
:
function change_link( $post_link, $id = 0 ) {
$post = get_post( $id );
if( $post->post_type == 'courses' )
{
if ( is_object( $post ) ) {
$terms = wp_get_object_terms( $post->ID, array('course') );
if ( $terms ) {
return str_replace( '%cat%', $terms[0]->slug, $post_link );
}
}
}
return $post_link ;
}
add_filter( 'post_type_link', 'change_link', 1, 3 );
// Загружаем шаблон для нового сгенерированного URL, иначе будет ошибка 404
function generated_rewrite_rules() {
add_rewrite_rule(
'^courses/(.*)/(.*)/?$',
'index.php?post_type=courses&name=$matches[2]',
'top'
);
}
add_action( 'init', 'generated_rewrite_rules' );
После этого необходимо сбросить правила перезаписи (rewrite rules). Перейдите в wp-admin > Настройки > Постоянные ссылки, обновите настройки и нажмите кнопку "Сохранить изменения". В результате URL будут выглядеть так: domain.example/courses/[название-курса{категория}]/название-урока

Для всех, кто ищет решение без необходимости возиться с сырым PHP-кодом, я настоятельно рекомендую плагин Permalink Manager Lite от Maciej Bis. Это настоящая палочка-выручалочка.
Он предоставляет визуальный механизм для удаления или добавления любых частей в URL пользовательских типов записей на основе 'permastructs':
(Со всей болью, связанной с простой структурой URL для пользовательских типов записей, мы уже собирались отказаться от WP и перейти на другую CMS. Но этот плагин в сочетании с ACF и CPTUI или Pods делает WordPress достаточно профессиональным.)

Да! После долгих исследований я нашел плагин 'Custom Permalinks', который полностью соответствует моим требованиям к настройке пользовательских URL, например:
- Для рубрик
- Для записей
- Для пользовательских типов записей
- Для пользовательских таксономий и т.д.
Вот так выглядит настройка для пользовательского типа записи - Пост:

Я нашел ответ @chetan-vaghela почти идеальным; в моем случае я также хотел иметь возможность видеть список всех записей этого типа, как на типичной странице архива (например, /courses/, без каких-либо таксономий после этого). Мне просто нужно было добавить одно дополнительное правило перезаписи:
function generated_rewrite_rules() {
add_rewrite_rule(
'^courses/(.*)/(.*)/?$',
'index.php?post_type=courses&name=$matches[2]',
'top'
);
}
