WordPress 5.0: что ждать в новой версии системы

WordPress 5.0

Середина 2018 года. Пора поговорить, про ожидаемую, в смысле неизбежности, версию системы с красивым счётом 5:0, WordPress 5.0. Фишка версии в новом редакторе «Gutenberg».

Читать дальше …

Функция 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'); ?>

Получим результат:

Дом/Деревянный  и это будет одно общая ссылка,на категорию Деревянный дом.в которой находится пост.

 

Еще функции

Функция 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? Если вы не практикуете заполнение поля цитата, то и разделять вам нечего. Однако, использование цитаты меняет содержание и внешний вид страниц сайта. Кроме этого, дело не только во внешнем виде страниц сайта. Управляя, содержанием анонсов в архивах сайта решается проблема частичного дублирования содержания сайта и задача вовлечения новых поисковых запросов. Если грамотно настроить и разделить вывод анонсов в архивах и статьях, то можно не закрывать все архивы от поисковиков и не боятся дублирования содержания сайта.
Читать дальше …