Pro Betting Tools — WordPress‑плагин с 12 беттинг‑калькуляторами и модульной архитектурой

Разработка модульного WordPress‑плагина “Pro Betting Tools” — 12 беттинг‑инструментов (калькуляторы, конвертеры, визуализации) с админкой, автодокументацией и подключением через шорткоды.

👨‍💻 Роль: Full-cycle Developer (Architecture, WP Admin, Frontend UI, Logic, QA)
🛠 Стек: WordPress (PHP), JavaScript, CSS (BEM), Shortcodes API
⚙️ Технологии: OOP, WP Settings API, wp_enqueue_script/style, wp_localize_script, JSON‑LD Schema (SEO), Chart.js (on‑demand), Jest (Unit Tests)
🚀 Результат: Готовый WP‑плагин с 12 инструментами для ставок, единым UI‑китом и системой расширения “utility‑modules”

💡 Задача

Цель проекта — создать SEO‑дружелюбный и расширяемый плагин WordPress для беттинг‑калькуляторов, который можно ставить на сайт и быстро подключать нужные инструменты через шорткоды. Я делал не “один калькулятор”, а платформу, куда легко добавлять новые модули без переписывания ядра.
Ключевые требования:

• 🧩 Модульность: каждый инструмент — отдельный модуль (utility) с единым контрактом, чтобы расширять плагин по принципу Open/Closed.
• ⚡ Быстрое подключение на страницы: шорткоды для вставки калькуляторов/виджетов в записи, страницы и лендинги.
• 🛠 Админка: глобальные настройки (валюта, формат коэффициентов) + вкладка с автогенерируемой документацией по всем инструментам.
• 🎨 Единый дизайн: аккуратный UI без конфликтов со стилями темы (BEM + CSS‑переменные).
• 🌍 Локализация: полностью русифицированный интерфейс и сообщения для пользователя.
• 🔎 SEO: добавление JSON‑LD schema для инструментов, подключенных через master‑шорткод, чтобы повысить качество сниппетов и доверие поисковиков.

🛠 Решение

1. Архитектура плагина: Core + Utility Modules

Плагин построен как “ядро + плагины внутри плагина”:

• Core отвечает за загрузку модулей, регистрацию шорткодов, подключение ассетов и общую инициализацию.
• Utilities — отдельные классы инструментов в папке utilities/, каждый реализует интерфейс IBettingUtility.
• UtilityLoader автоматически сканирует папку, валидирует классы и подключает только корректные модули.

✅ Плюс: чтобы добавить новый калькулятор ставок — достаточно создать новый utility‑класс (ядро не трогаем).
✅ Это ускоряет развитие проекта и снижает риск регрессий.

2. Шорткоды: единая точка подключения + legacy‑алиасы

Реализован master‑шорткод:

• [bet_tool type="..."] — универсальный формат для подключения любого инструмента по ID.

Параллельно сохранены legacy‑шорткоды для некоторых инструментов (например, [wpbet_margin_calc], [wpbet_simple_calc]), чтобы не ломать существующий контент.

3. 12 инструментов (калькуляторы и визуализаторы)

Внутри проекта реализовано 12 betting tools для WordPress:

• 1) Simple Bet Calculator — расчёт потенциальной прибыли и выплаты (stake / odds).
• 2) Margin Calculator — маржа букмекера + “честные” вероятности (2‑way / 3‑way рынки).
• 3) Odds Converter — конвертация коэффициентов: Decimal / Fractional / American.
• 4) Break‑Even Calculator — точка безубыточности + ROI и сравнение win rate.
• 5) Kelly Criterion — оптимальный размер ставки + стратегии (Full/Half/Quarter) и график роста банка (Chart.js).
• 6) Poisson Matrix (xG) — матрица вероятностей (точный счёт) + агрегированные 1X2 вероятности.
• 7) Dropping Odds — визуализация движения линии (Market Movement) и сдвига вероятностей.
• 8) System Bet Calculator — системы (“2 из 3”, “3 из 4”…), комбинации и логика Win/Lose/Void.
• 9) Surebet Calculator — вилки (2‑way / 3‑way), распределение ставок, отображение профита.
• 10) Hedging Calculator — хеджирование (Cash Out): режимы bookmaker/exchange + комиссия + слайдер распределения прибыли.
• 11) Asian Handicap — четвертные форы (0.25 / 0.75) с разбиением на половины и статусами Win/Void/Lose.
• 12) Synthetic DNB — синтетическая фора(0) из 1X с сравнением эффективного кэфа с линией БК.

4. UI‑kit и фронтенд‑логика

Чтобы интерфейс выглядел единообразно и быстро внедрялся на любые страницы сайта:

• сделан общий CSS design system (карточки, таблицы, input, кнопки, сетка) в стиле BEM;
• вынесены общие функции расчётов в JS Utility Library (нормализация ввода, округления, implied probability, конвертер odds, payout/profit);
• глобальные настройки (валюта и формат коэффициентов) прокидываются на фронт через wp_localize_script.

5. Админка: настройки + автодокументация

В админ‑панели WordPress добавлено меню “Инструменты ставок”:

• Настройки: валюта по умолчанию и формат коэффициентов.
• Документация: список всех загруженных инструментов, описание и готовые примеры шорткодов (копировать‑вставить).

6. SEO: JSON‑LD Schema для инструментов

Для калькуляторов, подключенных через [bet_tool], добавляется JSON‑LD разметка (тип WebApplication). Это полезно для SEO‑качества страницы с инструментами и повышает “понятность” контента для поисковых систем.

🧪 Тестирование

Логика на JavaScript покрыта unit‑тестами через Jest (отдельные тесты под большинство калькуляторов). Это позволяет спокойно менять формулы и UI‑поведение, не ломая расчёты на проде.

⚡ AI‑Augmented Workflow

В разработке я использовал AI‑инструменты как “второго пилота”:

• 🚀 Скорость: ускорение рутины (шаблоны модулей, тест‑кейсы, повторяющиеся UI‑блоки).
• 🛡️ Качество: помощь в поиске edge cases (округления, некорректные вводы, пограничные odds).
• 🧠 Архитектура: контроль разделения ответственности (core vs utilities, общие функции vs UI‑код).

📥 Попробовать

Плагин разработан специально для сайта 1sports.ru и попробовать его можно здесь.

Если нужно — могу помочь в разработке и доработке плагинов WordPress под ваш сайт: от архитектуры и админки до фронтенд‑калькуляторов, SEO‑разметки и тестирования.