Теги шаблонов WordPress – Теги сообщений.
09 октября, 2008- the_ID
- the_title
- the_title_attribute
- single_post_title
- the_title_rss
- the_content
- the_content_rss
- the_excerpt
- the_excerpt_rss
- previous_post_link
- previous_post (Не поддерживается)
- next_post_link
- next_post (Не поддерживается)
- posts_nav_link
- the_meta
- the_tags (С версии 2.3)
- wp_count_posts (С версии 2.5)
the_ID
Показывает ID текущего сообщения. Этот тег используется внутри Цикла.
Примеры:
Использование по умолчанию:
<p>Номер сообщения: <?php the_ID(); ?></p>
Устанавливает якорь в виде уникального идентификатора к каждому сообщению:
<h3 id="post-<?php the_ID(); ?>"><?php the_title(); ?></h3>
the_title
Выводит или возвращает заголовок текущего сообщения. Используется внутри Цикла.
Параметры:
- before
- (string) Текст до заголовка. По умолчанию ''.
- after
- (string) Текст после заголовка. По умолчанию ''.
- display
- (Boolean) Вывести заголовок (TRUE) или вернуть для дальнейшего использования (FALSE). По умолчаню TRUE.
Пример:
<?php the_title('<h3>', '</h3>'); ?>
the_title_attribute
Выводит или возвращает заголовок текущего сообщения. Повторяет функциональность тега the_title(), за исключением преобразования спецсимволов и использованием строковых параметров. Используется в Цикле.
Параметры:
- before
- (string) Текст до заголовка. По умолчанию ''.
- after
- (string) Текст после заголовка. По умолчанию ''.
- echo
- (Boolean) Выводить заголовок (1) или возвратить (0). По умолчанию 1.
Пример:
<?php the_title_attribute('before=<h3>&after=</h3>'); ?>
single_post_title
Показывает или возвращает заголовок сообщения при выводе одного сообщения. Может использоваться вне Цикла.
Параметры:
- prefix
- (string) текст до заголовка. По умолчанию ''.
- display
- (boolean) Выводить (TRUE) или возвратить (FALSE) заголовок. По умолчанию TRUE.
Примеры:
<h2><?php single_post_title('Текущее сообщение: '); ?></h2>
the_title_rss
Выводит заголовок текущего сообщения отформатированный для RSS. Используется внутри Цикла.
Примеры:
<item> <title><?php the_title_rss(); ?></title>
the_content
Выводит содержание текущего сообщения. Используется внутри Цикла.
Если используется тег <!--more--> то сообщение показывается только до <!--more--> (только на главной странице, на странице сообщения будет показываться полностью).
Заметка:
- Проследите чтобы не было других символов до слова “more” в <!--more-->. При наличии других символов тег <!-- more --> работать не будет!
- <!--more--> не будет работать если отображается только одно сообщение.
Параметры:
- more_link_text
- (string) Текст ссылки для “more”. По умолчанию '(далее...)'.
- strip_teaser
- (boolean) Скрыть текст до ссылки “more” (TRUE) или вывести (FALSE). По умолчанию FALSE.
- more_file
- (string) На какой файл ссылка “more”. По умолчанию на текущий файл. (V2.0: В настоящее время параметр ‘more_file’ не работает).
Примеры:
Изменение текста ссылки <!--more-->.
<?php the_content('Читать далее...'); ?>
Изменение текста ссылки <!--more--> на Читать полностью “Заголовок текущего сообщения”.
<?php the_content("Читать плоностью " . the_title('', '', false)); ?>
the_content_rss
Выводит содержание текущего сообщения в формате RSS. Используется в Цикле.
Параметры:
- more_link_text
- (string) Текст ссылки для “more”. По умолчанию '(далее...)'.
- strip_teaser
- (boolean) Скрыть текст до ссылки “more” (TRUE) или вывести (FALSE). По умолчанию FALSE.
- more_file
- (string) На какой файл ссылка “more”. По умолчанию на текущий файл.
- cut
- (integer) Количество слов выводимые до конца сообщения. По умолчанию 0 (Выводить все).
- encode_html
- (integer) Фильтр html тегов и кодирование спецсимволов (например ‘&’). Параметры:
- 0 – (Default) Парсинг исходящих ссылок для сносок.
- 1 – Фильтр на PHP функцию htmlspecialchars(), но устанавливает параметр cut в 0, не рекомендуется если используется параметр cut.
- 2 – Заменяет спецсимволы вида ‘&’ на эквивалент (&). По умолчанию при использовании параметра cut.
Примеры:
Использование по умолчанию:
<?php the_content_rss(); ?>
the_excerpt
Выводит краткое содержание текущего сообщеняия с [...] на конце, без ссылки “read more”. Если вы не не указали текст краткого содержания сообщения (в поле краткое содержание в редакторе сообщений), используется первые 55 слов сообщения. Также в этом случае HTML теги и рисунки не выводятся. Используется в Цикле.
Примеры:
Использование по умолчанию:
<?php the_excerpt(); ?>
Заменяет the_content() на the_excerpt() на архивных страницах ( is_archive()) или на страницах категорий (is_category()).
<?php if(is_category() || is_archive()) {
the_excerpt();
} else {
the_content();
} ?>
the_excerpt_rss
Выводит краткое содержание текущего сообщеняия в формате RSS.
Примеры:
<description><?php the_excerpt_rss(); ?></description>
previous_post_link
Используется для вывода ссылки на предыдущее сообщение, при просмотре одного сообщения. Используется в Цикле.
Параметры:
- format
- (string) Форматирование строки для ссылки. Здесь можно указать, что будет до и после ссылки. Строка '%link' будет заменена на ссылку. Например 'Перейти к %link' создаст ссылку типа “Перейти к <a href=… . По умолчанию '« %link.
- link
- (string) Текст ссылки. По умолчанию заголовок предыдущего сообщения ('%title').
- in_same_cat
- (boolean) Если TRUE то ссылка будет на сообщения из текущей категории, иначе из всех категорий. Параметры:
- TRUE
- FALSE (По умолчанию)
- excluded_categories
- (string) Цифровой ID категории(й) которая будет исключаться. Разделяйте несколько категорий с and; например: '1 and 5 and 15'. Нет значения по умолчанию.
Примеры:
Использование по умолчанию:
<?php previous_post_link(); ?>
Текст ссылки выделенный жирным:
<?php previous_post_link('<strong>%link</strong>'); ?>
previous_post
Не используется. Заменена на previous_post_link
next_post_link
Используется для вывода ссылки на следующее сообщение, при просмотре одного сообщения. Используется в Цикле.
Параметры:
- format
- (string) Форматирование строки для ссылки. Здесь можно указать, что будет до и после ссылки. Строка '%link' будет заменена на ссылку. Например 'Перейти к %link' создаст ссылку типа “Перейти к <a href=… . По умолчанию '%link ».
- link
- (string) Текст ссылки. По умолчанию заголовок предыдущего сообщения ('%title').
- in_same_cat
- (boolean) Если TRUE то ссылка будет на сообщения из текущей категории, иначе из всех категорий. Параметры:
- TRUE
- FALSE (По умолчанию)
- excluded_categories
- (string) Цифровой ID категории(й) которая будет исключаться. Разделяйте несколько категорий с and; например: '1 and 5 and 15'. Нет значения по умолчанию.
Примеры:
Использование по умолчанию:
<?php next_post_link(); ?>
Текст ссылки выделенный жирным:
<?php next_post_link('<strong>%link</strong>'); ?>
next_post
Не используется. Заменена на next_post_link.
posts_nav_link
Выводит ссылки на предыдущую/следующую страницу с сообщениями.
Параметры:
- sep
- (string) Текст выводимый между ссылками.
- По умолчанию ' :: ' в 1.2.x.
- По умолчанию ' — ' в 1.5.
- prelabel
- (string) Текст ссылки для предыдущей страницы.
- По умолчанию '<< Предыдущая страница' в 1.2.x.
- По умолчанию '« Предыдущая страница' в 1.5.
- nxtlabel
- (string) Текст ссылки для следующей страницы.
- По умолчанию 'Следующая страница >>' в 1.2.x.
- По умолчанию 'Следующая страница »' в 1.5
Примеры:
Использование по умолчанию:
<?php posts_nav_link(); ?>
« Предыдущая Страница — Следующая страница »
Измененный текст ссылок:
<p><?php posts_nav_link(' или ', 'Вы можете вернуться на предыдущую страницу',
'Вы можете перейти к следующей странице'); ?>.</p>
Вы можете вернуться на предыдущую страницу или Вы можете перейти к следующей странице.
the_meta
Выводит неупорядоченный список типа “Ключ:Значение” из дополнительных полей. Используется внутри Цикла.
Примеры:
<?php the_meta(); ?>
the_tags
Выводит метки(теги) к сообщению. Работает с версии 2.3. Используется в Цикле.
Параметры:
- before
- (string) Текст до вывода меток. По умолчанию Метки:
- separator
- (string) Текст которым будет отделяться каждая метка. По умолчанию запятая (,).
- after
- (string) Текст который будет выводиться после последней метки. По умолчанию нет.
Примеры:
По умолчанию:
<p><?php the_tags(); ?></p>
Разделенные стрелкой:
<?php the_tags('Метки: ',' > '); ?>
В списке:
<?php
the_tags('<ul><li>','</li><li>','</li></ul>');
?>
wp_count_posts
Возвращает количество записей в таблице wp_posts, принимает параметры wp_type и wp_status.
Параметры:
- type
- (string) Тип сообщения post_type в таблице wp_posts. По умолчанию post
- status
- (string) Статус сообщения post_status в таблице wp_posts. По умолчанию publish
Примеры:
По умолчанию:
<?php $published_posts=wp_count_posts(); ?>
Неопубликованные:
<?php $draft_posts=wp_count_posts('post','draft'); ?>
Страницы:
<?php $published_pages=wp_count_posts('page','publish'); ?>
Хорошо что нашел информацию про Теги шаблонов WordPress и в частности Теги сообщений! А то она разбросана везде и отрывками ! а здесь нашел все то что мне нужно!