trackback_url

Выводит или возвращает url трекбека текущего сообщения. Используется в Цикле.

Параметры:

display

(boolean) Вывести URL (TRUE), или вернуть (FALSE). По умолчанию TRUE.

Пример:

<p>URL трекбека для текущего сообщения: <?php trackback_url(); ?></p>

trackback_rdf

Возвращает url трекбека в RDF формате для текущего сообщения. Используется в Цикле.

Пример:

Выводит RDF информацию до конца Цикла. Оберните этот тег HTML тегами комментария чтобы избежать ошибок при валидации.

<!--
<?php trackback_rdf(); ?>
-->

<?php endforeach; else: ?>

wp_tag_cloud

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

Параметры:

smallest

(integer) Размер текста метки с самым малым числом.

largest

(integer) Размер текста метки с самым большим числом.

unit

(string) Единица измерения для smallest и largest. Например: pt, px, em, %; по умолчанию pt (пункты).

number

(integer) Количество выводимых меток. (Используйте ’0′ для вывода всех меток.)

format

(string) Форматирование вывода облака меток.

• 'flat' (По умолчанию) разделяются пробелом
• 'list' метки заключаются в список UL с классом class=’wp-tag-cloud’
• 'array' метки возвращаются в виде архива для использования в PHP.

orderby

(string) Сортировка меток по:

• 'name' (По умолчанию) по имени
• 'count'

order

(string) Сортировка. В верхнем регистре:

• 'ASC' (По умолчанию)
• 'DESC'
• 'RAND' случайным образом.

exclude

(string) Список меток для исключения, разделенные запятой. Например, ‘exclude=5,27′ исключит метки с the term_id 5 или 27.

include

(string) Список меток для добавления, разделенные запятой. Например, ‘include=5,27′ добавит метки с the term_id 5 или 27.

Примеры:

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

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

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

• smallest – Самая маленькая метка выводится размером 8
• largest – Самая большая метка выводится размером 22
• unit – Единица измерения по умолчанию ‘pt’ (пункты)
• number – Выводит 45 меток
• format – Выводит метки в плоском стиле (разделенными пробелами)
• orderby -Сортировка по имени
• order – Сортировка по возрастанию
• exclude – Не исключаются метки
• include – Добавляются все метки

Вывод популярных меток:

<?php if ( function_exists('wp_tag_cloud') ) : ?>
<li>
<h2>Popular Tags</h2>
<ul>
<?php wp_tag_cloud('smallest=8&largest=22'); ?>
</ul>
</li>
<?php endif; ?>

Ограничение до 30 меток и сортировка по числу употреблений:

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

the_tags

Выводит метки(теги) к сообщению. Работает с версии 2.3. Используется в Цикле.

Параметры:

before

(string) Текст до вывода меток. По умолчанию Метки:

separator

(string) Текст которым будет отделяться каждая метка. По умолчанию запятая (,).

after

(string) Текст который будет выводиться после последней метки. По умолчанию нет.

Примеры:

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

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

Разделенные стрелкой:

<?php the_tags('Метки: ',' > '); ?>

В списке:

<?php
the_tags('<ul><li>','</li><li>','</li></ul>');
?>

get_the_tags

Возвращает массив объектов, один объект для каждой метки, назначенной на сообщение. Используется в Цикле.

Поля:

term_id

id метки

name

Имя метки

slug

Короткое имя метки

term_group

Группа метки

taxonomy

Всегда ‘post_tag’ для меток

description

Описание метки

count

Количество использований метки, общее

Примеры:

Эта функция ничего не выводит, она возвращает массив данных для дальнейшего использования.

<?php
$posttags = get_the_tags();
if ($posttags) {
foreach($posttags as $tag) {
echo $tag->name . ' ';
}
}
?>

Выод меток в виде изображений названных как term_id и аттрибут alt установлен в название метки name.

<?php
$posttags = get_the_tags();
if ($posttags) {
foreach($posttags as $tag) {
echo '<img src="http://example.com/images/' . $tag->term_id . '.jpg"
alt="' . $tag->name . '" />';
}
}
?>

get_the_tag_list

Генерирует HTML строку меток связанных с текущим сообщением. Каждая метка будет ссылкой на страницу метки. Используется в Цикле.

Параметры:

before

(string) Текст выводимый перед метками.

separator

(string) Текст разделяющий метки.

after

(string) Текст выводимый после меток.

Примеры:

Эта функция ничего не выводит, она возвращает данные для дальнейшего использования.

Вывод списка меток заключенных в тег <p>, разделенный запятыми.

<?php
echo get_the_tag_list('<p>Метки: ',', ','</p>');
?>

Результат.

<p>
Метки:
<a href="tag1">1 Метка</a>,
<a href="tag2">2 Метка</a>, ...
</p>

single_tag_title

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

Параметры:

prefix

(string) Текст перед именем метки. По умолчанию '' (нет текста).

display

(boolean) Вывести (TRUE) или вернуть (FALSE). По умолчанию TRUE.

Примеры:

Выводит текст “Сейчас вы просматриваете ” + имя метки.

<p><?php single_tag_title('Сейчас вы просматриваете '); ?>.</p>

the_ID

Показывает ID текущего сообщения. Этот тег используется внутри Цикла.

Примеры:

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

<p>Номер сообщения: <?php the_ID(); ?></p>

Устанавливает якорь в виде уникального идентификатора к каждому сообщению:

<h3 id="post-<?php the_ID(); ?>"><?php the_title(); ?></h3>

the_title

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

Параметры:

before

(string) Текст до заголовка. По умолчанию ''.

after

(string) Текст после заголовка. По умолчанию ''.

display

(Boolean) Вывести заголовок (TRUE) или вернуть для дальнейшего использования (FALSE). По умолчаню TRUE.

Пример:

<?php the_title('<h3>', '</h3>'); ?>

the_title_attribute

Выводит или возвращает заголовок текущего сообщения. Повторяет функциональность тега the_title(), за исключением преобразования спецсимволов и использованием строковых параметров. Используется в Цикле.

Параметры:

before

(string) Текст до заголовка. По умолчанию ''.

after

(string) Текст после заголовка. По умолчанию ''.

echo

(Boolean) Выводить заголовок (1) или возвратить (0). По умолчанию 1.

Пример:

<?php the_title_attribute('before=<h3>&after=</h3>'); ?>

single_post_title

Показывает или возвращает заголовок сообщения при выводе одного сообщения. Может использоваться вне Цикла.

Параметры:

prefix

(string) текст до заголовка. По умолчанию ''.

display

(boolean) Выводить (TRUE) или возвратить (FALSE) заголовок. По умолчанию TRUE.

Примеры:

<h2><?php single_post_title('Текущее сообщение: '); ?></h2>

the_title_rss

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

Примеры:

<item>    <title><?php the_title_rss(); ?></title>

the_content

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

Если используется тег <!--more--> то сообщение показывается только до <!--more--> (только на главной странице, на странице сообщения будет показываться полностью).

Заметка:

• Проследите чтобы не было других символов до слова “more” в <!--more-->. При наличии других символов тег <!-- more --> работать не будет!
• <!--more--> не будет работать если отображается только одно сообщение.

Параметры:

more_link_text

(string) Текст ссылки для “more”. По умолчанию '(далее...)'.

strip_teaser

(boolean) Скрыть текст до ссылки “more” (TRUE) или вывести (FALSE). По умолчанию FALSE.

more_file

(string) На какой файл ссылка “more”. По умолчанию на текущий файл. (V2.0: В настоящее время параметр ‘more_file’ не работает).

Примеры:

Изменение текста ссылки <!--more-->.

<?php the_content('Читать далее...'); ?>

Изменение текста ссылки <!--more--> на Читать полностью “Заголовок текущего сообщения”.

<?php the_content("Читать плоностью " . the_title('', '', false)); ?>

the_content_rss

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

Параметры:

more_link_text

(string) Текст ссылки для “more”. По умолчанию '(далее...)'.

strip_teaser

(boolean) Скрыть текст до ссылки “more” (TRUE) или вывести (FALSE). По умолчанию FALSE.

more_file

(string) На какой файл ссылка “more”. По умолчанию на текущий файл.

cut

(integer) Количество слов выводимые до конца сообщения. По умолчанию 0 (Выводить все).

encode_html

(integer) Фильтр html тегов и кодирование спецсимволов (например ‘&’). Параметры:

• 0 – (Default) Парсинг исходящих ссылок для сносок.
• 1 – Фильтр на PHP функцию htmlspecialchars(), но устанавливает параметр cut в 0, не рекомендуется если используется параметр cut.
• 2 – Заменяет спецсимволы вида ‘&’ на эквивалент (&). По умолчанию при использовании параметра cut.

Примеры:

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

<?php the_content_rss(); ?>

the_excerpt

Выводит краткое содержание текущего сообщеняия с [...] на конце, без ссылки “read more”. Если вы не не указали текст краткого содержания сообщения (в поле краткое содержание в редакторе сообщений), используется первые 55 слов сообщения. Также в этом случае HTML теги и рисунки не выводятся. Используется в Цикле.

Примеры:

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

<?php the_excerpt(); ?>

Заменяет the_content() на the_excerpt() на архивных страницах ( is_archive()) или на страницах категорий (is_category()).

<?php if(is_category() || is_archive()) {
the_excerpt();
} else {
the_content();
} ?>

the_excerpt_rss

Выводит краткое содержание текущего сообщеняия в формате RSS.

Примеры:

<description><?php the_excerpt_rss(); ?></description>

previous_post_link

Используется для вывода ссылки на предыдущее сообщение, при просмотре одного сообщения. Используется в Цикле.

Параметры:

format

(string) Форматирование строки для ссылки. Здесь можно указать, что будет до и после ссылки. Строка '%link' будет заменена на ссылку. Например 'Перейти к %link' создаст ссылку типа “Перейти к <a href=… . По умолчанию '« %link.

link

(string) Текст ссылки. По умолчанию заголовок предыдущего сообщения ('%title').

in_same_cat

(boolean) Если TRUE то ссылка будет на сообщения из текущей категории, иначе из всех категорий. Параметры:

• TRUE
• FALSE (По умолчанию)

excluded_categories

(string) Цифровой ID категории(й) которая будет исключаться. Разделяйте несколько категорий с and; например: '1 and 5 and 15'. Нет значения по умолчанию.

Примеры:

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

<?php previous_post_link(); ?>

Текст ссылки выделенный жирным:

<?php previous_post_link('<strong>%link</strong>'); ?>

previous_post

Не используется. Заменена на previous_post_link

next_post_link

Используется для вывода ссылки на следующее сообщение, при просмотре одного сообщения. Используется в Цикле.

Параметры:

format

(string) Форматирование строки для ссылки. Здесь можно указать, что будет до и после ссылки. Строка '%link' будет заменена на ссылку. Например 'Перейти к %link' создаст ссылку типа “Перейти к <a href=… . По умолчанию '%link ».

link

(string) Текст ссылки. По умолчанию заголовок предыдущего сообщения ('%title').

in_same_cat

(boolean) Если TRUE то ссылка будет на сообщения из текущей категории, иначе из всех категорий. Параметры:

• TRUE
• FALSE (По умолчанию)

excluded_categories

(string) Цифровой ID категории(й) которая будет исключаться. Разделяйте несколько категорий с and; например: '1 and 5 and 15'. Нет значения по умолчанию.

Примеры:

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

<?php next_post_link(); ?>

Текст ссылки выделенный жирным:

<?php next_post_link('<strong>%link</strong>'); ?>


next_post

Не используется. Заменена на next_post_link.

posts_nav_link

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

Параметры:

sep

(string) Текст выводимый между ссылками.

• По умолчанию ' :: ' в 1.2.x.
• По умолчанию ' — ' в 1.5.

prelabel

(string) Текст ссылки для предыдущей страницы.

• По умолчанию '<< Предыдущая страница' в 1.2.x.
• По умолчанию '« Предыдущая страница' в 1.5.

nxtlabel

(string) Текст ссылки для следующей страницы.

• По умолчанию 'Следующая страница >>' в 1.2.x.
• По умолчанию 'Следующая страница »' в 1.5

Примеры:

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

<?php posts_nav_link(); ?>

« Предыдущая Страница — Следующая страница »

Измененный текст ссылок:

<p><?php posts_nav_link(' или ', 'Вы можете вернуться на предыдущую страницу',

'Вы можете перейти к следующей странице'); ?>.</p>

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

the_meta

Выводит неупорядоченный список типа “Ключ:Значение” из дополнительных полей. Используется внутри Цикла.

Примеры:

<?php the_meta(); ?>

the_tags

Выводит метки(теги) к сообщению. Работает с версии 2.3. Используется в Цикле.

Параметры:

before

(string) Текст до вывода меток. По умолчанию Метки:

separator

(string) Текст которым будет отделяться каждая метка. По умолчанию запятая (,).

after

(string) Текст который будет выводиться после последней метки. По умолчанию нет.

Примеры:

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

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

Разделенные стрелкой:

<?php the_tags('Метки: ',' > '); ?>

В списке:

<?php
the_tags('<ul><li>','</li><li>','</li></ul>');
?>

wp_count_posts

Возвращает количество записей в таблице wp_posts, принимает параметры wp_type и wp_status.

Параметры:

type

(string) Тип сообщения post_type в таблице wp_posts. По умолчанию post

status

(string) Статус сообщения post_status в таблице wp_posts. По умолчанию publish

Примеры:

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

<?php $published_posts=wp_count_posts(); ?>

Неопубликованные:

<?php $draft_posts=wp_count_posts('post','draft'); ?>

Страницы:

<?php $published_pages=wp_count_posts('page','publish'); ?>

permalink_anchor

Выводит идентификатор якоря постоянной сслыки, или id (<a id=”….) сообщения. Полезно для ссылки на отдельный пост на странице, содержащей несколько сообщений, например, в архивах. Этот тег должен находиться внутри Цикла.

Параметры:

type

(string) Тип якоря. Значения:

• 'id' – Якорь равен числовому ID сообщения. По умолчанию.
• 'title' – Якорь равен краткому имени сообщения(slug).

get_permalink

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

Параметры:

id

(integer) ID сообщения. Когда тег используется в Цикле и параметр id не задан, по умолчанию возвращается постоянная ссылка к текущему сообщению.

Примеры:

Постоянная ссылка к текущему сообщению (использование в Цикле). Так как данный тег не выводит информацию а возвращает, вывод осуществляется PHP командой echo.

Постоянная ссылка на текущее сообщение:<br />

<?php echo get_permalink(); ?>

Возвращается постоянные ссылки двух сообщений (сообщение с ID 1 и 10).

<ul>

<li>Инфо:

    <ul>

    <li><a href="<?php echo get_permalink(1); ?>">О блоге</a></li>

    <li><a href="<?php echo get_permalink(10); ?>">Обо мне</a></li>

    </ul>

</li>

</ul>

the_permalink

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

Примеры:

Вывести URL к сообщению без создания ссылки:

Постоянная ссылка к текущему сообщению: <?php the_permalink(); ?>

Выводит постоянную ссылку, текст ссылки – название сообщения.

<a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>

permalink_single_rss

Выводит постоянную ссылку для текущего сообщения в формате RSS или Atom. Используется в Цикле.

Параметры:

file

(string) Ссылка на сообщение. По умолчанию текущее сообщение.

Пример:

<link><?php permalink_single_rss(); ?></link>

get_links_list

Не поддерживается с версии 2.3, заменена на wp_list_bookmarks.

wp_get_links

Не поддерживается с версии 2.3, заменена на wp_list_bookmarks.

get_links

Не поддерживается с версии 2.3, заменена на wp_list_bookmarks.

wp_list_bookmarks

Выводит ссылки из панели Администрирование -> Ссылки -> Управление ссылками(Blogroll).

Параметры:

categorize

(boolean) Выводить ссылки с оглавлением в виде присвоеной им категории (TRUE) или выводить общим списком (FALSE). По умолчанию TRUE.

• 1 (True – по умолчанию)
• 0 (False)

category

(string) Список ID категорий для вывода, разделенные запятыми. Если не указано то выводятся все категории. По умолчанию (все категории).

category_name

(string) Имя категории чьи ссылки будут выведены. Если не указано то выводятся все категории. По умолчанию (все категории).

category_before

(string) Текст подставляемый до каждой категории. По умолчанию '<li id="[category id]" class="linkcat">' .

category_after

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

class

(string) CSS Класс присваемый для тега li каждой категории. По умолчанию 'linkcat' .

category_orderby

(string) Сортировка категорий. По умолчанию по 'name'. Значения:

• 'name' (По умолчанию)
• 'id'

category_order

(string) Порядок сортировки, по возрастанию, убыванию для параметра category_orderby. Значения:

• ASC (По умолчанию)
• DESC

title_li

(string) Текст для заголовка списка ссылок. По умолчанию '__('Закладки')', который выведет “Закладки” (__('') используется для локализации). Используется только когда параметр categorize = 0 (иначе выводятся названия категорий). Если установить значение 0, оглавление не выводится, также список не обрамляется тегами <ul>, </ul>.

title_before

(string) Текст выводимый до заголовка каждой категории, если ‘categorize’ равно TRUE. По умолчанию '<h2>'.

title_after

(string) Текст выводимый после заголовка каждой категории, если ‘categorize’ равно TRUE. По умолчанию '</h2>'.

show_private

(boolean) Выводить ли категории даже если они приватные. Админские настройки игнорируются и приватные категории выводятся (TRUE) или не выводятся (FALSE). По умолчанию FALSE.

• 1 (True)
• 0 (False – по умолчанию)

include

(string) Разделенный запятыми список ID ссылок для добавления в список. Для примера, ‘include=1,3,6′ выводит только ссылки с ID 1, 3, и 6. Если параметр include используется, то параметры category, category_name, и exclude игнорируются. По умолчанию (все Ссылки).

exclude

(string) Разделенный запятыми список ID ссылок для исключения. Для примера, ‘exclude=4,12′ исключает из списка ссылки с IDs 4 и 12. По умолчанию (ничего не исключается).

orderby

(string) Значение для сортировки ссылок. По умолчанию по 'name'. Значения:

• 'id'
• 'url'
• 'name'
• 'target'
• 'description'
• 'owner' – Пользователь, который добавил закладку через Менеджера закладок.
• 'rating'
• 'updated'
• 'rel' – отношение к ссылке (XFN).
• 'notes'
• 'rss'
• 'length' – Длина названия закладки, от самого короткого к самому длинному.
• 'rand' – Выводить ссылки в случайном порядке.

order

(string) Порядок сортировки: по возрастанию, убыванию для параметра category_orderby. Значения:

• ASC (По умолчанию)
• DESC

limit

(integer) Максимальное количество выводимых ссылок. По умолчанию -1 (все ссылки).

before

(string) Текст размещаемые перед каждой ссылкой. По умолчанию '<li>'.

after

(string) Текст размещаемые после каждой ссылкой. По умолчанию '</li>'.

category_before

(string) Текст размещаемые перед каждой категории. По умолчанию '<li>' с присваиванием соответствующего id и class.

category_after

(string) Текст размещаемые после каждой категории. По умолчанию '</li>'.

between

(string) Текст между каждой ссылкой/картинка и описанием. По умолчанию '\n' (новая строка).

show_images

(boolean) Показывать картинки к ссылкам (TRUE) или нет (FALSE). По умолчанию TRUE.

• 1 (True – По умолчанию)
• 0 (False)

show_description

(boolean) Показывать описание (TRUE) или нет (FALSE). Доступно когда show_images равно FALSE, или картинка не задана. По умолчанию FALSE.

• 1 (True)
• 0 (False – По умолчанию)

show_rating

(boolean) Показывать рейтинг в виде звездочек/символов (TRUE) или нет (FALSE). По умолчанию FALSE.

• 1 (True)
• 0 (False – По умолчанию)

show_updated

(boolean) Показывать время последнего изменения (TRUE) или нет (FALSE). По умолчанию FALSE.

• 1 (True)
• 0 (False – По умолчанию)

hide_invisible

(boolean) Показывать ссылки параметр Visible установлен в No. Использует админские настройки (TRUE) или нет (FALSE). По умолчанию TRUE.

• 1 (True – По умолчанию)
• 0 (False)

echo

(boolean) Выводить (TRUE) или возвратить (FALSE). По умолчанию TRUE.

• 1 (True – По умолчанию)
• 0 (False)

Примеры:

Значения по умолчанию

$defaults = array(
'orderby' => 'name',
'order' => 'ASC',
'limit' => -1,
'category' => '',
'category_name' => '',
'hide_invisible' => 1,
'show_updated' => 0,
'show_description' => 1,
'echo' => 1,
'categorize' => 1,
'title_li' => __('Bookmarks'),
'title_before' => '<h2>',
'title_after' => '</h2>',
'category_orderby' => 'name',
'category_order' => 'ASC',
'class' => 'linkcat',
'category_before' => '<li id="%id" class="%class">',
'category_after' => '</li>'
);

При значениях по умолчанию:

<?php wp_list_bookmarks(); ?>

• Ссылки разделяются по категориям с заголовками категорий
• Все ссылки включены
• Сортировка по названию
• An image if one is included
• Пробел между картинкой и текстом
• Описание ссылок выводится
• Рейтинг не показывается
• Если limit не установлен выводятся все ссылки
• Ссылки выводятся

Вывести все ссылки с заголовком “Закладки” и каждая ссылка заключается в теги <li>. Заголовок заключается в теги h2:

<?php wp_list_bookmarks('title_li=&category_before=&category_after='); ?>

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

<ol>
<?php wp_list_bookmarks('between=<br />&show_images=0&orderby=id&show_rating=1&show_updated=1'); ?>
</ol>

wp_get_linksbyname

Не поддерживается с версии 2.1, заменена на wp_list_bookmarks.

get_linksbyname

Не поддерживается с версии 2.1, заменена на wp_list_bookmarks.

edit_post_link

Выводит ссылку для редактирования текущего сообщения, если пользователь вошел и имеет права для редактирования. Используется в Цикле.

Параметры:

link

(string) Текст ссылки. По умолчанию это 'Edit This'.

before

(string) Текст перед ссылкой. Нет значения по умолчанию.

after

(string) Текст после ссылки. Нет значения по умолчанию.

Примеры:

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

<?php edit_post_link(); ?>

выводит ссылку с текстом “edit” заключенную в теги <p> </p>

<?php edit_post_link('edit', '<p>', '</p>'); ?>

edit_comment_link

Выводит ссылку для редактирования текущего комментария, если пользователь вошел и имеет права для редактирования. Используется в Цикле или в цикле вывода комментариев.

Параметры:

link

(string) Текст ссылки. По умолчанию это 'Edit This'.

before

(string) Текст перед ссылкой. Нет значения по умолчанию.

after

(string) Текст после ссылки. Нет значения по умолчанию.

Примеры:

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

<?php edit_comment_link(); ?>

выводит ссылку с текстом “edit comment” заключенную в теги <p> </p>

<?php edit_comment_link('edit comment', '<p>', '</p>'); ?>

wp_link_pages

Выводит ссылки на странице в многостраничном сообщении(например при использовании <!--nextpage-->). Используется в Цикле.

Параметры:

before

(string) Текст перед всеми ссылками. По умолчанию <p>Pages:.

after

(string) Текст после всех ссылок. По умолчанию </p>.

next_or_number

(string) Указывает использовать ли нумерацию. Значения:

• number (По умолчанию)
• next (С версии WordPress 1.5)

nextpagelink

(string) Текст для ссылки на следующую страницу. По умолчанию Next page. (С версии WordPress 1.5)

previouspagelink

(string) Текст для ссылки на предыдущую страницу. По умолчанию Previous page. (С версии WordPress 1.5)

pagelink

(string) Формат строки для нумерации страниц. % в строке заменяется на номер, например Page % выведет “Page 1″, “Page 2″, и т.д. По умолчанию %.

more_file

(string) Страница, от которой должен вестись отсчет ссылок. По умолчанию текущая.

Примеры:

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

<?php wp_link_pages(); ?>

Ссылки заключены в <p> </p>

<?php wp_link_pages('before=<p>&after=</p>&next_or_number=number&pagelink=page %'); ?>

Ссылки заключены в <div>

<?php wp_link_pages('before=<div id="page-links">&after=</div>'); ?>

link_pages

Запрещено, заменено на wp_link_pages.

get_year_link

Возвращает ссылку на годовой архив, если задать ‘ ‘, возвратит ссылку на текущий год.

Параметры:

year

(integer) Год для архива. Используйте '' для текущего года.

Примеры:

<a href="<?php echo get_year_link(''); ?>">Сообщения текущего года</a>

Сообщения за 2003 год:

<a href="<?php echo get_year_link(2003); ?>">Сообщения текущего года</a>

get_month_link

Возвращает помесячный архив, если задать ‘ ‘, возвратит ссылку на текущий месяц.

Параметры:

year

(integer) Год. Используйте '' для текущего года.

month

(integer) Месяц. Используйте '' для текущего месяца.

Примеры:

Для текущего месяца:

<a href="<?php echo get_month_link('', ''); ?>">Все посты текущего месяца</a>

Для октября 2004 года:

<a href="<?php echo get_month_link(2004, 10); ?>">Сообщения за октябрь 2004 года</a>

get_day_link

Возвращает архив за определенный день, если задать ‘ ‘, возвратит ссылку на текущий день.

Параметры:

year

(integer) Год. Используйте '' для текущего года.

month

(integer) Месяц. Используйте '' для текущего месяца.

day

(integer) День. Используйте '' для текущего дня.

Примеры:

Все сообщения за текущий день:

<a href="<?php echo get_day_link('', '', ''); ?>">Все сообщения за текущий день</a>

Сообщения за 14 октября 2004 года:

<a href="<?php echo get_day_link(2004, 10, 14); ?>">Today's posts</a>

previous_posts_link

Выводит ссылку на следующие сообщения.

Параметры:

label

(integer) Текст для ссылки. По умолчанию « Previous Page.

max_page

(integer) Максимальное количество страниц. По умолчанию 0 (Без ограничений).

Пример:

<?php previous_posts_link('« Следующие сообщения', '0') ?>

next_posts_link

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

Параметры:

label

(integer) Текст для ссылки. По умолчанию Next Page ».

max_page

(integer) Максимальное количество страниц. По умолчанию 0 (Без ограничений).

Пример:

<?php next_posts_link('Предыдущие сообщения »', '0') ?>

wp_list_pages

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

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).

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

$defaults = array('depth'=> 0,'show_date'=> '','date_format' => get_option('date_format'),
'child_of'    => 0,
'exclude'     => '',
'title_li'    => __('Pages'),
'echo'        => 1,
'authors'     => '',
'sort_column' => 'menu_order, post_title');

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

• Все страницы и внутренние страницы(без ограничения по глубине)
• Дата создания не выводится.
• child_of не установлено ни для какой страницы.
• Никакие страницы не исключаются
• Заголовок списка выводится как “Страниц”
• Результат выводится.
• Не ограничивается по автору.
• Сортируется сначала по порядку страниц, затем по заголовку.
• Сортируется по возрастанию.
• Страницы выводятся иерархически.
• Включаются все страницы.
• Не используются дополнительные поля(Ключ, Значение).

wp_list_pages();

Заголовок списка, по умолчанию (“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

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

Параметры:

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. По умолчанию ни что не исключается.

Примеры:

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

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

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

• Страницы и подстраницы выводятся иерархически (с отступом)
• Выводятся все страницы (дочерние страницы не исключаются)
• Ни одна страницы не выбрана в выпадающем списке
• Выпадающему списку присваивается имя ‘page_id’
• Позволяет вам не выбирать ни одну из страниц (show_option_none)

<?php wp_dropdown_pages(); ?>

Выводит иерархический выпадающий список в форме 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)

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

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

Параметры:

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

КАТЕГОРИИ.

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

• cat
• category_name

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

query_posts('cat=4');

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

query_posts('category_name=Staff Home');

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

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

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

query_posts('cat=-3');

МЕТКИ.

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

• tag

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

query_posts('tag=cooking');

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

query_posts('tag=bread,baking');

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

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

АВТОР.

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

• author_name=Harriet
• author=3

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

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

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

• p=1 – используйте ID сообщения для вывода первого сообщения
• name=first-post – используйте “Краткое имя” для вывода первого сообщения
• page_id=7
• pagename=about
• showposts=1 (вы можете так же использовать showposts=3, или любое другое число для задания лимита вывода сообщений

ВРЕМЯ И ДАТА.

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

• hour=
• minute=
• second=
• day= – день месяца; например вывести все сообщения от 15 числа.
• monthnum=
• year=

СТРАНИЦА.

• paged=2 – выводит сообщения которые показывались бы на второй странице после нажатия на ссылку “Предыдущие записи”.
• posts_per_page=10 – число сообщений на страницу; значение -1 выводит все сообщения.
• order=ASC – показывает сообщения в порядке опубликования, DESC выводит в обратном порядке (по умолчанию)

СМЕЩЕНИЕ.

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

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

СОРТИРОВКА.

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

• orderby=author
• orderby=date
• orderby=category
• orderby=title
• orderby=modified
• orderby=modified
• orderby=menu_order
• orderby=parent
• orderby=ID
• orderby=rand

Также “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
// возвращает одно сообщение с ID 5
query_posts('p=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' => );

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

• smallest – Самый маленький тег выводится с размером 8
• largest – Самый большой тег выводится с размером 22
• unit – Единица измерения – ‘pt’ (пункты)
• number – выводятся 45 тегов
• format – Теги выводятся разделенные пустым пространством
• orderby – Отсортированы по имени
• order – Отсортированы по возрастанию
• 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>

bloginfo

Выводит информацию о вашем блоге, из настроек WordPress и вашего профиля. Может использоваться в любом месте шаблона. Тег всегда выводит результат. Если вы хотите возвратить, а не вывести результат используйте get_bloginfo().

Параметры:

show

(string) Информация о вашем блоге. Значения:

• 'name' – Название блога; устанавливается в настройках WordPress. (По умолчанию)
• 'description' – Краткое описание блога; устанавливается в настройках WordPress.
• 'url' – адрес вашего блога.
• 'rdf_url' – URL вашей RDF/RSS 1.0 ленты.
• 'rss_url' – URL вашей RSS 0.92 ленты.
• 'rss2_url' – URL вашей RSS 2.0 ленты.
• 'atom_url' – URL вашей Atom ленты.
• 'comments_rss2_url' – URL вашей RSS 2.0 ленты комментариев.
• 'pingback_url' – URL для Pingback(файл XML-RPC).
• 'admin_email' – email адрес администратора; устанавливается в настройках WordPress.
• 'charset' – Кодировка вашего блога; устанавливается в настройках WordPress.
• 'version' – Версия WordPress на которой работает ваш блог.
• 'text_direction' – Возвращает ‘rtl’ для направления текста справа на лево или ‘ltr’ для направления текста слева на право (По умолчанию).

Работающие только в WordPress версии 1.5 или старше:

• 'html_type' – “Content-type”для вашего блога.
• 'wpurl' – URL для папки куда инсталлирован WordPress.
• 'template_url' – URL для используемого шаблона.
• 'template_directory' – URL для папки с шаблоном.
• 'stylesheet_url' – URL для основного CSS файла. Возвращает: http//example.com/wp-content/themes/ + имя+вашей-текущей-темы(значение из wp_options, поле “stylesheet” ) + “/style.css”
• 'stylesheet_directory' – URL для папки с CSS. (Не поддерживается с версии 2.3.1)

Примеры:

Вывод названия блога:

<h1><?php bloginfo('name'); ?></h1>

Вывод кодировки блога:

<p>Кодировка: <?php bloginfo('charset'); ?> </p>

Вывод описания блога:

<p><?php bloginfo('description'); ?> </p>

bloginfo_rss

Выводит информацию о блоге, идентичен bloginfo(), отличается лишь тем, что на выходе формирует HTML разметку для использования в фид лентах.

show

(string) Информация о вашем блоге. Значения:

• 'name' – Название блога; устанавливается в настройках WordPress. (По умолчанию)
• 'description' – Краткое описание блога; устанавливается в настройках WordPress.
• 'url' – адрес вашего блога.
• 'rdf_url' – URL вашей RDF/RSS 1.0 ленты.
• 'rss_url' – URL вашей RSS 0.92 ленты.
• 'rss2_url' – URL вашей RSS 2.0 ленты.
• 'atom_url' – URL вашей Atom ленты.
• 'comments_rss2_url' – URL вашей RSS 2.0 ленты комментариев.
• 'pingback_url' – URL для Pingback(файл XML-RPC).
• 'admin_email' – email адрес администратора; устанавливается в настройках WordPress.
• 'charset' – Кодировка вашего блога; устанавливается в настройках WordPress.
• 'version' – Версия WordPress на которой работает ваш блог.

Работающие только в WordPress версии 1.5 или старше:

• 'html_type' – “Content-type”для вашего блога.
• 'wpurl' – URL для папки куда инсталлирован WordPress.
• 'template_url' – URL для используемого шаблона.
• 'template_directory' – URL для папки с шаблоном.
• 'stylesheet_url' – URL для основного CSS файла. Возвращает: http//example.com/wp-content/themes/ + имя+вашей-текущей-темы(значение из wp_options, поле “stylesheet” ) + “/style.css”
• 'stylesheet_directory' – URL для папки с CSS.

Пример:

Выводит название блога и его url в тегах title и link rss ленты:

<title><?php bloginfo_rss('name'); ?></title><link><?php bloginfo_rss('url') ?></link>

get_bloginfo

Возвращает информацию о блоге для дальнейшего использования в PHP. Работает так же как и bloginfo(), только в отличие от нег не выводи, а возвращает информацию.

Параметры:

show

(string) Информация о блоге. Значения:

• '' – (По умолчанию) возвращает название блога, установленное в настройках WordPress.
• 'name' – Возвращает то же самое что и '' (которое по умолчанию).
• 'description' – Возвращает краткое описание блога, установленное в настройках WordPress.
• 'url' – Возвращает адрес вашего блога.
• 'home' – Возвращает то же самое что и ‘url’.
• 'siteurl' – Возвращает то же самое что и ‘url’.
• 'wpurl' – адрес куда установлен WordPress.
• 'rdf_url' – URL для ленты RDF/RSS 1.0 которые состоит из url вашего блога с прибавлением строки /feed/rfd.
• 'rss_url' – URL для ленты RSS 0.92 которые состоит из url вашего блога с прибавлением строки /feed/rss.
• 'rss2_url' – URL для ленты RSS 2.0 которые состоит из url вашего блога с прибавлением строки /feed.
• 'atom_url' – URL для ленты Atom которые состоит из url вашего блога с прибавлением строки /feed/atom.
• 'comments_rss2_url' – URL для RSS 2.0 ленты комментариев которые состоит из url вашего блога с прибавлением строки /comments/feed.
• 'pingback_url' – URL для Pingback (файл XML-RPC) которые состоит из url вашего блога с прибавлением строки /xmlrpc.php.
• 'stylesheet_url' – URL для основного CSS файла которые состоит из url вашего блога с прибавлением строки /wp-content/themes плюс имя текущей темы, плюс строка /style.css. Для примера, http://www.sample.com/wordpress/wp-content/themes/default/style.css
• 'stylesheet_directory' – Локальный путь к папке с стилями. Для примера, /home/you/public_html/wordpress/wp-content/themes/default.
• 'template_directory' – Локальный путь к папке с шаблонами. Для примера, /home/you/public_html/wordpress/wp-content/themes/default.
• 'template_url' – То же самое что и ‘template_directory’.
• 'admin_email' – email администратора.
• 'charset' – Кодировка блога.
• 'version' – Версия WordPress.
• 'html_type' – “Content-type” для вышего блога.

Пример:

Использование по умолчанию присваивает переменной $blog_title название вашего блога.

<?php $blog_title = get_bloginfo(); ?>

get_bloginfo_rss

Возвращает информацию о блоге, идентичен get_bloginfo(), формирует HTML разметку для использования в фид лентах. Не выводит информацию, а возвращает ее.

wp_title

Выводит или возвращает заголовок страницы. Можно использовать разделитель, с версии 2.5 можно указать располагать разделитель после или до заголовка. Можно использовать в любом месте шаблона вне Цикла, обычно используется в элементе <title>.

Текст заголовка зависит от типа страницы:

Одно сообщение на странице

заголовок сообщения (или Страницы)

Архив в виде календаря

дата (например, “2006″, “Январь – 2006″)

Категория

название категории

Страница автора

публичное имя автора

Параметры:

sep

(string) Текст который выводится до или после заголовка (разделитель). По умолчанию (если разделитель пуст) выводится символ » (») который располагается перед или после (устанавливается параметром seplocation) заголовка.

echo

(boolean) Выводить заголовок (True) или возвратить (False). Значения:

• 1 (True) – По умолчанию
• 0: (False)

seplocation

(string) начиная с версии 2.5, этот параметр может использоваться для указания где будет выведен разделитель: до(слева) или после(справа) заголовка. Любое значение кроме ‘right’, выведет разделитель до(слева) заголовка. Если указано значение ‘right’ то разделитель будет выведен после(справа) заголовка.

wp_get_archives

Выводит список архива в виде дат, работает также как и get_archives(). Единственное отличие – параметры аргументов выводятся в формате строкового запроса. Этот тег можно использовать в любом месте шаблона.

Параметры:

type

(string) Тип списка архива для вывода. По умолчанию как в настройках WordPress. Значения:

• yearly
• monthly (По умолчанию)
• daily
• weekly
• postbypost

limit

(integer) Количество архивов для вывода. По умолчанию без ограничений.

format

(string) Формат списка архивов. Значения:

• html – В виде HTML списка (<li>). По умолчанию.
• option – В виде выпадающего списка <option> или <select>.
• link – В виде ссылок (<link>).
• custom – Другой список используя строки before и after.

before

(string) Текст для вывода перед ссылкой в формате html или custom. Нет значения по умолчанию.

after

(string) Текст для вывода после ссылки в формате html или custom. Нет значения по умолчанию.

show_post_count

(boolean) Выводить количество сообщений в архиве(1 – true) или нет (0 – false). Для использования со всеми типами кроме 'postbypost'. По умолчанию 0.

Примеры:

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

<?php $defaults = array(type' => 'monthly',limit' => ,format' => 'html',before' => ,after' => ,show_post_count' => false); ?>

По умолчанию выводит:

• Ежемесячный архив
• Выводит все архивы (без ограничений)
• Выводит архивы в HTML списке <li>
• Ничего не отображает до или после каждой ссылки
• Не выводит число сообщений

Выводит последние 12 месяцев:

<?php wp_get_archives('type=monthly&limit=12'); ?>

Последние 15 дней:

<?php wp_get_archives('type=daily&limit=15'); ?>

Последние 20 сообщений:

<?php wp_get_archives('type=postbypost&limit=20&format=custom'); ?>

Выводит выпадающий список помесячно в теге select с выводом числа сообщений:

<select name=\"archive-dropdown\" onChange='document.location.href=this.options[this.selectedIndex].value;'>  <option value=\"\"><?php echo attribute_escape(__('Select Month')); ?></option>
<?php wp_get_archives('type=monthly&format=option&show_post_count=1'); ?> </select>

get_archives

Не поддерживается. Заменено на wp_get_archives(), работает так же, параметры те же.

get_posts

Этот тег используется для цикла вывода сообщений.

Параметры:

$numberposts

(integer) (optional) Количество возвращаемых сообщений.

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

$offset

(integer) (optional) Смещение от последнего сообщения.

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

$category

(integer) (optional) Показывать сообщения только этой категории.

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

$orderby

(string) (optional) Сортирует сообщения в зависимости от значения:

• 'post_title' – Сортировка в алфавитном порядке по заголовку страницы или сообщения.
• 'post_date' – Сортировка по дате создания.
• 'post_modified' – Сортировка по дате последнего изменения.
• 'ID' – Сортировка по ID сообщений.
• 'post_author' – Сортировка по ID авторов.
• 'post_name' – Сортировка в алфавитном порядке по короткому имени сообщения.

Замечание: Значение $orderby может быть именем любого поля в таблице wp_posts table.

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

$order

(string) (optional) Как сортировать по $orderby. Значения:

• 'ASC' – В порядке возрастания (снизу вверх).
• 'DESC' – В порядке убывания (сверху вниз).

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

$include

(string) (optional) ID сообщений которые вы хотите вывести, разделенные запятыми и/или пробелами. Например:

• ’45,63, 78 94 ,128 , 140′

Note: Использование этого параметра отменит действие параметров numberposts, offset, category, exclude, meta_key, meta_value, and post_parent.

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

$exclude

(string) (optional) ID любых сообщений которые вы хотите исключить, разделенных запятыми и/или пробелами (смотри параметр $include).

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

$meta_key и $meta_value

(string) (optional) Выводит сообщения которые содержат в дополнительном поле этот ключ и значение. Оба параметра должны быть указаны, иначе работать не будут.

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

$post_type

(string) (optional) Тип сообщения для вывода. Значения:

• post – По умолчанию(Сообщение)
• page – (Страница)
• attachment – (Прикрепления)
• (blank) – Все типы сообщений

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

$post_status

(string) (optional) Показывает сообщения со статусом. Значения:

• publish – По умолчанию(Опубликовано)
• private – (Личное)
• draft – (Черновик)
• future – (Ожидает утверждения)
• (blank) – Все типы сообщений

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

$post_parent

(integer) (optional) Показывает только потомков сообщения с указанным ID

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

Примеры:

Список сообщений со смещением:

Если вы настроили свой блог для показа одного сообщения на главной странице, то вы можете вывести список ссылок на предыдущие 5 сообщений из категории с ID 1:

 <ul> <?php
global $post;
$myposts = get_posts('numberposts=5&offset=1&category=1');
foreach($myposts as $post) :
?>
<li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li>
<?php endforeach; ?>
</ul>

Доступ ко всем данным сообщения:

Некоторые связанные с сообщениями данные по умолчанию не доступны через get_posts, содержание сообщения the_content(), или через ID. Это решается путем вызова внутренней функции setup_postdata(), с массивом $post в виде его параметра:

 <?php
 $lastposts = get_posts('numberposts=3');
 foreach($lastposts as $post) :
    setup_postdata($post);
 ?>
 <h2><a href="<?php the_permalink(); ?>" id="post-<?php the_ID(); ?>"><?php the_title(); ?></a></h2>
 <?php the_content(); ?>
 <?php endforeach; ?>

Для доступа к ID сообщений или к содержанию без вызова setup_postdata(), или к любым данным относящихся к сообщению(данные хранятся в таблице the posts), вы можете использовать $post->COLUMN, где COLUMN название столбца в таблице. Так $post->ID содержит ID, а $post->post_content содержание, и т.д. Для вывода этих данных используйе команду PHP echo, вот так:

 <?php echo $post->ID; ?>

Последние записи отсортированные по заголовку:

Для вывода последних 10 сообщений с датой, заголовком и кратким содержанием отсортированных в алфавитном порядке по возрастанию, используйте:

 <?php
 $postslist = get_posts('numberposts=10&order=ASC&orderby=post_title');
 foreach ($postslist as $post) :
    setup_postdata($post);
 ?>
 <div>
 <?php the_date(); ?>
 <br />
 <?php the_title(); ?>
 <?php the_excerpt(); ?>
 </div>
 <?php endforeach; ?>

Вывести список из 5 сообщений случайным образом, с использованием функции MySQL RAND():

 <ul><li><h2>A random selection of my writing</h2>
    <ul>
 <?php
 $rand_posts = get_posts('numberposts=5&orderby=RAND()');
 foreach( $rand_posts as $post ) :
 ?>
    <li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li>
 <?php endforeach; ?>
    </ul>
 </li></ul>

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

Напишите это вне любых Циклов вашего шаблона.

<?php

$args = array(
	'post_type' => 'attachment',
	'numberposts' => null,
	'post_status' => null,
	'post_parent' => null, // any parent
	);
$attachments = get_posts($args);
if ($attachments) {
	foreach ($attachments as $post) {
		setup_postdata($post);
		the_title();
		the_attachment_link($post->ID, false);
		the_excerpt();
	}
}

?>

Показать прикрепления к текущему сообщению:

Напишите это внутри Цикла(где $post->ID определен).

<?php

$args = array(
	'post_type' => 'attachment',
	'numberposts' => null,
	'post_status' => null,
	'post_parent' => $post->ID
	);
$attachments = get_posts($args);
if ($attachments) {
	foreach ($attachments as $attachment) {
		echo apply_filters('the_title', $attachment->post_title);
		the_attachment_link($attachment->ID, false);
	}
}

?>

the_date_xml

Выводит дату сообщения в формате YYYY-MM-DD (например: 2004-09-24). Используется внутри Цикла.

Пример:

<p>Дата сообщения: <?php the_date_xml(); ?></p>

the_date

Выводит/возвращает дату сообщения или ряда сообщений если они были опубликованы в тот же день. Для ряда сообщений от одного числа отобразится только первое. Используется внутри Цикла.

Параметры:

format

(string) Формат даты. По умолчанию как в WordPress.

before

(string) Текст перед датой. Нет значения по умолчанию.

after

(string) Текст после даты. Нет значения по умолчанию.

echo

(boolean) Показывать дату (TRUE), или возвратить для дальнейшего использования (FALSE). По умолчанию TRUE.

Примеры:

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

<p>Date posted: <?php the_date(); ?></p>

Формат YYYY-MM-DD заключенный в HTML теги <h2></h2>:

<?php the_date('Y-m-d', '<h2>', '</h2>'); ?>

Не выводить дату, а присвоить переменной для дальнейшей рабы с ней:

<?php $my_date = the_date('', '', '', FALSE); echo $my_date; ?>

the_time

Выводит время текущего поста. Используется в Цикле.

Параметры:

d

(string) Формат времени для отображения. По умолчанию как в опциях WordPress.

Примеры:

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

<p>Time posted: <?php the_time(); ?></p>

Формат AM/PM:

<p>Сообщение написано: <?php the_time('g:i a'); ?></p>

Формат 24H:

<p>Сообщение написано: <?php the_time('G:i'); ?></p>

Вывести месяц, день, год:

<div><?php the_time('F j, Y'); ?></div>

Вывести как дату так и время:

<p>Опубликовано: <?php the_time('F j, Y'); ?> в <?php the_time('g:i a'); ?></p>

the_modified_date

Этот тег выводит дату(и время тоже) последнего изменения сообщения. Работает так же как и the_modified_time().Если формат не задан, то он будет использоваться из настроек WordPress. Используется в Цикле. Если сообщение не редактировалась, то вернет дату создания.

Параметры:

d

(string) Формат даты для отображения. По умолчанию как в опциях WordPress.

Примеры:

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

<p>Последнее изменение: <?php the_modified_date(); ?></p>

Дата в виде месяц, день, год:

<div>Последнее изменение: <?php the_modified_date('F j, Y'); ?></div>

Дата и время:

<p>Изменено: <?php the_modified_date('F j, Y'); ?> в <?php the_modified_date('g:i a'); ?></p>

the_modified_time

Этот тег выводит время(и дату тоже) последнего изменения сообщения. Если формат не задан, то он будет использоваться из настроек WordPress. Используется в Цикле. Если сообщение не редактировалась, то вернет время создания. Если выхотите выводить как время создания так и время изменения вы можете воспользоваться условным опреатором if (например: if (get_the_modified_time() != get_the_time())) для того чтобы не выводить одно и то же время дважды.

Параметры:

d

(string) Формат времени для отображения. По умолчанию как в опциях WordPress.

Примеры:

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

<p>Последнее изменение: <?php the_modified_time(); ?></p>

Формат AM/PM:

<p>Сообщение написано: <?php the_modified_time('g:i a'); ?></p>

Формат 24H:

<p>Сообщение написано: <?php the_modified_time('G:i'); ?></p>

Дата в виде месяц, день, год:

<div>Последнее изменение: <?php the_modified_time('F j, Y'); ?></div>

Дата и время:

<p>Изменено: <?php the_modified_time('F j, Y'); ?> в <?php the_modified_time('g:i a'); ?></p>

get_the_time

Возвращает время опубликования текущего сообщения для дальнейшего использования. Используется в Цикле. Введен с версии WordPress 1,5.

Параметры:

d

(string) Формат времени для отображения. По умолчанию как в опциях WordPress.

Примеры:

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

<?php echo get_the_time(); ?>

Присваивает переменной время в секундах( с 1 января 1970 года известное как Эпоха Unix)

<?php $u_time = get_the_time('U'); ?>

single_month_title

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

Параметры:

prefix

(string) Текст перед названием. Нет значения по умолчанию.

display

(boolean) Показывать названия (TRUE), или вернуть (FALSE). По умолчанию TRUE.

Примеры:

Использование: <?php single_month_title('prefix', display) ?>

Месяц и год на новых строках:

<p><?php single_month_title('<br />') ?></p>

Возвращение в переменную:

<?php $my_month = single_month_title('', false); echo $my_month; ?>

get_calendar

Выводит календарь(По умолчанию текущий месяц/год). Дни с сообщениями выделяются. Можно использовать в любом месте шаблона.

Параметры:

initial

(boolean) Если true, то день будет выводится одной буквой; если false, то день будет выводится в зависимости от вашей локализацией. Например:

• false выведет “Воскресенье” как “Вс”
• true (по умолчанию) выведет как “В”

Пример:

<?php get_calendar(true); ?>

the_weekday

Не поддерживается. Выводит название дня недели. Заменена на the_time()

Пример:

Так как тег больше не поддерживается, используйте тег the_time() с параметром “l”(Маленькая буква “L”)

<?php the_time('l'); ?>

the_weekday_date

Не поддерживается. Выводит название дня недели текущего сообщения только если он отличается от дня недели предыдущего сообщения. Используется в Цикле.
Пример:

Так как тег больше не поддерживается используйте связку the_date и the_time:

<?php if(the_date('','','', FALSE)) the_time('l'); ?>

comments_number

Выводит общее число комментариев, трекбэков и пингбэков. Используется в Цикле.

Параметры:

zero

(string) Текст который показывается когда нет комментариев. По умолчанию 'No Comments'.

one

(string) Текст который показывается когда 1 комментарий. По умолчанию '1 Comment'.

more

(string) Текст который показывается когда комментариев больше одного. Символ % заменяется числом комментариев, например 'Комментариев: % пока' показывается как “Комментариев: 5 пока” если комментариев пять. По умолчанию '% Comments'.

number

(integer) Количество комментариев. По умолчанию равно общему количеству комментариев, трекбэков, пингбэков.

Пример:
Показывает текст основанный на количестве комментариев: кол-во комментариев ноль – нет отзывов; кол-во комментариев один – один отзыв; больше одного комментария(общее кол-во 42) покажет 42 отзыва.

<p>На это сообщение<?php comments_number('нет отзывов','один отзыв','% отзывов'); ?>.</p>

comments_link

Выводит ссылку на комментарии к сообщению. Используется в Цикле.

Пример:

<a href="<?php comments_link(); ?>"> Оставь отзыв!</a>

comments_rss_link

Выводит ссылку на rss ленту комментариев.

Параметры:

‘text’

(string) Текст ссылки для RSS ленты комментариев. По умолчанию 'RSS Комментариев'.

‘file’

(string) Ссылка на файл. По умолчанию 'wp-commentsrss2.php'.

comments_popup_script

Выводит JavaScript код для комментариев во всплывающем окне. Используется совместно с comments_popup_link(), этот тег может использоваться в любом месте шаблона, обычно размещается внутри <head>.

Параметры:

width

(integer) Ширина всплывающего окна. По умолчанию 400 (пикселей).

height

(integer) Высота всплывающего окна. По умолчанию 400 (пикселей).

Пример:

Устанавливает ширину всплывающего окна равную 400 пикселям, и высоту 500 пикселям.

<?php comments_popup_script(400, 500); ?>

comments_popup_link

Выводит ссылку для комментариев во всплывающем окне если comments_ popup_script() используется, иначе выводит обычную ссылку на комментарии. Используется в Цикле или в цикле комментариев.

Параметры:

zero

(string) Текст который показывается когда нет комментариев. По умолчанию 'No Comments'.

one

(string) Текст который показывается когда 1 комментарий. По умолчанию '1 Comment'.

more

(string) Текст который показывается когда комментариев больше одного. Символ % заменяется числом комментариев, например 'Комментариев: % пока' показывается как “Комментариев: 5 пока” если комментариев пять. По умолчанию '% Comments'.

CSSclass

(string) CSS (stylesheet) класс для ссылки. Нет значения по умолчанию.

none

(string) Текст который показывается если комментарии отключены. По умолчанию 'Comments Off'.

Примеры:

Выводит ссылку на всплывающее окно комментариев, используя “Нет комментариев” если их нет, “Пока 1 комментарий” если один, “Пока % комментариев” если больше одного, и “Комментарии к этому сообщению отключены” если отключено комментирование. Так же, 'comments-link' это CSS класс для ссылки.

<p><?php comments_popup_link('Нет комментариев', 'Пока 1 комментарий','Пока % комментариев', 'comments-link', 'Комментарии к этому сообщению отключены'); ?></p>

Скрывает элемент <p></p> если комментарии к этому сообщению отключены.

<?php if ( comments_open() ) : ?><p><?php comments_popup_link('Нет комментариев', 'Пока 1 комментарий',

'Пока % комментариев', 'comments-link', 'Комментарии к этому сообщению отключены'); ?>

</p>

<?php endif; ?>

comment_ID

Выводит ID комментария. Используется внутри Цикла или цикла комментариев.

Пример:

<p>This is comment <?php comment_ID(); ?> for all comments.</p>

comment_author

Выводит имя автора комментария. Используется внутри Цикла или цикла комментариев.

Пример:

<div>Комментарий от <?php comment_author(); ?>:</div>

comment_author_IP

Выводит IP адрес автора комментария. Используется внутри Цикла или цикла комментариев.

Пример:

<p>Комментарий от: <?php comment_author(); ?>; IP адрес: <?php comment_author_IP(); ?></p>

comment_author_email

Выводит email автора комментария, без ссылки. Используется внутри Цикла или цикла комментариев.

Пример:

<a href="mailto:<?php comment_author_email(); ?>">свяжитесь с<?php comment_author(); ?></a>

comment_author_email_link

Выводит email автора комментария, с ссылкой. Используется внутри Цикла или цикла комментариев.

Параметры:

linktext

(string) Текст для ссылки на email. По умолчанию сам email адрес.

before

(string) Текст перед ссылкой. Нет значения по умолчанию.

after

(string) Текст после ссылки. Нет значения по умолчанию.

Пример:

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

email: <?php comment_author_email_link(); ?><br />

Выводит email автора комментария в виде текста Чиркни пару строк автору комментария и добавляет стрелки до и после ссылки.

<?php comment_author_email_link('Чиркни пару строк автору комментария', ' > ', ' < '); ?>

Выглядит так:
> Чиркни пару строк автору комментария <

comment_author_url

Выводит url автора комментария, без ссылки. Используется внутри Цикла или цикла комментариев.

Пример:

Выводит url автора комментария.

<a href="<?php comment_author_url(); ?>">Глянь на сайт<?php comment_author(); ?></a>

comment_author_url_link

Выводит url автора комментария с ссылкой. Используется внутри Цикла или цикла комментариев.

Параметры:

linktext

(string) Текст для ссылки. По умолчанию сам url.

before

(string) Текст перед ссылкой. Нет значения по умолчанию.

after

(string) Текст после ссылки. Нет значения по умолчанию.

Пример:

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

сайт: <?php comment_author_url_link(); ?><br />

Выводит url автора комментария.

<?php comment_author_url_link('Посети сайт автора комментария', ' • ', ' • '); ?>

comment_author_link

Выводит имя автора комментария с ссылкой на его url, если он указан. Используется внутри Цикла или цикла комментариев.

Пример:

<p>Комментарий от: <?php comment_author_link(); ?></p>

comment_type

Выводит тип комментария: комментарий, трекбэк или пингбэк. Используется внутри Цикла или цикла комментариев.

Параметры:

comment

(string) Текст для комментария. По умолчанию 'Comment'.

trackback

(string) Текст для трекбэка. По умолчанию 'Trackback'.

pingback

(string) Текст для пингбэка. По умолчанию 'Pingback'.

Пример:

<p><?php comment_type(); ?> к сообщению <?php the_title(); ?>: </p>

comment_text

Выводит текст комментария. Используется внутри Цикла или цикла комментариев.

Пример:

Выводит текст комментария и имя автора в элементе списка(<li>).

<li>Комментарий от <?php comment_author(); ?>:<br />
<?php comment_text(); ?></li>

comment_excerpt

Выводит кусок(максимум 20 слов) из текста комментария. Работает в пределах цикла комментариев.

Пример:

<p>Последний комментарий: <?php comment_excerpt(); ?></p>

comment_date

Выводит дату написания комментария. Используется внутри Цикла или цикла комментариев.

Параметры:

d

(string) Форматирование даты. По умолчанию как установлено в WordPress.

Пример:

Выводит дату в формате “6-30-2004″:

Комментарий написан <?php comment_date('n-j-Y'); ?>

comment_time

Выводит время написания комментария. Используется внутри Цикла или цикла комментариев.

Параметры:

d

(string) Форматирование времени. По умолчанию как установлено в WordPress.

Пример:
Выводит время в формате “22:04:11″:

Комментарий написан в <?php comment_time('H:i:s'); ?>

comment_author_rss

Выводит имя автора комментария в формате RSS. Обычно используется в RSS ленте комментариев. Используется внутри Цикла или цикла комментариев.

Пример:

<title>Комментарий от: <?php comment_author_rss() ?></title>

comment_text_rss

Выводит текст комментария в формате RSS. Обычно используется в RSS ленте комментариев. Используется внутри Цикла или цикла комментариев.

Пример:

<description><?php comment_text_rss() ?></description>

comment_link_rss

Выводит url к комментариям в формате RSS. Обычно используется в RSS ленте комментариев. Используется внутри Цикла или цикла комментариев.

Пример:

<link><?php comment_link_rss() ?></link>

permalink_comments_rss

Выводит постоянную ссылку для сообщения к которому относится комментарий в формате RSS. Обычно используется в RSS ленте комментариев. Используется внутри Цикла или цикла комментариев.

Пример:

<link><?php permalink_comments_rss(); ?></link>