sau/wp_template

Base template for Wordpress

2.0.2 2019-04-25 09:35 UTC

This package is auto-updated.

Last update: 2024-04-04 18:23:06 UTC


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()

Ссылки