Пълна документация
Съдържание
Преглед на плъгина
ContentAI Pro е революционен WordPress плъгин, който използва изкуствен интелект за автоматично генериране на SEO-оптимизирано съдържание. Плъгинът анализира съществуващото съдържание на вашия сайт, изгражда профил на бранда и създава ново съдържание в същия стил и тон.
Плъгинът е разработен от Stanchev SEO и е предназначен за блогове, корпоративни сайтове и онлайн магазини. Той автоматизира целия процес от анализ до публикуване, като гарантира високо качество и SEO оптимизация.
Основни функционалности
🧠 AI Анализ на бранда
При първоначална настройка плъгинът използва ChatGPT API за анализ на:
- Вече публикувани статии и страници в блога
- Tone of voice, стил и езикови особености
- Ключови теми, които вече са покривани
- Изграждане на вътрешен профил на бранда (tone/style guide)
🔍 Сканиране на съдържанието
Плъгинът периодично обхожда всички постове и категории за откриване на:
- Липсващи ключови теми
- Недостатъчно покрити въпроси
- Конкурентни ниши (чрез интеграция с Google Search Console API / Ahrefs API)
✍️ Генериране на ново съдържание
С помощта на ChatGPT API плъгинът автоматично създава статии:
- В същия стил като останалото съдържание
- Оптимизирани за SEO (Yoast, RankMath, All in One SEO)
- Директно попълва title, description, keywords, schema
- Следва Yoast/RankMath правила за 10/10 SEO score
📅 Планиране и публикуване
Позволява на администратора да избере:
- Автоматично публикуване по график
- Ръчен преглед преди публикуване
- Добавяне на вътрешни линкове към съществуващи статии
🛒 E-commerce Deep Analysis
Специални функции за онлайн магазини:
- Анализ на продукти и категории
- Генериране на рекламни статии, свързани с продукти
- Оптимизация за търговски ключови думи
- Интеграция с WooCommerce
🤖 AI Store Assistant
Интелигентен асистент за търсене на продукти:
- Търсене на реални продукти по описание
- Анализ на title, meta description
- Връщане на най-близкия наличен артикул
- Shortcode за вграждане в страници
Инсталация
Изисквания
- WordPress 5.0 или по-нова версия
- PHP 7.4 или по-нова версия
- MySQL 5.6 или по-нова версия
- Минимум 128MB PHP memory limit
- cURL разширение за PHP
- JSON разширение за PHP
- WooCommerce (за e-commerce функции)
Стъпки за инсталация
- Изтеглете плъгина от GitHub репозитория
- Качете папката
contentai-proв/wp-content/plugins/ - Активирайте плъгина от WordPress админ панела
- Отидете на ContentAI Pro > Settings за настройка
Настройка
ChatGPT API настройка
- Отидете на ContentAI Pro > Settings
- Въведете вашия OpenAI API ключ
- Изберете модел (gpt-3.5-turbo или gpt-4)
- Настройте максимални токени за отговор
SEO плъгин интеграция
Плъгинът автоматично открива и се интегрира с:
- Yoast SEO - Попълва meta title, description, focus keyword
- RankMath - Интегрира се с RankMath настройките
- All in One SEO - Поддържа AIOSEO функционалности
Настройки за генериране
- Брой статии на ден - Колко статии да генерира автоматично
- Дължина на статиите - Минимална и максимална дължина
- Тон на съдържанието - Формален, неформален, професионален
- Целева аудитория - За кого се пише съдържанието
Използване
Първоначална настройка
- Отидете на ContentAI Pro > Brand Analysis
- Натиснете "Start Brand Analysis"
- Изчакайте анализа да завърши (може да отнеме 5-10 минути)
- Прегледайте резултатите и настройките
Сканиране на съдържанието
- Отидете на ContentAI Pro > Content Scanner
- Изберете категории за сканиране
- Натиснете "Start Scan"
- Прегледайте откритите SEO пропуски
Генериране на съдържание
- Отидете на ContentAI Pro > Content Generator
- Изберете теми от предложените
- Настройте SEO параметрите
- Натиснете "Generate Content"
- Прегледайте и редактирайте генерираното съдържание
- Публикувайте или запазете като чернова
Планиране на съдържание
- Отидете на ContentAI Pro > Content Scheduler
- Създайте график за публикуване
- Изберете автоматично или ръчно публикуване
- Настройте уведомления
API интеграции
ChatGPT API
Основната интеграция с OpenAI ChatGPT за:
- Анализ на съществуващо съдържание
- Генериране на ново съдържание
- SEO оптимизация
- Търсене на продукти в Store Assistant
Google Search Console API
За анализ на SEO показатели:
- Ключови думи с висок потенциал
- Страници с ниска производителност
- Възможности за подобрение
Ahrefs API (опционално)
За конкурентен анализ:
- Анализ на конкурентни ключови думи
- Откриване на нови теми
- Следи за промени в SEO тенденциите
WooCommerce API
За e-commerce функции:
- Анализ на продукти и категории
- Генериране на рекламни статии
- Оптимизация за търговски ключови думи
SEO оптимизация
Yoast SEO правила (10/10 score)
- Ключова фраза в първия параграф - Автоматично поставяне
- Правилна дължина на meta title - 30-60 символа
- Правилна дължина на meta description - 120-160 символа
- Минимум 30% преходни думи - Автоматично добавяне
- Под 10% пасивен залог - Проверка и корекция
- Вътрешни и външни линкове - Автоматично добавяне
RankMath оптимизация
- Автоматично попълване на RankMath полета
- Генериране на schema markup
- Оптимизация за featured snippets
- Voice search оптимизация
Автоматична SEO проверка
Плъгинът автоматично:
- Проверява SEO резултата след генериране
- Дооптимизира текста ако резултатът не е 10/10
- Добавя липсващи елементи
- Корегира дължината на meta полетата
E-commerce функции
Deep Analysis за онлайн магазини
Специален модул за анализ на WooCommerce магазини:
- Анализ на продукти и техните описания
- Идентифициране на ключови думи за всеки продукт
- Откриване на пропуски в SEO оптимизацията
- Предложения за подобрение на продуктни описания
Рекламни статии
Автоматично генериране на блог статии, свързани с продукти:
- Статии за ползите от продуктите
- Сравнителни статии
- Ръководства за използване
- FAQ статии за продуктите
Продуктна оптимизация
- Автоматично подобряване на продуктни заглавия
- Генериране на SEO-оптимизирани описания
- Добавяне на релевантни ключови думи
- Създаване на meta данни за продуктите
AI Store Assistant
Функционалности
Интелигентен асистент за търсене на продукти:
- Търсене на продукти по естествен език
- Анализ на заявките с ChatGPT
- Намиране на най-близките налични продукти
- Предоставяне на релевантни предложения
Shortcode използване
Настройки
- Активиране/деактивиране на асистента
- Настройка на броя предложения
- Персонализиране на интерфейса
- Логиране на търсенията
Аналитика
Проследяване на:
- Най-често търсени продукти
- Неуспешни търсения
- Популярни заявки
- Конверсионни показатели
Файлова структура
ContentAI Pro/ ├── 📄 ai-content-writer.php # Главен файл на плъгина ├── 📄 README.md # Документация ├── 📄 RELEASE_NOTES_v1.0.0.md # Release notes ├── 📄 index.html # GitHub Docs ├── 📁 admin/ # Admin страници (8 страници) │ ├── 📄 dashboard.php # Главен дашборд │ ├── 📄 brand-analysis.php # Анализ на бранда │ ├── 📄 content-scanner.php # Сканиране на съдържание │ ├── 📄 content-generator.php # Генериране на съдържание │ ├── 📄 content-scheduler.php # Планиране на съдържание │ ├── 📄 ecommerce-analyzer.php # E-commerce анализ │ ├── 📄 store-assistant.php # AI Store Assistant │ └── 📄 settings.php # Настройки ├── 📁 includes/ # PHP класове (11 класа) │ ├── 📄 class-brand-analyzer.php # Анализ на бранда │ ├── 📄 class-content-scanner.php # Сканиране на съдържание │ ├── 📄 class-content-generator.php # Генериране на съдържание │ ├── 📄 class-content-scheduler.php # Планиране на съдържание │ ├── 📄 class-ecommerce-analyzer.php # E-commerce анализ │ ├── 📄 class-store-assistant.php # AI Store Assistant │ ├── 📄 class-store-assistant-shortcode.php # Shortcode функционалност │ ├── 📄 class-seo-optimizer.php # SEO оптимизация │ ├── 📄 class-seo-integration.php # SEO интеграция │ ├── 📄 class-scheduler.php # Общ планировчик │ ├── 📄 class-learning-system.php # Система за обучение │ └── 📄 class-database.php # База данни ├── 📁 assets/ # Статични файлове │ ├── 📁 css/ # Стилове │ │ ├── 📄 admin.css # Admin стилове │ │ └── 📄 store-assistant.css # Store Assistant стилове │ └── 📁 js/ # JavaScript │ ├── 📄 admin.js # Admin JavaScript │ └── 📄 store-assistant.js # Store Assistant JavaScript └── 📁 languages/ # Преводи (празна засега)
Технически детайли
Архитектура
Плъгинът използва модулна архитектура с отделни класове за всяка функционалност:
- Brand Analyzer - Анализ на съществуващо съдържание
- Content Scanner - Сканиране за SEO пропуски
- Content Generator - Генериране на ново съдържание
- SEO Optimizer - SEO оптимизация
- Learning System - Непрекъснато обучение
База данни
Плъгинът създава следните таблици:
contentai_brand_profiles- Профили на брандаcontentai_scheduled_content- Планирано съдържаниеcontentai_search_analytics- Аналитика на търсениятаcontentai_learning_data- Данни за обучение
API извиквания
Оптимизирани API извиквания с:
- Кеширане на отговори
- Batch обработка
- Rate limiting
- Error handling
Безопасност
- Nonce проверки за всички AJAX заявки
- Capability проверки за admin функции
- Sanitization на всички входни данни
- Escape на всички изходни данни
Отстраняване на проблеми
Често срещани проблеми
API грешки
- Проблем: "API key is invalid"
- Решение: Проверете API ключа в настройките
Медлено генериране
- Проблем: Генерирането отнема твърде много време
- Решение: Увеличете PHP memory limit и max execution time
SEO интеграция не работи
- Проблем: SEO плъгинът не се открива
- Решение: Уверете се, че SEO плъгинът е активиран
Debug режим
За активиране на debug режим, добавете в wp-config.php:
Логове
Плъгинът записва логове в:
- WordPress debug.log
- Плъгин логове в админ панела
- API заявки и отговори
Поддръжка и контакт
Поддръжка
- Безплатна поддръжка за основни проблеми
- Платена поддръжка за персонализация
- Обучение за използване на плъгина
- Консултации за SEO стратегия
Принос в проекта
Приветстваме приноса в проекта:
- Fork на репозитория
- Създаване на feature branch
- Pull request с описанието на промените
- Следване на coding standards
Обновления
- Автоматични обновления през WordPress
- Ръчни обновления от GitHub
- Уведомления за нови версии
- Changelog за всяка версия