sau / wp_template
Base template for Wordpress
2.0.2
2019-04-25 09:35 UTC
Requires
- php: >=7.0
- filp/whoops: ^2.1.9
- htmlburger/carbon-fields: 3.1.*
- sau/library: dev-master
- symfony/event-dispatcher: ^v3
- symfony/yaml: ^3
- tgmpa/tgm-plugin-activation: ~2.6.1
- twig/twig: ^2.4.4
README
Установка
composer create-project sau/wp_template {PROJECT_NAME}
где {PROJECT_NAME} название проэкта
Используемые пакеты
- 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
При внедрении планина были дописаны для него обёртки и в результате подключение новых полей свелось к вызову статического метода
Carbon::registerFields($path);
где $path путь к файлу с описанием полей относительно
Twig
В теме испорльзуется шаблонизатор twig.
Для удобства его использования были добавлены новые функции.
реальная_функция() => функция_twig()
WP
Реальные функции являются базовыми для wp их работу можно узнать из документации WP
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
Эти функции были добавлены для отладки. Обе выводят переменную в теге <pre>
pre() - использует для вывода print_r()
dump() - использует для вывода var_dimp()
Carbon Custom Fields
Функции обёртки для ccf. Документация по плагину тут
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()