
Середина 2018 года. Пора поговорить, про ожидаемую, в смысле неизбежности, версию системы с красивым счётом 5:0, WordPress 5.0. Фишка версии в новом редакторе «Gutenberg».
WordPress Codex принято называть онлайн-руководство для пользователей и разработчиков WordPress. Это по сути «живой» репозиторий для информации и документации WordPress CMS. В тематических блогах, WordPress Codex это вся информация поясняющая, объясняющая, демонстрирующая работу функций и тегов WordPress.
Функция 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 (строка) , определяет как показывать ссылки, если текущая категория является дочерней.
Может принимать:
По умолчанию: просто выводятся категории, к которым принадлежит пост (никакая связь не учитывается)
$post_id (число)
ID поста, категории которого нужно вывести.
По умолчанию: текущий пост ($post->ID)
Пост находится в категории «Деревянный Дом». Это дочерняя категория рубрики «Дом».
Применив
<?php the_category(' / ', 'multiple'); ?>
Получим результат:
Дом/Деревянный дом и это будут две отдельные ссылки.
Если применить
<?php the_category(' / ', 'single'); ?>
Получим результат:
Дом/Деревянный и это будет одно общая ссылка,на категорию Деревянный дом.в которой находится пост.
Функция 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 сайта
Отображает выдержку после публикации. Фильтрует отображаемую выдержку.
Файл: 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_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? Если вы не практикуете заполнение поля цитата, то и разделять вам нечего. Однако, использование цитаты меняет содержание и внешний вид страниц сайта. Кроме этого, дело не только во внешнем виде страниц сайта. Управляя, содержанием анонсов в архивах сайта решается проблема частичного дублирования содержания сайта и задача вовлечения новых поисковых запросов. Если грамотно настроить и разделить вывод анонсов в архивах и статьях, то можно не закрывать все архивы от поисковиков и не боятся дублирования содержания сайта.
Читать дальше …
Функция tag_description получает описание метки, которое задается при создании/редактировании метки в админ-панели.
Функция tag_description возвращает текст, в виде описания метки или ничего , если описание не создано или его не удалось получить
<?php tag_description( $tag_id ); ?>
$tag_id
(число), ID метки, описание которой нужно получить.
По умолчанию: ID метки, страница которой отображается
Выведем описание метки с ID 43:
<?php echo 'Описание метки: ' . tag_description('43'); ?>
Функция get_post
в качестве аргумента принимает ID записи и возвращает хранящуюся в базе данных информацию о ней. Формат возвращаемых данных зависит от параметра $output
.
Функция get_post
используется в posts_nav_link()
, wp_get_recent_posts()
, get_children()
.
<?php get_post( $post, $output ); ?>
$post
(Необходим ) ID записи, которую вы бы хотели «достать».
Вам нужно подставлять именно переменную со значением ID (напр. $id), а не просто цифру, равную ID (напр. 7). В последнем случае получите критическую ошибку. (Only variables can be passed for reference или Cannot pass parameter 1 by reference)
По умолчанию(Default) : None
$output
(Необязательно) Определяет формат возвращаемых данных.
По умолчанию : OBJECT
Пример: Вывод заголовка поста с ID 7
<?php
$my_id = 7;
$post_id_7 = get_post($my_id);
$title = $post_id_7->post_title;
?>
В случае ошибки эта функция возвращает null.
String (строка) и Integer (целое) это типы параметров тегов.
ID
ID поста
post_author
ID автора поста
post_date
Дата и время создания поста (ГГГГ-ММ-ДД ЧЧ:ММ:СС)
post_date_gmt
Дата и время создания поста по Гринвичу (GMT) (ГГГГ-ММ-ДД ЧЧ:ММ:СС)
post_content
Содержание поста
post_title
Заголовок поста
post_category
ID рубрики к которой принадлежит пост. Важно помнить, что это значения всегда будет равно 0 начиная с WordPress 2.1 Для определения рубрики или рубрик, в которых находится запись используйте get_the_category().
post_excerpt
Выдержка из поста (отрывок текста)
post_status
Статус поста (publish|pending|draft|private|static|object|attachment|inherit|future)
comment_status
Статус комментирования (open|closed|registered_only)
ping_status
Статус пингов и трекбеков (open|closed)
post_password
Пароль поста
post_name
Приставка к URL поста (slug, ее видно в URL, если включена опция ЧПУ)
to_ping
URL для пингов
pinged
URL, которые уже были «пингованы»
post_modified
Дата и время последнего редактирования поста (ГГГГ-ММ-ДД ЧЧ:ММ:СС)
post_modified_gmt
Дата и время последнего редактирования поста по Гринвичу (GMT) (ГГГГ-ММ-ДД ЧЧ:ММ:СС)
post_content_filtered
post_parent
ID родительской поста (для вложений, например и т.п.)
guid
Ссылка на пост. Можно сказать, что это текущая ссылка на конкретный пост.
menu_order
Число определяющее «рейтинг» поста (влияет на порядок вывода страниц в списке)
post_type
Тип записи (post|page|attachment)
post_mime_type
Mimе-тип (для вложений, проч.)
comment_count
Число комментариев.