Блог

Шпаргалка для тех кто работает с WordPress

Функции подключения темы:

ФункцияОписание действия кода
comments_template()Подгружает файл шаблона комментариев на странице записи. По умолчанию загружает файл: /comments.php из папки темы.
get_footer()Подключает файл footer.php из шаблона (темы). Если указано имя в параметре, то будет подключен файл: footer-{name}.php из шаблона темы.
get_header()Подключает файл шаблона header.php (шапку). Если передан параметр $name, то будет подключен файл header-{name}.php.
get_parent_theme_file_path()Получает полный путь от корня сайта до текущей темы (родительской, не дочерней). Не содержит слэш на конце.
get_parent_theme_file_uri()Получает URL указанного файла, который находится в родительской теме.
get_search_form()Подключает форму поиска, файл темы searchform.php. Если такого файла в шаблоне темы нет, то будет использован дефолтный код для формы поиска.
get_sidebar()Подключает файл шаблона sidebar.php (сайдбар). Если передан параметр $name, то будет подключен файл sidebar-{name}.php.
get_stylesheet_directory()Получает путь до папки темы — папки где находится текущий файл стилей родительской или дочерней темы. Не содержит закрывающего слэша /.
get_stylesheet_directory_uri()Получает URL текущей темы (дочерней если она используется или родительской). Не содержит / на конце. Учитывает SSL.
get_stylesheet_uri()Получает ссылку (URL) на файл стилей style.css текущей темы.
get_template_directory()Получает полный путь от корня сайта до текущей темы (родительской, не дочерней). Не содержит слэш на конце.
get_template_directory_uri()Получает URL родительской темы (вернет URL родительской темы, даже если используется дочерняя). Не содержит закрывающий слэш.
get_template_part()Ищет и подключает указанный файл темы. Похожа на PHP функцию include(), только не нужно указывать путь до темы.
get_theme_file_path()Получает путь до указанного файла темы. Учитывает дочерние темы.
get_theme_file_uri()Получает URL указанного файла темы. Учитывает дочерние темы.
get_theme_root_uri()Получает УРЛ каталога с темами. УРЛ не имеет заканчивающего слэша.
is_page_template()Проверяет используется ли для страницы файл шаблона. Можно указать название файла шаблона.
load_template()Подключает указанный файл в PHP, с помощью require_once.
locate_template()Находит наиболее подходящий серверный путь к указанному файлу шаблона. При поиске учитывается дочерняя тема. Можно указать, чтобы файл сразу подключался в PHP.

Файлы Темы (иерархия) /themes/ТЕМА/ :

style.cssФайл стилей темы (обязательный)
index.phpЛюбая страница без файла шаблона (обязательный)
front-page.phpГлавная страница
home.phpСтраница Постов (или Главная страница)
functions.phpСпециальный файл для .php функций (кода)
404.phpСтраница «не найдено»
comments.phpШаблон Комментариев (подключаемый)
header.phpШаблон Шапки сайта (подключаемый)
searchform.phpШаблон формы Поиска (подключаемый)
sidebar.phpШаблон Боковой панели (подключаемый)
footer.phpШаблон Подвала сайта (подключаемый)
single.phpЗапись (пост)
single-POST_TYPE.phpЗапись типа POST_TYPE
single-POST_TYPE-POST_NAME.phpЗапись POST_NAME типа POST_TYPE
singular.phpЗапись любого типа
page.phpПостоянная Страница
page-POST_NAME.phpСтраница с Именем POST_NAME
page-ID.phpСтраница с ID
attachment.phpСтраница Вложения
image.phpСтраница Вложения-картинки
archive.phpСтраница любого Архива
archive-POST_TYPE.phpСтраница Архива типа записи
search.phpСтраница Поиска
category.phpСтраница Рубрики
category-ID.phpСтраница Рубрики с id
tag.phpСтраница Метки
tag-ID.phpСтраница Метки с id
taxonomy.phpСтраница любого Термина
author.phpСтраница постов Автора

Шаблон записи из любого файла:
<?php
/*
Template Name: Мой шаблон страницы
Template Post Type: post, page, product
*/
// … остальной код шаблона

Функции для темы (теги шаблона):

Теги шаблона — это функции, которые задумывались специально для использования в теме (шаблоне). Такие функции расположены в файлах:

  • wp-includes/general-template.php
  • wp-includes/author-template.php
  • wp-includes/bookmark-template.php
  • wp-includes/category-template.php
  • wp-includes/comment-template.php
  • wp-includes/link-template.php
  • wp-includes/post-template.php
  • wp-includes/post-thumbnail-template.php
  • wp-includes/nav-menu-template.php
home_url()Получает URL главной страницы сайта
site_url()Получает URL админки-сайта
wp_get_document_title()Получает заголовок страницы для <title>
the_archive_title()Выводит заголовок архивной страницы: метка, рубрика, дата
single_term_title()Выводит/получает заголовок страницы термина
single_post_title()Выводит/получает заголовок страницы записи
single_cat_title()Выводит/получает заголовок страницы рубрики/метки
body_class()Выводит css классы для тега <body>
wp_body_open()Запускает хук wp_body_open. Используется сразу после <body>
wp_head()Запускает хук wp_head. Для файла header.php
wp_footer()Запускает хук wp_footer. Для файла footer.php
wp_list_categories()Выводит список категорий в виде ссылок
wp_dropdown_categories()Выводит выпадающий список рубрик/таксономий
wp_list_comments()Выводит/получает комментарии записи
comment_form()Выводит форму комментирования
wp_tag_cloud()Выводит/получает облако меток
register_sidebar()Регистрирует панель виджетов
register_sidebars()Регистрирует панели виджетов (сразу несколько)
wp_nav_menu()Выводит произвольное меню, созданное в админке
register_nav_menu()Регистрируется одно место для меню
register_nav_menus()Регистрируется несколько мест для меню
wp_get_attachment_image()Получает IMG тег картинки
wp_get_attachment_image_src()Получает данные картинки: URL/ширина/высота
wp_get_attachment_image_url()Получает URL картинки по ID
category_description()Получает описание рубрики
term_description()Получает описание термина
get_the_term_list()Выводит список терминов записи в виде ссылок
get_avatar()Получает html код аватара, тег <img>
next_post_link()Выводит ссылку на следующую по дате запись
previous_post_link()Выводит ссылку на предыдущий по дате запись
wp_link_pages()Выводит пагинацию для многостраничных записей <!—nextpage—>
the_post_navigation()Выводит HTML блок ссылок на следующую/предыдущую записи
wp_get_archives()Выводит ссылки на страницы архивов по дате: дни, месяцы, годы
wp_login_form()Выводит HTML код формы входа
edit_tag_link()Выводит ссылку на редактирование текущей метки
Теги
Кнопка «Наверх»
Закрыть
Закрыть