Feature: Add Beta Feature Flags (#7242)

give.php

@@ -238,6 +238,7 @@ final class Give
         //TODO: merge this service provider
         Give\PaymentGateways\Gateways\ServiceProvider::class,
         Give\EventTickets\ServiceProvider::class,
+        Give\BetaFeatures\ServiceProvider::class,
     ];
 
     /**

src/BetaFeatures/Actions/RegisterSettingSection.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Give\BetaFeatures\Actions;
+
+/**
+ * @unreleased
+ */
+class RegisterSettingSection
+{
+    public function __invoke($sections)
+    {
+        $sections['beta'] = __('Beta Features', 'give');
+        return $sections;
+    }
+}

src/BetaFeatures/Actions/RegisterSettings.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Give\BetaFeatures\Actions;
+
+/**
+ * @unreleased
+ */
+class RegisterSettings
+{
+    public function __invoke($settings)
+    {
+        if('beta' !== give_get_current_setting_section()) {
+            return $settings;
+        }
+
+        return $this->getSettings();
+    }
+
+    protected function getSettings()
+    {
+        return [
+            ['id' => 'give_title_beta_features_1', 'type' => 'title'],
+            [
+                'name' => __('Event Tickets', 'give'),
+                'desc' => __(
+                    'If enabled, you’ll be get access to the event tickets feature where you can create and manage events, and link them to your donation form. Since this is in a beta, your feedback is crucial to help us improve and make the experience better before making it public.',
+                    'give'
+                ),
+                'id' => 'enable_event_tickets',
+                'type' => 'radio_inline',
+                'default' => 'enabled',
+                'options' => [
+                    'enabled' => __('Enabled', 'give'),
+                    'disabled' => __('Disabled', 'give'),
+                ],
+            ],
+            ['id' => 'give_title_beta_features_2', 'type' => 'sectionend'],
+        ];
+    }
+}

src/BetaFeatures/Facades/FeatureFlag.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Give\BetaFeatures\Facades;
+
+use Give\Framework\Support\Facades\Facade;
+
+/**
+ * @method static bool eventTickets()
+ * @method static bool enabled(string $feature)
+ */
+class FeatureFlag extends Facade
+{
+    protected function getFacadeAccessor()
+    {
+        return \Give\BetaFeatures\Repositories\FeatureFlagRepository::class;
+    }
+}

src/BetaFeatures/Repositories/FeatureFlagRepository.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Give\BetaFeatures\Repositories;
+
+class FeatureFlagRepository
+{
+    public function eventTickets(): bool
+    {
+        return $this->enabled('event_tickets', true);
+    }
+
+    public function enabled($feature, $default = false): bool
+    {
+        // Workaround so that the updated option is available at the start of the request.
+        $option = isset($_POST["enable_$feature"])
+            ? give_clean($_POST["enable_$feature"])
+            : give_get_option("enable_$feature", $default);
+
+        return give_is_setting_enabled($option);
+
+    }
+}

src/BetaFeatures/ServiceProvider.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Give\BetaFeatures;
+
+use Give\Helpers\Hooks;
+use Give\ServiceProviders\ServiceProvider as ServiceProviderInterface;
+
+/**
+ * @unreleased
+ */
+class ServiceProvider implements ServiceProviderInterface
+{
+    /**
+     * @unreleased
+     * @inheritDoc
+     */
+    public function register(): void
+    {
+        //
+    }
+
+    /**
+     * @unreleased
+     * @inheritDoc
+     */
+    public function boot(): void
+    {
+        Hooks::addFilter('give_get_settings_general', Actions\RegisterSettings::class);
+        Hooks::addFilter('give_get_sections_general', Actions\RegisterSettingSection::class);
+    }
+}

src/EventTickets/ServiceProvider.php

@@ -2,6 +2,7 @@
 
 namespace Give\EventTickets;
 
+use Give\BetaFeatures\Facades\FeatureFlag;
 use Give\EventTickets\Hooks\DonationFormBlockRender;
 use Give\EventTickets\Repositories\EventRepository;
 use Give\EventTickets\Repositories\EventTicketRepository;
@@ -21,6 +22,10 @@ class ServiceProvider implements ServiceProviderInterface
      */
     public function register(): void
     {
+        if( ! FeatureFlag::eventTickets() ) {
+            return;
+        }
+
         global $wpdb;
         $wpdb->give_events = "{$wpdb->prefix}give_events";
         $wpdb->give_event_tickets = "{$wpdb->prefix}give_event_tickets";
@@ -37,6 +42,10 @@ public function register(): void
      */
     public function boot(): void
     {
+        if( ! FeatureFlag::eventTickets() ) {
+            return;
+        }
+
         give( MigrationsRegister::class )->addMigrations([
             Migrations\CreateEventsTable::class,
             Migrations\CreateEventTicketTypesTable::class,

tests/Unit/BetaFeatures/Repositories/FeatureFlagRepositoryTest.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace Give\Tests\Unit\BetaFeatures\Repositories;
+
+use Give\BetaFeatures\Facades\FeatureFlag;
+use Give\Tests\TestCase;
+use Give\Tests\TestTraits\RefreshDatabase;
+
+class FeatureFlagRepositoryTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function testEventTicketsShouldBeEnabledByDefault()
+    {
+        $this->assertTrue(FeatureFlag::eventTickets());
+    }
+
+    public function testShouldReturnDisabledWhenNotSet()
+    {
+        $this->assertFalse(FeatureFlag::enabled('my_feature'));
+    }
+
+    public function testShouldReturnDisabledWhenNotEnabled()
+    {
+        give_update_option('enable_my_feature', false);
+
+        $this->assertFalse(FeatureFlag::enabled('my_feature'));
+    }
+
+    public function testShouldReturnEnabledWhenEnabled()
+    {
+        give_update_option('enable_my_feature', true);
+
+        $this->assertTrue(FeatureFlag::enabled('my_feature'));
+    }
+
+    public function testShouldReturnDisabledWhenSetInGlobal()
+    {
+        $_POST['enable_my_feature'] = 'disabled';
+
+        $this->assertFalse(FeatureFlag::enabled('my_feature'));
+    }
+
+    public function testShouldReturnEnabledWhenSetInGlobal()
+    {
+        $_POST['enable_my_feature'] = 'enabled';
+
+        $this->assertTrue(FeatureFlag::enabled('my_feature'));
+    }
+}