Теги шаблонов WordPress
Нижеследующая информация беспардонно передрана с http://mywp.spb.ru/tegi-shablonov-wordpress/, но не корысти ради, а токмо из соображений безопасности любознательных коллег, ибо вышеозначенный сайт, увы, поражен трояном.
Информация немного уже сильно устаревшая, но лучше что-то, чем ничего поэтому лучше пользоваться Кодексом.
Теги шаблонов 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 для текущего сообщения. Этот тег должен находиться внутри Цикла.
Можете попробовать в работе плагин Yoast Seo Plagin, в нем если я не ошибаюсь есть есть редактор плагина .htaccess
Артем, Вы не промахнулись? В этом посте речь совершенно не о .htaccess.
Полезная подборка,пользуюсь иногда,сравниваю,недавно удалил файл .htaccess,посоветуйте что можно зделать,к сожалению сохраненного файла нет?
Создать файл, путь даже пустой, поставить на него права 666 и сохранить настройки ЧПУ. WP сам запишет в .htaccess нужные директивы. После этого можно поставить права 444.
Либо сохранить настройки ЧПУ и на той же странице посмотреть, что WP рекомендует записать в .htaccess.
На здоровье! 🙂 Но труд в основном не мой. Честно говоря, нет ни времени, ни желания заниматься актуализацией. Пусть этим занимаются люди, вызвавшиеся вести официальный русский раздел на wordpress.org.
Спасибо Вам за огромный труд!
Было бы здорово, если бы вы добавили в список тэгов the_tags. Я не раз обращался к этой странице. Она мне очень помогала.
Насчет подробней — не знаю, я предпочитаю оригинальный Кодекс, но есть еще один кладезь на русском — http://codex.mywordpress.ru/
Давно искал сие чудо!
А есть еще описание более подробное?