get_tags()

get_tags( string|array $args = '' ) : WP_Term[]|int|WP_Error

$args = array(
  'taxonomy' => 'post_tag', // Таксономия для получения меток (по умолчанию 'post_tag')
  'orderby' => 'name', // Сортировка по имени
  'order' => 'ASC', // Сортировка в порядке возрастания
  'hide_empty' => false, // Показывать метки, не присвоенные ни одной записи
  'number' => 10 // Максимальное количество меток для получения
);
$tags = get_tags( $args );
if ( ! empty( $tags ) ) {
  foreach ( $tags as $tag ) {
    echo '<a href="' . get_tag_link( $tag ) . '">' . $tag->name . '</a> ';
  }
} else {
  echo 'Метки не найдены.';
}

$tags = get_tags();
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

$count = get_tags( array( 'count' => true ) );
echo $count;

$tags = get_tags( array( 'include' => '1,2,3' ) );
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

$tags = get_tags( array( 'exclude' => '4,5,6' ) );
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

$tags = get_tags( array( 'orderby' => 'name', 'order' => 'ASC' ) );
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

$tags = get_tags( array( 'meta_key' => 'color', 'meta_value' => 'red' ) );
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

$tags = get_tags( array( 'name' => 'tag1,tag2,tag3' ) );
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

$tags = get_tags( array( 'childless' => true ) );
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

$tags = get_tags( array( 'number' => 5 ) );
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

$tags = get_tags( array( 'description__like' => 'Lorem ipsum' ) );
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

$tags = get_tags( array( 'exclude' => '4,5,6', 'exclude_tree' => '7,8,9' ) );
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

$tags = get_tags( array( 'meta_key' => 'color', 'meta_value' => 'red', 'orderby' => 'count', 'order' => 'DESC' ) );
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

Вопросы и ответы

Как получить все метки постов?

Для получения всех меток постов в WordPress можно использовать функцию get_tags(). Она возвращает массив объектов терминов типа ‘post_tag’, количество этих терминов или объект WP_Error в случае, если таксономия не существует.

Пример использования:

$tags = get_tags();
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

Как отсортировать метки постов по имени?

Для сортировки меток постов по имени можно использовать параметр orderby функции get_tags(). Значение этого параметра должно быть строкой ‘name’.

Пример использования:

$tags = get_tags( array(
    'orderby' => 'name',
) );
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

Как получить только метки постов определенной таксономии?

Для получения только меток постов определенной таксономии можно использовать параметр taxonomy функции get_tags(). Значение этого параметра должно быть строкой с названием таксономии.

Пример использования:

$tags = get_tags( array(
    'taxonomy' => 'my_taxonomy',
) );
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

Как получить метки постов в обратном порядке?

Для получения меток постов в обратном порядке можно использовать параметр order функции get_tags(). Значение этого параметра должно быть строкой ‘DESC’.

Пример использования:

$tags = get_tags( array(
    'order' => 'DESC',
) );
if ( ! empty( $tags ) ) {
    foreach ( $tags as $tag ) {
        echo $tag->name;
    }
}

Как скрыть метки постов, которые не привязаны ни к одному посту?

Для скрытия меток постов, которые не привязаны ни к одному посту, можно использовать параметр hide_empty функции get_tags(). Установите значение этого параметра в true или 1. В итоге будут возвращены только метки, которые привязаны к постам.

$tags = get_tags( array(
    'hide_empty' => true,
) );

Как получить только определенные метки постов по их ID?

Для получения только определенных меток постов по их ID можно использовать параметр include функции get_tags(). Укажите в этом параметре массив или строку с ID нужных меток. В итоге будут возвращены только указанные метки.

$tags = get_tags( array(
    'include' => array( 1, 2, 3 ),
) );

Как исключить определенные метки постов по их ID?

Для исключения определенных меток постов по их ID можно использовать параметр exclude функции get_tags(). Укажите в этом параметре массив или строку с ID меток, которые нужно исключить. В итоге будут возвращены все метки, кроме указанных.

$tags = get_tags( array(
    'exclude' => array( 4, 5, 6 ),
) );

Как получить метки постов, у которых есть дочерние метки?

Для получения меток постов, у которых есть дочерние метки, можно использовать параметр child_of функции get_tags(). Укажите в этом параметре ID метки, для которой нужно получить дочерние метки. В итоге будут возвращены только метки, которые являются дочерними для указанной метки.

$tags = get_tags( array(
    'child_of' => 7,
) );

Функция get_tags() позволяет получить все метки постов или выполнить более точный запрос с использованием различных параметров. Вы можете скрыть метки, которые не привязаны ни к одному посту, получить только определенные метки по их ID, исключить определенные метки постов по их ID, а также получить метки постов, у которых есть дочерние метки. Эти возможности делают функцию get_tags() мощным инструментом для работы с метками в WordPress.