README

🇷🇺 Русский | 🇬🇧 English

🚩 Feature Flags for EvolutionCMS CE 3

Manage feature flags with rules engine, statistics, and A/B testing — built for EvolutionCMS CE 3.

📦 Installation

cd /core
php artisan package:installrequire ambrion/evocms-feature-flags "v0.1.0-alpha"
php artisan vendor:publish --provider="EvolutionCMS\FeatureFlags\FeatureFlagsServiceProvider"
php artisan migrate

⚙️ Requirements

💡 Note: The module uses modern PHP 8.3 features (readonly classes, typed properties, match expressions). PHP 8.1–8.2 are not supported.

⚙️ Quick Start

1. Open Manager → Modules → Feature Flags in EvolutionCMS admin panel
2. Create your first feature flag
3. Use in your snippets:

if ($flags->isEnabled('my_flag', context: ['user_role' => 'manager'])) {
    // show the feature
}

🎯 Key Features

• ✅ Rule-based evaluation: Enable features by user role, document category, date, percentage, and more
• ✅ A/B Testing: Split traffic between variants with deterministic user assignment
• ✅ Statistics & Analytics: Track flag evaluations, export data, visualize distributions
• ✅ Admin UI: Manage flags directly in EvolutionCMS manager — no config file edits needed
• ✅ TDD-friendly: Domain-driven design, fully testable without Evo bootstrap

🔗 Documentation

• Feature Flags Core (engine)
• Author's website
• Telegram channel (RU)

📬 Support

• 🐛 Bug reports: GitHub Issues
• ✉️ Email: ping@ambrion.dev
• 💬 Telegram: @ambrion_dev

📜 License

MIT © Ambrion

💡 Note: For Russian documentation, see README.ru.md.