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
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;
|
|
}
|
|
```
|
|
|
|
И дальше по аналогии. |