Середина 2018 года. Пора поговорить, про ожидаемую, в смысле неизбежности, версию системы с красивым счётом 5:0, WordPress 5.0. Фишка версии в новом редакторе «Gutenberg».
WordPress 5.0: что ждать в новой версии системы
Метка: Codex Wordpress
Codex Wordpress
WordPress Codex принято называть онлайн-руководство для пользователей и разработчиков WordPress. Это по сути «живой» репозиторий для информации и документации WordPress CMS. В тематических блогах, WordPress Codex это вся информация поясняющая, объясняющая, демонстрирующая работу функций и тегов WordPress.
Функция the_category
the_category
Функция the_category отображает ссылку на категорию или категории, к которой принадлежит сообщение. Этот тег должен быть использован в течение Loop (основного цикла).
Применение
Функция the_category позволит вывести категории в которой находится пост в различном виде, определенном параметрами функции. Позволит отобразить список категорий для публикации в любом списке HTML или в специальном формате.
Использование
<?php the_category( $separator, $parents, $post_id ); ?>более подробно:
the_category( string $separator = '', string $parents = '', int $post_id = false )Параметры
Все параметры НЕ обязательные.
$separator (строка), Разделитель между ссылками.
По умолчанию: выведет ссылки в списке <ul>
$parents (строка) , определяет как показывать ссылки, если текущая категория является дочерней.
Может принимать:
- multiple — показывать отдельно ссылки на родительскую и дочернюю категории, сохраняя порядок (родитель/предок);
- single — показать одну ссылку, на категорию в которой находится пост, но текстом ссылки станет вся структура вложенности поста в категории (родитель/предок).
По умолчанию: просто выводятся категории, к которым принадлежит пост (никакая связь не учитывается)
$post_id (число)
ID поста, категории которого нужно вывести.
По умолчанию: текущий пост ($post->ID)
Пример
Пост находится в категории «Деревянный Дом». Это дочерняя категория рубрики «Дом».
Применив
<?php the_category(' / ', 'multiple'); ?>Получим результат:
Дом/Деревянный дом и это будут две отдельные ссылки.
Если применить
<?php the_category(' / ', 'single'); ?>Получим результат:
Дом/Деревянный и это будет одно общая ссылка,на категорию Деревянный дом.в которой находится пост.
Еще функции
Как вывести описание рубрики WordPress
Несложным редактированием кода WordPress можно легко вывести описание рубрики WordPress на страницу архива рубрик.
Функция category_description
category_description
Функция category_description назначение
Функция category_description возвращает описание рубрики, которое задается на вкладке Записи>>>Рубрики, ссылка «Исправить» под рубрикой в административной панели сайта.
Применение
При использовании функция размещается в шаблоне архивов (archive.php), в условном операторе is_category (). В противном случае эта функция будет останавливать обработку страниц архива.
Как использовать
<? php echo category_description ( $category_id ); ?>Параметры
$category_id (число), ID категории.
если НЕ указать ID, то используется описание текущей рубрики.
Примеры использования
<?php echo category_description(77); ?>Результат: Описание категории с ID=77
<div><strong><?php single_cat_title('В этой категории вы найдете:'); ?>
</strong>: <?php echo category_description(); ?></div>Результат. В этой категории вы найдете:
далее «Описание категории», созданное при редактировании рубрики в админ. панели сайта.
Пример с названием рубрики:
<?php echo category_description(); ?>
<h1 class="archive-title"><?php single_cat_title('<Вы на странице рубрики:'); ?></h1>Подробно в статье: Красиво оформить и оптимизировать страницы рубрик WordPress сайта
Другие функции
Функция the_excerpt()
the_excerpt()
Отображает выдержку после публикации. Фильтрует отображаемую выдержку.
Источник
Файл: wp-includes/post-template.php Строка 351-361.
function the_excerpt() {
/**
* Filters the displayed post excerpt.
*
* @since 0.71
*
* @see get_the_excerpt()
*
* @param string $post_excerpt The post excerpt.
*/Назначение
Отображает отрывок текущего сообщения после применения к нему нескольких фильтров, включая форматирование авторов, которое превращает двойные разрывы строк в абзацы HTML.
Он использует функцию get_the_excerpt (), чтобы сначала сгенерировать сокращенную версию полного содержания поста, если не будет показан явный отрывок для сообщения тегом more.
В автоматически генерированном отрывке будут удалены все короткие коды и теги. Он обрезается до границы слова, а длина по умолчанию составляет 55 слов.
Excerpt является альтернативой использования тега more. В то время, как тег more требует, чтобы автор вручную создавал «разделение» в посте и участвует в создании ссылки «читать дальше», Excerpt делает всё в автоматическом режиме и не требует простановки автором никаких тегов.
Тег <! - more -> требуется, чтобы шаблоны использовали функцию the_content (), тогда как для использования отрывков достаточно разработчикам шаблонов явно выбрать, показывать ли полные сообщения (используя the_content () ) или выдержки (используя the_excerpt () ).
Еще функции
Функция the_content
Функция
the_content
Назначение
Функция the_content выводит контент текущего поста (записи).
Применение
Функция the_content выводит контент текущего поста (записи) шаблона, должена использоваться внутри Цикла WordPress или на станице записи (single.php, page.php).
Использование
<?php the_content( $more_link_text, $strip_teaser ); ?>Параметры
- $more_link_text – Параметр Строка, добавляется опционально. Задает текст для отображения ссылки «далее», «дополнительно». Значение по умолчанию: «Читать далее →».
- $stripteaser – Логический параметр, добавляется опционально. Обрезает содержимое перед тегом комментарии. По умолчанию значение: FALSE. Работает только при показе одиночных записей (single.php).
Источник
Расположен в wp-includes/post-template.php строка 230
Пример
Изменяет стандартный текст ссылки, который выводится функцией, после отрывка по тегу <!—more—>
<?php the_content('Перейти ко всей статье...');>Функция the_post_thumbnail
Функция
the_post_thumbnail
Назначение
Функция the_post_thumbnail выводит html код картинки-миниатюры поста пустое значение, если картинка отсутствует.
Применение
Этот тег шаблона, функция the_post_thumbnail, должен использоваться внутри Цикла WordPress
Использование
<?php the_post_thumbnail( $size, $attr ); ?>the_post_thumbnail( string|array $size = 'post-thumbnail', string|array $attr = '' )Источник
Файл: wp-includes / post-thumbnail-template.php
function the_post_thumbnail( $size = 'post-thumbnail', $attr = '' ) {
echo get_the_post_thumbnail( null, $size, $attr );
}Параметры
$size (строка/массив)
Размер миниатюры, которую нужно получить. Может быть строкой с условными размерами: thumbnail, medium, large, full или массив из двух элементов (ширина и высота картинки): array(60, 60).
По умолчанию: ‘post-thumbnail’, то есть размер который устанавливается для текущей темы функцией set_post_thumbnail_size()
$attr (строка/массив)
Массив атрибутов, которые нужно добавить получаемому html тегу img (alt — альтернативное название).
По умолчанию:
Пример
<?php // Post featured image
if(has_post_thumbnail()) {
if (!is_single()){ ?><a href="<?php the_permalink(); ?>" title=
"<?php printf( $SMTheme->_( 'permalink' ), the_title_attribute( 'echo=0' ) ); ?>"> <?php }
the_post_thumbnail(
array($SMTheme->get( 'layout', 'imgwidth' ), $SMTheme->get( 'layout', 'imgheight' )),
array("class" => $SMTheme->get( 'layout','imgpos' ) . " featured_image")
);
if (!is_single()){ ?></a><?php }
}
?>Как разделить анонс и цитату в шаблоне WordPress
Зачем разделять анонс и цитату в шаблоне WordPress? Если вы не практикуете заполнение поля цитата, то и разделять вам нечего. Однако, использование цитаты меняет содержание и внешний вид страниц сайта. Кроме этого, дело не только во внешнем виде страниц сайта. Управляя, содержанием анонсов в архивах сайта решается проблема частичного дублирования содержания сайта и задача вовлечения новых поисковых запросов. Если грамотно настроить и разделить вывод анонсов в архивах и статьях, то можно не закрывать все архивы от поисковиков и не боятся дублирования содержания сайта.
Читать дальше …