sau/wp_template

Base template for Wordpress

Базовый каркас темы WP

Установка

composer create-project sau/wp_template {PROJECT_NAME}

где {PROJECT_NAME} название проэкта, _(*1)

Используемые пакеты

• twig/twig - шблонизатор
• htmlburger/carbon-fields - кастомные поля
• tgmpa/tgm -plugin-activation - для подключения в тему обязательных плагинов
• sau/library - вспомогательный пакет. Пакет по большей части является обёрткой стандартных методов WP для более простого их применения

Структура

• core - Базовая логика темы
• css - Файлы стили
• images - Изображения
• js - Скрипты
• l10n - Файлы переводов
• lib - Файлы расширений
• scss - scss файлы
• views - Шаблоны

Дирректория lib/

• extend_function.php - дополнение function.php
• carbon/ - описание полей ccf
• class/ - классы (namespace Sau\WP\Theme)
• function/ - собственные вспомогательные функции

Carbon Custom Fields

При внедрении планина были дописаны для него обёртки и в результате подключение новых полей свелось к вызову статического метода, _(*2)

Carbon::registerFields($path);

где $path путь к файлу с описанием полей относительно, _(*3)

Twig

В теме испорльзуется шаблонизатор twig., _(*4)

Для удобства его использования были добавлены новые функции., _(*5)

реальная_функция() => функция_twig()

WP

Реальные функции являются базовыми для wp их работу можно узнать из документации WP, _(*6)

wp_get_post_tags() => wp_get_post_tags()
have_posts() => have_posts()
the_post() => the_post()
get_posts() => get_posts()
the_excerpt() => the_excerpt()
the_excerpt() => the_introtext()
the_content() => the_content()
get_the_post_thumbnail_url() => get_post_thumbnail_url()
get_post_permalink() => get_post_permalink()
get_stylesheet_directory_uri() => theme_uri()
do_shortcode() => do_shortcode()
is_user_logged_in() => is_user_logged_in()
wp_footer() => wp_footer()
get_footer() => get_footer()
wp_head() => wp_head()
get_header() => get_header()
wp_get_attachment_image_url() => wp_attach_img_src()
language_attributes() => ln_attributes()
wp_nonce_field() => wp_nonce_field()

Template

Эти функции были добавлены для отладки. Обе выводят переменную в теге \, _(*7)

<, _(*8)

pre>, _(*9)

pre() - использует для вывода print_r()
dump() - использует для вывода var_dimp()

Carbon Custom Fields

Функции обёртки для ccf. Документация по плагину тут, _(*10)

carbon_get_term_meta() => crb_term()
carbon_get_post_meta() => crb_post()
carbon_get_comment_meta() => crb_com()
carbon_get_nav_menu_item_meta() => crb_nav()
carbon_get_user_meta() => crb_user()
carbon_get_the_post_meta() => crb_the_post()
carbon_get_theme_option() => crb_theme()

Ссылки

• https://carbonfields.net/docs
• https://twig.symfony.com/doc/2.x/