Создавал для себя ( С помощью ИИ ). Для РФ и Белоруссии не актуально так как в этих странах реклама Google AdSense не показывается.
Расширение создано специально что бы блокировать рекламу AdSense для пользователей подключённых через VPN, так как AdSense определяет такой трафик как недействительный, что грозить блокировкой аккаунта.
Обзор
Расширение VPN Detector для phpBB — это мощный инструмент, предназначенный для обнаружения пользователей VPN и автоматической блокировки рекламы Google AdSense для этих посетителей. Это помогает администраторам форума соблюдать политику Google AdSense и предотвращать потенциальные нарушения, которые могут привести к блокировке аккаунта.
Возможности
- Обнаружение VPN в реальном времени с помощью vpnapi.io
- Автоматическая блокировка Google AdSense для пользователей VPN
- Кэширование на стороне клиента для минимизации вызовов API
- Простая настройка через панель управления администратора phpBB
- Эффективная система кэширования на стороне сервера
- Бесшовная интеграция с phpBB 3.3.x
Требования
- phpBB 3.3.0 или выше
- PHP 7.1.3 или выше
- Действующий ключ API vpnapi.io
- Активная реализация Google AdSense
Установка
1. Загрузите расширение
2. Скопируйте папку `roma30/vpndetector` в каталог `ext/` вашего phpBB
3. Перейдите в `ACP -> Настроить -> Управление расширениями`
4. Найдите "VPN Detector" в разделе "Отключенные расширения"
5. Нажмите "Включить"
Конфигурация
1. Получите свой ключ API из [vpnapi.io](https://vpnapi.io/)
2. Перейдите в раздел `ACP -> Расширения -> Настройки VPN-детектора`
3. Введите свой API-ключ vpnapi.io
4. Нажмите «Отправить»
Как это работает
Расширение работает в несколько этапов:
1. **Обнаружение на стороне клиента**:
- Когда пользователь посещает ваш форум, расширение выполняет проверку VPN
- Результаты кэшируются в браузере на 5 минут, чтобы минимизировать вызовы API
2. **Обработка на стороне сервера**:
- Расширение выполняет вызов API к vpnapi.io для проверки IP посетителя
- Результаты кэшируются на сервере на 5 минут
- Ключ API надежно хранится в конфигурации phpBB
3. **Защита AdSense**:
- При обнаружении VPN расширение автоматически:
- Блокирует загрузку скриптов Google AdSense
- Удаляет все существующие элементы рекламы
- Предотвращает появление новых вставки рекламы
- Поддерживает чистый, свободный от рекламы опыт для пользователей VPN
Система кэширования
Расширение реализует двухуровневую систему кэширования:
1. **Кэш на уровне браузера**:
- Сохраняет результаты проверки VPN в хранилище браузера
- Длительность кэширования 5 минут
- Снижает нагрузку на сервер и вызовы API
2. **Кэш на уровне сервера**:
- Файлы JSON хранятся в `ext/roma30/vpndetector/cache/`
- Длительность кэширования 5 минут
- Предотвращает исчерпание квоты API
Устранение неполадок
Распространенные проблемы
1. **Ошибка «API key not configure»**:
- Убедитесь, что вы ввели свой API-ключ vpnapi.io в ACP
- Проверьте, действителен ли ключ
- Убедитесь, что ключ правильно сохранен в базе данных
2. **Проблемы с каталогом кэша**:
- Убедитесь, что каталог `cache` существует в `ext/roma30/vpndetector/`
- Убедитесь, что у вас есть необходимые разрешения на запись (chmod 777)
- Проверьте журналы сервера на наличие ошибок разрешений
3. **AdSense все еще отображается**:
- Очистите кэш браузера
- Убедитесь, что скрипт обнаружения VPN загружен
- Проверьте консоль браузера на наличие ошибок JavaScript
Рекомендации
1. **Управление ключами API**:
- Обеспечьте безопасность ключа API vpnapi.io
- Отслеживайте использование API
- Рассмотрите возможность обновления плана API, если у вас высокий трафик
2. **Конфигурация кэша**:
- Длительность кэша по умолчанию составляет 5 минут
- При необходимости отрегулируйте в зависимости от шаблонов трафика
- Отслеживайте нагрузку на сервер и использование API
3. **Оптимизация производительности**:
- Расширение разработано для минимизации влияния на загрузку страницы
- Кэширование на стороне клиента снижает нагрузку на сервер
- Кэширование на стороне сервера предотвращает чрезмерное использование API
Лицензия
Это расширение лицензировано только по GPL-2.0. Подробности см. в файле LICENSE.
Кредиты
- Обнаружение VPN на базе [vpnapi.io](https://vpnapi.io/)
- Разработано для программного обеспечения форума phpBB
- Создано Roma30
История версий
- 1.0.0 (2024-01-09)
- Первоначальный выпуск
- Базовое обнаружение VPN
- Блокировка AdSense
- Система кэширования
- Модуль ACP
Ключ API из [vpnapi.io] (https://vpnapi.io/) платный. Минимальная стоимость 19 $ в месяц за 10000 запросов в день. Но есть тест на 1000 запросов.
Язык: Английский.