# LinkMesh FAQ Redesign — Анализ архитектуры и предложение ## 1. Анализ текущего состояния ### 1.1 Что есть сейчас | Расположение | Файл | Тип контента | Статус | |----------|------|-------------|--------| | Плагин | [`admin/class-ailm-faq-tab.php`](../admin/class-ailm-faq-tab.php) | Встроенная справка — 6 вкладок с детальными руководствами + скриншоты | **Production** — но отсутствуют модули (Dashboard, Review Queue, Gutenberg Sidebar, PageRank) | | Лендинг | [`faq.html`](../../Downloads/project-bolt-sb1-zq57uuag/project/faq.html) | Пресейл-FAQ — цены, безопасность, совместимость, поддержка (17 вопросов, аккордеон, schema.org FAQPage) | **Production** | | Лендинг | [`documentation.html`](../../Downloads/project-bolt-sb1-zq57uuag/project/documentation.html) | Заглушка — "Documentation Portal" с фиктивным текстом Quick Start / Auth / Rate Limits | **Заглушка — требуется полная переработка** | ### 1.2 Архитектура плагина — все модули Плагин содержит следующие модули. Текущий FAQ покрывает только **6 из 10**: | # | Модуль | В текущем FAQ? | PHP-класс | |---|--------|:---:|---| | 1 | **Dashboard** (Performance + Unified Table) | ❌ Нет | `class-ailm-dashboard-admin.php` | | 2 | **Bulk Settings** (General + Category Rules + Simulation) | ✅ "General Settings" | `class-ailm-settings-tab.php` | | 3 | **Orphan Rescue** | ✅ | `class-ailm-orphan-admin.php` | | 4 | **Keyword Intelligence** | ✅ | `class-ailm-ki-admin.php` | | 5 | **404 Scout** | ✅ | `class-ailm-scout-admin.php` | | 6 | **Click Stats** | ✅ | `class-ailm-clicks-admin.php` | | 7 | **Links Report** (старая вкладка Stats) | ✅ "Links Report" | `class-ailm-stats-tab.php` | | 8 | **Review Queue** (Semantic Link Queue) | ❌ Нет | `class-ailm-review-queue-admin.php` | | 9 | **Semantic Engine** (AI Smart Link Generator — модальное окно) | ❌ Нет | `class-ailm-semantic-init.php` | | 10 | **Gutenberg Sidebar** (боковая панель в редакторе) | ❌ Нет | `class-ailm-gutenberg-sidebar.php` | | 11 | **PageRank** (колонка AILM Rank) | ❌ Нет | `class-ailm-pagerank.php` | ### 1.3 Текущая структура FAQ в плагине ```php $sections = [ 'general' => 'General Settings', // Обзор + руководство по Bulk Settings 'orphan' => 'Orphan Rescue', // 3-шаговый процесс 'reports' => 'Links Report', // Распределение ссылочного веса 'clicks' => 'Click Stats', // Аналитика кликов 'ki' => 'Keyword Intelligence', // LSI / N-grams 'scout' => '404 Scout' // Мониторинг битых ссылок ]; ``` Реализовано как горизонтальные кнопки-вкладки, переключающие div-блоки через jQuery. Каждая вкладка — длинное руководство со скриншотами. --- ## 2. Стратегическое решение (ОБНОВЛЕНО) ### Исходный вопрос: Должен ли Plugin FAQ = Website Documentation? **Ответ: НЕТ. Но есть более радикальное решение.** Вместо того чтобы поддерживать два набора документации (в плагине и на сайте), предлагается: ### ✅ Новая стратегия: Единый источник документации — сайт ``` Плагин (WordPress) Лендинг (linkmesh.co) ┌─────────────────────────┐ ┌──────────────────────────────┐ │ │ │ │ │ LinkMesh → FAQ / Help │ │ documentation.html │ │ ┌───────────────────┐ │ │ ┌────────────────────────┐ │ │ │ │ │ │ │ 🚀 Quick Start │ │ │ │ 📖 Open Full │ │ │ │ 📖 Core Concepts │ │ │ │ Documentation ───┼──┼────────▶│ │ ⚙️ Module Guides │ │ │ │ (linkmesh.co/docs)│ │ │ │ 🔧 Advanced │ │ │ │ │ │ │ │ 🐛 Troubleshooting │ │ │ │ ❓ Quick FAQ │ │ │ │ 📝 Changelog │ │ │ │ (linkmesh.co/faq) │ │ │ └────────────────────────┘ │ │ └───────────────────┘ │ │ │ │ │ │ faq.html (пресейл-FAQ) │ │ Ссылки также │ │ ┌────────────────────────┐ │ │ добавлены в: │ │ │ 💰 Pricing & Billing │ │ │ • Dashboard (хедер) │ │ │ 🔒 Security & Privacy │ │ │ • Каждую страницу │ │ │ 📞 Support │ │ │ модуля (хедер) │ │ └────────────────────────┘ │ └─────────────────────────┘ └──────────────────────────────┘ ``` ### Почему это правильное решение: 1. **Единый источник правды (Single Source of Truth)**: Документация живет в одном месте — на сайте. Любое изменение применяется мгновенно, без необходимости выпускать обновление плагина. 2. **Никакого дублирования**: Не нужно синхронизировать PHP + i18n с HTML. Одна кодовая база. 3. **SEO**: Документация на сайте индексируется Google и приводит органический трафик. Документация внутри плагина (за логином WordPress) не индексируется. 4. **Мгновенные обновления**: Обновил страницу на сайте — пользователи сразу видят изменения. С плагином пришлось бы ждать релиза и обновления у всех пользователей. 5. **Богатый контент**: На сайте можно использовать видео, интерактивные элементы, любые JS-библиотеки. В плагине мы ограничены WordPress API и стилями админки. 6. **Аналитика**: Можно отслеживать через Google Analytics, какие разделы документации самые популярные. 7. **Удобство для пользователя**: Пользователь открывает документацию в новой вкладке браузера — может одновременно смотреть документацию и работать в плагине. ### Что меняется в плагине: Вместо тяжелой страницы FAQ с 6+ вкладками и сотнями строк PHP — легкая страница-хаб со ссылками: - **Текущий подход**: `class-ailm-faq-tab.php` — 448 строк PHP, 6 вкладок, jQuery, скриншоты - **Новый подход**: Легкая страница с: - Кнопка "📖 Open Full Documentation" → `https://linkmesh.co/documentation.html` - Кнопка "❓ Frequently Asked Questions" → `https://linkmesh.co/faq.html` - Краткая информация о поддержке (`support@linkmesh.co`) - Дополнительно: иконка "?" в хедере каждой страницы модуля, ведущая на соответствующий раздел документации --- ## 3. Структура Website Documentation (documentation.html) Единый портал документации. Структура: ``` documentation.html ├── 🚀 Быстрый старт │ ├── Установка плагина │ ├── Активация и лицензионный ключ │ └── Первая ссылка за 5 минут ├── 📖 Основные концепции │ ├── Как работает LinkMesh (модель Static Freeze) │ ├── Simulation vs. Freeze │ └── Безопасность верстки (Layout Protection, HTML Parser) ├── ⚙️ Руководства по модулям │ ├── Dashboard & PageRank │ ├── Bulk Settings & Category Rules │ ├── Orphan Rescue │ ├── Keyword Intelligence │ ├── 404 Scout │ ├── Click Stats │ ├── Review Queue & AI Generator │ └── Gutenberg Sidebar ├── 🔧 Продвинутые темы │ ├── Поддержка Custom Post Types │ ├── Совместимость с Elementor │ ├── CSV Import/Export │ ├── WP-Cron и фоновая обработка │ └── Рекомендации по производительности ├── 🔌 API Reference (на будущее) ├── 🐛 Устранение неполадок │ ├── Ссылки не появляются │ ├── Расхождение симуляции и реальности │ ├── Проблемы с балансом токенов │ └── Частые сообщения об ошибках └── 📝 Changelog ``` --- ## 4. Website FAQ (faq.html) — оставить почти как есть Текущий [`faq.html`](../../Downloads/project-bolt-sb1-zq57uuag/project/faq.html) хорошо работает как пресейл-FAQ. Структура: ``` faq.html ├── О LinkMesh (Что это, платформы, большие сайты) ├── Начало работы (Пробный период, существующие ссылки, удаление) ├── Цены и планы (Annual vs LTD, возврат, истечение, апгрейд, перенос) ├── Продукт и возможности (Поддерживаемые редакторы, типы контента, ручное управление, производительность) ├── Безопасность и конфиденциальность (Обработка данных, TLS, удаление данных) └── Поддержка (Время ответа, контакты) ``` ### Мелкие улучшения: 1. Добавить перекрестную ссылку: "📖 Подробные руководства — в [Documentation](documentation.html)." 2. Добавить 1-2 вопроса о новом Semantic Engine / AI-функциях. 3. Поддерживать schema.org FAQPage разметку в актуальном состоянии. --- ## 5. План действий | # | Задача | Где | Приоритет | |---|--------|-----|:---:| | 1 | Заменить `class-ailm-faq-tab.php` на легкую страницу-хаб со ссылками на сайт | Плагин | 🔴 HIGH | | 2 | Добавить иконки "?" в хедеры страниц модулей плагина | Плагин | 🔴 HIGH | | 3 | Написать полную документацию на сайте | `documentation.html` | 🟡 MEDIUM | | 4 | Обновить пресейл-FAQ (мелкие правки) | `faq.html` | 🟢 LOW | --- ## 6. Как будет выглядеть FAQ в плагине (новая концепция) Вместо текущих 6 вкладок с руководствами — одна чистая страница: ``` ┌─────────────────────────────────────────────────────────┐ │ LinkMesh: Semantic AI Internal Linking — Help │ │ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ 📖 Full Documentation │ │ │ │ Complete guides for every module: Dashboard, │ │ │ │ Bulk Settings, Orphan Rescue, Keyword │ │ │ │ Intelligence, 404 Scout, Click Stats, │ │ │ │ Review Queue, Gutenberg Sidebar, and more. │ │ │ │ [Open Documentation →] linkmesh.co/docs │ │ │ └─────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ ❓ Frequently Asked Questions │ │ │ │ Pricing, billing, security, compatibility, │ │ │ │ and more. │ │ │ │ [Open FAQ →] linkmesh.co/faq │ │ │ └─────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ 📧 Need Help? │ │ │ │ Contact support@linkmesh.co │ │ │ │ We respond within 24 hours, 6 days a week. │ │ │ └─────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────┘ ``` А также в хедере каждой страницы модуля — иконка `?` с ссылкой на соответствующий раздел документации: ``` Dashboard → linkmesh.co/documentation.html#dashboard Bulk Settings → linkmesh.co/documentation.html#bulk-settings Orphan Rescue → linkmesh.co/documentation.html#orphan-rescue ...и т.д. ```