Hookable.php
4 years ago
LegacyFormSettingCompatibility.php
4 years ago
Options.php
3 years ago
Scriptable.php
4 years ago
LegacyFormSettingCompatibility.php
147 lines
| 1 | <?php |
| 2 | |
| 3 | namespace Give\Form\Template; |
| 4 | |
| 5 | use Give\Form\Template; |
| 6 | use Give\Helpers\Form\Utils; |
| 7 | |
| 8 | /** |
| 9 | * Class LegacyFormSettingCompatibility |
| 10 | * |
| 11 | * @package Give\Form\Template |
| 12 | * @since 2.7.0 |
| 13 | */ |
| 14 | class LegacyFormSettingCompatibility |
| 15 | { |
| 16 | /** |
| 17 | * Name of key which we are using in field description to connect template setting with legacy setting. |
| 18 | * |
| 19 | * @var string |
| 20 | */ |
| 21 | public static $key = 'mapToLegacySetting'; |
| 22 | |
| 23 | /** |
| 24 | * Map legacy setting key name to template function/property from which you will get donation form configuration about different features. |
| 25 | * |
| 26 | * @var array $mapToTemplateProperty Form settings default values for form template. |
| 27 | */ |
| 28 | private $mapToTemplateProperty = [ |
| 29 | '_give_display_style' => 'donationFormLevelsStyle', |
| 30 | '_give_payment_display' => 'donationFormStyle', |
| 31 | '_give_form_floating_labels' => 'floatingLabelsStyle', |
| 32 | '_give_reveal_label' => 'getContinueToDonationFormLabel', |
| 33 | '_give_checkout_label' => 'getDonateNowButtonLabel', |
| 34 | '_give_display_content' => 'showDonationIntroductionContent', |
| 35 | '_give_content_placement' => 'getDonationIntroductionContentPosition', |
| 36 | '_give_form_content' => 'getDonationIntroductionContent', |
| 37 | ]; |
| 38 | |
| 39 | /** |
| 40 | * @var Template $template |
| 41 | */ |
| 42 | private $template; |
| 43 | |
| 44 | /** |
| 45 | * LegacyFormSettingCompatibility constructor. |
| 46 | * |
| 47 | * @param Template $template |
| 48 | */ |
| 49 | public function __construct(Template $template) |
| 50 | { |
| 51 | $this->template = $template; |
| 52 | } |
| 53 | |
| 54 | /** |
| 55 | * Save legacy settings. |
| 56 | * |
| 57 | * Note: we are using this function internally to store legacy form settings when save form template setting. |
| 58 | * |
| 59 | * @see src/Helpers/Form/Theme/Theme.php:46 we are using this function in set function. |
| 60 | * @since 2.7.0 |
| 61 | * |
| 62 | * @param array $settings |
| 63 | * @param int $formId |
| 64 | */ |
| 65 | public function save($formId, $settings) |
| 66 | { |
| 67 | $alreadySavedLegacySettings = []; |
| 68 | $templateOptions = $this->template->getOptionsConfig(); |
| 69 | $enableDisableValueSet = ['disabled', 'enabled']; |
| 70 | |
| 71 | foreach ($templateOptions as $groupId => $group) { |
| 72 | foreach ($group['fields'] as $field) { |
| 73 | // Continue if setting is not map to legacy setting. |
| 74 | if ( ! isset($field[self::$key])) { |
| 75 | continue; |
| 76 | } |
| 77 | |
| 78 | Give()->form_meta->update_meta($formId, $field[self::$key], $settings[$groupId][$field['id']]); |
| 79 | $alreadySavedLegacySettings[] = $field[self::$key]; |
| 80 | } |
| 81 | } |
| 82 | |
| 83 | if ($remainingSettings = array_diff(array_keys($this->mapToTemplateProperty), $alreadySavedLegacySettings)) { |
| 84 | foreach ($remainingSettings as $metaKey) { |
| 85 | $value = property_exists($this->template, $this->mapToTemplateProperty[$metaKey]) ? |
| 86 | $this->template->{$this->mapToTemplateProperty[$metaKey]} : // Get value from property. |
| 87 | $this->template->{$this->mapToTemplateProperty[$metaKey]}(); // Get value from function |
| 88 | |
| 89 | // Convert boolean value to enable and disabled. |
| 90 | if (is_bool($value)) { |
| 91 | $value = $enableDisableValueSet[absint($value)]; |
| 92 | } |
| 93 | |
| 94 | Give()->form_meta->update_meta( |
| 95 | $formId, |
| 96 | $metaKey, |
| 97 | $value |
| 98 | ); |
| 99 | } |
| 100 | } |
| 101 | } |
| 102 | |
| 103 | /** |
| 104 | * Migrate existing legacy form settings. |
| 105 | * Note: Only for internal use. This function can be removed or change in future |
| 106 | * |
| 107 | * @since 2.7.0 |
| 108 | */ |
| 109 | public static function migrateExistingFormSettings() |
| 110 | { |
| 111 | // Only migrate settings for existing form when editing. |
| 112 | if ( ! isset($_GET['action']) || 'edit' !== give_clean($_GET['action'])) { |
| 113 | return; |
| 114 | } |
| 115 | |
| 116 | $formId = absint($_GET['post']); |
| 117 | |
| 118 | if ( ! Utils::isLegacyForm($formId)) { |
| 119 | return; |
| 120 | } |
| 121 | |
| 122 | if (Give()->form_meta->get_meta($formId, '_give_legacy_form_template_settings', true)) { |
| 123 | return; |
| 124 | } |
| 125 | |
| 126 | $mapToSetting = [ |
| 127 | 'display_style' => '_give_display_style', |
| 128 | 'payment_display' => '_give_payment_display', |
| 129 | 'reveal_label' => '_give_reveal_label', |
| 130 | 'checkout_label' => '_give_checkout_label', |
| 131 | 'form_floating_labels' => '_give_form_floating_labels', |
| 132 | 'display_content' => '_give_display_content', |
| 133 | 'content_placement' => '_give_content_placement', |
| 134 | 'form_content' => '_give_form_content', |
| 135 | ]; |
| 136 | |
| 137 | foreach ($mapToSetting as $newSetting => $oldSetting) { |
| 138 | if ($value = Give()->form_meta->get_meta($formId, $oldSetting, true)) { |
| 139 | $settings['display_settings'][$newSetting] = $value; |
| 140 | } |
| 141 | } |
| 142 | |
| 143 | Give()->form_meta->update_meta($formId, '_give_form_template', 'legacy'); |
| 144 | Give()->form_meta->update_meta($formId, '_give_legacy_form_template_settings', $settings); |
| 145 | } |
| 146 | } |
| 147 |