<?php
declare( strict_types = 1 );
namespace Automattic\WooCommerce\Internal\StockNotifications\Admin;
use Automattic\WooCommerce\Internal\StockNotifications\Config;
use Automattic\WooCommerce\Internal\StockNotifications\Frontend\MyAccountEndpoint;
/**
* Settings controller for Customer Stock Notifications.
*/
class SettingsController {
/**
* Constructor.
*/
public function __construct() {
// Add a 'Customer stock notifications' section to Products settings.
add_filter( 'woocommerce_get_sections_products', array( $this, 'add_customer_stock_notifications_section' ), 100, 1 );
// Add the Customer Stock Notifications settings.
add_filter( 'woocommerce_get_settings_products', array( $this, 'add_customer_stock_notifications_settings' ), 100, 2 );
// Add the My Account endpoint setting to the Advanced tab.
add_filter( 'woocommerce_get_settings_advanced', array( $this, 'add_my_account_endpoint_setting' ), 100, 2 );
add_filter( 'woocommerce_admin_settings_sanitize_option_woocommerce_customer_stock_notifications_unverified_deletions_days_threshold', array( $this, 'sanitize_unverified_deletion_days_threshold' ) );
// The product edit hooks stay admin-only: process_product_object() reads $_POST and
// checks an admin nonce, so it must not run for cron or CLI code that fires the hook.
if ( ! is_admin() ) {
return;
}
// Display admin notices about incompatible settings combinations.
add_action( 'admin_notices', array( $this, 'output_admin_notices' ) );
// Display and save product-level stock notifications option.
add_action( 'woocommerce_product_options_stock_status', array( $this, 'add_disable_stock_notifications_checkbox' ), 20 );
add_action( 'woocommerce_admin_process_product_object', array( $this, 'process_product_object' ) );
}
/**
* Add the stock notifications endpoint setting to Settings > Advanced > Account endpoints.
*
* Sits with the core account endpoints rather than in the feature's own section, since
* everything that reads it is the endpoint plumbing core owns. Unlike the core entries it
* only shows while the feature is enabled, because this controller loads with the feature.
*
* @param array $settings Original settings.
* @param string $section_id Settings section identifier.
* @return array New settings.
*/
public function add_my_account_endpoint_setting( $settings, $section_id ) {
if ( ! is_array( $settings ) ) {
return $settings;
}
if ( '' !== $section_id ) {
return $settings;
}
$setting = array(
'title' => __( 'Stock notifications', 'woocommerce' ),
'desc' => __( 'Endpoint for the "My account → Stock notifications" page.', 'woocommerce' ),
'id' => MyAccountEndpoint::ENDPOINT_OPTION,
'type' => 'text',
'default' => MyAccountEndpoint::ENDPOINT,
'desc_tip' => true,
);
// Slot it right after Downloads so it sits with the other list endpoints,
// otherwise before Logout so Logout stays last, otherwise at the end of the group.
$position = 0;
foreach ( array_values( $settings ) as $index => $field ) {
if ( ! is_array( $field ) || ! isset( $field['id'] ) ) {
continue;
}
if ( 'woocommerce_myaccount_downloads_endpoint' === $field['id'] ) {
$position = $index + 1;
break;
}
if ( 'woocommerce_logout_endpoint' === $field['id'] || ( 'account_endpoint_options' === $field['id'] && 'sectionend' === ( $field['type'] ?? '' ) ) ) {
$position = $index;
break;
}
}
if ( 0 === $position ) {
return $settings;
}
array_splice( $settings, $position, 0, array( $setting ) );
return $settings;
}
/**
* Add a 'Customer stock notifications' section to Products settings.
*
* @param array $sections Products settings sections.
* @return array New Products settings sections.
*/
public function add_customer_stock_notifications_section( $sections ) {
if ( ! is_array( $sections ) ) {
return $sections;
}
$section_title = __( 'Customer stock notifications', 'woocommerce' );
// Add 'Customer stock notifications' section to the Products tab, after Inventory.
$inventory_index = array_search( 'inventory', array_keys( $sections ), true );
if ( false !== $inventory_index ) {
$sections = array_slice( $sections, 0, $inventory_index + 1, true ) +
array( 'customer_stock_notifications' => $section_title ) +
array_slice( $sections, $inventory_index + 1, null, true );
} else {
$sections['customer_stock_notifications'] = $section_title;
}
return $sections;
}
/**
* Add the Customer Stock Notifications settings.
*
* @param array $settings Original settings.
* @param string $section_id Settings section identifier.
* @return array New settings.
*/
public function add_customer_stock_notifications_settings( $settings, $section_id ) {
if ( ! is_array( $settings ) ) {
return $settings;
}
if ( 'customer_stock_notifications' !== $section_id ) {
return $settings;
}
/**
* Filter the Customer Stock Notifications settings.
*
* @since 10.2.0
*
* @param array $default_customer_stock_notifications_settings The default Customer Stock Notifications settings.
*/
$stock_notification_settings = apply_filters(
'woocommerce_customer_stock_notifications_settings',
array(
array(
'title' => __( 'Customer stock notifications', 'woocommerce' ),
'type' => 'title',
'desc' => '',
'id' => 'product_customer_stock_notifications_options',
),
array(
'title' => __( 'Allow sign-ups', 'woocommerce' ),
'desc' => __( 'Let customers sign up to be notified when products in your store are restocked.', 'woocommerce' ),
'id' => 'woocommerce_customer_stock_notifications_allow_signups',
'default' => 'no',
'type' => 'checkbox',
),
array(
'title' => __( 'Require double opt-in to sign up', 'woocommerce' ),
'desc' => __( 'To complete the sign-up process, customers must follow a verification link sent to their e-mail after submitting the sign-up form.', 'woocommerce' ),
'id' => 'woocommerce_customer_stock_notifications_require_double_opt_in',
'default' => 'no',
'type' => 'checkbox',
),
array(
'title' => __( 'Delete unverified notification sign-ups after (in days)', 'woocommerce' ),
'desc' => __( 'Controls how long unverified notification sign-ups are stored in the database. Enter zero, or leave this field empty, to store unverified sign-up requests indefinitely.', 'woocommerce' ),
'id' => 'woocommerce_customer_stock_notifications_unverified_deletions_days_threshold',
'default' => Config::get_unverified_deletion_days_threshold(),
'value' => Config::get_unverified_deletion_days_threshold(),
'type' => 'number',
'custom_attributes' => array(
'min' => 0,
'step' => 1,
),
),
array(
'title' => __( 'Require login', 'woocommerce' ),
'desc' => __( 'Customers must be logged in to sign up for stock notifications.', 'woocommerce' ),
'id' => 'woocommerce_customer_stock_notifications_require_account',
'default' => 'no',
'type' => 'checkbox',
'desc_tip' => __( 'When enabled, guests see a login prompt instead of the sign-up form.', 'woocommerce' ),
),
array(
'type' => 'sectionend',
'id' => 'product_customer_stock_notifications_options',
),
)
);
$settings = array_merge( $settings, $stock_notification_settings );
return $settings;
}
/**
* Store negative values of the unverified sign-up deletion threshold as 0, which turns the cleanup off.
*
* An empty value is kept as is, since it also means off.
*
* @internal
*
* @since 11.3.0
*
* @param mixed $value The value about to be saved.
* @return mixed
*/
public function sanitize_unverified_deletion_days_threshold( $value ) {
if ( null === $value || '' === $value ) {
return $value;
}
return max( 0, (int) $value );
}
/**
* Display admin notices about incompatible settings combinations.
*
* @return void
*/
public function output_admin_notices() {
// Only show notices on the Customer Stock Notifications settings page.
$screen = get_current_screen();
if ( ! $screen || 'woocommerce_page_wc-settings' !== $screen->id || ! isset( $_GET['section'] ) || 'customer_stock_notifications' !== $_GET['section'] ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended
return;
}
if ( 'yes' === get_option( 'woocommerce_hide_out_of_stock_items' ) && Config::allows_signups() ) {
wp_admin_notice(
sprintf(
/* translators: %s settings page link */
__( 'WooCommerce is currently <a href="%s">configured</a> to hide out-of-stock products from your catalog. Customers will not be able sign up for back-in-stock notifications while this option is enabled.', 'woocommerce' ),
esc_url( admin_url( 'admin.php?page=wc-settings&tab=products§ion=inventory' ) )
),
array(
'id' => 'message',
'type' => 'warning',
'dismissible' => false,
)
);
}
}
/**
* Setting to allow admins disabling bis on product level.
*
* @return void
*/
public function add_disable_stock_notifications_checkbox() {
if ( ! Config::allows_signups() ) {
return;
}
global $product_object;
if ( ! is_a( $product_object, 'WC_Product' ) ) {
return;
}
$enable_signups = 'no' !== $product_object->get_meta( Config::get_product_signups_meta_key() ) ? 'yes' : 'no';
wp_nonce_field( 'woocommerce-customer-stock-notifications-edit-product', 'customer_stock_notifications_edit_product_security' );
woocommerce_wp_checkbox(
array(
'id' => Config::get_product_signups_meta_key(),
'label' => __( 'Stock notifications', 'woocommerce' ),
'value' => $enable_signups,
'wrapper_class' => implode(
' ',
array_map(
function ( $type ) {
return 'show_if_' . $type;
},
Config::get_supported_product_types()
)
),
'description' => __( 'Let customers sign up to be notified when this product is restocked', 'woocommerce' ),
)
);
}
/**
* Save product settings meta.
*
* @param WC_Product $product The product object.
* @return void
*/
public static function process_product_object( $product ) {
// Without the nonce field the checkbox was not rendered, so there is nothing to save.
if ( ! isset( $_POST['customer_stock_notifications_edit_product_security'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing -- Only checks presence; the nonce is verified before saving.
return;
}
if ( ! Config::allows_signups() ) {
return;
}
if ( ! is_a( $product, 'WC_Product' ) ) {
return;
}
if ( ! $product->is_type( Config::get_supported_product_types() ) ) {
return;
}
$posted_is_enabled = isset( $_POST[ Config::get_product_signups_meta_key() ] );
$current_enabled = 'no' !== $product->get_meta( Config::get_product_signups_meta_key() );
if ( $posted_is_enabled !== $current_enabled ) {
check_admin_referer( 'woocommerce-customer-stock-notifications-edit-product', 'customer_stock_notifications_edit_product_security' );
$product->update_meta_data( Config::get_product_signups_meta_key(), $posted_is_enabled ? 'yes' : 'no' );
}
}
}