You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

90 lines
5.3 KiB

# la-Components-wp
## Описание
Набор готовых компонентов для Wordpress (tailpress-theme)
## Компоненты:
**language-switcher.php**
: Переключает язык темы, либо филиалы сайта, если они реализованы через Polylang плагин
**navigation-menu.php**
: Выводит навигационное меню, по умолчанию используется меню "Шапка сайта", добавлена сео разметка (бредкрамсы и прочее), так как Yoast или другой seo плагин сюда не подцепится.
**footer.php**
: Скелетон компонент футера
## Блоки
**hero-block.php**
: Заглавный блок, добавлен без скелетона, для примера вёрстки, стилей и скриптов, есть слайдер и текст из ацф полей. Присутствует лайтбокс.
**gallery-tabs.php**
: Галерея-слайдер с табами, схожа с reviews-block.php, но есть различия в полях и коде
**reviews-block.php**
: Галерея с отзывами - галерея-слайдер с табами, есть возможность загружать видеоотзывы и отзывы в виде изображений.
**contacts-block.php**
: Блок с контактами и яндекс картой, карта подгружена через библиотеку, для возможности стилизации, поддерживается собственная свг иконка для отметки локации, настроено смещение, активация карты по клику, чтобы не блокировать скрол на мобилках. Контейнер с адресом заполняемый через ацф-поле.
**club-card.php**
: Блок выводит кастомный пост тайп, в текущей реализации есть надстройка через Polylang, чтобы выводить посты относящиеся к выбранному языку
**Формы**
: Блоки формы предлагаю делать через плагин fluent forms, выглядит самым гибким из всех существующих, есть невидимые инпуты, чтобы не мучаться в вёрсткой (верстаем обычные инпуты, затем делаем форму с невидимыми инпутами в плагине и просто заполняем их контентом из сверстанных блоков) и хорошая настройка
## Остальное
**modals.php и js/modals.js**
: Система вывода модалок, создает в футере, общий компонент обертку для модалок, куда потом выводится контент из php-файлов в modals директории.
: Создаем php-файл в modals с префиксом modal, например modal-example.php c любым содержимым (```<div>Контент</div>``` / ```echo do_shortcode('[fluentform id="1"]')```), затем его можно будет вызывать через button с дата ```data-modal="example"```
: Есть скелетоны-примеры нескольких модалок
**blocks.php**
: Файл для регистрации ацф-блоков, есть примеры. Скрипты подключаются через enqueue_scripts в блоке, библиотеки предлагаю по возможности подключать там же, чтобы не грузилась бибилотека если нет блоков используемых ее (как исключение swiper.js или другие библиотеки требуемые в нескольких блоках)
## Установка
### Как отдельный репозиторий
```bash
git clone https://git.good-production.xyz/Good-Production/la-components-wp.git
```
### Как git subtree в проект
```bash
git remote add la-components https://git.good-production.xyz/Good-Production/la-components-wp.git
git subtree add --prefix=template-parts/la-components la-components main
```
## Использование
### В коде
```php
get_template_part('template-parts/la-components/footer');
```
### Блоки
Блоки создаются в отдельную категорию и выводятся через gutenberg редактор
### Обновление компонентов в проекте
```bash
git subtree pull --prefix=template-parts/la-components la-components main
```
## Разработка
Подключить в тему файлы с функциями из компонентов:
```
$modal_file = get_template_directory() . '/template-parts/la-components/functions/modals.php';
$block_file = get_template_directory() . '/template-parts/la-components/functions/blocks.php';
if (file_exists($block_file)) {
require_once $block_file;
}
if (file_exists($modal_file)) {
require_once $modal_file;
}
```
И дальше по аналогии.