Теги шаблонов WordPress. Основные теги

Ромчик
7

Создание своей темы для WordPressДоброго времени суток. Сегодняшний пост это дополнение к уроку 3, да и не только к уроку 3. Без изучения тегов шаблона WordPress, мы не сможем создать хорошую тему для WordPress. Теги шаблонов WordPress помогают упростить создание темы для WordPress. Поэтому я и прерву серию уроков по созданию темы, пока мы с Вами не рассмотрим все теги.
Как Вы уже заметили в уроке 3, когда мы добавили вывод постов к нашей теме для WordPress — мы использовали теги. И в дальнейшем мы будем постоянно обращаться к данным тегам. Поэтому давайте и остановимся на изучении тегов шаблона WordPress. А сегодня мы поговорим об основных тегах.
Ну, что ж приступим…

Основные теги:

get_header()
Данная функция включает файл header.php, если имя не задано. Функция get_header может принимать значение $name, где $name — это название часть названия подключаемого файла header-{name}.php.
Пример:

<?php get_header() ?>

подключит файл header.php

<?php get_header(‘home’) ?>

подключит файл header-home.php

Наверх

get_footer()
Данная функция включает файл footer.php, если имя не задано. Функция get_footer может принимать значение $name, где $name — это название часть названия подключаемого файла footer-{name}.php.
Пример:

<?php get_footer() ?>

подключит файл footer.php

<?php get_footer(‘home’) ?>

подключит файл footer-home.php

Наверх

get_sidebar()
Данная функция включает файл sidebar.php, если имя не задано. Функция get_sidebar может принимать значение $name, где $name — это название часть названия подключаемого файла sidebar-{name}.php.
Пример:

<?php get_sidebar() ?>

подключит файл sidebar.php

<?php get_footer(‘left’) ?>

подключит файл footer-left.php

Наверх

get_template_part()
Данная функция загружает шаблон в шаблон (кроме header, sidebar и footer). Тем самым данная функция упрощает создание шаблона, помогает избегать многократного повторения кода. Данная функция может принимать два значения $slug — имя общего шаблона и $name — имя специализированного шаблона.
Пример:
Добавим панель навигации в шаблон, используя общий шаблон навигации nav.php

<?php get_template_part( 'nav' ); ?>

подключит к нашей теме файл nav.php

<?php get_template_part( 'nav',’single’ ); ?>

подключит к нашей теме файл nav-single.php

Наверх

get_search_form()
Данная функция отображает форму поиска, используя файл searchform.php данной темы. Может принимать одно значение $echo — если true, то покажет форму поиска, если false — то не покажет. По умолчанию: true.
Если в теме отсутствует файл searchform.php, то данная функция сгенерирует следующую форму:

<form role="search" method="get" id="searchform" action="<?php echo home_url( '/' ); ?>">
    <div><label for="s">Search for:</label>
        <input type="text" value="" name="s" id="s" />
        <input type="submit" id="searchsubmit" value="Search" />
    </div>
</form>

Наверх

wp_loginout()
Отображает ссылку для входа, или, если пользователь вошел в систему, выводит ссылку выхода из системы. Может принимать два параметра $redirect — перенаправление при авторизации или выхода пользователя из системы и $echo — если true, то отбражает ссылку входа/выхода, если false — то не отображает. По умолчанию: true.
Пример:

<?php wp_loginout() ?>

Наверх

wp_logout_url()
Дання функция позволяет пользователю разлогинеться на сайте. Может принимать параметр $redirect — адрес, куда будем перенапрвлять пользователя после разлогиневания.
Пример:

<a href="<?php echo wp_logout_url(); ?>" title="Logout">Logout</a>

или

<a href="<?php echo wp_logout_url( home_url() ); ?>" title="Logout">Logout</a>

перенаправление на домашнюю страницу.

Наверх

wp_login_url()


Данная функция позволяет пользователю залогиниться на сайте. Может принимать параметр $redirect — перенаправляет пользователя на URL, после прохождения авторизации.
Пример:

<a href="<?php echo wp_login_url(); ?>" title="Login">Login</a>

или

<a href="<?php echo wp_login_url( home_url() ); ?>" title="Login">Login</a>

перенаправляет пользователя на домашнюю страницу, после прохождения успешной авторизации.

Наверх

wp_login_form()


Данная функция показывает простую форму входа на сайт. Принимает массив аргументов:

<?php $args = array(
        'echo' => true,
        'redirect' => site_url( $_SERVER['REQUEST_URI'] ),
        'form_id' => 'loginform',
        'label_username' => __( 'Username' ),
        'label_password' => __( 'Password' ),
        'label_remember' => __( 'Remember Me' ),
        'label_log_in' => __( 'Log In' ),
        'id_username' => 'user_login',
        'id_password' => 'user_pass',
        'id_remember' => 'rememberme',
        'id_submit' => 'wp-submit',
        'remember' => true,
        'value_username' => NULL,
        'value_remember' => false ); ?>

где:

  • echo — если true, то показывает форму авторизации, если же false, то не показывает. По умолчанию true.
  • redirect — адрес перенаправления, после прохождения авторизации. URL должен быть записан относительно (т.е. https://web-programming.com.ua). По умолчанию, текущая страница.
  • form_id — id формы. По умолчанию: loginform
  • remember — показывать(true) или не показывать(false) поле remember. По умолчанию: true.
  • value_username — значение поля usernmame
  • value_remember — значения поля remember. По умолчанию: false.

Пример:

<?php wp_login_form(); ?>

Показывает форму авторизации с заданными параметрами по умолчанию.

<?php
$args = array(
        'echo' => true,
        'redirect' => site_url( $_SERVER['REQUEST_URI'] ),
        'form_id' => 'loginform',
        'label_username' => __( 'Username' ),
        'label_password' => __( 'Password' ),
        'label_remember' => __( 'Remember Me' ),
        'label_log_in' => __( 'Log In' ),
        'id_username' => 'user_login',
        'id_password' => 'user_pass',
        'id_remember' => 'rememberme',
        'id_submit' => 'wp-submit',
        'remember' => false,
        'value_username' => 'Логин',
        'value_remember' => false );
wp_login_form($args)
?>

Показывает форму авторизации с заданными параметрами.

Наверх

wp_lostpassword_url()


Эта функция возвращает пользователя на страницу для получения забытого пароля. Принимает значение $redirect — переадресация пользователя на URL после восстановления пароля. По умолчанию $redirect пусто.
Пример:

<a href="<?php echo wp_lostpassword_url( get_permalink() ); ?>" title="Lost Password">Lost Password</a>

Переадресация пользователя на текущую страницу.

Наверх

wp_register()


Данная функция отображает либо ссылку на админку, если пользователь авторизован на сайте или ссылку на регистрацию, если пользователь не авторизован на сайте. Может принимать три параметра $before — текст перед ссылкой на страницу регистрации или ссылкой на админку сайта (по умолчанию: <li>), $after — текст после ссылки на страницу регистрации или адвинку сайта (по умолчанию: </li>), $echo — если true — то показывает ссылку, если false — то не показывает ссылку. По умолчанию: true.
Пример:

<?php wp_register(); ?>

или

<?php wp_register(‘ ’, ‘ ’); ?>

Наверх

wp_meta()
Данная функция создает hook, для дальнейшей вставки данных. О hook-ах мы поговорим чуть позже.

Наверх

bloginfo()
Данная функция возвращает информацию о Вашем ресурсе. Если же Вам необходимо получить значения для дальнейшего использования в php коде, то используйте get_bloginfo(). Принимает параметр $show, который в свою очередь может прнимать следующие значения:

  • name — название Вашего ресурса
  • description — описание ресурса
  • admin_email — почтовый адрес администратора
  • url — адрес ресурса
  • wpurl — адрес ресурса
  • stylesheet_directory — папка со стилями данного шаблона
  • stylesheet_url — адрес файла таблицы стилей
  • template_directory — адрес папки с текущим шаблоном
  • template_url — адрес текущего шаблона
  • atom_url — адрес atom рассылки
  • rss2_url — адрес rss рассылки
  • rss_url — адрес rss рассылки
  • pingback_url — адрес файла оповещения других ресурсов о добавлении нового материала
  • rdf_url — адрес rdf расылки
  • comments_atom_url — адрес atom рассылки комментариев
  • comments_rss2_url — адрес rss рассылки комментариев
  • charset — кодировка ресурса
  • html_type — медиа тип
  • language — язык ресурса
  • text_direction — направление текста
  • version — версия WordPress

Пример:

<?php bloginfo('name'); ?>

Вывод названия сайта.

Наверх

get_bloginfo()
Возвращает информацию о Вашем ресурсе, которая может в дальнейшем использоваться.
Принимает два параметра $show и $filter. Параметр $name может принимать такие же значения, что и функция bloginfo(). Праметр $filter может принимать два значения ‘Display’, который передает данные $show через wptexturize() и ‘raw’ возвращает значение $show так, как есть. По умолчанию: $raw.
Пример:

<?php $blog_title = get_bloginfo(); ?>

Наверх

get_current_blog_id()
Данная функция получает текущий id блога.

Наверх

wp_title()
Данная функция возвращает заголовок текущей страницы. Может принимать следующие параметры: $sep, $echo, $seplocation, где:

  • $sep — текст до и после названия поста, разделитель. По умолчанию: >>
  • $echo — показывать (true) название поста или нет (false). По умолчанию: true
  • $seplocation —

Пример:

<title><?php bloginfo('name'); ?><?php wp_title('|',true,''); ?></title>

Печатает в title название блога | название поста

Наверх

single_post_title()
Данная функция отображает заголовок поста. Полезно использовать в не механизма The Loop. Может принимать два параметра: $prefix и $display, где:

  • $prefix — текст перед заголовком статьи. По умолчанию: пусто.
  • $display — заголовок будет отображаться(true) или значение будет возвращено для дальнейшего использования в коде (false). По умолчанию: true.

Наверх

post_type_archive_title()
Показывает title поста, который находиться в архиве. Эта функция оптимизирована для файла arhive.php — шаблон архивных постов. Может принимать два параметра: $prefix и $display, где:

  • $prefix — текст перед заголовком статьи. По умолчанию: пусто.
  • $display — заголовок будет отображаться(true) или значение будет возвращено для дальнейшего использования в коде (false). По умолчанию: true.

Наверх

single_cat_title()
Отображает или возвращает название категории для текущего поста. Может использоваться вне механизма The Loop. Принимает два параметра: $prefix и $display, где:

  • $prefix — текст перед заголовком статьи. По умолчанию: пусто.
  • $display — заголовок будет отображаться(true) или значение будет возвращено для дальнейшего использования в коде (false). По умолчанию: true.

Наверх

single_tag_title()
Отображает или возвращает название тега для текущего поста. Принимает два параметра: $prefix и $display, где:

  • $prefix — текст перед заголовком статьи. По умолчанию: пусто.
  • $display — заголовок будет отображаться(true) или значение будет возвращено для дальнейшего использования в коде (false). По умолчанию: true.

Наверх

single_term_title()
Отображает или возвращает заголовок таксономии текущего поста. Может принимать два параметра: $prefix и $display, где:

  • $prefix — текст перед заголовком статьи. По умолчанию: пусто.
  • $display — заголовок будет отображаться(true) или значение будет возвращено для дальнейшего использования в коде (false). По умолчанию: true.

Наверх

single_month_title()
Отображает или возвращает название месяца и года для текущей страницы. Работает только для архивных страниц. Может принимать два параметра: $prefix и $display, где:

  • $prefix — текст перед заголовком статьи. По умолчанию: пусто.
  • $display — заголовок будет отображаться(true) или значение будет возвращено для дальнейшего использования в коде (false). По умолчанию: true.

Наверх

get_archives_link()
Получение ссылки на архив контента. Может принимать следующие параметры:

  • $url — адрес архива
  • $text — описание архива
  • $format — формат, может быть ‘link’, ‘option’, ‘html’. По умолчанию: ‘html’
  • $before — текст перед ссылкой
  • $after — текст после ссылки

Наверх

wp_get_archives()
Данная функция выводит список архива. В качестве параметра принимает массив, следующего вида:

$args = array(
    'type'            => 'monthly',
    'limit'           => ,
    'format'          => 'html',
    'before'          => ,
    'after'           => ,
    'show_post_count' => false,
    'echo'            => 1
);

Где:

  • type — по какому типу будет отображаться список архива, может принимать следующие значения: yearly, monthly — по умолчанию, daily, weekly, postbypost (посты сортируются по дате), alpha (посты сортируются по названиям)
  • limit — количество постов в архиве. По умолчанию: неограничено.
  • format — формат представления: html — по умолчанию, option, link, custom(пользовательский список)
  • before — текст перед ссылкой для формата html или custom
  • after — текст после ссылки для формата html или custom
  • show_post_count — показывать количество постов. По умолчанию: false.
  • echo — отображать (1) или возвращать(0). По умолчанию: 1

Наверх

get_calendar()
Отображение календаря. Может принимать два параметра:

  • $initial — если true, то день недели будет сокращаться до одной буквы, false — до трех
  • $echo — отображать календарь(true) или нет (false)

Наверх

wp_enqueue_script()
Функция позволяет безопасно добавить JavaScript в WordPress. Принимает параметры:

  • $handle — название скрипта. Название должно быть в нижнем регистре.
  • $src — ссылка на скрипт
  • $deps — массив названий сценариев, которые должны быть загружены до выполнения текущего скрипта
  • $ver — номер версии сценария
  • $in_footer — если параметр принимает true, скрипт находиться в нижней части <body>

Наверх

На этом мы закончили рассмотрение основных тегов WordPress.  Благодаря этим тегам мы можем с легкостью подключить header, footer, sidebar, javascript и многое другое. Да, статья получилась большая, но разделять ее я не вижу смысла — нарушиться логика.
На этом на сегодня все. В следующей статье, которая будет продолжением данного поста мы рассмотрим теги для работы с автором (авторами) постов. Так, что не пропускайте выхода новых статей, подписавшись на RSS-рассылку.

Понравилась статья? Поделись с друзьями.
  • Add to favorites
  • Добавить ВКонтакте заметку об этой странице
  • Twitter
  • Facebook
  • Мой Мир
  • LiveJournal
  • Одноклассники
  • Блог Я.ру
  • MySpace
  • FriendFeed
  • В закладки Google
  • Google Buzz
  • Яндекс.Закладки
  • Reddit
  • StumbleUpon
  • Technorati
  • del.icio.us
  • БобрДобр
  • LinkedIn
  • Memori.ru
  • Сто закладок
  • Blogger

  • Теги для работы с автором (авторами) постов WordPress | Все о WEB программировании - 28.02.2012 в 22:38

    […] Мы с Вами продолжаем изучать теги для шаблонов WordPress. В прошлом материале мы рассмотрели основные теги для шаблонов WordPress. […]

  • Третяк Дмитрий - 05.11.2012 в 16:11

    О, спасибо. Очень интересно и полезно!

  • Rosemary - 06.08.2014 в 12:43

    Nice post. I was checking continuously this blog and I’m impressed! Very helpful information specially the last part :) I care for such information a lot. I was looking for this certain info for a very long time. Thank you and best of luck.

  • Juliet - 06.08.2014 в 13:08

    Oh my goodness! Impressive article dude! Many thanks, However I am going through troubles with your RSS. I don’t understand why I cannot join it. Is there anybody having identical RSS issues? Anyone who knows the answer will you kindly respond? Thanks!!

  • Maximo - 06.08.2014 в 14:07

    If some one wants expert view about blogging afterward i propose him/her to pay a visit this weblog, Keep up the nice job.

  • Velva - 06.08.2014 в 14:47

    Wonderful items from you, man. I’ve take note your stuff prior to and you’re simply extremely great. I actually like what you’ve received here, really like what you’re saying and the best way through which you assert it. You’re making it enjoyable and you continue to take care of to keep it sensible. I can’t wait to learn far more from you. That is really a wonderful web site.

  • Rudolf - 06.08.2014 в 15:12

    Good information. Lucky me I found your website by accident (stumbleupon). I have saved as a favorite for later!

  • ©2012-2017 По всем вопросам обращайтесь через форму обратной связи

    Яндекс.Метрика