Теги шаблонов WordPress - Общие теги(продолжение)

wp_list_pages

Выводит список страниц в виде ссылок. Можно использовать с версии WordPress 1.5 и выше.

Использование

<?php wp_list_pages( $args ); ?>

Использование по умолчанию:

<?php $args = array(
    'authors'      => '',
    'child_of'     => 0,
    'date_format'  => get_option('date_format'),
    'depth'        => 0,
    'echo'         => 1,
    'exclude'      => '',
    'include'      => '',
    'link_after'   => '',
    'link_before'  => '',
    'post_type'    => 'page',
    'post_status'  => 'publish',
    'show_date'    => '',
    'sort_column'  => 'menu_order, post_title',
    'sort_order'   => '',
    'title_li'     => __('Pages'),
    'walker'       => ''
); ?>

При использовании по умолчанию выводит:

Параметры:

sort_column
(string) Сортирует список страниц разными способами. По умолчанию сортирует в алфавитном порядке по заголовку страницы.
  • 'post_title' – Сортировка в алфавитном порядке (по заголовку) – по умолчанию
  • 'menu_order' – Сортирует страницы по их порядку.
  • 'post_date' – По дате создания.
  • 'post_modified' – По дате последнего изменения.
  • 'ID' – По уникальному ID страницы.
  • 'post_author' – По ID автора страницы.
  • 'post_name' – В алфавитном порядке по короткому имени страницы.
sort_order
(string) Порядок сортировки списка страниц(по возрастанию или по убыванию). По умолчанию по возрастанию. Значения:
  • 'ASC' – По возрастанию (По умолчанию).
  • 'DESC' – По убыванию.
exclude
(string) Исключает страницы из списка, указанные в виде ID страницы разделенные запятой (пример: 'exclude=3,7,31'). Нет значения по умолчанию.
include
(string) Включает только выбранные страницы. Как и exclude, этот параметр принимает список ID страниц разделенных запятой. Нет значения по умолчанию.
depth
(integer) Этот параметр контролирует сколько уровней в иерархии страниц будет включено в список выдаваемый wp_list_pages. По умолчанию 0 (показываются все страницы, включая внутренние страницы).
  • 0 – Страницы и внутренние страницы выводятся иерархически (с отступом) (По умолчанию).
  • -1 – Страницы и внутренние страницы выводятся плоско (без отступа).
  • 1 – Выводятся только главные страницы(без внутренних страниц)
  • 2 – Значения равное 2 или больше указывают глубину (или уровень) отображения страниц.
child_of
(integer) Выводит внутренние страницы только одной страницы; используйте ID страницы как значение. По умолчанию 0 (Выводит все страницы).
show_date
(string) Выводить дату создания или изменения возле каждой страницы. По умолчанию "пусто" (не показывать дату). Значения:
  • '' – Не показывать дату (По умолчанию).
  • 'modified' – Выводить дату последнего изменения.
  • 'xxx' – Любое другое значение кроме modified выводит дату (post_date) создания страницы.
date_format
(string) Устанавливает формат даты выводимой параметром show_date (например: "l, F j, Y"). По умолчанию выводит так как настроено в WordPress.
title_li
(string) Стиль для заголовка к списку страниц. По умолчанию '__('Pages')', выводитs "Pages" ( __('') используется для локализации). Если использовать пустое значение (''), то заголовок не будет выводиться
echo
(boolean) Выводить или возвратить список ссылок. По умолчанию 1 (выводить список). Значения:
  • 1 (true) – По умолчанию
  • 0 (false)
hierarchical
(boolean) Устанавливает, показывать ли внутренние страницы в иерархическом порядке. Возможные значения:
  • 1 (true) – default
  • 0 (false)
meta_key
(string) Включает в список только те страницы у которых заполнено Ключ Дополнительного Поля (используется вместе с полем meta_value).
meta_value
(string) Включает в список только те страницы у которых заполнено Значение Дополнительного Поля (используется вместе с полем meta_key).

Примеры:

Заголовок списка, по умолчанию (“Pages”) который создает wp_list_pages может быть скрытым путем присваивания пустого значения параметру the title_li. Пример ниже показывает это.

<ul>
    <?php wp_list_pages('title_li='); ?>
</ul>

В приведенном ниже примере выводятся только страницы с ID 9, 5, и 23, а также меняется заголовок списка на слово “Поэзия”, с заключением его в теги <h2>:

<ul>
    <?php wp_list_pages('include=5,9,23&title_li=<h2>' . __('Поэзия') . '</h2>' ); ?>
</ul>

В этом примере страницы выводятся упорядоченными по полю “Порядок страницы” заданному при создании страницы.

<ul>
    <?php wp_list_pages('sort_column=menu_order'); ?>
</ul>

Если вы хотите отсортировать страницы в соответствии с Порядком Страницы и озаглавить список страниц словом “Проза” (в теге h2) в Боковой колонке, вы можете добавить следующий код в файл sidebar.php:

<ul>
    <?php wp_list_pages('sort_column=menu_order&title_li=<h2>' . __('Проза') . '</h2>' ); ?>
</ul>

Следующий код выведет список страниц без заголовка, отсортированный по полю “Порядок Страницы”:

<ul>
    <?php wp_list_pages('sort_column=menu_order&title_li='); ?>
</ul>

wp_dropdown_pages

Выводит список страниц в выпадающем списке, без кнопки.

Использование

<?php wp_dropdown_pages( $args ); ?>

Использование по умолчанию:

$defaults = array(
    'depth' => 0,
    'child_of' => 0,
    'selected' => 0,
    'echo' => 1,
    'name' =>
    'page_id',
    'show_option_none' => ''
);

При использовании по умолчанию:

Параметры:

depth
(integer) Этот параметр указывает уровней в иерархии страниц будет включено в список созданный тегом wp_list_pages. Значение по умолчанию 0 (выводятся все страницы, включая подстраницы).
  • 0 – Страницы и подстраницы выводятся иерархически (с отступом) (По умолчанию).
  • -1 – Страницы и подстраницы выводятся плоско (без отступа).
  • 1 – Показывает только верхние страницы.
  • 2 – значения равное 2 (или больше) указывает глубину (или уровень) вывода страниц.
child_of
(integer) Выводит подстраницы только указанной страницы; использует ID страницы как значение. По умолчанию 0 (выводятся все страницы).
selected
(integer) ID страницы которая будет выбрана в выпадающем списке. По умолчанию нет.
echo
(boolean) Указывает выводить список или вернуть для использования в PHP. По умолчанию 1 (выводить). Значения:
  • 1 (true) – По умолчанию
  • 0 (false)
name
(string) Имя присваиваемое выпадающему списку. По умолчанию 'page_id'.
show_option_none
(string) Добавляет в список элемент для выбора ни одной из страниц.
exclude
(string) Список ID разделенных запятыми для исключения. Для примера, 'exclude=4,12' уберет из списка страницы с ID 4 и 12. По умолчанию ни что не исключается.

Примеры:

Выводит иерархический выпадающий список в форме HTML с кнопкой.

<li id="pages">
    <h2><?php _e('pages:'); ?></h2>
    <form action="<?php bloginfo('url'); ?>" method="get">
    <?php wp_dropdown_pages(); ?>
    <input type="submit" name="submit" value="view" />
    </form>
</li>

wp_loginout

Выводит ссылку для входа/выхода в WordPress. Введено с версии 1.5.

Пример:

<p><?php wp_loginout(); ?></p>

wp_register

Этот тег выводит ссылку “Регистрация” связываются с пользователями, которые не зарегистрированы или ссылку “Управление”, если пользователь зпрегистрирован. Ссылка “Регистрация” выводится только если в Администрирование-> Настройки-> Общие-> Членство, выбрано: Любой может зарегистрироваться. Ссылка “Регистрация” вызывает /wp-register.php, а ссылка “Управление” /wp-admin/index.php.

Этот тег доступен с WordPress 1.5.

Этот тэг не функционирует должным образом в WordPress µ.

Параметры:

before
(string) Текст для вывода до ссылки. По умолчанию <li>.
after
(string) Текст для вывода после ссылки. По умолчанию </li>.

Примеры:

wp_register выводит ссылку заключенную в тег <li>.

<?php wp_register(); ?>

Этот пример выводит ссылку без текста до и после ссылки.

<?php wp_register('', ''); ?>

В WordPress µ, нет файла /wp-register.php, и /wp-login.php?action=register неправильная регистрационная форма. Таким образом, wp_register не показывает регистрационную ссылку.

query_posts

query_posts может использоваться для определения, какие сообщения будут выводиться в Цикле. Использует разнообразные параметры в том же самом формате какой используется в вашем URL(например p=4 для вывода только сообщения с ID 4)

Может использоваться для того что бы:

Параметры:

Это не полный список. Здесь показываются некоторые вещи которые можно использовать при создании собственных запросов.

КАТЕГОРИИ.

Показать сообщения только одной категории.

Выводит сообщения только одной категории используя ее ID:

query_posts('cat=4');

Выводит сообщения только одной категории используя ее название:

query_posts('category_name=Staff Home');

Выводит сообщения из нескольких указанных категорий используя их ID:

query_posts('cat=2,6,17,38');

Выводит все сообщения кроме тех которые находятся в исключенной категории, исключается путем добавления знака минуса перед ID категории:

query_posts('cat=-3');

МЕТКИ.

Вывести сообщения ассоциированные с определенными метками.

Выбирает сообщение с одной меткой :

query_posts('tag=cooking');

Выбирает сообщение с любой из определенных меток:

query_posts('tag=bread,baking');

Выбирает сообщение со всеми тремя метками:

query_posts('tag=bread+baking+recipe');

АВТОР.

Также вы можете ограничить вывод сообщений по их автору.

author_name основывается на поле user_nicename, а author на id автора.

СООБЩЕНИЯ И СТРАНИЦЫ.

Выводит одно сообщение или одну страницу.

ВРЕМЯ И ДАТА.

Возвращает сообщения опубликованные в определенный промежуток времени.

СТРАНИЦА.

СМЕЩЕНИЕ.

Выведет 5 сообщений пропуская 1:

query_posts('showposts=5&offset=1');

СОРТИРОВКА.

Сортирует сообщения по следующим полям.

Также “ASC” или “DESC”

ОБЪЕДИНЕНИЕ ПАРАМЕТРОВ.

Вы можете комбинировать параметры с помощью символа (&), вот так:

query_posts('cat=3&year=2004');

Сообщения из категории с ID 13, опубликованные в текущем месяце на главной странице:

if (is_home()) {
    query_posts($query_string . '&cat=13&monthnum=' . date('n',current_time('timestamp')));
}

В 2.3 эта комбинация выведет 2 сообщения из категорий 1 и 3, отсортированные по убыванию, по заголовку:

query_posts(
    array(
        'category__and'=>array(1,3),
        'showposts'=>2,
        'orderby'=>title,
        'order'=>DESC
    )
);

В 2.3 и в 2.5 выведет все сообщения с меткой “apples” из категории с ID 1

query_posts('cat=1&tag=apples');

Примеры:

Исключение определенной категории из главной страницы блога:

<?php
    if (is_home()) { query_posts("cat=-3"); }
?>

Вы также можете исключить несколько категорий:

<?php
    if (is_home()) { query_posts("cat=-1,-2,-3"); }
?>

Вывести определенное сообщение:

<?php
    query_posts('p=5'); //возвращает одно сообщение с ID 5
?>

Вывести определенную страницу:

<?php
    query_posts('page_id=7'); //возвращается только страница с ID 7
?>

или

<?php
    query_posts('pagename=about'); //возвращается только страница about
?>

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

<?php
    query_posts('pagename=parent/child'); // возвращается дочерняя страница child родителя parent
?>

rss_enclosure

Преобразовывает ссылки на аудио и видео файлы в сообщении в RSS вложения. Используется для подкастинга.

Пример:

<?php rss_enclosure(); ?>

wp_tag_cloud

Введен с версии 2.3. Выводит список тегов виде “облака тегов”, где размер каждого тега определен количеством сообщений в которых он был использован.

Параметры:

smallest
(integer) Размер текста для тега с самым малым числом (единица измерения указывается в параметре unit).
largest
(integer) Размер текста для тега с самым большим числом (единица измерения указывается в параметре unit).
unit
(string) Единица измерения для параметров smallest и largest. Например pt, px, em, %; по умолчанию pt (пункты).
number
(integer) Число тегов показываемые в облаке тегов. (Используйте ’0′ для вывода всех тегов.)
format
(string) Формат вывода облака.
  • 'flat' (По умолчанию) теги отделяются пустым пространством
  • 'list' теги выводятся в виде списка UL CSS класс которого class=’wp-tag-cloud’
  • 'array' теги возвращаются в виде массива для дальнейшего использования в PHP. Замечание: Возвращаются, а не выводятся.
Замечание: этот параметр введен в версии 2.5.
orderby
(string) Сортировка тегов. Значения:
  • 'name' (По умолчанию)
  • 'count'
order
(string) Порядок сортировки. Значения – **Долдны быть Заглавными**:
  • 'ASC' (По умолчанию)
  • 'DESC'
  • 'RAND' теги выводятся в случайном порядке. Замечание: этот параметр введен в версии 2.5.
exclude
(string) Список тегов для исключения, разделенные запятой. Пример, ‘exclude=5,27′ исключит теги с term_id 5 и 27 из результата. По умолчанию ничего не исключается.
include
(string) Список тегов для добавления, разделенные запятой. Пример, ‘include=5,27′ выведет только теги с term_id 5 и 27. По умолчанию выводятся все.

Примеры:

При использовании по умолчанию:

$defaults = array('smallest' => 8, 'largest' => 22, 'unit' => 'pt', 'number' => 45, 'format' => 'flat', 'orderby' => 'name', 'order' => 'ASC','exclude' => *, 'include' => *);

По умолчанию:

Вывод тегов под заголовком “Популярные теги”

<?php
    if ( function_exists('wp_tag_cloud') ) : ?>
        <li> <h2>Популярные теги</h2>
            <ul> <?php wp_tag_cloud('smallest=8&largest=22'); ?> </ul>
        </li>
<?php endif; ?>

Облако ограничено по числу тегов и отсортировано по числу

<?php wp_tag_cloud('smallest=8&largest=22&number=30&orderby=count'); ?>

Возвращается массив, облако не выводится

<?php $tag = wp_tag_cloud('format=array' );?>

the_search_query

Отображает слово по которому был произведен поиск.

Примеры:

При поиске в поле поиска отображается текущий запрос:

<form method="get" id="searchform" action="<?php bloginfo('url'); ?>/">
    <div>
        <input type="text" value="<?php the_search_query(); ?>" name="s" id="s" />
        <input type="submit" id="searchsubmit" value="Поиск" />
    </div>
</form>

Отображает слово при выводе результатов поиска:

<p>Вы искали: " <?php the_search_query() ?> ". Результаты:</p>