'capability_here'
* To add a page to the network admin (wp-admin/network), use: 'network_admin_menu' => 'capability_here'
* To add a page to the user (wp-admin/user) admin, use: 'user_admin_menu' => 'capability_here'
*
* @since 2.0.0
* @var array
*/
protected $supported_panels = [
'network_admin_menu' => 'wu_edit_discount_codes',
];
/**
* Allow child classes to register widgets, if they need them.
*
* @since 1.8.2
* @return void
*/
public function register_widgets(): void {
parent::register_widgets();
$this->add_fields_widget(
'description',
[
'title' => __('Description', 'wp-multisite-waas'),
'position' => 'normal',
'fields' => [
'description' => [
'type' => 'textarea',
'title' => __('Description', 'wp-multisite-waas'),
'placeholder' => __('Tell your customers what this product is about.', 'wp-multisite-waas'),
'value' => $this->get_object()->get_description(),
'html_attr' => [
'rows' => 3,
],
],
],
]
);
$tz_note = sprintf('The site timezone is %s
. The current time is %s
', date_i18n('e'), date_i18n('r'));
$options = [
'general' => [
'title' => __('Limit Uses', 'wp-multisite-waas'),
'icon' => 'dashicons-wu-lock',
'desc' => __('Rules and limitations to the applicability of this discount code.', 'wp-multisite-waas'),
'fields' => [
'uses' => [
'title' => __('Uses', 'wp-multisite-waas'),
'type' => 'text-display',
// translators: %d is the number of times the coupon was used.
'display_value' => sprintf(__('This discount code was used %d times.', 'wp-multisite-waas'), $this->get_object()->get_uses()),
'tooltip' => __('The number of times that this discount code was used so far.', 'wp-multisite-waas'),
],
'max_uses' => [
'title' => __('Max Uses', 'wp-multisite-waas'),
'desc' => __('Use this option to set a limit on how many times this discount code can be used. Leave blank or 0 for unlimited uses.', 'wp-multisite-waas'),
'type' => 'number',
'min' => 0,
'placeholder' => 0,
'value' => $this->get_object()->has_max_uses() ? $this->get_object()->get_max_uses() : __('Unlimited', 'wp-multisite-waas'),
],
],
],
'time' => [
'title' => __('Start & Expiration Dates', 'wp-multisite-waas'),
'desc' => __('Define a start and end date for this discount code. Useful when running campaigns for a pre-determined period.', 'wp-multisite-waas'),
'icon' => 'dashicons-wu-calendar',
'state' => [
'enable_date_start' => $this->get_object()->get_date_start(),
'enable_date_expiration' => $this->get_object()->get_date_expiration(),
],
'fields' => [
'enable_date_start' => [
'type' => 'toggle',
'title' => __('Enable Start Date', 'wp-multisite-waas'),
'desc' => __('Allows you to set a start date for this coupon code.', 'wp-multisite-waas'),
'value' => 1,
'html_attr' => [
'v-model' => 'enable_date_start',
],
],
'date_start' => [
'title' => __('Start Date', 'wp-multisite-waas'),
'desc' => __('The discount code will only be good to be used after this date.', 'wp-multisite-waas') . ' ' . $tz_note,
'type' => 'text',
'date' => true,
'value' => $this->edit ? $this->get_object()->get_date_start() : __('No date', 'wp-multisite-waas'),
'placeholder' => 'E.g. 2020-04-04 12:00:00',
'wrapper_html_attr' => [
'v-cloak' => 1,
'v-show' => 'enable_date_start',
],
'html_attr' => [
'v-bind:name' => 'enable_date_start ? "date_start" : ""',
'wu-datepicker' => 'true',
'data-format' => 'Y-m-d H:i:S',
'data-allow-time' => 'true',
],
],
'enable_date_expiration' => [
'type' => 'toggle',
'title' => __('Enable Expiration Date', 'wp-multisite-waas'),
'desc' => __('Allows you to set an expiration date for this coupon code.', 'wp-multisite-waas'),
'value' => 1,
'html_attr' => [
'v-model' => 'enable_date_expiration',
],
],
'date_expiration' => [
'title' => __('Expiration Date', 'wp-multisite-waas'),
'desc' => __('The discount code will expire after this date.', 'wp-multisite-waas') . ' ' . $tz_note,
'type' => 'text',
'date' => true,
'value' => $this->edit ? $this->get_object()->get_date_expiration() : __('Never Expires', 'wp-multisite-waas'),
'placeholder' => 'E.g. 2020-04-04 12:00:00',
'wrapper_html_attr' => [
'v-cloak' => 1,
'v-show' => 'enable_date_expiration',
],
'html_attr' => [
'v-bind:name' => 'enable_date_expiration ? "date_expiration" : ""',
'wu-datepicker' => 'true',
'data-format' => 'Y-m-d H:i:S',
'data-allow-time' => 'true',
],
],
],
],
'products' => [
'title' => __('Limit Products', 'wp-multisite-waas'),
'desc' => __('Determine if you want this discount code to apply to all discountable products or not.', 'wp-multisite-waas'),
'icon' => 'dashicons-wu-price-tag',
'state' => [
'limit_products' => $this->get_object()->get_limit_products(),
],
'fields' => array_merge(
[
'limit_products' => [
'type' => 'toggle',
'title' => __('Select Products', 'wp-multisite-waas'),
'desc' => __('Manually select to which products this discount code should be applicable.', 'wp-multisite-waas'),
'value' => 1,
'html_attr' => [
'v-model' => 'limit_products',
],
],
],
$this->get_product_field_list()
),
],
];
$this->add_tabs_widget(
'options',
[
'title' => __('Advanced Options', 'wp-multisite-waas'),
'position' => 'normal',
'sections' => apply_filters('wu_discount_code_options_sections', $options, $this->get_object()),
]
);
/*
* Handle legacy options for back-compat.
*/
$this->handle_legacy_options();
$this->add_list_table_widget(
'events',
[
'title' => __('Events', 'wp-multisite-waas'),
'table' => new \WP_Ultimo\List_Tables\Inside_Events_List_Table(),
'query_filter' => [$this, 'query_filter'],
]
);
$this->add_save_widget(
'save',
[
'html_attr' => [
'data-wu-app' => 'save_discount_code',
'data-state' => wu_convert_to_state(
[
'apply_to_setup_fee' => $this->get_object()->get_setup_fee_value() > 0,
'code' => $this->get_object()->get_code(),
'type' => $this->get_object()->get_type(),
'value' => $this->get_object()->get_value(),
'setup_fee_type' => $this->get_object()->get_setup_fee_type(),
'setup_fee_value' => $this->get_object()->get_setup_fee_value(),
]
),
],
'fields' => [
'code' => [
'title' => __('Coupon Code', 'wp-multisite-waas'),
'type' => 'text',
'placeholder' => __('E.g. XMAS10OFF', 'wp-multisite-waas'),
'desc' => __('The actual code your customers will enter during checkout.', 'wp-multisite-waas'),
'value' => $this->get_object()->get_code(),
'tooltip' => '',
'wrapper_html_attr' => [
'v-cloak' => '1',
],
'html_attr' => [
'v-on:input' => 'code = $event.target.value.toUpperCase().replace(/[^A-Z0-9-_]+/g, "")',
'v-bind:value' => 'code',
],
],
'value_group' => [
'type' => 'group',
'title' => __('Discount', 'wp-multisite-waas'),
'wrapper_html_attr' => [
'v-cloak' => '1',
],
'fields' => [
'type' => [
'type' => 'select',
'value' => $this->get_object()->get_type(),
'placeholder' => '',
'wrapper_classes' => 'wu-w-2/3',
'options' => [
'percentage' => __('Percentage (%)', 'wp-multisite-waas'),
// translators: %s is the currency symbol. e.g. $
'absolute' => sprintf(__('Absolute (%s)', 'wp-multisite-waas'), wu_get_currency_symbol()),
],
'html_attr' => [
'v-model' => 'type',
],
],
'value' => [
'type' => 'number',
'value' => $this->get_object()->get_value(),
'placeholder' => '',
'wrapper_classes' => 'wu-ml-2 wu-w-1/3',
'html_attr' => [
'min' => 0,
'v-bind:max' => "type === 'percentage' ? 100 : 999999999",
'step' => 'any',
],
],
],
],
'apply_to_renewals' => [
'type' => 'toggle',
'title' => __('Apply to Renewals', 'wp-multisite-waas'),
'desc' => __('By default, discounts are only applied to the first payment.', 'wp-multisite-waas'),
'value' => $this->get_object()->should_apply_to_renewals(),
'wrapper_html_attr' => [
'v-cloak' => '1',
],
],
'apply_to_setup_fee' => [
'type' => 'toggle',
'title' => __('Setup Fee Discount', 'wp-multisite-waas'),
'desc' => __('Also set a discount for setup fee?', 'wp-multisite-waas'),
'value' => $this->get_object()->get_setup_fee_value() > 0,
'html_attr' => [
'v-model' => 'apply_to_setup_fee',
],
'wrapper_html_attr' => [
'v-cloak' => '1',
],
],
'setup_fee_value_group' => [
'type' => 'group',
'title' => __('Setup Fee Discount', 'wp-multisite-waas'),
'wrapper_html_attr' => [
'v-show' => 'apply_to_setup_fee',
'v-cloak' => '1',
],
'fields' => [
'setup_fee_type' => [
'type' => 'select',
'value' => $this->get_object()->get_setup_fee_type(),
'placeholder' => '',
'wrapper_classes' => 'wu-w-2/3',
'options' => [
'percentage' => __('Percentage (%)', 'wp-multisite-waas'),
// translators: %s is the currency symbol. e.g. $
'absolute' => sprintf(__('Absolute (%s)', 'wp-multisite-waas'), wu_get_currency_symbol()),
],
'html_attr' => [
'v-model' => 'setup_fee_type',
],
],
'setup_fee_value' => [
'type' => 'number',
'value' => $this->get_object()->get_setup_fee_value(),
'placeholder' => '',
'wrapper_classes' => 'wu-ml-2 wu-w-1/3',
'html_attr' => [
'min' => 0,
'v-bind:max' => "setup_fee_type === 'percentage' ? 100 : 999999999",
],
],
],
],
],
]
);
$this->add_fields_widget(
'active',
[
'title' => __('Active', 'wp-multisite-waas'),
'fields' => [
'active' => [
'type' => 'toggle',
'title' => __('Active', 'wp-multisite-waas'),
'desc' => __('Use this option to manually enable or disable this discount code for new sign-ups.', 'wp-multisite-waas'),
'value' => $this->get_object()->is_active(),
],
],
]
);
}
/**
* List of products to apply this coupon to.
*
* @since 2.0.0
* @return array
*/
protected function get_product_field_list() {
$fields = [];
foreach (wu_get_products() as $product) {
$product_id = $product->get_id();
$fields[ "allowed_products_{$product_id}" ] = [
'type' => 'toggle',
'title' => $product->get_name(),
'desc' => __('Make applicable to this product.', 'wp-multisite-waas'),
'tooltip' => '',
'wrapper_classes' => '',
'html_attr' => [
':name' => "'allowed_products[]'",
':checked' => wp_json_encode(!$this->get_object()->get_limit_products() || in_array($product_id, $this->get_object()->get_allowed_products())), // phpcs:ignore
':value' => $product_id,
],
'wrapper_html_attr' => [
'v-cloak' => 1,
'v-show' => 'limit_products',
],
];
// TODO: this is a hack-y fix. Needs to be re-implemented.
$fields['allowed_products_none'] = [
'type' => 'hidden',
'value' => '__none',
'html_attr' => [
':name' => "'allowed_products[]'",
],
];
}
if (empty($fields)) {
$fields['allowed_products_no_products'] = [
'type' => 'note',
'title' => '',
'desc' => __('You do not have any products at this moment.', 'wp-multisite-waas'),
'wrapper_html_attr' => [
'v-cloak' => 1,
'v-show' => 'limit_products',
],
];
}
return $fields;
}
/**
* Handles legacy advanced options for coupons.
*
* @since 2.0.0
* @return void
*/
public function handle_legacy_options(): void {
global $wp_filter;
$tabs = [__('Legacy Add-ons', 'wp-multisite-waas')];
if ( ! isset($wp_filter['wp_ultimo_coupon_advanced_options'])) {
return;
}
wp_enqueue_style('wu-legacy-admin-tabs', wu_get_asset('legacy-admin-tabs.css', 'css'), false, wu_get_version());
$priorities = $wp_filter['wp_ultimo_coupon_advanced_options']->callbacks;
$fields = [
'heading' => [
'type' => 'header',
'title' => __('Legacy Options', 'wp-multisite-waas'),
// translators: %s is the comma-separated list of legacy add-ons.
'desc' => sprintf(__('Options for %s, and others.', 'wp-multisite-waas'), implode(', ', $tabs)),
],
];
foreach ($priorities as $priority => $callbacks) {
foreach ($callbacks as $id => $callable) {
$fields[ $id ] = [
'type' => 'html',
'classes' => 'wu--mt-2',
'content' => function () use ($callable) {
call_user_func($callable['function'], $this->get_object());
},
];
}
}
$this->add_fields_widget(
'legacy-options',
[
'title' => __('Legacy Options', 'wp-multisite-waas'),
'position' => 'normal',
'fields' => $fields,
'classes' => 'wu-legacy-options-panel',
'field_wrapper_classes' => 'wu-w-full wu-box-border wu-items-center wu-flex wu-justify-between wu-p-4 wu-m-0 wu-border-t wu-border-l-0 wu-border-r-0 wu-border-b-0 wu-border-gray-300 wu-border-solid',
'html_attr' => [
'style' => 'margin-top: -5px;',
],
]
);
}
/**
* Register ajax forms that we use for discount code.
*
* @since 2.0.0
* @return void
*/
public function register_forms(): void {
/*
* Delete Discount code - Confirmation modal
*/
add_filter(
'wu_data_json_success_delete_discount_code_modal',
fn($data_json) => [
'redirect_url' => wu_network_admin_url('wp-ultimo-discount-codes', ['deleted' => 1]),
]
);
}
/**
* Filters the list table to return only relevant events.
*
* @since 2.0.0
*
* @param array $args Query args passed to the list table.
* @return array Modified query args.
*/
public function query_filter($args) {
$extra_args = [
'object_type' => 'discount_code',
'object_id' => absint($this->get_object()->get_id()),
];
return array_merge($args, $extra_args);
}
/**
* Returns the title of the page.
*
* @since 2.0.0
* @return string Title of the page.
*/
public function get_title() {
return $this->edit ? __('Edit Discount Code', 'wp-multisite-waas') : __('Add new Discount Code', 'wp-multisite-waas');
}
/**
* Returns the title of menu for this page.
*
* @since 2.0.0
* @return string Menu label of the page.
*/
public function get_menu_title() {
return __('Edit Discount Code', 'wp-multisite-waas');
}
/**
* Returns the action links for that page.
*
* @since 1.8.2
* @return array
*/
public function action_links() {
return [];
}
/**
* Returns the labels to be used on the admin page.
*
* @since 2.0.0
* @return array
*/
public function get_labels() {
return [
'edit_label' => __('Edit Discount Code', 'wp-multisite-waas'),
'add_new_label' => __('Add new Discount Code', 'wp-multisite-waas'),
'updated_message' => __('Discount Code updated successfully!', 'wp-multisite-waas'),
'title_placeholder' => __('Enter Discount Code', 'wp-multisite-waas'),
'title_description' => '',
'save_button_label' => __('Save Discount Code', 'wp-multisite-waas'),
'save_description' => '',
'delete_button_label' => __('Delete Discount Code', 'wp-multisite-waas'),
'delete_description' => __('Be careful. This action is irreversible.', 'wp-multisite-waas'),
];
}
/**
* Returns the object being edit at the moment.
*
* @since 2.0.0
* @return \WP_Ultimo\Models\Discount_Code
*/
public function get_object() {
if (null !== $this->object) {
return $this->object;
}
if (isset($_GET['id'])) {
$item_id = wu_request('id', 0);
$item = wu_get_discount_code($item_id);
if ( ! $item) {
wp_safe_redirect(wu_network_admin_url('wp-ultimo-discount_codes'));
exit;
}
$this->object = $item;
return $this->object;
}
$this->object = new Discount_Code();
return $this->object;
}
/**
* Discount_Codes have titles.
*
* @since 2.0.0
*/
public function has_title(): bool {
return true;
}
/**
* Should implement the processes necessary to save the changes made to the object.
*
* @since 2.0.0
* @return void
*/
public function handle_save(): void {
/*
* Set the recurring value to zero if the toggle is disabled.
*/
if ( ! wu_request('apply_to_renewals')) {
$_POST['apply_to_renewals'] = false;
}
/*
* Set the limit products value.
*/
if ( ! wu_request('limit_products')) {
$_POST['limit_products'] = false;
}
/*
* Set the setup fee value to zero if the toggle is disabled.
*/
if ( ! wu_request('apply_to_setup_fee')) {
$_POST['setup_fee_value'] = 0;
}
/**
* Unset dates to prevent invalid dates
*/
if ( ! wu_request('enable_date_start') || ! wu_validate_date(wu_request('date_start'))) {
$_POST['date_start'] = null;
}
if ( ! wu_request('enable_date_expiration') || ! wu_validate_date(wu_request('date_expiration'))) {
$_POST['date_expiration'] = null;
}
$_POST['code'] = trim((string) wu_request('code'));
parent::handle_save();
}
}