<?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; use WP_Ultimo\Managers\Field_Templates_Manager; // 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_Steps extends Base_Signup_Field { /** * Returns the type of the field. * * @since 2.0.0 */ public function get_type(): string { return 'steps'; } /** * Returns if this field should be present on the checkout flow or not. * * @since 2.0.0 */ public function is_required(): bool { 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 __('Steps', 'wp-ultimo'); } /** * 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 list of the steps.', 'wp-ultimo'); } /** * 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 list of the steps.', 'wp-ultimo'); } /** * Returns the icon to be used on the selector. * * Can be either a dashicon class or a wu-dashicon class. * * @since 2.0.0 */ public function get_icon(): string { return 'dashicons-wu-filter_1'; } /** * 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 [ 'steps_template' => 'clean', ]; } /** * 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 []; } /** * 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 [ 'id' => 'steps', ]; } /** * Returns the list of available pricing table templates. * * @since 2.0.0 * @return array */ public function get_templates() { $available_templates = Field_Templates_Manager::get_instance()->get_templates_as_options('steps'); return $available_templates; } /** * Returns the list of additional fields specific to this type. * * @since 2.0.0 * @return array */ public function get_fields() { $editor_fields['steps_template'] = [ 'type' => 'group', 'desc' => Field_Templates_Manager::get_instance()->render_preview_block('steps'), 'order' => 98, 'fields' => [ 'steps_template' => [ 'type' => 'select', 'title' => __('Layout', 'wp-ultimo'), 'placeholder' => __('Select your Layout', 'wp-ultimo'), 'options' => [$this, 'get_templates'], 'wrapper_classes' => 'wu-flex-grow', 'html_attr' => [ 'v-model' => 'steps_template', ], ], ], ]; // @todo: re-add developer notes. // $editor_fields['_dev_note_develop_your_own_template_steps'] = array( // 'type' => 'note', // 'order' => 99, // 'wrapper_classes' => 'sm:wu-p-0 sm:wu-block', // 'classes' => '', // 'desc' => sprintf('<div class="wu-p-4 wu-bg-blue-100 wu-text-grey-600">%s</div>', __('Want to add customized steps templates?<br><a target="_blank" class="wu-no-underline" href="https://help.wpultimo.com/article/343-customize-your-checkout-flow-using-field-templates">See how you can do that here</a>.', 'wp-ultimo')), // ); return $editor_fields; } /** * 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) { if (wu_get_isset($attributes, 'steps_template') === 'legacy') { wp_enqueue_style('legacy-shortcodes', wu_get_asset('legacy-shortcodes.css', 'css'), ['dashicons'], wu_get_version()); wp_add_inline_style('legacy-shortcodes', \WP_Ultimo\Checkout\Legacy_Checkout::get_instance()->get_legacy_dynamic_styles()); } $attributes['steps'] = \WP_Ultimo\Checkout\Checkout::get_instance()->steps; $attributes['current_step'] = \WP_Ultimo\Checkout\Checkout::get_instance()->step_name; $template_class = Field_Templates_Manager::get_instance()->get_template_class('steps', $attributes['steps_template']); $content = $template_class ? $template_class->render_container($attributes) : __('Template does not exist.', 'wp-ultimo'); return [ $attributes['id'] => [ 'type' => 'note', 'desc' => $content, 'wrapper_classes' => $attributes['element_classes'], ], ]; } }