Added checkout customization parameters

Author: DanieleFreemius

includes/class-freemius.php

@@ -365,6 +365,15 @@ class Freemius extends Freemius_Abstract {
          */
         private $_is_bundle_license_auto_activation_enabled = false;
 
+        /**
+         * Developer-defined config overrides for checkout.
+         *
+         * @var array
+         */
+        protected $_checkout_config = [];
+
+        /**
+
         #region Uninstall Reasons IDs
 
         const REASON_NO_LONGER_NEEDED = 1;
@@ -5181,6 +5190,10 @@ private function parse_settings( &$plugin_info ) {
                 ) );
             }
 
+            if ( isset( $plugin_info['checkout'] ) && is_array( $plugin_info['checkout'] ) ) {
+                $this->_checkout_config = $this->validate_checkout_config( $plugin_info['checkout'] );
+            }
+
             $plugin = ( $this->_plugin instanceof FS_Plugin ) ?
                 $this->_plugin :
                 new FS_Plugin();
@@ -5322,6 +5335,93 @@ private function parse_settings( &$plugin_info ) {
             );
         }
 
+        /**
+         * Validates and filters developer-provided checkout config.
+         *
+         * @param array $config
+         *
+         * @return array
+         */
+        protected function validate_checkout_config($config)
+        {
+            $schema = [
+                    'cart'       => [
+                            'always_show_renewals_amount'   => 'bool',
+                            'annual_discount'               => 'bool',
+                            'billing_cycle'                 => ['string', 'int'],
+                            'bundle_discount'               => 'float',
+                            'maximize_discounts'            => 'bool',
+                            'multisite_discount'            => ['bool', 'string'], // string expected to be "auto"
+                            'show_inline_currency_selector' => 'bool',
+                            'show_monthly'                  => 'bool',
+                    ],
+                    'appearance' => [
+                            'form_position'          => 'string',
+                            'is_bundle_collapsed'    => 'bool',
+                            'layout'                 => 'string',
+                            'refund_policy_position' => 'string',
+                            'show_refund_badge'      => 'bool',
+                            'show_reviews'           => 'bool',
+                            'show_upsells'           => 'bool',
+                            'title'                  => 'string',
+                    ],
+            ];
+
+            $result = [];
+
+            foreach ($schema as $section => $fields)
+            {
+                if (isset($config[$section]) && is_array($config[$section]))
+                {
+                    foreach ($fields as $key => $expected_type)
+                    {
+                        if (array_key_exists($key, $config[$section]))
+                        {
+                            $value = $config[$section][$key];
+                            $types = is_array($expected_type) ? $expected_type : [$expected_type];
+                            $valid = false;
+
+                            foreach ($types as $type)
+                            {
+                                switch ($type)
+                                {
+                                    case 'bool':
+                                        if (is_bool($value))
+                                            $valid = true;
+                                        break;
+                                    case 'string':
+                                        if (is_string($value))
+                                            $valid = true;
+                                        break;
+                                    case 'int':
+                                        if (is_int($value))
+                                            $valid = true;
+                                        break;
+                                    case 'float':
+                                        if (is_float($value) || is_int($value))
+                                            $valid = true;
+                                        break;
+                                }
+                            }
+
+                            if ($valid)
+                                $result[$key] = $value;
+                        }
+                    }
+                }
+            }
+
+            return $result;
+        }
+
+        /**
+         * @return array
+         */
+        public function get_checkout_config()
+        {
+            return $this->_checkout_config;
+        }
+
         /**
          * @param string[] $options
          * @param string   $key

includes/managers/class-fs-checkout-manager.php

@@ -153,6 +153,11 @@ public function get_query_params( Freemius $fs, $plugin_id, $plan_id, $licenses
 				( $fs->is_theme() && current_user_can( 'install_themes' ) )
 			);
 
+            // Add developer-defined checkout overrides directly to context.
+            foreach ( $fs->get_checkout_config() as $key => $value ) {
+                $context_params[ $key ] = $value;
+            }
+
 			return array_merge( $context_params, $_GET, array(
 				// Current plugin version.
 				'plugin_version' => $fs->get_plugin_version(),

start.php

@@ -15,7 +15,7 @@
 	 *
 	 * @var string
 	 */
-	$this_sdk_version = '2.12.1.2';
+	$this_sdk_version = '2.12.1.3';
 
 	#region SDK Selection Logic --------------------------------------------------------------------