Теги шаблонов WordPress
Полезная информация для тех, кто использует WordPress в качестве рабочей платформы для своих проектов.
Теги шаблонов – это встроенный набор пользовательских функций для отображения информации, динамически генерируемой WordPress.
Ниже расположен список этих тегов, разбитый по категориям.
-
Категории тегов шаблонов
- Авторские теги »
- Теги категорий »
- Теги комментариев »
- comment_ID
- comments_link
- comments_popup_script
- comments_popup_link
- comments_number
- comment_author
- comment_author_email
- comment_author_url
- comment_author_email_link
- comment_author_url_link
- comment_author_IP
- comment_author_link
- comment_type
- comment_text
- comment_excerpt
- comment_date
- comment_time
- comments_rss_link
- comment_author_rss
- comment_text_rss
- comment_link_rss
- permalink_comments_rss
- Теги даты и времени »
- the_date
- the_date_xml
- the_time
- get_the_time
- single_month_title
- the_weekday (Deprecated)
- the_weekday_date (Deprecated)
- Общие теги »
- Теги ссылок »
- Теги управления ссылками »
- Теги постоянных ссылок »
- Теги сообщений »
- Теги трекбэк »
Для более подробной информации по тегам и шаблонам WordPress смотрите Кодекс: http://codex.wordpress.org/Templates
Авторские теги
Теги категорий
- the_category
<?php the_category(’separator’, ‘parents’ ); ?>
Отображает ссылку на категорию или категории, к которым принадлежит сообщение. Тег должен использоваться внутри Цикла.Параметры
- separator
- (строка) Текст или символ для отображения между двумя категориями. По умолчанию располагает ссылки в ненумерованном списке. .
- parents
- (строка) Как отображать ссылки в дочерних (под) категориях. Опции:
- ‘multiple’ – показывает раздельные ссылки к родительским и дочерним категориям, отображая, отношения “родитель/потомок”.
- ’single’ – показывает ссылку только на дочернюю категорию, а текст ссылки отображает отношения “родитель/потомок”.
- Примечание: По умолчанию показывается ссылка на дочернюю категорию, без отображения отношений “родитель/потомок”.
- the_category_ID (не рекомендовано)
<?php the_category_ID(echo); ?>
Отображает или возвращается числовой ID категории, к которой принадлежит сообщение. Тег должен использоваться внутри Цикла.Параметры
- echo
- (булево) Отображает ID категории (TRUE) или возвращает значение для использования в PHP (FALSE). По умолчанию – TRUE.
- the_category_head (не рекомендовано)
<?php the_category_head(’before’, ‘after’); ?>
Отображает название категории, если оно отлично от предыдущей категории. Должен использоваться внутри Цикла.Параметры
- before
- (строка) Текст для вывода перед категорией. По умолчанию – ‘’ (пусто).
- after
- (строка) Текст для вывода после категории. По умолчанию – ‘’ (пусто).
- single_cat_title
<?php single_cat_title(’prefix’, ‘display’); ?>
Отображает или возвращает название категории для текущей страницы.Параметры
- prefix
- (строка) Текст для вывода перед названием категории. По умолчанию – ‘’ (пусто).
- display
- (булево) Отображает ID категории (TRUE) или возвращает значение для использования в PHP (FALSE). По умолчанию – TRUE.
- category_description
<?php category_description(category); ?>
Возвращает описание категории.Параметры
- category
- (целое) Числовой ID категории, к которой относится описание. По умолчанию – текущая категория, если установлено ее значение.
- list_cats
<?php list_cats(optionall, ‘all’, ’sort_column’, ’sort_order’, ‘file’, list, optiondates, optioncount, hide_empty, use_desc_for_title, children, child_of, ‘categories’, recurse, ‘feed’, ‘feed_img’, ‘exclude’, hierarchical); ?>
Отображает список категорией в виде ссылок. Работает аналогично тегу wp_list_cats, но использует аргументы в стиле фукций PHP.Параметры
- optionall
- (булево) Устанавливает, нужна ли опция для отображения всех категорий. Возможные значения:
- TRUE (по умолчанию)
- FALSE
- all
- (строка) Текст для опции отображения всех категорий. По умолчанию – ‘All’.
- sort_column
- (строка) Способ сортировки категорий. Возможные значения:
- ‘ID’ (по умолчанию)
- ‘name’
- sort_order
- (строка) Порядок сортировки. Возможные значения:
- ‘asc’ (по умолчанию)
- ‘desc’
- file
- (строка) Файл, в котором должна отображаться ссылка на категорию. По умолчанию – ‘index.php’.
- list
- (булево) Устанавливает, заключен ли перечень категорий в ненумерованный список (<ul><li>). Возможные значения:
- TRUE (по умолчанию)
- FALSE
- optiondates
- (булево) Устанавливает, показывать ли дату последнего сообщения в каждой категории. Возможные значения:
- TRUE
- FALSE (по умолчанию)
- optioncount
- (булево) Устанавливает, показывать ли число сообщений в каждой категории. Возможные значения:
- TRUE
- FALSE (по умолчанию)
- hide_empty
- (булево) Устанавливает, показывать ли категории, в которых нет сообщений. Возможные значения:
- TRUE (по умолчанию)
- FALSE
- use_desc_for_title
- (булево) Устанавливает, показывать ли описание категории как заголовок к ссылке (т.e. <a title=”Описание категории” href=”…). Возможные значения:
- TRUE (по умолчанию)
- FALSE
- children
- (булево) Устанавливает, показывать ли дочерние (под-) категории. Возможные значения:
- TRUE
- FALSE (по умолчанию)
- child_of
- (целое) Отображает только категории, которые являются потомком к данной (номер ID). Умолчаний нет.
- categories
- (целое) Этот параметр должен быть установлен как 0 (ноль) при вызове тега. (Как ни странно, другие
значение используются тегом только внутри системы при генерации иерархического списка.) - recurse
- (булево) Отображает список (FALSE) или возвращает значение для использования в PHP (TRUE). По умолчанию – FALSE.
- feed
- (строка) Текст для ссылки на ленту RSS категории. По умолчанию не показывается ни текста ни ленты.
- feed_img
- (строка) Путь/файл на картинку для отображения в виде ссылки на ленту RSS для каждой категории. Переписывает параметр feed.
- exclude
- (строка) Устанавливает категории для исключения из списка. Должно указываться в виде массива (пример: ‘1, 2, 3′).
- hierarchical
- (булево) Устанавливает, показывать ли подкатегории в иерархическом порядке. Возможные значения:
- TRUE (по умолчанию)
- FALSE
- wp_list_cats
<?php wp_list_cats(’arguments’); ?>
Отображает список категорий в виде ссылок. Работает аналогично тегу list_cats(), отличие в том, что аргументы передаются в формате строчного запроса.Параметры
- optionall
- (булево) Устанавливает, нужна ли опция для отображения всех категорий. Возможные значения:
- 1 (True)
- 0 (False – default)
- all
- (строка) Текст для опции отображения всех категорий. По умолчанию – All.
- sort_column
- (строка) Способ сортировки категорий. Возможные значения:
- ID (по умолчанию)
- name
- sort_order
- (строка) Порядок сортировки. Возможные значения:
- asc (по умолчанию)
- desc
- file
- (строка) Файл, в котором должна отображаться ссылка на категорию. По умолчанию – index.php.
- list
- (булево) Устанавливает, заключен ли перечень категорий в ненумерованный список (<ul><li>). Возможные значения:
- 1 (True – по умолчанию)
- 0 (False)
- optiondates
- (булево) Устанавливает, показывать ли дату последнего сообщения в каждой категории. Возможные значения:
- 1 (True)
- 0 (False – по умолчанию)
- optioncount
- (булево) Устанавливает, показывать ли число сообщений в каждой категории. Возможные значения:
- 1 (True)
- 0 (False – по умолчанию)
- hide_empty
- (булево) Устанавливает, показывать ли категории, в которых нет сообщений. Возможные значения:
- 1 (True – по умолчанию)
- 0 (False)
- use_desc_for_title
- (булево) Устанавливает, показывать ли описание категории как заголовок к ссылке (т.e. <a title=”Описание категории” href=”…). Возможные значения:
- 1 (True – по умолчанию)
- 0 (False)
- children
- (булево) Устанавливает, показывать ли дочерние (под-) категории. Возможные значения:
- 1 (True – по умолчанию)
- 0 (False)
- child_of
- (целое) Отображает только категории, которые являются потомком к данной (номер ID). Без умолчаний.
- feed
- (строка) Текст для ссылки на ленту RSS категории. По умолчанию не показывается ни текста ни ленты.
- feed_img
- (строка) Путь/файл на картинку для отображения в виде ссылки на ленту RSS для каждой категории. Переписывает параметр feed.
- exclude
- (строка) Устанавливает категории для исключения из списка. Должно указываться в виде массива (пример: ‘1, 2, 3′).
- hierarchical
- (булево) Устанавливает, показывать ли подкатегории в иерархическом порядке. Возможные значения:
- 1 (True – по умолчанию)
- 0(False)
- dropdown_cats
<?php dropdown_cats(optionall, ‘all’, ’sort_column’, ’sort_order’, optiondates, optioncount, hide_empty, optionnone, selected, hide); ?>
Отображает список категорий в виде выпадающего списка.Параметры
- optionall
- (булево) Устанавливает, нужна ли опция для отображения всех категорий. Возможные значения:
- TRUE (по умолчанию)
- FALSE
- all
- (строка) Текст для опции отображения всех категорий. По умолчанию – ‘All’.
- sort_column
- (строка) Способ сортировки категорий. Возможные значения:
- ‘ID’ (по умолчанию)
- ‘name’
- sort_order
- (строка) Порядок сортировки. Возможные значения:
- ‘asc’ (по умолчанию)
- ‘desc’
- optiondates
- (булево) Устанавливает, показывать ли дату последнего сообщения в каждой категории. Возможные значения:
- TRUE
- FALSE (по умолчанию)
- optioncount
- (булево) Устанавливает, показывать ли число сообщений в каждой категории. Возможные значения:
- TRUE
- FALSE (по умолчанию)
- hide_empty
- (булево) Устанавливает, показывать ли категории, в которых нет сообщений. Возможные значения:
- TRUE (по умолчанию)
- FALSE
- optionnone
- (булево) Устанавливает, нужна ли опция для показа ни одной из категорий. Возможные значения:
- TRUE
- FALSE (по умолчанию)
- selected
- (целое) Устанавливает выбор категории по умолчанию по ID категории. По умолчанию – текущая категория.
- hide
- (целое) Не выводит категорию (по номеру ID). Умолчаний нет.
- get_category_parents
<?php echo(get_category_parents(category, display link, separator)); ?>
Возвращает список родительских категорий, включающих выбранную, отсортированных по ID.Параметры
- category
- (целое) Числовой ID категории, для которое возвращаются родительские. По умолчанию – текущая, если таковая определена.
- the_category_rss
<?php the_category_rss(’type’) ?>
Отображает название категории или категорий, к которой принадлежит сообщение, в формате RSS. Тег должен использоваться внутри Цикла.Параметры
- type
- (строка) Тип ленты для отображения. Возможные значения:
- ‘rss’ (по умолчанию)
- ‘rdf’
Теги комментариев
- comment_ID
<?php comment_ID(); ?>
Отображает числовой ID комментария. Этот тег должен находиться внутри Цикла. - comments_link
<?php comments_link(’file’, display); ?>
Отображает или возвращает URL к комментариям данного сообщения. Этот тег должен находиться внутри Цикла, или цикл должен быть задан для комментариев.Параметры
- file
- (строка) Страница, которую нужно указать в URL. По умолчанию – текущая.
- display
- (булево) Показывает URL (TRUE), или возвращает значение для использования в PHP (FALSE). По умолчанию – TRUE.
- comments_popup_script
<?php comments_popup_script(width, height); ?>
Выводит код JavaScript для комментариев во всплывающем окне. Используется вместе с comments_popup_link(), может использоваться в любом месте шаблона, но обычно прописывается в <шапке>.Параметры
- width
- (целое) Ширина всплывающего окна. По умолчанию – 400 (пикселов).
- height
- (целое) Высота всплывающего окна. По умолчанию – 400 (пикселов).
- comments_popup_link
<?php comments_popup_link(’zero’, ‘one’, ‘more’, ‘CSSclass’, ‘none’); ?>
Отображает ссылку на всплывающего окна комментариев, если используется comments_popup_script(), в противном случае отображает обычную ссылку к комментариям. Этот тег должен находиться внутри Цикла, или в цикле комментариев.Параметры
- zero
- (строка) Текст при отсутствии комментариев. По умолчанию – ‘No Comments’.
- one
- (строка) Текст при наличии 1 комментария. По умолчанию – ‘1 Comment’.
- more</dt>
- (строка) Текст при наличии более чем одного комментария. ‘%’ заменяется числом комментариев, так что ‘Камментов пока %’ отображается как “Камментов пока 5″. По умолчанию – ‘% Comments’.
- CSSclass
- (строка) класс CSS (таблицы стилей) для ссылки. Значения по умолчанию нет.
- none
- (строка) Текст при отключенных комментариях. По умолчанию – ‘Comments Off’.
- comments_number
<?php comments_number(’zero’, ‘one’, ‘more’, ‘number’); ?>
Отображает общее число комментариев, Трекбэков, и PingbacksПингов к сообщению. Этот тег должен находиться внутри Цикла.Параметры
- zero
- (строка) Текст при отстутствии комментариев. По умолчанию – ‘No Comments’.
- one
- (строка) Текст при наличии 1 комментария. По умолчанию – ‘1 Comment’.
- more
- (строка) Текст при наличии более чем одного комментария. ‘%’ заменяется числом комментариев, так что ‘Камментов пока %’ отображается как “Камментов пока 5″. По умолчанию – ‘% Comments’.
- number
- (целое) Число комментариев. По умолчанию – общее количество комментариев, пингов и трекбэков.
- comment_type
<?php comment_type(’comment’, ‘trackback’, ‘pingback’); ?>
Отображает тип комментария (обычнй комментарий, Трекбэк или Пинг). Этот тег должен находиться внутри Цикла, или в цикле комментария.Параметры
- comment
- (строка) Текст для описания обычного комментария. По умолчанию – ‘Comment’.
- trackback
- (строка’Trackback’.
- pingback
- (строка) Текст для описания комментария вида Пингбэк. По умолчанию – ‘Pingback’.
- comment_text
<?php comment_text(); ?>
Выводит текст комментария. Этот тег должен находиться внутри Цикла, или цикла комментария. - comment_excerpt
<?php comment_excerpt(); ?>
Отображает выдержку (максимум 20 слов) из текста комментария. Этот тег должен находиться внутри Цикла, или в цикле комментария. - comment_date
<?php comment_date(’format’); ?>
Отображает дату размещения комментария. Этот тег должен находиться внутри Цикла, или цикла комментария.Параметры
- format
- (строка) Форматирование даты. По умолчанию – формат даты в настройках WordPress. Смотри также Форматирование даты и времени.
- comment_time
<?php comment_time(’format’); ?>
Отображает время отправки комментария. Этот тег должен находиться внутри Цикла, или цикла комментария.Параметры
- format
- (строка) Форматирование времени. По умолчанию – формат времени в настройках WordPress. Смотри также Форматирование даты и времени.
- comments_rss_link
<?php comments_rss_link(’text’, ‘file’); ?>
Отображает ссылку на ленту RSS комментариев к данному сообщению. Этот тег должен находиться внутри Цикла, или цикла комментариев.Параметры
- ‘text’
- (строка) Текст ссылки к ленте RSS. По умолчанию – ‘Comments RSS’.
- ‘file’
- (строка) Файл, к которому ведет ссылка. По умолчанию – ‘wp-commentsrss2.php’.
- comment_text_rss
<?php comment_text_rss(); ?>
Отображает текст комментария в виде ленты RSS. Обычно используется в шаблоне для ленты RSS комментариев. Этот тег должен находиться внутри Цикла, или в цикле комментариев. - comment_link_rss
<?php comment_link_rss(); ?>
Отображает URL к комментариям сообщения в виде RSS. Обычно используется в шаблоне для ленты RSS комментариев. Этот тег должен находиться внутри Цикла, или в цикле комментариев. - permalink_comments_rss
<?php permalink_comments_rss(); ?>
Отображает постоянную ссылку сообщения, к которому принадлежит комментарий,
в виде RSS. Обычно используется в шаблоне для ленты RSS комментариев. Этот тег должен находиться внутри Цикла, или в цикле комментариев.
Теги даты и времени
- the_date
<?php the_date(’format’, ‘before’, ‘after’, echo); ?>
Отображает или возвращает дату сообщения. Для двух и более отображаемых сообщений от одного числа, тег отображает дату только при первом вызове. Тег должен использоваться внутри Цикла.Параметры
- format
- (строка) Формат даты. По умолчанию – настраивается в соответствии с настройками WordPress. Смотрите Formatting Date and Time.
- before
- (строка) Текст для размещения перед датой. Без умолчаний.
- after
- (строка) Текст для размещения после даты. Без умолчаний.
- echo
- (булево) Отображает дату (TRUE), или возвращает дату для использования в PHP (FALSE). По умолчанию – TRUE.
- the_date_xml
<?php the_date_xml(); ?>
Отображает дату сообщения в формате YYYY-MM-DD (т.е.: 2006-01-21). Тег должен использоваться внутри Цикла. - the_time
<?php the_time(’format’); ?>
Отображает время текущего сообщения. Тег должен использоваться внутри Цикла.Параметры
- format
- (строка) Формат для отображения времени. По умолчанию – согласно настройкам WordPress. Смотрите Formatting Date and Time.
- get_the_time
<?php get_the_time(’format’); ?>
Возвращает время текущего сообщения для использования в PHP. Не отображает время. Тег должен использоваться внутри Цикла.Параметры
- format
- (строка) Формат отображения времени. По умолчанию – согласно настройкам WordPress. Смотрите Formatting Date and Time.
- single_month_title
<?php single_month_title(’prefix’, display) ?>
Отображает или возвращает название месяца и года для текущей страницы. Тег работает только при получении аргумента месяца внутреннего архива при обработке WordPress текущей страницы (это происходит пр просмотре помесячного архива).Параметры
- prefix
- (строка) Текст для вывода перед названием. Без умолчаний.
- display
- (булево) Отображает название (TRUE), или возвращает название для использования в PHP (FALSE). По умолчанию – TRUE.
- the_weekday (не рекомендовано)
<?php the_weekday() ?>
Отображает день недели (например, Понедельник). Тег должен использоваться внутри Цикла. - the_weekday_date (не рекомендовано)
<?php the_weekday_date(’before’, ‘after’) ?>
Отображает день недели для текущего сообщения (например, Понедельник), только если он отличается от дня недели предыдущего сообщения. Тег должен использоваться внутри Цикла.Параметры
- before
- (строка) Текст для вывода перед тегом. Без умолчаний.
- after
- (строка;;) Текст для вывода после тега. Без умолчаний.
Общие теги
- bloginfo
<?php bloginfo(’show’); ?>
Отображает информацию о вашем блоге. Может использоваться в любом месте шаблона.Параметры
- show
- (строка) Детальная информация о блоге. Возможные значения:
- ‘name’ – название блога, устанавливается в общих настройках. (по умолчанию)
- ‘description’ – описание блога, в общих настройках.
- ‘url’ – URL вашего сайта.
- ‘rdf_url’ – URL для ленты RDF/RSS 1.
- ‘rss_url’ – URL для ленты RSS 0.92.
- ‘rss2_url’ – URL для ленты RSS 2.0.
- ‘atom_url’ – URL для ленты Atom.
- ‘comments_rss2_url’ – URL для ленты комментариев RSS 2.0 feed.
- ‘pingback_url’ – URL для Pingback (XML-RPC file).
- ‘admin_email’ – Адрес администратора, в общих настройках.
- ‘charset’ – Кодировка блога, в настройках для чтения.
- ‘version’ – Версия WordPress.
- ‘wpurl’ – URL для папки, в которой находится WordPress.
- ‘template_url’ – URL для используемого шаблона.
- ‘template_directory’ – URL для директории шаблонов.
- ’stylesheet_url’ – URL для первичного файла CSS.
- ’stylesheet_directory’ – URL для папки стилей.
- bloginfo_rss
<?php bloginfo_rss(’show’); ?>
Отображает информацию о блоге. Идентичен bloginfo за исключением того, что форматирует разметку HTML на выходе для использования в лентах.Параметры
- show
- (строка) Детальная информация о блоге. Возможные значения:
- ‘name’ – Название блога, в общих настройках. (по умолчанию)
- ‘description’ – Описание блога, в общих настройках.
- ‘url’ – URL адреса сайта.
- ‘rdf_url’ – URL для ленты RDF/RSS 1.
- ‘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 file).
- ‘admin_email’ – Адрес администратора, в общих настройках.
- ‘charset’ – Кодировка блога, в настройках для чтения.
- ‘version’ – Версия WordPress.
- ‘wpurl’ – для папки, в которой находится WordPress.
- ‘template_url’ – URL для используемого шаблона.
- ‘template_directory’ – URL для директории шаблонов.
- ’stylesheet_url’ – URL для первичного файла CSS.
- ’stylesheet_directory’ – URL для директории стилей.
- wp_title
<?php wp_title(’sep’, display); ?>
Отображает или возвращает заголовок страницы. Тег можно размещать в любом месте шаблона, но обычно используется в теге <title> в шапке страницы. Заголовок страницы всегда включает в себя название блога. При просмотре сообщения, включается его заголовок; при просмотре архива, включается месяц и год; при просмотре рубрики включается ее название.Параметры
- sep
- (строка) Текст для вывода между частями заголовка (разделитель), например название блога и рубрики. По умолчанию – ‘»’ (»).
- display
- (булево) Отображает заголовок страницы (TRUE), или возвращает значение для использования в (FALSE). По умолчанию – TRUE.
- get_archives
<?php get_archives(’type’, ‘limit’, ‘format’, ‘before’, ‘after’, show_post_count); ?>
Отображает список ссылок на архивы. Аналогичен тегу wp_get_archives(), различие состоит в том, что параметры аргумента даются в формате функций PHP. Этот тег можно использовать в любом месте шаблона.Параметры
- type
- (строка) Тип архива для вывода. Возможные значения:
- ‘monthly’ (по умолчанию)
- ‘daily’
- ‘weekly’
- ‘postbypost’
- limit
- (целое) Количество ссылок для вывода. Используйте ” для вывода без ограничений.
- format
- (строка) Формат для списка архивов. Возможные значения:
- ‘html’ – В качестве спика HTML (<li>), значение по умолчанию.
- ‘option’ – В виде выпадающего списка (<option>).
- ‘link’ – Внутри тегов (<link>).
- ‘custom’ – Выборочный список.
- before
- (строка) Текст для вывода перед ссылкой при использовании формата ‘custom’ или ‘html’. По умолчанию – ”.
- after
- (строка) Текст для вывода после ссылки при использовании формата ‘custom’ или ‘html’. По умолчанию – ”.
- show_post_count
- (булево) Отображает число сообщений в архиве (TRUE) или нет (FALSE). При использовании, когда тип установлен как ‘monthly’. По умолчанию – FALSE.
- wp_get_archives
<?php wp_get_archives(’arguments’); ?>
Отображает список ссылок на архивы. Аналогичен get_archives(), но параметры аргументов выводятся в формате строкового запроса. Этот тег можно использовать в любом месте шаблона.Параметры
- type
- (строка) Тип вывода ссылок. Возможные значения:
- monthly (по умолчанию)
- daily
- weekly
- postbypost
- limit
- (целое) Количество архивов для вывода. По умолчанию, без ограничений.
- format
- (строка) Формат для списка архивов. Возможные значения:
- html – В виде списка HTML (<li>), значение по умолчанию.
- option – В виде выпадающего списка (<option>).
- link – Внутри тегов (<link>).
- custom – Выборочный список.
- before
- (строка) Текст для вывода перед ссылкой в формате custom или html. Без умолчаний.
- after
- (строка) Текст для вывода после ссылки в формате custom или html. Без умолчаний.
- show_post_count
- (булево) Отображает число сообщений в архиве (1 – true) или нет(0 – false). Для использования, когда тип установлен как monthly. По умолчанию – 0.
- get_calendar
<?php get_calendar(daylength); ?>
Отображает календарь за последний месяц, в котором публиковались сообщения. Этот тег можно использовать в любом месте шаблона.Параметры
- daylength
- (целое) Длина сокращения дней недели. Например, 1 приводит к отображению вторника как “В”, 2 выводит как “Вт”. По умолчанию – 1. Любое значение, кроме 1, приводит к отображению аббревиатуры в зависимости от локализации WordPress.
- wp_list_pages
<?php wp_list_pages(’arguments’); ?>
Отображает древовидный, ненумерованный список HTML list of all the страниц.Параметры
- child_of
- (целое) Отображает только дочерние страницы указанной страницы, в качестве параметра задается числовой ID страницы. По умолчанию – 0 (отображает все страницы).
- sort_column
- (строка) Сортирует список страниц согласно следующих опций:
- post_title – Сортировка по названию сообщения/страницы в алфавитном порядке (по умолчанию).
- menu_order – Сортировка по Порядку страниц (настраивается в управлении страницами).
- time_created – Сортировка по дате создания.
- time_modified – Сортировка по последнему изменению.
- ID – Сортировка по числовому ID страницы.
- post_author – Сортировка по числовому ID автора.
- post_name – Сортировка по названию, выведенному в тексте в постоянной ссылке (Быстрый доступ).
- sort_order
- (строка) Возможности сортировки. Возможные значения:
- ASC – По возрастанию (по умолчанию).
- DESC – По убыванию.
- exclude
- (строка) разделенный запятыми список чиловых ID страниц для исключения (например: exclude=10, 20, 30). Без умолчаний.
- depth
- (целое) Число уровней глубины вложения страниц. По умолчанию – 0 (отображаются все страницы).
- show_date
- (строка) Отображает дату создания или последнего изменения после каждой страницы. Возможные значения:
- – Пустое значение, дата не выводится (по умолчанию).
- modified – Отображает дату последнего изменения.
- created – Отображает дату создания.
- date_format
- (строка) Формат даты. По умолчанию – согласно настройкам WordPress. Смотрите Formatting Date and Time.
- title_li
- (строка) Текст для заголовка списка. По умолчанию – __(Pages), выводит “Pages” (символ __() используется для локализации). Если значение не введено, заголовок не выводится, и список не будет заключен в теги <ul><li>, </li></ul>.
- wp_loginout
<?php wp_loginout(); ?>
Отображает ссылку на вход в систему, а если пользователь опознан, ссылку на выход. - wp_register
<?php wp_register(’before’, ‘after’); ?>
Отображает ссылку Регистрация/Управление.Параметры
- before
- (строка) Текст для отображения перед ссылкой Регистрация/Управление. По умолчанию, ‘<li>’.
- after
- (строка) Текст для отображения после ссылки Регистрация/Управление. По умолчанию ‘</li>’.
- query_posts
Теги ссылок
- edit_post_link
<?php edit_post_link(’text’, ‘before’, ‘after’); ?>
Отображает ссылку для редактирования текущего сообщения, если пользователь опознан и имеет доступ. Должен быть внутри Цикла.Параметры
- text
- (строка) Текст ссылки. По умолчанию – ‘Edit This’.
- before
- (строка) Текст для вывода перед ссылкой. Без умолчаний.
- after
- (строка) Текст для вывода после ссылки. Без умолчаний.
- edit_comment_link
<?php edit_comment_link(’text’, ‘before’, ‘after’); ?>
Отображает ссылку на редактирование комментария, если пользователь опознан и имеет доступ. Должен быть внутри Цикла, и внутри цикла для комментариев.Параметры
- text
- (строка) Текст ссылки. По умолчанию – ‘Edit This’.
- before
- (строка) Текст для вывода перед ссылкой. Без умолчаний.
- after
- (строка) Текст для вывода после ссылки. Без умолчаний.
- link_pages
<?php link_pages(’before’, ‘after’, ‘next_or_number’, ‘nextpagelink’, ‘previouspagelink’, ‘pagelink’, ‘more_file’); ?>
Отображает постраничные ссылки для сообщений, разбитых на определенное число. Аналогичен wp_link_pages(), различие в представлении аргументов в формате функций PHP. Этот тег должен находиться внутри Цикла.Параметры
- before
- (строка) Текст перед всеми ссылками. По умолчанию – ‘<br />’.
- after
- (строка) Текст после всех сссылок. По умолчанию – ‘<br />’.
- next_or_number
- (строка) Показывает, нужно ли выводить номера страниц. Доступные значения:
- ‘number’ (по умолчанию)
- ‘next’.
- nextpagelink
- (строка) Текст для ссылки на следующую страницу. По умолчанию – ‘next page’
- previouspagelink
- (строка) Текст ссылки на предыдущую страницу. По умолчанию – ‘previous page’.
- pagelink
- (строка) Формат для номеров страниц. Символ ‘%’ в строке будет заменяться номерами страниц, поэтому конструкция Страница %’ будет генерировать “Страница 1″, “Страница 2″, и т.д.. По умолчанию – ‘%’.
- more_file
- (строка) Страница, от которой должен вестись отсчет ссылок. По умолчанию – текущая.
- wp_link_pages
<?php wp_link_pages(’arguments’); ?>
Отображает ссылки нумерованных страниц. Аналогичен link_pages(), отличие в строковом формате представления аргументов. Этот тег должен находиться внутри Цикла.Параметры
- before
- (строка) Текст перед всеми ссылками. По умолчанию – <p>Pages:.
- after
- (строка) Текст после всех ссылок. По умолчанию – </p>.
- next_or_number
- (строка) Показывает, нужно ли использовать номера страниц. Доступные значения:
- number (по умолчанию)
- next
- nextpagelink
- (строка) Текст ссылки на следующую страницу. По умолчанию – Next page.
- previouspagelink
- (строка) Текст ссылки на предыдущую страницу. По умолчанию – Previous page.
- pagelink
- (строка) Формат для номеров страниц. Символ ‘%’ в строке будет заменяться номерами страниц, поэтому конструкция Страница %’ будет генерировать “Страница 1″, “Страница 2″, и т.д.. По умолчанию – ‘%’.
- more_file
- (строка) Страница, от которой должен вестись отсчет ссылок. По умолчанию – текущая.
- get_year_link
<?php get_year_link(’year’); ?>
Возвращает URL годового архива к отдельному году, для использования в PHP. URL не отображается. Если год определен как ‘’, тег возвращает URL к архиву текущего года.Параметры
- year
- (целое) Год архива. Используйте ‘’ для текущего года.
- get_month_link
<?php get_month_link(’year’, ‘month’); ?>
Возвращает URL архива за месяц определенного года для использования в PHP. Сам URL не отображается. Если парметры месяца и года установлены как ‘’, тег возвращает URL на архив текущего месяца.Параметры
- year
- (целое) Год. Используйте ‘’ для выбора текущего года.
- month
- (целое) Месяц. Используйте ‘’ для текущего месяца.
- get_day_link
<?php get_day_link(’year’, ‘month’, ‘day’); ?>
Возвращает URL к архиву за конкретную дату, для использования в PHP. Сам URL не отображается. Если параметры года, месяца и дня установлены как ‘’, тег возвращает URL архива за текущую дату.Параметры
- year
- (целое) Год. ‘’ для текущего года.
- month
- (целое) Месяц. ‘’ для текущего месяца.
- day
- (целое) День. ‘’ для текущего дня.
Теги менеджера ссылок
- get_links_list
<?php get_links_list(’order’); ?>
Отображает древовидный ненумерованный список всех ссылок, введенных в Менеджере, отсортированных по категориям.Параметры
- order
- (строка) Способ сортировки категорий. Возможные значения:
- ‘name’ (по умолчанию)
- ‘id’
- Примечание: Символ подчеркивания перед опцией (например: ‘_id’) предполагает, что они сортируются в обратном порядке.
- get_links
<?php get_links(category, ‘before’, ‘after’, ‘between’, show_images, ‘order’, show_description, show_rating, limit, show_updated, echo); ?>
Как и wp_get_links(), этот тег выводит ссылки из Менеджера ссылок, но позволяет контролировать их параметрами тега, а не через интерфейс WordPress (полезно при использовании ссылок в разных шаблонах).Параметры
- category
- (целое) Числовой ID категории, из которой отбираются ссылки. Если не определено, отображаются все ссылки. По умолчанию – -1 (все ссылки).
- before
- (строка) Текст перед каждой ссылкой. Без умолчаний.
- after
- (строка) Текст после каждой ссылки. По умолчанию – ‘<br />’.
- between
- (строка) Текст между каждой парой ссылка/картинка и описание. По умолчанию – ‘ ‘ (пусто).
- show_images
- (булево) Должны ли отображаться картинки к ссылкам (TRUE) или нет (FALSE). По умолчанию – TRUE.
- orderby
- (строка) Значение для сортировки ссылок. По умолчанию – ‘name’, если не введен параметр ” (пусто), в этом случае значение переводится в ‘id’. Доступные опции:
- ‘id’
- ‘url’
- ‘name’
- ‘target’
- ‘category’
- ‘description’
- ‘owner’ – Пользователь, добавивший ссылку.
- ‘rating’
- ‘updated’
- ‘rel’ – Отношение к ссылке (XFN).
- ‘notes’
- ‘rss’
- Примечание: Символ подчеркивания перед опцией (например: ‘_id’) предполагает, что они сортируются в обратном порядке.
- ‘rand’ – Вывод ссылок в случайном порядке.
- show_description
- (булево) Должно ли описание выводиться (TRUE) или нет (FALSE). Доступно, когда значение show_images выключено (FALSE), или картинка к ссылке не задана. По умолчанию – TRUE.
- show_rating
- (булево) Должен ли отображаться звездочно/текстовый рейтинг (TRUE) или нет (FALSE). По умолчанию – FALSE.
- limit
- (целое) Максимальное число ссылок для вывода. По умолчанию – -1 (все).
- show_updated
- (булево) Должно ли отображаться время последнего изменения (TRUE) или нет (FALSE). По умолчанию – FALSE.
- echo
- (булево) Отображать ссылки (TRUE), или возвращать для использования в PHP (FALSE). По умолчанию – TRUE.
- wp_get_links
<?php wp_get_links(category); ?>
Отображает ссылки, связанные с числовым ID категории. Этот тег использует установки, изменяемые в Менеджере ссылок. Для контроля за форматированием и отображением ссылок, смотрите тег get_links().Параметры
- category
- (целое) Числовой ID категории ссылок. Если категория не задана, будут показаны все ссылки.
- get_linksbyname
<?php get_linksbyname(’cat_name’, ‘before’, ‘after’, ‘between’, show_images, ‘orderby’, show_description, show_rating, limit, show_updated); ?>
Как и wp_get_linksbyname(), этот тег выводит ссылки из базы данных, но предполагает больший контроль параметрами.Параметры
- cat_name
- (строка) Название категории, из которой выводятся ссылки. Если не определено, отображаются все ссылки. По умолчанию – ‘noname’ (все ссылки).
- before
- (строка) Текст перед каждой ссылкой. Без умолчаний.
- after
- (строка) Текст после каждой ссылки. По умолчанию – ‘<br />’.
- between
- (строка) Текст между каждой парой ссылка/имидж и описание. По умолчанию – ‘ ‘ (пусто).
- show_images
- (булево) Должны ли картинки отображаться (TRUE) или нет (FALSE). По умолчанию – TRUE.
- orderby
- (строка) Способ сортировки. По умолчанию – ‘id’. Доступные опции:
- ‘id’
- ‘url’
- ‘name’
- ‘target’
- ‘category’
- ‘description’
- ‘owner’ – Пользователь, который добавил ссылку.
- ‘rating’
- ‘updated’
- ‘rel’ – Отношение к ссылке (XFN).
- ‘notes’
- ‘rss’
- Примечание: Символ подчеркивания перед опцией (например: ‘_id’) предполагает, что они сортируются в обратном порядке.
- ‘rand’ – Вывод ссылок в случайном порядке.
- show_description
- (булево) Должно ли описание выводиться (TRUE) или нет (FALSE). Доступно, когда значение show_images выключено (FALSE), или картинка к ссылке не задана. По умолчанию – TRUE.
- show_rating
- (булево) Должен ли отображаться звездочно/текстовый рейтинг (TRUE) или нет (FALSE). По умолчанию – FALSE.
- limit
- (целое) Максимальное число ссылок для вывода. По умолчанию – -1 (all links).
- show_updated
- (булево) Должно ли отображаться время последнего изменения (TRUE) или нет (FALSE). По умолчанию – FALSE.
- wp_get_linksbyname
<?php wp_get_linksbyname(’category’); >
Отображает ссылки, связанные с названной категорией. Этот тег использует установки, изменяемые в Менеджере ссылок. Для контроля за форматированием и отображением ссылок, смотрите тег get_linksbyname().Параметры
- category
- (строка) Название категории, из которой выводятся ссылки. Без умолчаний.
Теги постоянных ссылок
- the_permalink
<?php the_permalink(); ?>
Отображает URL постоянной ссылки к сообщению, которое обрабатывается в данный момент в Цикле. Этот тег должен находиться внутри Цикла, и обычно используется для вывода постоянного адреса каждого сообщения. Поскльку этот тег ограничен отображением постоянного адреса обрабатываемого сообщения, его нельзя использовать для отображения адреса произвольного сообщения в вашем блоге. Обратитесь к тегу get_permalink(), если хотите отобразить постоянную ссылку на сообщение, с данным уникальным id. - permalink_anchor
<?php permalink_anchor(’type’); ?>
Выводит идентификатор якоря постоянной сслыки, или id (<a id=”….) сообщения. Полезно для ссылки на отдельный пост на странице, содержащей несколько сообщений, например, в архивах. Этот тег должен находиться внутри Цикла.Параметры
- type
- (строка) Тип якоря для вывода. Доступные значения:
- ‘id’ – Якорь равен числовому ID сообщения, значение по умолчанию.
- ‘title’ – Якорь идентичен заголовку в адресе ссылки (Быстрый доступ).
- get_permalink
<?php get_permalink(id); ?>
Возвращает постоянную ссылку к сообщению для использованию в PHP. Сама ссылка НЕ выводится.Параметры
- id
- (целое) Числовой ID сообщения. Когда тег используется в Цикле без заданного параметра id, тег поо умолчанию присваивает ID текущего сообщения.
- permalink_single_rss
<?php permalink_single_rss(’file’); ?>
Отображает постоянную ссылку к текущему сообщению, отформатированную для лент типа RSS или Atom. Тег должен использоваться внутри Цикла.Параметры
- file
- (строка) Адрес, на который должна вести ссылка. По умолчанию – текущая страница.
Теги сообщений
- the_ID
<?php the_ID(); ?>
Отображает числовой ID текущего сообщения. Этот тег должен находиться внутри Цикла. - the_title
<?php the_title(’before’, ‘after’, display); ?>
Отображает или возвращает заголовок текущего сообщения. Этот тег должен находиться внутри Цикла.Параметры
- before
- (строка) Текст перед заголовком. По умолчанию – ‘’.
- after
- (строка) Текст после заголовка. По умолчанию – ‘’.
- display
- (булево) Отображать заголовок, или (TRUE) возвращать его для использования в PHP (FALSE). По умолчанию – TRUE.
- single_post_title
<?php single_post_title(’prefix’, display); ?>
Отображает или возвращает заголовок на (постоянном адресе page) собственно сообщения. Тег может быть полезен для отображения заголовков вне Цикла.Параметры
- prefix
- (строка) Текст перед заголовком. По умолчанию – ‘’.
- display
- (булево) Заголовок должен отображаться (TRUE) или возвращаться для использования в PHP (FALSE). По умолчанию – TRUE.
- the_content
<?php the_content(’more_link_text’, strip_teaser, ‘more_file’); ?>
Отображает содержимое текущего сообщения. Этот тег должен находиться внутри Цикла.Параметры
- more_link_text
- (строка) Текст для ссылки “more”, ведущей на полное содержание сообщения. По умолчанию – ‘(more…)’.
- strip_teaser
- (булево) Должна ли ссылка “more” быть спрятана (TRUE) или отображаться (FALSE). По умолчанию – FALSE.
- more_file
- (строка) Файл, на который ведет ссылка “more”. По умолчанию – текущий файл.
- the_excerpt
<?php the_excerpt(); ?>
Отображает выдержку/цитату текущего сообщения. Если цитата не введена, возвращаются первые 120 сообщения. В этом случае, теги HTML игнорируются. Этот тег должен находиться внутри Цикла. - previous_post
<?php previous_post(’format’, ‘text’, ‘title’, ‘in_same_cat’, limitprev, excluded_category); ?>
Используется на странице полного текста сообщения, выводя предыдущий пост в хронологическом порядке. Может работать в сочетании с тегом next_post(). Тег должен использоваться внутри Цикла.Параметры
- format
- (строка) Строка форматирования. Символ ‘%’ в строке будет заменен ссылкой, поэтому ‘Перейти на %’ будет отображаться как “Перейти на <a href=…” По умолчанию – ‘%’.
- text
- (строка) Текст ссылки для отображения. По умолчанию – ‘previous post: ‘.
- title
- (строка) Показывает, должен ли выводиться заголовок сообщения как текст ссылки. Если ‘yes’, сразу выводится text (выше). Опции:
- ‘yes’ (по умолчанию)
- ‘no’
- limitprev
- (целое) Устанавливает ссылку на предыдущее сообщение в зависимости от текущего в числовом выражении (ID текущего поста минус limitprev). По умолчанию – 1. Так и рекомендуется.
- next_post
<?php next_post(’format’, ‘text’, ‘title’, ‘in_same_cat’, limitnext, excluded_category); ?>
Используется на странице полного текста сообщения, выводя следующий пост в хронологическом порядке. Может работать в сочетании с тегом previous_post(). Тег должен использоваться внутри Цикла.Параметры
- format
- (строка) Строка форматирования. Символ ‘%’ в строке будет заменен ссылкой, поэтому ‘Перейти на %’ будет отображаться как “Перейти на <a href=…” По умолчанию – ‘%’.
- text
- (строка) Текст ссылки для отображения. По умолчанию – ‘next post: ‘.
- title
- (строка) Показывает, должен ли выводиться заголовок сообщения как текст ссылки. Если ‘yes’, сразу выводится text (выше). Опции:
- ‘yes’ (по умолчанию)
- ‘no’
- limitnext
- (целое) Устанавливает ссылку на следующее сообщение в зависимости от текущего в числовом выражении (ID текущего поста плюс limitnext). По умолчанию – 1. Так и рекомендуется.
- the_meta
<?php the_meta(); ?>
Отображает ненумерованный список пар выборочных полей “key:value”, или PostMeta к текущему сообщению. Используется внутри Цикла. - the_title_rss
<?php the_title_rss(); ?>
Отображает заголовок текущего сообщения, отформатированный для RSS. Этот тег должен находиться внутри Цикла. - the_content_rss
<?php the_content_rss(’more_link_text’, strip_teaser, ‘more_file’, cut, encode_html); ?>
Отображает содержимое текущего сообщение, отформатированное для RSS. Этот тег должен находиться внутри Цикла.Параметры
- more_link_text
- (строка) Текст ссылки для “more”. По умолчанию – ‘(more…)’.
- strip_teaser
- (булево) Должна ли ссылка “more” быть спрятана (TRUE) или отображаться (FALSE). По умолчанию – FALSE.
- more_file
- (строка) Файл, на который ведет ссылка “more”. По умолчанию – текущий файл.
- cut
- (целое) Число отображаемых слов до. По умолчанию 0 (выводится все).
- encode_html
- (целое) Определяет кодировку тегов html и специальных символов (например, ‘&’). Опции:
- the_excerpt_rss
<?php the_excerpt_rss(); ?>
Отображает цитату из текущего сообщения, отформатированную для RSS. Если таковой нет, выводит первые 120 слов. Этот тег должен находиться внутри Цикла.
Теги Трекбэк
- trackback_url
<?php trackback_url(display); ?>
Отображает или возвращает URL для ссылки на данный пост. Этот тег должен находиться внутри Цикла.Параметры
- display
- (булево) Отображать URL (TRUE), или возвращать значение для PHP (FALSE). По умолчанию – TRUE.
- trackback_rdf
<?php trackback_rdf(); ?>
Выводит информацию Трекбэк в RDF для текущего сообщения. Этот тег должен находиться внутри Цикла.