Вивчаємо теги шаблонів: частина перша
Вивчаємо теги шаблонів: частина друга
Вивчаємо теги шаблонів: частина третя
Вивчаємо теги шаблонів: частина четверта
Вивчаємо теги шаблонів: частина п’ята
Вивчаємо теги шаблонів: частина шоста
У сьогоднішній, шостій статті з цієї серії, ми раді представити вам чергову порцію з практично 200 тегів шаблонів. Ми розглянемо теги, пов’язані з записами, сторінками і елементами шаблонів.
Отримуємо і виводимо автоматичні класи для кожного запису: get_post_class() і post_class()
Дані теги дозволяють додавати нові класи CSS, які можна використовуватиме в тілі кожного запису.
Параметри
Обидва тега шаблонів приймають два значення:
- $class (string, необов’язковий): Додаткові CSS-класи, які необхідно додати. За замовчуванням:’ ‘;
- $post_ID (integer або Object, необов’язковий): ID запису. За замовчуванням: поточний запис.
Застосування
Отримуємо і виводимо постійне посилання на поточну запис: get_permalink() і the_permalink()
Теги отримують або виводять постійне посилання на запис.
Параметри
the_permalink() не приймає параметрів.
get_permalink() приймає два параметри:
- $post_ID (integer або Object, необов’язковий): ID запису. За замовчуванням: поточна запис;
- $leavename (bool, необов’язковий): Зберігати чи назву сторінки. За замовчуванням: FALSE.
Застосування
Отримуємо і виводимо ID запису: get_the_ID() і the_ID()
Теги повертають і виводять ID запису.
Параметри
Ці теги шаблонів не приймають параметрів.
Застосування
Отримуємо і виводимо заголовок поста: single_post_title()
Тег отримує і виводить заголовок поста для використання в заголовках сторінок (які оформляються тегом ).
Параметри
Цей тег шаблону приймає два параметри:
- $prefix (string, необов’язковий): Приставка до заголовка. За замовчуванням: »;
- $echo (bool, необов’язковий): Вивести (TRUE) або повернути заголовок (FALSE). За замовчуванням: TRUE.
Застосування
Отримуємо і виводимо посилання на запис: get_next_post_link() і next_post_link()
Дані теги дозволяють отримувати або виводити посилання на наступну запис щодо поточної.
Параметри
Обидва тега шаблонів беруть п’ять параметрів:
- format (string, необов’язковий): Формат посилання, де %link є параметром $link. За замовчуванням: ‘%link «‘;
- $link (string, необов’язковий): Формат анкорного тексту, де %title – це заголовок запису. За замовчуванням: ‘%title‘;
- $in_same_term (bool, необов’язковий): Робити посилання на записи з тієї ж таксономії. За замовчуванням: FALSE;
- $excluded_terms (string або array, необов’язковий): Список термінів для виключення. За замовчуванням: »;
- $taxonomy (string, необов’язковий): Таксономія для фільтрації наступних записів. За замовчуванням: ‘category‘.
Застосування
Отримуємо і виводимо посилання на попередню запис: get_previous_post_link() і previous_post_link()
Дані теги дозволяють отримувати або виводити посилання на попередню запис.
Параметри
Обидва тега шаблонів беруть п’ять параметрів:
- format (string, необов’язковий): Формат посилання, де %link є параметром $link. За замовчуванням: ‘%link «;’;
- $link (string, необов’язковий): Анкор посилання. ‘%title‘ заміниться на заголовок запису. За замовчуванням: ‘%title‘;
- $in_same_term (bool, необов’язковий): Робити посилання на запис з тієї ж таксономії. За замовчуванням: FALSE;
- $excluded_terms (string або array, необов’язковий): Список термінів таксономії для виключення. За замовчуванням: »;
- $taxonomy (string, необов’язковий): Таксономія для фільтрації наступних записів. За замовчуванням: ‘category‘.
Застосування
Отримуємо постійну посилання на сторінку: get_page_link()
Тег отримує постійний URL заданої сторінки.
Параметри
Цей тег шаблону приймає три параметри:
- $post_ID (integer або Object, необов’язковий): ID запису. За замовчуванням: поточна запис;
- $leavename (bool, необов’язковий): Зберігати назва сторінки чи ні. За замовчуванням: FALSE;
- $sample (bool, необов’язковий): це Є зразком постійної посилання. За замовчуванням: FALSE.
Застосування
Отримуємо і виводимо постійне посилання запису: get_post_permalink() і post_permalink()
Дані теги отримують і виводять постійне посилання запису.
Параметри
get_post_permalink() приймає три параметри:
- $post_ID (integer або Object, необов’язковий): ID запису. За замовчуванням: поточна запис;
- $leavename (bool, необов’язковий): Зберігати чи назву сторінки. За замовчуванням: FALSE;
- $sample (bool, необов’язковий): це Є зразком постійної посилання. За замовчуванням: FALSE.
post_permalink() приймає один параметр:
- $post_ID (integer або Object, необов’язковий): ID запису. За замовчуванням: поточний запис.
Застосування
Отримуємо і виводимо коротке посилання на запис: wp_get_shortlink() і the_shortlink()
Дані теги повертають і виводять коротку версію посилання на запис.
Параметри
wp_get_shortlink() приймає три параметри:
- $ID (string, необов’язковий): ID запису або блогу. За замовчуванням: поточний запис або на блог;
- $context (string, необов’язковий): ID записом в блозі, записом на сайті або ID медіа файлу. Ви можете виставити параметр на ‘post‘ (для записів у блозі) або ‘query‘ (для іншого типу ID). За замовчуванням: ‘post‘;
- $allow_slugs (bool, необов’язковий): Використовувати транслітерацію (slug) в укорочених посиланнях. За замовчуванням: TRUE.
the_shortlink() приймає чотири параметри:
- $text (string, необов’язковий): Текст посилання. За замовчуванням: «Це коротке посилання«;
- $title (string, необов’язковий): Значення атрибута title тега . За замовчуванням: », але конвертується у оформлений заголовок запису;
- $before (string, необов’язковий): Текст або HTML-код, який буде показаний перед посиланням. За замовчуванням: »;
- $after (string, необов’язковий): Текст або HTML-код, який буде показаний після посилання. За замовчуванням: ».
Застосування
Отримуємо і виводимо на посилання «Редагувати»: get_edit_post_link() і edit_post_link()
Даний тег дозволяє отримати або вивести на посилання «Редагувати запис», яку потім можна використовувати в шаблонах.
Параметри
get_edit_post_link() приймає два параметри:
- $post_ID (integer, необов’язковий): ID запису. За замовчуванням: поточна запис;
- $context (integer, необов’язковий): потрібно екранувати символ & (тобто замінювати на &). Можна використовувати всі значення, крім ‘display‘, щоб запобігти шифрування посилання. За замовчуванням: ‘display‘.
edit_post_link() приймає чотири параметри:
- $text (string, необов’язковий): Текст посилання. За замовчуванням: «Редагувати«;
- $before (string, необов’язковий): Текст або HTML-код, який буде показаний перед посиланням. За замовчуванням: »;
- $after (string, необов’язковий): Текст або HTML-код, який буде показаний після посилання. За замовчуванням: »;
- $post_ID (string, необов’язковий): ID запису. За замовчуванням: поточний запис.
Застосування
Отримуємо посилання для видалення запису: get_delete_post_link()
Тег дозволяє отримати посилання для видалення запису.
Параметри
Цей тег шаблону приймає три параметри:
- $post_ID (integer, необов’язковий): ID запису. За замовчуванням: поточна запис;
- $deprecated (string, застарілий): Цей параметр застарів, залишіть його порожнім. За замовчуванням: »;
- $force_delete (bool, необов’язковий): Видалити запис повністю, минаючи Кошик. За замовчуванням: FALSE.
Застосування
ID, ‘ ‘, true );
?>
Виводимо «анкорный текст» для постійної посилання на поточну запис: permalink_anchor()
Тег виводить анкорный текст для постійної посилання на запис. Для наочності, погляньте на приклад.
Параметри
Цей тег шаблону приймає лише один параметр:
- $mode (string, необов’язковий): задає тип якоря для виводу. Якщо задати значення параметру ‘id‘, то якір буде дорівнює числовому ID посту. Якщо ‘title‘, то анкор буде дорівнює імені посту. За замовчуванням: ‘id‘.
Застосування
Завантажуємо шаблон заголовка: get_header()
Цей відомий тег дозволяє довантажувати зовнішній PHP-файл, в якому міститься шаблон заголовка.
Параметри
Цей тег шаблонів приймає лише один параметр:
- $name (string, необов’язковий): Назва файлу шапки сайту (header-{$name}.php). За замовчуванням: »,якщо цей параметр завантажує файл header.php.
Застосування
Завантажуємо шаблон підвалу сайту: get_footer()
Цей популярний тег дозволяє завантажити зовнішній PHP-файл, в якому міститься шаблон підвалу сайту.
Параметри
Цей тег шаблону приймає лише один параметр:
- $name (string, необов’язковий): Назва файлу підвалу (footer-{$name}.php). За замовчуванням: », якщо цей параметр завантажить файл footer.php.
Застосування
Завантажуємо шаблон бічній панелі: get_sidebar()
Популярний тег, який дозволяє завантажувати зовнішній PHP-файл, в якому міститься шаблон боковій панелі:
Параметри
Цей тег шаблону приймає лише один параметр:
- $name (string, необов’язковий): Назва файлу бічній панелі (sidebar-{$name}.php). За замовчуванням: », якщо цей параметр завантажить файл sidebar.php.
Застосування
Завантажуємо файли шаблону: get_template_part()
Цей тег дозволяє завантажувати зовнішні PHP-файли з папки шаблону.
Параметри
Цей тег шаблону приймає два параметри:
- $slug (string, обов’язковий): назва файлу шаблону. За замовчуванням: NULL;
- $name (string, необов’язковий): Довільну назву, яка додається до імені файлу. За замовчуванням: NULL.
Застосування
На завершення
Сподіваємося, вам сподобалася п’ята «порція» тегів шаблонів. Найближчим часом ми опублікуємо ще кілька статей з цієї серії.
Якщо у вас виникли питання або зауваження, обов’язково напишіть про це в коментарях. І якщо вам сподобалася наша стаття, не забудьте поділитися з друзями!
Переклад статті «The Tuts+ Guide to Template Tags: Fifth Batch» був підготовлений дружною командою проекту Сайтостроение від А до Я.