AI Film Recommender для DataLife Engine

AI Film Recommender додає на сайт окрему сторінку підбору фільмів та серіалів за текстовим запитом користувача. Запит може описувати настрій, жанр, бажану атмосферу, сюжет, країну виробництва, період випуску або іншу комбінацію умов.

Модуль не імпортує сторонні матеріали та не виводить твори, відсутні в базі сайту. AI використовується для формування списку рекомендацій, після чого модуль шукає відповідні публікації DLE та відображає лише знайдені записи.

Принцип роботи

1. Користувач надсилає текстовий запит через AJAX-інтерфейс модуля.
2. Запит доповнюється налаштуваннями каталогу сайту та інструкціями адміністратора.
3. Вибраний AI-провайдер повертає структурований список: оригінальна назва, локалізовані назви та рік випуску.
4. Модуль зіставляє отримані дані з публікаціями DLE за налаштованими додатковими полями та заголовком матеріалу.
5. Знайдені публікації виводяться через стандартний механізм show.short.php та вибраний TPL-шаблон.

Підтримувані AI-провайдери

• OpenAI (GPT) — окремий API-ключ, вибір моделі, веб-пошук, примусовий веб-пошук та налаштування глибини пошукового контексту.
• Google Gemini — окремий API-ключ, вибір моделі та веб-пошук через Google Search grounding.
• DeepSeek — окремий API-ключ та вибір моделі; вбудований веб-пошук для цього провайдера не використовується.

Каталог дозволених моделей зберігається всередині модуля. При виборі невідомої або застарілої моделі використовується модель за замовчуванням відповідного провайдера.

Налаштування промпту та тематики каталогу

Адміністратор задає контекст, у якому AI має формувати рекомендації. Доступні готові профілі:

• фільми та серіали різних країн;
• корейські дорами;
• аніме;
• турецькі серіали;
• індійське кіно;
• користувацький профіль.

Для будь-якого профілю можна вказати власний опис каталогу та додаткові інструкції. Це дозволяє враховувати спеціалізацію сайту, мову назв, склад бази та правила формування рекомендацій.

Зіставлення рекомендацій з базою DLE

• Впорядковані поля назв. Адміністратор вибирає кілька додаткових полів та задає їхній пріоритет. Першим вказується поле оригінальної назви, далі можна додати локалізовані назви та заголовок публікації як резервне джерело.
• Перевірка року випуску. Можна вибрати кілька полів року та налаштувати строгий, бажаний або вимкнений режим зіставлення.
• Структурована відповідь AI. При пошуку враховуються оригінальна назва, альтернативні назви та рік, а не лише один текстовий рядок.
• Детермінований вибір. При кількох збігах враховуються пріоритет джерела назви, відповідність року та ID публікації.
• Сумісність XFields. Для старих версій DLE підтримується формат xfields.txt, для нових — xfields.json та DLEXFields.

Відображення результатів

• Результати формуються з реальних публікацій сайту.
• Для карток можна вказати окремий TPL-шаблон без зміни основного shortstory.tpl.
• Підтримуються стандартні теги DLE та додаткові поля, що обробляються через show.short.php.
• Кількість рекомендованих результатів налаштовується в адміністративній панелі.
• Сторінка модуля має окремі SEO Title, Description та Keywords.

Кешування та обмеження запитів

• Відповіді AI зберігаються в структурованому JSON-кеші з урахуванням провайдера, моделі, режиму веб-пошуку, профілю сайту та інших параметрів запиту.
• Різні профілі та налаштування не використовують спільний кеш, навіть якщо користувач надіслав однаковий текст.
• Старий кеш попередніх версій читається лише в сумісному контексті та переноситься в новий формат.
• Для кожної групи користувачів задається окрема погодинна ліміт запитів.
• Лічильник збільшується лише після успішного отримання та формування результату.
• В адміністративній панелі доступний перегляд стану та безпечне очищення кешу модуля.

Проксі та мережеві запити

Для звернень до AI API можна увімкнути загальний проксі. Підтримуються HTTP, SOCKS5 та SOCKS5H, а також авторизація за ім'ям користувача та паролем. SOCKS5H виконує розпізнавання доменних імен через проксі.

URL та SEO-маршрути

• Модуль завжди доступний за внутрішньою адресою index.php?do=ai-film-recommender.
• Можна увімкнути окремий ЧПУ-префікс сторінки, наприклад /ai-films/.
• На DLE 19.0 та новіших правила модуля синхронізуються з rules.json.
• При синхронізації перевіряються конфлікти, створюється резервна копія та змінюються лише правила, що належать модулю.
• Для старих версій DLE в панелі виводяться правила для ручного налаштування веб-сервера.

Адміністративна панель

Панель керування оформлена стандартними компонентами DLE та розділена на три частини:

• Налаштування — провайдери, моделі, веб-пошук, проксі, профіль сайту, зіставлення полів, шаблон результатів, ліміти та SEO;
• Керування кешем — інформація про файли кешу, перевірка та очищення;
• URL та SEO-маршрути — налаштування та синхронізація ЧПУ.

API-ключі та пароль проксі не виводяться після збереження. Адміністративні дії перевіряють права доступу та токен user_hash.

Сумісність та вимоги

• DataLife Engine: 14.x–20.0.
• PHP: 7.4 та новіші.
• Розширення PHP: cURL, JSON, mbstring.
• AI API: потрібен ключ хоча б одного підтримуваного провайдера.
• База матеріалів: для точного пошуку необхідно налаштувати хоча б одне реальне додаткове поле оригінальної назви; поле року рекомендується, але не обов'язкове.

Особливості експлуатації

• Якість результату залежить від складу бази сайту, заповненості назв та року випуску, обраної моделі та тексту запиту користувача.
• Веб-пошук використовується лише провайдерами, які підтримують відповідний режим.
• Модуль виводить лише ті рекомендації, для яких знайдено відповідність серед публікацій сайту.
• Змінюваний файл конфігурації створюється після збереження налаштувань і не входить до інсталяційного архіву, тому оновлення модуля не перезаписує налаштування сайту.

Відео-прев'ю