Мы уже разобрали два урока на тему, как правильно создать шаблон WordPress своими руками. Теперь вы понимаете, из каких частей состоит тема, где расположены ее основные файлы и какие элементы требуются для построения страниц. Прошлый раз речь шла о тегах шаблона, сегодня же мы подробнее разберем только один из них, имеющий наибольшую значимость. Тег bloginfo () выводит на экран ту или иную информацию сервисе. Он обладает немалым количеством параметром, использование которых упростит вывод данных в нужном вам виде на страничках сайта. Давайте разберемся в каждом из них и научимся правильно применять их при создании собственного шаблона.
Полезно: шаблон WordPress своими руками. Урок 1. Основы
Общая информация
Функция bloginfo () представляет собой тег шаблона, который выводит информацию о сайте или блоге, хранимую в опциях ресурса. Получаемые данных могут извлекаться из профильной информации ли же из главных настроек админки WordPress. Тег может быть использован в любом удобном месте сайта. Единственным условием будет правильное расположение в файле шаблона и корректное написание параметров. Вызов функции передает браузеру информацию для вывода на экран, а значит мы получаем нужные данные в считанные секунды и видим их в уже привлекательном для взгляда формате. Больше не нужно вручную задавать данные, изменяя их в каждом месте на сайте. Достаточно задействовать параметры функции, чтобы вывести всю полезную информацию о ресурсе.
Если тег шаблона необходимо использовать в PHP-документе, то можно записать его в следующем виде: get_bloginfo (). Именно на основе этой функции работает тег, разница лишь в том, что она записывает результат в переменную, которую уже можно вывести на экран.
Исходный код тега находится в файле wp-includes/general-template.php, где можно найти все основные функции. В ядре системы WordPress он записан следующим со следующим синтаксисом:
function bloginfo( $show = ” ) { echo get_bloginfo( $show, ‘display’ ); }
Таким образом, главное отличие его от изначальной функции в наличие параметра ‘display’, который и отвечает за отображение результата на экране.
Давайте подробнее поговорим о данном теге шаблона и его возможностях в процессе создания темы. В ходе нашего урока мы разберем, какие есть варианты его использования на собственном сайте, а также виды параметров для эффективного применения. Все это позволит вам приблизиться к своему собственному шаблону.
Полезно: шаблон WordPress своими руками. Урок 2. Теги
Использование тега
Все данные, которые получает bloginfo (), извлекаются из основной информации о сайте, записанной в административной панели. Чтобы вывести информацию из базы данных на экран, следует использовать следующий синтаксис в PHP-файле: <? PHP bloginfo ($show);?>
Строковая переменная show представляет собой один из параметров тега. В ней может храниться зарезервированное значение, которое мы разберем в дальнейшем ходе нашего урока.
Стоит отметить, что bloginfo () является стандартным тегом шаблона. Он выводит данные после запуска через фильтр. Это означает, что дополнительно экранировать его не нужно, так как на безопасность системы это не повлияет, тем более, что мы планируем использовать его исключительно для отображения основной информации о ресурсе. С точки зрения безопасности темы тег шаблона никак не ухудшит ее показатели.
Полезно: как можно удалить определенные теги из записи на сайте WordPress
Параметры
Если не указать параметр для переменной $show или указать неизвестное для системы значение, то будет использован вариант по умолчанию. Он стандартно определяется значением «name». В этом случае тег будет выводить название вашего сайта, которое прописано в административной панели в настройках во вкладке «Общие». Помимо такого варианта, есть и другие возможности задания переменной $show.
Полезно : Шаблон WordPress своими руками. Урок 5. Работа с кодом
Строковые данные при этом извлекаются из БД таблицы системы под названием wp_options. Каждый элемент в ней обладает своим зарезервированным именем, которое и задается в скобках рядом с самим параметром. Давайте разберем все варианты характеристик тега, которые можно использовать в собственном шаблоне:
- name (blogname) позволяет вывести название сайта в том месте, где записан тег, а также может использоваться в сочетании с иными функциями HTML;
- description (blogdescription) отображает на экране краткое описание сайта, используемое в ходе работы поисковых систем;
- wpurl (siteurl) или site_url() предназначена для вывод адреса нахождения ресурса;
- url (home) или home_url() получает адрес сайта, прописанный в административной панели;
- admin_email (admin_email) генерирует на экране адрес электронной почти из общих настроек сервиса;
- text_direction или is_rtl () определяет направление текста на сайте;
- charset (blog_charset) доступен только для версий WordPress 3.5 и ниже, так как далее является стандартом кодировки UTF-8;
- version осуществляет взаимосвязь с файлом version.php из папки «includes», с его помощью можно увидеть текущую версию системы;
- html_type (html_type) или pre_option_html_type поможет узнать, какой именно Content-Type установлен на страничке;
- language дает информацию о используемом в системе языке;
- stylesheet_url или get_stylesheet_uri() отображает на экране URL-адрес главного стилевого файла шаблона;
- stylesheet_directory или get_stylesheet_directory_uri() позволяет узнать адрес директории, где расположены файлы стилей текущуй темы;
- template_url / template_directory или get_theme_root() или get_template() или get_template_directory_uri() или get_stylesheet_directory_uri() – все эти варианты выводят директорию задействованного шаблона (дочернего или родительского);
- pingback_url отображает адрес файла XML-RPC в виде активной ссылки;
- atom_url дает доступ к адресу Atom-канала;
- comments_atom_url показывает на страничке адреса комментариев Atom-канала;
- rdf_url необходим для получения адреса RDF/RSS 1.0-канала;
- rss_url отображает на экране RSS 0.92 –канал с его адресом;
- rss2_url нужен для генерации адреса RSS 2.0-канала;
- comments_rss2_url формирует URL для комментариев RSS 2.0-канала.
Все их можно подразделить на наиболее часто применяемые в практике и редко используемые. Вместо некоторых из параметров тега будет уместнее прописать другие функции WordPress, чтобы добиться лучшей производительности.
Полезно: как удалить базу категорий и тегов из URL-адреса
Примеры использования
Применять тег bloginfo () на сайте можно для самых различных задач. Давайте разберем основные варианты. Во-первых, с помощью данной функции можно вывести название сайта, заключив ее в тег <H1>. Таким образом, если вы измените значение этого поля в административной панели, то и на самих страничках появится новое название. Вторым вариантом можно задать отображение названия сайта в виде ссылки. Для этого потребуется добавить тег <a> с указание ссылки bloginfo(‘url’). Теперь при клике на его, посетитель будет оказываться на главной страничке вашего ресурса.
Полезно : Шаблон WordPress своими руками. Урок 4. Информация до разработки
Функция позволяет также выводить на сайте его описание. С ней можно легко опубликовать слоган, который уже задан в стандартных настройках ресурса, а также множество другой полезной информации. Этот процесс будет максимально автоматизирован и оптимизирован, что в последствие сократит время работы с сайтом и позволит лишний раз не задействовать программный код шаблона. Ведь настройки будут меняться через админку.
Тег шаблона не сильно нагружает сервер, показывая высокое быстродействие, поэтому не нужно бояться его использовать.
Функция bloginfo () достаточно простая по своей структуре. Она не создает лишней нагрузки на хостинг за счет частых обращений к базе данных. Благодаря этому, тег шаблона и получил такую распространенность в шаблонах, которые активно используются на WordPress. Ведь быстродействие ресурса является одним из ключевых характеристик отличного сайта.
Полезно: 10 топовых шаблонов для образовательного сайта 2019
Заключение
Третий урок из раздела «Шаблон WordPress своими руками» познакомил вас с одним из наиболее часто используемых тегов bloginfo (). Он представляет собой функцию с множеством параметров, которая открывает доступ к информации о сайте прямо из административной панели. Задавая те или иные значения, вы сможете опубликовать название, описание или ссылку на ваш сайт без лишних трудностей. Далее мы рассмотрим и другие подобные теги, без которых создание собственного шаблона было бы невозможным.
