Создание и продвижение сайтов » template tags http://www.eklmn.org оптимизация | интернет маркетинг | контент менеджемент | редизайн Mon, 11 Apr 2011 07:03:27 +0000 http://wordpress.org/?v=2.8.6 en hourly 1 Теги шаблонов WordPress http://www.eklmn.org/2008/01/09/tegi-shablonov-wordpress/ http://www.eklmn.org/2008/01/09/tegi-shablonov-wordpress/#comments Wed, 09 Jan 2008 20:52:29 +0000 eklmn http://www.eklmn.org/2008/01/09/tegi-shablonov-wordpress/ Полезная информация для тех, кто использует Wordpress в качестве рабочей платформы для своих проектов.

Теги шаблонов – это встроенный набор пользовательских функций для отображения информации, динамически генерируемой WordPress.
Ниже расположен список этих тегов, разбитый по категориям.

Для более подробной информации по тегам и шаблонам WordPress смотрите Кодекс: http://codex.wordpress.org/Templates

Авторские теги

  • the_author
    <?php the_author(’idmode’, display); ?>
    Отображает или возвращает имя автора сообщения. Тег должен использоваться внутри Цикла.

    Параметры

    idmode
    (строка) Устанавливает элемент профиля пользователя для отображения. Возможные значения:

    • ‘nickname’
    • ‘login’
    • ‘firstname’
    • ‘lastname’
    • ‘namefl’ (формат: firstname lastname)
    • ‘namelf’ (формат: lastname firstname)
    Примечание: По умолчанию выбор основан на Идентификации в блоге (Отображать как) – в настройках профиля пользователей. То же самое происходит при использовании для idmode пустого значения ‘’.
    display
    (булево) Отображает имя (TRUE), или возвращает значение для использования в PHP (FALSE). По умолчанию TRUE.
  • the_author_firstname
    <?php the_author_firstname(); ?>
    Отображает имя автора сообщения; устанавливается в профиле. Должно использоваться внутри Цикла.
  • the_author_lastname
    <?php the_author_lastname(); ?>
    Отображает фамилию автора сообщения; устанавливается в профиле. Должно использоваться внутри Цикла.
  • the_author_nickname
    <?php the_author_nickname(); ?>
    Отображает ник автора сообщения; устанавливается в профиле. Должно использоваться внутри Цикла.
  • the_author_email
    <?php the_author_email(); ?>
    Отображает адрес e-mail автора сообщения; устанавливается в профиле. Должно использоваться внутри Цикла.
  • the_author_url
    <?php the_author_url(); ?>
    Отображает URL сайта автора сообщения; устанавливается в профиле. Должно использоваться внутри Цикла.
  • the_author_description
    <?php the_author_description(); ?>
    Отображает содержимое поле Профиль: в профиле автора сообщения.
    Это текстовый блок для описания автора и его интересов, может быть достаточно объемным. Должно использоваться внутри Цикла.
  • the_author_aim
    <?php the_author_aim(); ?>
    Отображает имя в AIM автора сообщения; устанавливается в профиле. Должно использоваться внутри Цикла.
  • the_author_icq
    <?php the_author_icq(); ?>
    Отображает номер ICQ автора сообщения; устанавливается в профиле. Должно использоваться внутри Цикла.
  • the_author_msn
    <?php the_author_msn(); ?>
    Отображает идентификацию MSN автора сообщения; устанавливается в профиле. Должно использоваться внутри Цикла.
  • the_author_yim
    <?php the_author_yim(); ?>
    Отображает имя в Yahoo IM автора сообщения; устанавливается в профиле. Должно использоваться внутри Цикла.
  • the_author_login
    <?php the_author_login(); ?>
    Отображает логин автора сообщения; логин – это имя, которое пользователь использует для входа в Wordpress. Должно использоваться внутри Цикла.
  • the_author_ID
    <?php the_author_ID(); ?>
    Отображает уникальный цифровой ID автора сообщения; ID присваевается WordPress при создании пользователя. Должно использоваться внутри Цикла.
  • the_author_posts
    <?php the_author_posts(); ?>
    Отображает общее число сообщений автора. Должно использоваться внутри Цикла.
  • list_authors
    <?php list_authors(optioncount, exclude_admin, show_fullname, hide_empty, ‘feed’, ‘feed_image’); ?>
    Отображает список авторов блога и, при желании, другую информацию, например, ссылку ленту RSS каждого автора.
    Тег работает подобно wp_list_authors, различие заключается в том, что аргументы в этой функции обрабатываются в формате функций PHP.

    Параметры

    optioncount
    (булево) Отображает число сообщений автора. Опции:

    • TRUE
    • FALSE (по умолчанию)
    exclude_admin
    (булево) Исключить аккаунт администратора из списка автора. Опции:

    • TRUE (по умолчанию)
    • FALSE
    show_fullname
    (булево) Отображает полное (имя и фамилия) имя авторов. Опции:

    • TRUE
    • FALSE (по умолчанию)
    hide_empty
    (булево) Не отображаются авторы без сообщений (posts=0). Опции:

    • TRUE (по умолчанию)
    • FALSE
    feed
    (строка) Текст для отображения к ссылки на ленту RSS каждого автора. По умолчанию нет ни текста, ни ссылки на ленту.
    feed_image
    (строка) Путь/файл для картинки. Работает как ссылка на ленту RSS каждого автора, переписывает параметр feed.
  • wp_list_authors
    <?php wp_list_authors(’аргументы’); ?>
    Отображает список авторов блога, может отображать число сообщений каждого автора и ссылку на ленту RSS.
    Работает похоже на list_authors, отличие в обработке аргументов, которые обрабатываются в строчном формате.

    Параметры

    optioncount
    (булево) Отображает число сообщений каждого автора. Опции:

    • 1 (true)
    • 0 (false – значение по умолчанию)
    exclude_admin
    (булево) Исключает аккаунт админа из списка. Опции:

    • 1 (true – значение по умолчанию)
    • 0 (false)
    show_fullname
    (булево) Отображает полное (имя и фамилия) имя автора. Опции:

    • 1 (true)
    • 0 (false – значение по умолчанию)
    hide_empty
    (булево) Не отображает авторов без единого сообщения. Опции:

    • 1 (true – значение по умолчанию)
    • 0 (false)
    feed
    (строка) Текст для ссылки на ленту RSS каждого автора. По умолчанию нет ни текста, ни ссылки.
    feed_image
    (строка) Путь/файл для картинки. Работает как ссылка на ленту RSS каждого автора, переписывает параметр feed.

Теги категорий

  • 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)
  • 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_popup_script
    <?php comments_popup_script(width, height); ?>
    Выводит код JavaScript для комментариев во всплывающем окне. Используется вместе с comments_popup_link(), может использоваться в любом месте шаблона, но обычно прописывается в <шапке>.

    Параметры

    width
    (целое) Ширина всплывающего окна. По умолчанию – 400 (пикселов).
    height
    (целое) Высота всплывающего окна. По умолчанию – 400 (пикселов).
  • comments_number
    <?php comments_number(’zero’, ‘one’, ‘more’, ‘number’); ?>
    Отображает общее число комментариев, Трекбэков, и PingbacksПингов к сообщению. Этот тег должен находиться внутри Цикла.

    Параметры

    zero
    (строка) Текст при отстутствии комментариев. По умолчанию – ‘No Comments’.
    one
    (строка) Текст при наличии 1 комментария. По умолчанию – ‘1 Comment’.
    more
    (строка) Текст при наличии более чем одного комментария. ‘%’ заменяется числом комментариев, так что ‘Камментов пока %’ отображается как “Камментов пока 5″. По умолчанию – ‘% Comments’.
    number
    (целое) Число комментариев. По умолчанию – общее количество комментариев, пингов и трекбэков.
  • comment_author
    <?php comment_author(); ?>
    Отображает имя автора комментария. Если нет имени (и отключено “Нужно указать свое имя и email” согласно Опции общения), WordPress присвоит автору имя “Anonymous”. Этот тег должен находиться внутри Цикла, или в цикле комментариев.
  • comment_author_email
    <?php comment_author_email(); ?>
    Отображает адрес email автора комментария, без ссылки. Адрес email должен быть указан, если вклечена опция “Нужно указать свое имя и email” в Опциях общения. Этот тег должен находиться внутри Цикла, or a comment loop.
  • comment_author_url
    <?php comment_author_url(); ?>
    Отображает URL автора комментариев (обычно его сайт), без ссылки. Этот тег должен находиться внутри Цикла, или в цикле комментариев.
  • comment_author_IP
    <?php comment_author_IP(); ?>
    Отображает IP-адрес автора комментария. Этот тег должен находиться внутри Цикла, или в цикле комментария.
  • 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. Смотри также Форматирование даты и времени.
  • comment_author_rss
    <?php comment_author_rss(); ?>
    Отображает имя автора комментария, отформатированное в видет ленты RSS. Обычно используется в шаблоне для ленты RSS комментариев. Этот тег должен находиться внутри Цикла, или в цикле комментариев.
  • comment_text_rss
    <?php comment_text_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
    (строка) Текст для вывода после ссылки. Без умолчаний.
  • 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_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 игнорируются. Этот тег должен находиться внутри Цикла.
  • 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 и специальных символов (например, ‘&’). Опции:

    • 0 – (по умолчанию) Парсит ссылки (для “сноса url “).
    • 1 – Фильтрует через функцию PHP htmlspecialchars(), затем возвращается к значению 0, поэтому не рекоментуется при использовании параметра cut.
    • 2 – Игнорирует теги 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 для текущего сообщения. Этот тег должен находиться внутри Цикла.
]]> http://www.eklmn.org/2008/01/09/tegi-shablonov-wordpress/feed/ 27