Главная > Блог > Web-разработка > CMS WoprdPress >

WordPress. Теги шаблона

14.03.2019

Теги: CMS • PHP • Web-разработка • WordPress • Функция • Цикл

Функция the_title()

Выводит на экран заголовок записи. Принято использовать внутри цикла. Особенностью является, то что заголовки для «личных» и «защищенных» постов будут помечены соответственно: «Личное (Private)» и «Защищен (Protected)».

Возвращает null когда параметр $echo выставлен в true. Или строку, когда параметр $echo выставлен в false.

the_title($before, $after, $echo);

$before (строка). Текст или HTML-код, который нужно разместить перед заголовком. По умолчанию: пустая строка.
$after (строка). Текст или HTML-код, который нужно разместить после заголовка. По умолчанию: пустая строка.
$echo (логический). Вывести на экран (true) или возвратить для дальнейшей обработки (false). По умолчанию: true.

Функция the_excerpt()

Выводит отрывок (цитату) поста, со вставкой в конец […]. Предназначена для использования внутри Цикла WordPress.

Если поле «Цитата» не указано для поста, то функция «создаст» цитату самостоятельно — будут взяты первые 55 слов контента. HTML теги будут предварительно вырезаны, поэтому они не будут выводится и учитываться при подсчете.

the_excerpt();

Иногда лучше использовать функцию the_content(), потому что она понимает тег  и выводит то, что выше этого тега.

По умолчанию, длина по которому обрезается текст — это 55 слов. Чтобы изменить этот параметр, можно использовать фильтр excerpt_length, для этого добавляем в файл functions.php темы:

add_filter(
    'excerpt_length',
    function() {
        return 20;
    }
);

Чтобы заменить […] на три точки (...), добавляем фильтр:

add_filter(
    'excerpt_more',
    function () {
        return '...';
    }
);

Функция the_content()

Выводит контент текущего поста (записи). Должна использоваться внутри Цикла WordPress или на странице записи (page.php, single.php). Когда функция вызывается внутри Цикла и используется разделитель , то текст записи будет обрезан и будет добавлена ссылка далее….

the_content($more_link_text, $strip_teaser);

$more_link_text (строка). Текст, который будет показан как текст ссылки, вместо далее….
$strip_teaser (логический). Если установить параметр в true, то контент до тега  на странице записи будет удален.

Можно удалить контент до тега , указав в любом месте текста записи тег . Обычно его принято указывать сразу после тега .

Функция the_permalink()

Выводит ссылку (УРЛ) на пост, который в текущий момент обрабатывается в Цикле.

the_permalink($post);

$post (число/объект). Идентификатор или объект записи (поста), ссылку на который нужно получить. По умолчанию: идентификатор текущего поста в цикле.

Функция the_date()

Выводит на экран дату публикации поста или группы постов (опубликованных в один день). Используется только в Цикле WordPress.

Дата публикации группы постов означает, что для постов опубликованных в одни день, дата показывается только для первого поста. Чтобы выводить дату для всех постов, нужно использовать функции: the_time() или get_the_date().

the_date($format, $before, $after, $echo);

$format (строка). Формат даты как в PHP. Например, 'j F Y' выведет «14 марта 2019». По умолчанию: формат установленный в настройках.
$before (строка). Текст, который нужно разместить перед датой. По умолчанию: пустая строка.
$after (строка). Текст, который нужно разместить после даты. По умолчанию: пустая строка.
$echo (логический). Вывести на экран (true) или возвратить для дальнейшей обработки (false). По умолчанию: true.

Функция the_author()

Выводит имя автора поста. Не имеет параметров (были запрещены) и используется внутри Цикла WordPress.

the_author();

Функция the_tags()

Выводит ссылки на метки, которые относятся к посту.

the_tags($before, $separator, $after);

$before (строка). Текст перед ссылками. По умолчанию: 'Tags: '.
$separator (строка). Разделитель между ссылками. По умолчанию: ', '.
$after (строка). Текст после ссылок. По умолчанию: пустая строка.

Пример использования

<?php if (have_posts()): ?>
    <?php while (have_posts()): ?>
        <?php the_post(); ?>
        <div class="post">
            <h2><?php the_title(); ?></h2>
            <small><?php the_date(); ?></small>
            <p><?php the_excerpt(); ?></p>
            <a href="<?php the_permalink(); ?>">Читать далее…</a>
        </div>
    <?php endwhile; ?>
<?php else : ?>
    <p>Записей нет.</p>
<?php endif; ?>

Поиск: CMS • PHP • Web-разработка • WordPress • Функция • Теги шаблона • the_title • the_excerpt • the_content • the_permalink • the_date • the_author • the_tags • Цикл