Шорткод в цикле всегда отображает данные первого поста на странице.

Содержание

Вопрос или проблема
Ответ или решение
Теория
Пример
Применение

Вопрос или проблема

Я создаю шорткод, чтобы получить категории заданного поста и отобразить их стильным образом. Я создал следующий шорткод:

function t3_categories_fonction(){
    global $post; // Получаем глобальный объект поста
    
    // Получаем ID поста из глобального объекта, если он не предоставлен
    //$post_id = $post->ID;
    $post_id = get_the_ID();
    
    // тестовый цикл для отображения категорий в одной строке (стилизация будет позже)
    $post_cats = get_the_category($post_id);
    foreach($post_cats as $cat){
        $result .= '-';
        $result .= $cat->slug;
    }
    return $result;
}
add_shortcode('t3_categories', 't3_categories_fonction' );

Однако этот шорткод всегда отображает категории первого поста на странице, даже когда он находится в отдельном вторичном цикле, вместо категорий поста, в котором находится блок шорткода (я использую блоковые темы, я делал циклы как блоки, мой шорткод находится внутри блока модели публикации моего цикла).

Я пробовал и get_the_ID(), и глобальную переменную $post. Результат один и тот же.

Эта проблема похожа на ту, которую я опубликовал на StackOverflow, и решения, предложенные для нее, не устранили проблему.

Ответ или решение

Вопрос, который необходимо рассмотреть — это проблема с шорткодом, который при выполнении в цикле отображает категории только первого поста на странице, несмотря на присутствие в шорткоде внутри блока публикации модели цикла. Давайте разберем, в чем причина этого поведения и как можно решить данную проблему.

Теория

В WordPress шорткоды выполняются в контексте глобальных переменных, в числе которых глобальная переменная $post. Использование этой переменной позволяет шорткоду взаимодействовать с данными текущего поста. Однако если шорткод не правильно учитывает текущий контекст или не обновляет глобальную переменную $post, это может привести к нежелательному поведению — например, выводу данных первого поста на странице, даже если шорткод применяется к другим элементам.

Функция get_the_ID() обращается к текущему глобальному посту, это означает, что если контекст неправильно задан или не обновлен, функция возвращает идентификатор первого поста. Это приводит к тому, что данные всегда берутся именно у первого поста.

Пример

Ваш код выглядит следующим образом:

function t3_categories_fonction(){
    global $post; // Получение глобального объекта поста

    // Получаем ID поста из глобального объекта поста
    //$post_id = $post->ID;
    $post_id = get_the_ID();

    // Тестовый цикл для отображения категорий в виде одной строки
    $post_cats = get_the_category($post_id);
    foreach($post_cats as $cat){
        $result .= '-';
        $result .= $cat->slug;
    }
    return $result;
}
add_shortcode('t3_categories', 't3_categories_fonction' );

Вы используете функцию get_the_ID(), которая зависит от глобального контекста текущего поста. Если этот контекст не обновляется (или неправильно обновляется в цикле), возвращаемый ID не меняется, и следовательно произойдет возврат категорий первого поста.

Применение

Для решения данной проблемы можно предпринять несколько шагов:

Манипуляции с глобальной переменной $post:

Перед вызовом шорткода измените контекст глобальной переменной $post:

function t3_categories_fonction($atts, $content = null){
   global $post;
   // Сохраняем оригинальный пост в переменной для последующего восстановления
   $original_post = $post;

   $post_id = get_the_ID();
   $post = get_post($post_id); // Обновляем глобальный объект текущим постом

   $post_cats = get_the_category($post_id);
   $result = '';
   foreach($post_cats as $cat){
       $result .= '-';
       $result .= $cat->slug;
   }

   // Восстанавливаем оригинальный пост
   $post = $original_post;
   return $result;
}

Использование функции the_loop():

Если ваш код выполняется в рамках цикла the_loop(), убедитесь, что цикл корректно используется и что шорткод выполняется после вызова setup_postdata($post), который обновляет глобальную переменную $post.
Проверка контекста выполнения:

Убедитесь в правильности того, каким образом встроена модель ваших публикаций и блоков. Возможно потребуется использовать хуки WordPress, такие как wp_reset_postdata(), чтобы сбросить обрабатываемый пост после изменения.
Диагностика путем отладки:

Попробуйте использовать функции отладки, такие как var_dump(), для проверки значений идентификаторов постов в каждом цикле. Это может помочь определить, где именно происходит ошибка контекста.

Интеграция вышеупомянутых мер позволит корректно применять шорткод в циклах, избегая привязки только к первому посту. Эти подходы помогут глубже понять внутренние процессы WordPress и наладить корректную работу вашей темы или плагина.