<?php /** * Creates a cart with the parameters of the purchase being placed. * * @package WP_Ultimo * @subpackage Order * @since 2.0.0 */ namespace WP_Ultimo\Checkout\Signup_Fields; use WP_Ultimo\Checkout\Signup_Fields\Base_Signup_Field; // Exit if accessed directly defined('ABSPATH') || exit; /** * Creates an cart with the parameters of the purchase being placed. * * @package WP_Ultimo * @subpackage Checkout * @since 2.0.0 */ class Signup_Field_Hidden extends Base_Signup_Field { /** * Returns the type of the field. * * @since 2.0.0 * @return string */ public function get_type() { return 'hidden'; } /** * Returns if this field should be present on the checkout flow or not. * * @since 2.0.0 * @return boolean */ public function is_required() { return false; } /** * Requires the title of the field/element type. * * This is used on the Field/Element selection screen. * * @since 2.0.0 * @return string */ public function get_title() { return __('Hidden Field', 'wp-multisite-waas'); } /** * Returns the description of the field/element. * * This is used as the title attribute of the selector. * * @since 2.0.0 * @return string */ public function get_description() { return __('Adds a hidden field. This is useful when coupled with the "Fill from the Request" option, to load values from the URL, for example.', 'wp-multisite-waas'); } /** * Returns the tooltip of the field/element. * * This is used as the tooltip attribute of the selector. * * @since 2.0.0 * @return string */ public function get_tooltip() { return __('Adds a hidden field. This is useful when coupled with the "Fill from the Request" option, to load values from the URL, for example.', 'wp-multisite-waas'); } /** * Returns the icon to be used on the selector. * * Can be either a dashicon class or a wu-dashicon class. * * @since 2.0.0 * @return string */ public function get_icon() { return 'dashicons-wu-eye-off'; } /** * Returns the default values for the field-elements. * * This is passed through a wp_parse_args before we send the values * to the method that returns the actual fields for the checkout form. * * @since 2.0.0 * @return array */ public function defaults() { return [ 'from_request' => true, ]; } /** * List of keys of the default fields we want to display on the builder. * * @since 2.0.0 * @return array */ public function default_fields() { return [ 'id', 'save_as', ]; } /** * If you want to force a particular attribute to a value, declare it here. * * @since 2.0.0 * @return array */ public function force_attributes() { return []; } /** * Returns the list of additional fields specific to this type. * * @since 2.0.0 * @return array */ public function get_fields() { return [ 'fixed_value' => [ 'order' => 12, 'type' => 'text', 'title' => __('Pre-filled Value', 'wp-multisite-waas'), 'desc' => __('The field will be populated with this value. Can be overridden if the pre-fill from request option is enabled.', 'wp-multisite-waas'), 'placeholder' => __('e.g. blue', 'wp-multisite-waas'), 'tooltip' => '', 'value' => '', ], ]; } /** * Gets the pre-filled value for the field. * * @since 2.0.0 * @return mixed */ public function get_value() { $value = parent::get_value(); if (empty($value)) { $value = $this->attributes['fixed_value']; } return $value; } /** * Returns the field/element actual field array to be used on the checkout form. * * @since 2.0.0 * * @param array $attributes Attributes saved on the editor form. * @return array An array of fields, not the field itself. */ public function to_fields_array($attributes) { return [ $attributes['id'] => [ 'type' => 'hidden', 'id' => $attributes['id'], 'wrapper_classes' => $attributes['element_classes'], 'value' => $this->get_value(), ], ]; } }