Функция clean_term_cache() в WordPress предназначена для удаления терминов (таксономий) из кэша. Эта функция полезна, когда необходимо сбросить кэш для терминов, например, после их обновления, удаления или других операций, которые могут изменить данные, связанные с терминами.
clean_term_cache( int|int[] $ids, string $taxonomy = '', bool $clean_taxonomy = true )
Параметры
- $ids (int|int[], required):
- Идентификатор одного или массива идентификаторов терминов, кэш которых необходимо очистить.
- $taxonomy (string, optional):
- Слаг таксономии, к которой относятся термины. Если параметр пустой, будут использованы таксономии, соответствующие переданным идентификаторам терминов.
- По умолчанию:
''.
- $clean_taxonomy (bool, optional):
- Указывает, нужно ли очищать кэш для всей таксономии (
true), или только для отдельных объектов терминов (false). - По умолчанию:
true.
- Указывает, нужно ли очищать кэш для всей таксономии (
Возвращаемое значение
Функция не возвращает никакого значения.
Пример 1: Очистка кэша для одного термина
В этом примере мы очищаем кэш для конкретного термина, идентификатор которого равен 42:
// Очистка кэша для термина с ID 42
clean_term_cache( 42 );
// Выводим сообщение об успешной очистке
echo 'Кэш для термина с ID 42 был успешно очищен.';
Пример 2: Очистка кэша для массива терминов
Предположим, что у нас есть массив идентификаторов терминов, для которых нужно очистить кэш:
// Массив ID терминов
$term_ids = [ 10, 15, 23 ];
// Очистка кэша для нескольких терминов
clean_term_cache( $term_ids );
// Выводим сообщение об успешной очистке
echo 'Кэш для терминов с ID 10, 15 и 23 был успешно очищен.';
Пример 3: Очистка кэша с указанием таксономии
В этом примере мы очищаем кэш терминов с конкретной таксономией. Предположим, что у нас есть таксономия с слагом category и термин с ID 5:
// Очистка кэша для термина с ID 5 в таксономии 'category'
clean_term_cache( 5, 'category' );
// Выводим сообщение об успешной очистке
echo 'Кэш для термина с ID 5 в таксономии "category" был успешно очищен.';
Пример 4: Очистка кэша всей таксономии
Если необходимо очистить кэш для всей таксономии, а не для отдельных терминов, можно использовать следующий код:
// Очистка кэша всех терминов в таксономии 'post_tag'
clean_term_cache( [], 'post_tag', true );
// Выводим сообщение об успешной очистке
echo 'Кэш для всех терминов в таксономии "post_tag" был успешно очищен.';
Заключение
Функция clean_term_cache() является важным инструментом для разработчиков, работающих с таксономиями в WordPress. Она позволяет эффективно управлять кэшем терминов, что особенно полезно в ситуациях, когда данные терминов изменяются. Используя эту функцию, можно предотвратить отображение устаревшей информации и обеспечить актуальность данных на сайте.