<?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_Shortcode extends Base_Signup_Field { /** * Returns the type of the field. * * @since 2.0.0 */ public function get_type(): string { return 'shortcode'; } /** * 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 __('Shortcode', '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 __('Displays the content of a given WordPress shortcode. Can be useful to inset content from other plugins inside a WP Multisite WaaS checkout form.', '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 __('Displays the content of a given WordPress shortcode. Can be useful to insert content from other plugins inside a WP Multisite WaaS checkout form.', '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-terminal'; } /** * 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 [ '', ]; } /** * 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', // 'name', ]; } /** * 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 [ 'name' => __('Shortcode', 'wp-ultimo'), ]; } /** * Returns the list of additional fields specific to this type. * * @since 2.0.0 * @return array */ public function get_fields() { return [ 'shortcode_code' => [ 'type' => 'text', 'title' => __('Shortcode', 'wp-ultimo'), 'placeholder' => __('e.g. [shortcode]', 'wp-ultimo'), 'desc' => __('Please, enter the full shortcode, including [].', 'wp-ultimo'), ], ]; } /** * 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' => 'note', 'desc' => fn() => do_shortcode($attributes['shortcode_code']), 'wrapper_classes' => wu_get_isset($attributes, 'wrapper_element_classes', ''), 'classes' => wu_get_isset($attributes, 'element_classes', ''), 'wrapper_html_attr' => [ 'style' => $this->calculate_style_attr(), ], ], ]; } }