Общая информация

Системные требования

Назначение плагина

Blocksee Assistant — это комплексный плагин для фронтенд-редактирования WordPress сайтов, построенных на ACF Flexible Content. Плагин позволяет редактировать содержимое страниц прямо с фронтенда без необходимости заходить в административную панель WordPress.

Основные возможности

• Визуальный редактор блоков — управление ACF Flexible Content блоками прямо с фронтенда
• AI-генерация контента — интеграция с внешним AI API для автоматической генерации текстов
• SEO-менеджер — редактирование meta-тегов, интеграция с Yoast SEO, Rank Math, SEO Classic
• Управление шапкой и подвалом — смена и настройка header/footer блоков
• Менеджер контактов — централизованное управление контактными данными по регионам
• Drag & drop сортировка — изменение порядка блоков перетаскиванием

Структура файлов плагина

blocksee-assistant/
├── blocksee-assistant.php              # Главный файл плагина
└── modules/
    └── front-reordering/
        ├── class-front-reordering.php      # Главный класс модуля
        ├── class-navigator.php             # Боковая панель навигации
        ├── class-blocks-manager.php        # Управление блоками
        ├── class-assets-manager.php        # Подключение CSS/JS
        ├── class-editable-blocks.php       # Редактируемые блоки
        ├── class-editable-blocks-base.php  # Базовый класс блоков
        ├── class-editable-blocks-form.php  # Формы редактирования
        ├── class-editable-blocks-render.php # Рендеринг блоков
        ├── class-ai-content-manager.php    # AI-генерация контента
        ├── class-seo-manager.php           # SEO управление
        ├── class-seo-extractor.php         # Парсинг SEO с внешних URL
        ├── class-headers-manager.php       # Управление шапками
        ├── class-headers-editor.php        # Редактор шапок
        ├── class-footers-manager.php       # Управление подвалами
        ├── class-footers-editor.php        # Редактор подвалов
        ├── class-contacts-manager.php      # Управление контактами
        ├── class-default-field-injector.php # Инжектор полей по умолчанию
        ├── class-acf-cache.php             # Кэширование ACF данных
        ├── includes/
        │   ├── form/                       # Классы для форм
        │   │   ├── class-form-ajax-handlers.php
        │   │   ├── class-form-settings-handlers.php
        │   │   ├── class-form-field-renderer.php
        │   │   └── class-form-data-processor.php
        │   ├── fields/                     # Рендереры полей ACF
        │   │   ├── checkbox-field.php
        │   │   ├── radio-field.php
        │   │   ├── select-field.php
        │   │   ├── image-field.php
        │   │   ├── gallery-field.php
        │   │   ├── repeater-field.php
        │   │   ├── taxonomy-field.php
        │   │   └── ...
        │   └── utilities/                  # Вспомогательные функции
        │       ├── text-formatter.php
        │       └── url-download-handler.php
        ├── css/                            # Стили (debug режим)
        ├── js/                             # JavaScript (debug режим)
        └── dist/                           # Минифицированные ресурсы (production)

Основные компоненты

1. Navigator (class-navigator.php)

Боковая панель для управления структурой страницы. Появляется при нажатии на кнопку-шестерёнку в правом нижнем углу страницы.

Функционал:

• Отображение списка всех блоков на странице
• Drag & drop сортировка блоков
• Добавление новых блоков из каталога
• Удаление блоков
• Быстрый переход к редактированию блока
• Переключатель скрытия стандартного заголовка (breadcrumbs)

2. AI Content Manager (class-ai-content-manager.php)

Модуль генерации контента с помощью искусственного интеллекта.

Endpoint API:

https://lk.blocksee.ru/api.php

Возможности:

• Генерация нового контента по промпту
• Редактирование существующего текста (исправление ошибок, сокращение, улучшение)
• Анализ прикреплённых изображений
• Два режима генерации: обычный (temperature 0.2) и креативный (temperature 0.8)
• Выбор конкретных полей для генерации

3. SEO Manager (class-seo-manager.php)

Комплексное управление SEO-параметрами страницы.

Возможности:

• Редактирование SEO Title и Meta Description
• AI-генерация SEO-текстов на основе контента страницы
• Извлечение SEO-данных с конкурентных страниц по URL
• Редактирование заголовка страницы (H1)
• Изменение названия компании
• Счётчик символов для контроля длины

Интеграция с SEO-плагинами:

• Yoast SEO
• Rank Math
• SEO Classic Blocksee

4. Blocks Manager (class-blocks-manager.php)

Управление каталогом доступных блоков.

Категории блоков:

5. Headers/Footers Manager

Управление шапкой и подвалом сайта через ACF Flexible Content поля flex_headers и footer_flex с опцией 'option'.

6. Contacts Manager (class-contacts-manager.php)

Централизованное управление контактными данными.

Социальные сети и мессенджеры (глобальные настройки):

• WhatsApp, Telegram, MAX
• ВКонтакте, Одноклассники, Дзен
• YouTube, RuTube, Pinterest

Региональные контакты:

• До 3 телефонов с подписями
• До 2 email-адресов с подписями
• До 2 адресов с подписями
• До 2 режимов работы с подписями

AJAX Actions

REST API Endpoints

Namespace: blocksee/v1

Права доступа

Функционал плагина доступен пользователям, имеющим хотя бы одно из следующих прав:

• edit_pages — редактирование страниц
• edit_posts — редактирование записей
• manage_categories — управление категориями

Для управления контактами требуется право manage_options.

Внешние зависимости

Поддерживаемые типы полей ACF

Поддерживаемые типы контента

Плагин работает на следующих типах страниц:

• Страницы (is_page())
• Записи (is_single())
• Категории (is_category())
• Таксономии (is_tax())
• Товары WooCommerce (is_product(), is_singular('product'))

Режим отладки

Для включения режима отладки необходимо определить константу в wp-config.php:

define('BLOCKSEE_DEBUG', true);

В режиме отладки загружаются несжатые CSS и JS файлы из папок css/ и js/ вместо минифицированных из dist/.

Локализация JavaScript

Плагин создаёт следующие глобальные JavaScript объекты:

• blockseeNavigator — настройки навигатора
• blockseeBlocksManager — настройки менеджера блоков
• blockseeEditableBlocks — настройки редактируемых блоков
• blockseeHeadersManager — настройки менеджера шапок
• blockseeHeadersEditor — настройки редактора шапок
• blockseeFootersManager — настройки менеджера подвалов
• blockseeFootersEditor — настройки редактора подвалов
• blockseeContactsManager — настройки менеджера контактов

Хуки и фильтры

Actions

• blocksee_assistant_initialized — срабатывает после полной инициализации плагина

Filters

• blocksee_editable_blocks — массив поддерживаемых layout-ов для редактирования
• blocksee_ai_excluded_fields — массив полей, исключённых из AI-генерации

Мета-поля

Плагин использует следующие мета-поля:

Требования к теме

Для корректной работы плагина тема WordPress должна:

1. Использовать ACF Flexible Content с полем flex_content
2. Иметь шаблоны блоков в папке parts/sections/{layout}.php или parts/blocks/{layout}.php
3. Использовать ACF Flexible Content поля flex_headers и footer_flex для шапки и подвала (опционально)
4. Иметь кастомный тип записи regions с мета-полем regiondomain для мультирегиональности (опционально)

Установка

1. Загрузите папку blocksee-assistant в директорию /wp-content/plugins/
2. Убедитесь, что установлены и активированы плагины ACF Pro и ACF Extended
3. Активируйте плагин через меню «Плагины» в WordPress
4. Откройте любую страницу на фронтенде — в правом нижнем углу появится кнопка-шестерёнка

Обновление

Плагин поддерживает автоматические обновления через собственный сервер обновлений. При наличии новой версии уведомление появится в стандартном интерфейсе обновлений WordPress.