eventespresso / event-espresso-core

core/services/notices/NoticeConverter.php

Indentation +54 added lines, -54 removed lines

@@ -11,71 +11,71 @@
  */
 abstract class NoticeConverter implements NoticeConverterInterface
 {
-    /**
-     * @var NoticesContainerInterface $notices
-     */
-    private $notices;
+	/**
+	 * @var NoticesContainerInterface $notices
+	 */
+	private $notices;
 
-    /**
-     * if set to true, then errors will be thrown as exceptions
-     *
-     * @var boolean $throw_exceptions
-     */
-    private $throw_exceptions;
+	/**
+	 * if set to true, then errors will be thrown as exceptions
+	 *
+	 * @var boolean $throw_exceptions
+	 */
+	private $throw_exceptions;
 
 
-    /**
-     * NoticeConverter constructor.
-     *
-     * @param bool $throw_exceptions
-     */
-    public function __construct($throw_exceptions = false)
-    {
-        $this->throw_exceptions = $throw_exceptions;
-    }
+	/**
+	 * NoticeConverter constructor.
+	 *
+	 * @param bool $throw_exceptions
+	 */
+	public function __construct($throw_exceptions = false)
+	{
+		$this->throw_exceptions = $throw_exceptions;
+	}
 
 
-    /**
-     * @return NoticesContainerInterface
-     */
-    public function getNotices()
-    {
-        return $this->notices;
-    }
+	/**
+	 * @return NoticesContainerInterface
+	 */
+	public function getNotices()
+	{
+		return $this->notices;
+	}
 
 
-    /**
-     * @param NoticesContainerInterface $notices
-     */
-    protected function setNotices(NoticesContainerInterface $notices)
-    {
-        $this->notices = $notices;
-    }
+	/**
+	 * @param NoticesContainerInterface $notices
+	 */
+	protected function setNotices(NoticesContainerInterface $notices)
+	{
+		$this->notices = $notices;
+	}
 
 
-    /**
-     * @return bool
-     */
-    public function getThrowExceptions()
-    {
-        return $this->throw_exceptions;
-    }
+	/**
+	 * @return bool
+	 */
+	public function getThrowExceptions()
+	{
+		return $this->throw_exceptions;
+	}
 
 
-    /**
-     * @param bool $throw_exceptions
-     */
-    public function setThrowExceptions($throw_exceptions)
-    {
-        $this->throw_exceptions = filter_var($throw_exceptions, FILTER_VALIDATE_BOOLEAN);
-    }
+	/**
+	 * @param bool $throw_exceptions
+	 */
+	public function setThrowExceptions($throw_exceptions)
+	{
+		$this->throw_exceptions = filter_var($throw_exceptions, FILTER_VALIDATE_BOOLEAN);
+	}
 
 
-    /**
-     * @return void;
-     */
-    public function clearNotices()
-    {
-        $this->notices = null;
-    }
+	/**
+	 * @return void;
+	 */
+	public function clearNotices()
+	{
+		$this->notices = null;
+	}
 }

core/services/notices/NoticeConverterInterface.php

Indentation +23 added lines, -23 removed lines

@@ -12,31 +12,31 @@
  */
 interface NoticeConverterInterface
 {
-    /**
-     * @return NoticesContainerInterface
-     */
-    public function getNotices();
+	/**
+	 * @return NoticesContainerInterface
+	 */
+	public function getNotices();
 
-    /**
-     * @param bool $throw_exceptions
-     */
-    public function setThrowExceptions($throw_exceptions);
+	/**
+	 * @param bool $throw_exceptions
+	 */
+	public function setThrowExceptions($throw_exceptions);
 
-    /**
-     * @return bool
-     */
-    public function getThrowExceptions();
+	/**
+	 * @return bool
+	 */
+	public function getThrowExceptions();
 
-    /**
-     * Converts NoticesContainerInterface objects into other format
-     *
-     * @param NoticesContainerInterface $notices
-     * @return
-     */
-    public function process(NoticesContainerInterface $notices);
+	/**
+	 * Converts NoticesContainerInterface objects into other format
+	 *
+	 * @param NoticesContainerInterface $notices
+	 * @return
+	 */
+	public function process(NoticesContainerInterface $notices);
 
-    /**
-     * @return void;
-     */
-    public function clearNotices();
+	/**
+	 * @return void;
+	 */
+	public function clearNotices();
 }

core/services/context/ContextChecker.php

Indentation +153 added lines, -153 removed lines

@@ -15,157 +15,157 @@
  */
 class ContextChecker
 {
-    /**
-     * A unique string used to identify where this ContextChecker is being employed
-     * Is currently only used within the hook name for the filterable return value of isAllowed().
-     *
-     * @var string $identifier
-     */
-    private $identifier;
-
-    /**
-     * A list of values to be compared against the slug of the Context class passed to isAllowed()
-     *
-     * @var array $acceptable_values
-     */
-    private $acceptable_values;
-
-    /**
-     * Closure (or callable) that will be called to perform the evaluation within isAllowed().
-     * If none is provided, then a simple type sensitive in_array() check will be used
-     * and return true if the incoming Context::slug() is found within the array of $acceptable_values.
-     *
-     * @var callable $evaluation_callback
-     */
-    private $evaluation_callback;
-
-
-    /**
-     * ContextChecker constructor.
-     *
-     * @param string       $identifier
-     * @param array        $acceptable_values
-     * @param callable|null $evaluation_callback [optional]
-     */
-    public function __construct($identifier, array $acceptable_values, callable $evaluation_callback = null)
-    {
-        $this->setIdentifier($identifier);
-        $this->setAcceptableValues($acceptable_values);
-        $this->setEvaluationCallback($evaluation_callback);
-    }
-
-
-    /**
-     * @param string $identifier
-     */
-    private function setIdentifier($identifier)
-    {
-        $this->identifier = sanitize_key($identifier);
-    }
-
-
-    /**
-     * @param array $acceptable_values
-     */
-    private function setAcceptableValues(array $acceptable_values)
-    {
-        $this->acceptable_values = $acceptable_values;
-    }
-
-
-    /**
-     * @param callable $evaluation_callback
-     */
-    private function setEvaluationCallback(callable $evaluation_callback = null)
-    {
-        $this->evaluation_callback = is_callable($evaluation_callback)
-            ? $evaluation_callback
-            : [$this, 'evaluateContext'];
-    }
-
-
-    /**
-     * default callback for evaluating whether the supplied context exists within the supplied values
-     *
-     * @param ContextInterface $context
-     * @param array            $acceptable_values
-     * @return bool
-     * @since   4.10.14.p
-     */
-    public function evaluateContext(ContextInterface $context, array $acceptable_values = [])
-    {
-        return in_array($context->slug(), $acceptable_values, true);
-    }
-
-
-    /**
-     * @return string
-     */
-    protected function identifier()
-    {
-        return $this->identifier;
-    }
-
-
-    /**
-     * @return array
-     */
-    protected function acceptableValues()
-    {
-        return apply_filters(
-            "FHEE__EventEspresso_core_domain_entities_context_ContextChecker__{$this->identifier}__acceptableValues",
-            $this->acceptable_values
-        );
-    }
-
-
-    /**
-     * @return callable
-     */
-    protected function evaluationCallback()
-    {
-        return $this->evaluation_callback;
-    }
-
-
-    /**
-     * Returns true if the incoming Context class slug matches one of the preset acceptable values.
-     * The result is filterable using the identifier for this ContextChecker.
-     * example:
-     * If this ContextChecker's $identifier was set to "registration-checkout-type",
-     * then the filter here would be named:
-     *  "FHEE__EventEspresso_core_domain_entities_context_ContextChecker__registration-checkout-type__isAllowed".
-     * Other code could hook into the filter in isAllowed() using the above name
-     * and test for additional acceptable values.
-     * So if the set of $acceptable_values was: [ "initial-visit",  "revisit" ]
-     * then adding a filter to
-     *  "FHEE__EventEspresso_core_domain_entities_context_ContextChecker__registration-checkout-type__isAllowed",
-     * would allow you to perform your own conditional and allow "wait-list-checkout" as an acceptable value.
-     *  example:
-     *      add_filter(
-     *          'FHEE__EventEspresso_core_domain_entities_context_ContextChecker__registration-checkout-type__isAllowed',
-     *          function ($is_allowed, ContextInterface $context) { return $context->slug() === 'wait-list-checkout'
-     *                  ? true
-     *                  : $is_allowed;
-     *          },
-     *          10,
-     *          2
-     *      );
-     *
-     * @param ContextInterface $context
-     * @return boolean
-     */
-    public function isAllowed(ContextInterface $context)
-    {
-        $evaluation_callback = $this->evaluationCallback();
-        return filter_var(
-            apply_filters(
-                "FHEE__EventEspresso_core_domain_entities_context_ContextChecker__{$this->identifier}__isAllowed",
-                $evaluation_callback($context, $this->acceptableValues()),
-                $context,
-                $this
-            ),
-            FILTER_VALIDATE_BOOLEAN
-        );
-    }
+	/**
+	 * A unique string used to identify where this ContextChecker is being employed
+	 * Is currently only used within the hook name for the filterable return value of isAllowed().
+	 *
+	 * @var string $identifier
+	 */
+	private $identifier;
+
+	/**
+	 * A list of values to be compared against the slug of the Context class passed to isAllowed()
+	 *
+	 * @var array $acceptable_values
+	 */
+	private $acceptable_values;
+
+	/**
+	 * Closure (or callable) that will be called to perform the evaluation within isAllowed().
+	 * If none is provided, then a simple type sensitive in_array() check will be used
+	 * and return true if the incoming Context::slug() is found within the array of $acceptable_values.
+	 *
+	 * @var callable $evaluation_callback
+	 */
+	private $evaluation_callback;
+
+
+	/**
+	 * ContextChecker constructor.
+	 *
+	 * @param string       $identifier
+	 * @param array        $acceptable_values
+	 * @param callable|null $evaluation_callback [optional]
+	 */
+	public function __construct($identifier, array $acceptable_values, callable $evaluation_callback = null)
+	{
+		$this->setIdentifier($identifier);
+		$this->setAcceptableValues($acceptable_values);
+		$this->setEvaluationCallback($evaluation_callback);
+	}
+
+
+	/**
+	 * @param string $identifier
+	 */
+	private function setIdentifier($identifier)
+	{
+		$this->identifier = sanitize_key($identifier);
+	}
+
+
+	/**
+	 * @param array $acceptable_values
+	 */
+	private function setAcceptableValues(array $acceptable_values)
+	{
+		$this->acceptable_values = $acceptable_values;
+	}
+
+
+	/**
+	 * @param callable $evaluation_callback
+	 */
+	private function setEvaluationCallback(callable $evaluation_callback = null)
+	{
+		$this->evaluation_callback = is_callable($evaluation_callback)
+			? $evaluation_callback
+			: [$this, 'evaluateContext'];
+	}
+
+
+	/**
+	 * default callback for evaluating whether the supplied context exists within the supplied values
+	 *
+	 * @param ContextInterface $context
+	 * @param array            $acceptable_values
+	 * @return bool
+	 * @since   4.10.14.p
+	 */
+	public function evaluateContext(ContextInterface $context, array $acceptable_values = [])
+	{
+		return in_array($context->slug(), $acceptable_values, true);
+	}
+
+
+	/**
+	 * @return string
+	 */
+	protected function identifier()
+	{
+		return $this->identifier;
+	}
+
+
+	/**
+	 * @return array
+	 */
+	protected function acceptableValues()
+	{
+		return apply_filters(
+			"FHEE__EventEspresso_core_domain_entities_context_ContextChecker__{$this->identifier}__acceptableValues",
+			$this->acceptable_values
+		);
+	}
+
+
+	/**
+	 * @return callable
+	 */
+	protected function evaluationCallback()
+	{
+		return $this->evaluation_callback;
+	}
+
+
+	/**
+	 * Returns true if the incoming Context class slug matches one of the preset acceptable values.
+	 * The result is filterable using the identifier for this ContextChecker.
+	 * example:
+	 * If this ContextChecker's $identifier was set to "registration-checkout-type",
+	 * then the filter here would be named:
+	 *  "FHEE__EventEspresso_core_domain_entities_context_ContextChecker__registration-checkout-type__isAllowed".
+	 * Other code could hook into the filter in isAllowed() using the above name
+	 * and test for additional acceptable values.
+	 * So if the set of $acceptable_values was: [ "initial-visit",  "revisit" ]
+	 * then adding a filter to
+	 *  "FHEE__EventEspresso_core_domain_entities_context_ContextChecker__registration-checkout-type__isAllowed",
+	 * would allow you to perform your own conditional and allow "wait-list-checkout" as an acceptable value.
+	 *  example:
+	 *      add_filter(
+	 *          'FHEE__EventEspresso_core_domain_entities_context_ContextChecker__registration-checkout-type__isAllowed',
+	 *          function ($is_allowed, ContextInterface $context) { return $context->slug() === 'wait-list-checkout'
+	 *                  ? true
+	 *                  : $is_allowed;
+	 *          },
+	 *          10,
+	 *          2
+	 *      );
+	 *
+	 * @param ContextInterface $context
+	 * @return boolean
+	 */
+	public function isAllowed(ContextInterface $context)
+	{
+		$evaluation_callback = $this->evaluationCallback();
+		return filter_var(
+			apply_filters(
+				"FHEE__EventEspresso_core_domain_entities_context_ContextChecker__{$this->identifier}__isAllowed",
+				$evaluation_callback($context, $this->acceptableValues()),
+				$context,
+				$this
+			),
+			FILTER_VALIDATE_BOOLEAN
+		);
+	}
 }

core/services/progress_steps/ProgressStepsConfigInterface.php

Indentation +2 added lines, -2 removed lines

@@ -10,7 +10,7 @@
  */
 interface ProgressStepsConfigInterface
 {
-    public function get();
+	public function get();
 
-    public function update();
+	public function update();
 }

core/services/progress_steps/display_strategies/ProgressStepsDisplayInterface.php

Indentation +18 added lines, -18 removed lines

@@ -11,23 +11,23 @@
  */
 interface ProgressStepsDisplayInterface
 {
-    /**
-     * used for setting up css and js required for the display strategy
-     * ** IMPORTANT **
-     * This needs to be called BEFORE the wp_enqueue_scripts hook point for the frontend
-     * or the admin_enqueue_scripts in the admin.
-     * If setting up steps for the admin, this can be done via the
-     * 'FHEE__EE_Admin_Page___load_page_dependencies__after_load' ACTION
-     * in \EE_Admin_Page::_load_page_dependencies() or the targeted hook that comes after it
-     *
-     * @return void
-     */
-    public function enqueueStylesAndScripts();
+	/**
+	 * used for setting up css and js required for the display strategy
+	 * ** IMPORTANT **
+	 * This needs to be called BEFORE the wp_enqueue_scripts hook point for the frontend
+	 * or the admin_enqueue_scripts in the admin.
+	 * If setting up steps for the admin, this can be done via the
+	 * 'FHEE__EE_Admin_Page___load_page_dependencies__after_load' ACTION
+	 * in \EE_Admin_Page::_load_page_dependencies() or the targeted hook that comes after it
+	 *
+	 * @return void
+	 */
+	public function enqueueStylesAndScripts();
 
-    /**
-     * loads and returns a full server path to the template used for the display strategy
-     *
-     * @return string
-     */
-    public function getTemplate();
+	/**
+	 * loads and returns a full server path to the template used for the display strategy
+	 *
+	 * @return string
+	 */
+	public function getTemplate();
 }

core/services/progress_steps/ProgressStepInterface.php

Indentation +24 added lines, -24 removed lines

@@ -11,33 +11,33 @@
  */
 interface ProgressStepInterface
 {
-    /**
-     * @return boolean
-     */
-    public function isCurrent();
+	/**
+	 * @return boolean
+	 */
+	public function isCurrent();
 
-    /**
-     * @param boolean $is_current
-     */
-    public function setIsCurrent($is_current = true);
+	/**
+	 * @param boolean $is_current
+	 */
+	public function setIsCurrent($is_current = true);
 
-    /**
-     * @return string
-     */
-    public function id();
+	/**
+	 * @return string
+	 */
+	public function id();
 
-    /**
-     * @return int
-     */
-    public function order();
+	/**
+	 * @return int
+	 */
+	public function order();
 
-    /**
-     * @return string
-     */
-    public function htmlClass();
+	/**
+	 * @return string
+	 */
+	public function htmlClass();
 
-    /**
-     * @return string
-     */
-    public function text();
+	/**
+	 * @return string
+	 */
+	public function text();
 }

core/services/progress_steps/ProgressStepCollection.php

Indentation +9 added lines, -9 removed lines

@@ -16,13 +16,13 @@
  */
 class ProgressStepCollection extends Collection
 {
-    /**
-     * ProgressStepCollection constructor.
-     *
-     * @throws \EventEspresso\core\exceptions\InvalidInterfaceException
-     */
-    public function __construct()
-    {
-        parent::__construct('\EventEspresso\core\services\progress_steps\ProgressStepInterface');
-    }
+	/**
+	 * ProgressStepCollection constructor.
+	 *
+	 * @throws \EventEspresso\core\exceptions\InvalidInterfaceException
+	 */
+	public function __construct()
+	{
+		parent::__construct('\EventEspresso\core\services\progress_steps\ProgressStepInterface');
+	}
 }

core/services/form/meta/Required.php

Indentation +106 added lines, -106 removed lines

@@ -14,110 +14,110 @@
  */
 class Required implements JsonableInterface
 {
-    /**
-     * @var JsonDataHandler
-     */
-    private $json_data_handler;
-
-    /** Whether or not the input must be supplied with a value in order to complete the form.
-     *
-     * @var bool
-     */
-    private $required;
-
-    /**
-     * Custom validation text displayed alongside a required form input to assist users with completing the form.
-     *
-     * @var string
-     */
-    private $validationText;
-
-
-    /**
-     * Required constructor.
-     *
-     * @param JsonDataHandler $json_data_handler
-     * @param bool            $required
-     * @param string          $validationText
-     */
-    public function __construct(JsonDataHandler $json_data_handler, bool $required, string $validationText)
-    {
-        $this->json_data_handler = $json_data_handler;
-        $this->setRequired($required);
-        $this->setValidationText($validationText);
-    }
-
-
-    /**
-     * @param string $json
-     * @return Required
-     */
-    public static function fromJson(string $json): Required
-    {
-        $json_data_handler = new JsonDataHandler();
-        $json_data_handler->configure(JsonDataHandler::DATA_TYPE_OBJECT);
-        $data           = $json_data_handler->decodeJson($json);
-        $required       = $data->required ?? false;
-        $validationText = $data->validationText ?? '';
-        return new Required($json_data_handler, $required, $validationText);
-    }
-
-
-    /**
-     * @return array
-     */
-    public function toArray(): array
-    {
-        return [
-            'required'       => $this->required,
-            'validationText' => $this->validationText,
-        ];
-    }
-
-
-    /**
-     * @return string
-     */
-    public function toJson(): string
-    {
-        return $this->json_data_handler->encodeData($this->toArray());
-    }
-
-
-    /**
-     *
-     *
-     * @return bool
-     */
-    public function isRequired(): ?bool
-    {
-        return $this->required;
-    }
-
-
-    /**
-     * @param bool|int|string $required
-     */
-    public function setRequired($required = true)
-    {
-        $this->required = filter_var($required, FILTER_VALIDATE_BOOLEAN);
-    }
-
-
-    /**
-     * @return string
-     */
-    public function validationText(): ?string
-    {
-        return $this->validationText;
-    }
-
-
-    /**
-     * @param string $validationText
-     */
-    public function setValidationText(string $validationText)
-    {
-        $this->validationText = sanitize_text_field($validationText);
-    }
+	/**
+	 * @var JsonDataHandler
+	 */
+	private $json_data_handler;
+
+	/** Whether or not the input must be supplied with a value in order to complete the form.
+	 *
+	 * @var bool
+	 */
+	private $required;
+
+	/**
+	 * Custom validation text displayed alongside a required form input to assist users with completing the form.
+	 *
+	 * @var string
+	 */
+	private $validationText;
+
+
+	/**
+	 * Required constructor.
+	 *
+	 * @param JsonDataHandler $json_data_handler
+	 * @param bool            $required
+	 * @param string          $validationText
+	 */
+	public function __construct(JsonDataHandler $json_data_handler, bool $required, string $validationText)
+	{
+		$this->json_data_handler = $json_data_handler;
+		$this->setRequired($required);
+		$this->setValidationText($validationText);
+	}
+
+
+	/**
+	 * @param string $json
+	 * @return Required
+	 */
+	public static function fromJson(string $json): Required
+	{
+		$json_data_handler = new JsonDataHandler();
+		$json_data_handler->configure(JsonDataHandler::DATA_TYPE_OBJECT);
+		$data           = $json_data_handler->decodeJson($json);
+		$required       = $data->required ?? false;
+		$validationText = $data->validationText ?? '';
+		return new Required($json_data_handler, $required, $validationText);
+	}
+
+
+	/**
+	 * @return array
+	 */
+	public function toArray(): array
+	{
+		return [
+			'required'       => $this->required,
+			'validationText' => $this->validationText,
+		];
+	}
+
+
+	/**
+	 * @return string
+	 */
+	public function toJson(): string
+	{
+		return $this->json_data_handler->encodeData($this->toArray());
+	}
+
+
+	/**
+	 *
+	 *
+	 * @return bool
+	 */
+	public function isRequired(): ?bool
+	{
+		return $this->required;
+	}
+
+
+	/**
+	 * @param bool|int|string $required
+	 */
+	public function setRequired($required = true)
+	{
+		$this->required = filter_var($required, FILTER_VALIDATE_BOOLEAN);
+	}
+
+
+	/**
+	 * @return string
+	 */
+	public function validationText(): ?string
+	{
+		return $this->validationText;
+	}
+
+
+	/**
+	 * @param string $validationText
+	 */
+	public function setValidationText(string $validationText)
+	{
+		$this->validationText = sanitize_text_field($validationText);
+	}
 }

core/services/form/meta/FormLabel.php

Indentation +169 added lines, -169 removed lines

@@ -14,173 +14,173 @@
  */
 class FormLabel implements JsonableInterface
 {
-    /**
-     * @var JsonDataHandler
-     */
-    private $json_data_handler;
-
-    /**
-     * Input label displayed in the admin to help differentiate input from others
-     *
-     * @var string
-     */
-    private $adminLabel;
-
-    /**
-     * Input label displayed on public forms, ie: the actual question text.
-     *
-     * @var string
-     */
-    private $publicLabel;
-
-    /**
-     * @var bool
-     */
-    private $showLabel;
-
-    /**
-     * The HTML block displayed for block elements.
-     *
-     * @var string
-     */
-    private $html;
-
-
-    /**
-     * FormLabel constructor.
-     *
-     * @param JsonDataHandler $json_data_handler
-     * @param string          $adminLabel
-     * @param string          $publicLabel
-     * @param bool            $showLabel
-     */
-    public function __construct(
-        JsonDataHandler $json_data_handler,
-        string $adminLabel,
-        string $publicLabel,
-        bool $showLabel,
-        string $html
-    ) {
-        $this->json_data_handler = $json_data_handler;
-        $this->setAdminLabel($adminLabel);
-        $this->setPublicLabel($publicLabel);
-        $this->setShowLabel($showLabel);
-        $this->setHtml($html);
-    }
-
-
-    /**
-     * @param string $json
-     * @return FormLabel
-     */
-    public static function fromJson(string $json): FormLabel
-    {
-        $json_data_handler = new JsonDataHandler();
-        $json_data_handler->configure(JsonDataHandler::DATA_TYPE_OBJECT);
-        $data        = $json_data_handler->decodeJson($json);
-        $adminLabel  = $data->adminLabel ?? '';
-        $publicLabel = $data->publicLabel ?? '';
-        $showLabel   = $data->showLabel ?? false;
-        $html        = $data->html ?? '';
-        return new FormLabel($json_data_handler, $adminLabel, $publicLabel, $showLabel, $html);
-    }
-
-
-    /**
-     * @return array
-     */
-    public function toArray(): array
-    {
-        return [
-            'adminLabel'  => $this->adminLabel,
-            'publicLabel' => $this->publicLabel,
-            'showLabel'   => $this->showLabel,
-            'html'        => $this->html,
-        ];
-    }
-
-
-    /**
-     * @return string
-     */
-    public function toJson(): string
-    {
-        return $this->json_data_handler->encodeData($this->toArray());
-    }
-
-
-    /**
-     * Input label displayed in the admin to help differentiate input from others
-     *
-     * @return string
-     */
-    public function adminLabel(): string
-    {
-        return $this->adminLabel;
-    }
-
-
-    /**
-     * @param string $adminLabel
-     */
-    public function setAdminLabel(string $adminLabel): void
-    {
-        $this->adminLabel = sanitize_text_field($adminLabel);
-    }
-
-
-    /**
-     * Input label displayed on public forms, ie: the actual question text.
-     *
-     * @return string
-     */
-    public function publicLabel(): string
-    {
-        return $this->publicLabel;
-    }
-
-
-    /**
-     * @param string $publicLabel
-     */
-    public function setPublicLabel(string $publicLabel): void
-    {
-        $this->publicLabel = sanitize_text_field($publicLabel);
-    }
-
-
-    /**
-     * @return bool
-     */
-    public function showLabel(): bool
-    {
-        return $this->showLabel;
-    }
-
-
-    /**
-     * @param bool|int|string $showLabel
-     */
-    public function setShowLabel($showLabel): void
-    {
-        $this->showLabel = filter_var($showLabel, FILTER_VALIDATE_BOOLEAN);
-    }
-
-
-    /**
-     * @return string
-     */
-    public function html(): string
-    {
-        return $this->html;
-    }
-
-
-    /**
-     * @param string $html
-     */
-    public function setHtml(string $html): void
-    {
-        $this->html = wp_kses_post($html);
-    }
+	/**
+	 * @var JsonDataHandler
+	 */
+	private $json_data_handler;
+
+	/**
+	 * Input label displayed in the admin to help differentiate input from others
+	 *
+	 * @var string
+	 */
+	private $adminLabel;
+
+	/**
+	 * Input label displayed on public forms, ie: the actual question text.
+	 *
+	 * @var string
+	 */
+	private $publicLabel;
+
+	/**
+	 * @var bool
+	 */
+	private $showLabel;
+
+	/**
+	 * The HTML block displayed for block elements.
+	 *
+	 * @var string
+	 */
+	private $html;
+
+
+	/**
+	 * FormLabel constructor.
+	 *
+	 * @param JsonDataHandler $json_data_handler
+	 * @param string          $adminLabel
+	 * @param string          $publicLabel
+	 * @param bool            $showLabel
+	 */
+	public function __construct(
+		JsonDataHandler $json_data_handler,
+		string $adminLabel,
+		string $publicLabel,
+		bool $showLabel,
+		string $html
+	) {
+		$this->json_data_handler = $json_data_handler;
+		$this->setAdminLabel($adminLabel);
+		$this->setPublicLabel($publicLabel);
+		$this->setShowLabel($showLabel);
+		$this->setHtml($html);
+	}
+
+
+	/**
+	 * @param string $json
+	 * @return FormLabel
+	 */
+	public static function fromJson(string $json): FormLabel
+	{
+		$json_data_handler = new JsonDataHandler();
+		$json_data_handler->configure(JsonDataHandler::DATA_TYPE_OBJECT);
+		$data        = $json_data_handler->decodeJson($json);
+		$adminLabel  = $data->adminLabel ?? '';
+		$publicLabel = $data->publicLabel ?? '';
+		$showLabel   = $data->showLabel ?? false;
+		$html        = $data->html ?? '';
+		return new FormLabel($json_data_handler, $adminLabel, $publicLabel, $showLabel, $html);
+	}
+
+
+	/**
+	 * @return array
+	 */
+	public function toArray(): array
+	{
+		return [
+			'adminLabel'  => $this->adminLabel,
+			'publicLabel' => $this->publicLabel,
+			'showLabel'   => $this->showLabel,
+			'html'        => $this->html,
+		];
+	}
+
+
+	/**
+	 * @return string
+	 */
+	public function toJson(): string
+	{
+		return $this->json_data_handler->encodeData($this->toArray());
+	}
+
+
+	/**
+	 * Input label displayed in the admin to help differentiate input from others
+	 *
+	 * @return string
+	 */
+	public function adminLabel(): string
+	{
+		return $this->adminLabel;
+	}
+
+
+	/**
+	 * @param string $adminLabel
+	 */
+	public function setAdminLabel(string $adminLabel): void
+	{
+		$this->adminLabel = sanitize_text_field($adminLabel);
+	}
+
+
+	/**
+	 * Input label displayed on public forms, ie: the actual question text.
+	 *
+	 * @return string
+	 */
+	public function publicLabel(): string
+	{
+		return $this->publicLabel;
+	}
+
+
+	/**
+	 * @param string $publicLabel
+	 */
+	public function setPublicLabel(string $publicLabel): void
+	{
+		$this->publicLabel = sanitize_text_field($publicLabel);
+	}
+
+
+	/**
+	 * @return bool
+	 */
+	public function showLabel(): bool
+	{
+		return $this->showLabel;
+	}
+
+
+	/**
+	 * @param bool|int|string $showLabel
+	 */
+	public function setShowLabel($showLabel): void
+	{
+		$this->showLabel = filter_var($showLabel, FILTER_VALIDATE_BOOLEAN);
+	}
+
+
+	/**
+	 * @return string
+	 */
+	public function html(): string
+	{
+		return $this->html;
+	}
+
+
+	/**
+	 * @param string $html
+	 */
+	public function setHtml(string $html): void
+	{
+		$this->html = wp_kses_post($html);
+	}
 }