draft-order-control.php

<?php
/**
 * Plugin Name: Draft Order Control
 * Plugin URI: https://github.com/davidrukahu/draft-order-control
 * Description: Control when and how WooCommerce creates draft orders. Manage all 4 draft order creation conditions with individual enable/disable toggles.
 * Version: 1.0.0
 * Author: DavidR
 * Author URI: https://github.com/davidrukahu
 * License: GPL-2.0-or-later
 * License URI: https://www.gnu.org/licenses/gpl-2.0.html
 * Text Domain: draft-order-control
 * Requires at least: 6.0
 * Requires PHP: 7.4
 * WC requires at least: 8.0
 * WC tested up to: 10.3
 *
 * @package DraftOrderControl
 */

defined( 'ABSPATH' ) || exit;

// Define plugin constants.
if ( ! defined( 'WCDOC_VERSION' ) ) {
	define( 'WCDOC_VERSION', '1.0.0' );
}

if ( ! defined( 'WCDOC_PLUGIN_FILE' ) ) {
	define( 'WCDOC_PLUGIN_FILE', __FILE__ );
}

if ( ! defined( 'WCDOC_PLUGIN_DIR' ) ) {
	define( 'WCDOC_PLUGIN_DIR', plugin_dir_path( __FILE__ ) );
}

if ( ! defined( 'WCDOC_PLUGIN_URL' ) ) {
	define( 'WCDOC_PLUGIN_URL', plugin_dir_url( __FILE__ ) );
}

if ( ! defined( 'WCDOC_PLUGIN_BASENAME' ) ) {
	define( 'WCDOC_PLUGIN_BASENAME', plugin_basename( __FILE__ ) );
}

/**
 * Main plugin class.
 *
 * @class WCDOC_Plugin
 */
final class WCDOC_Plugin {

	/**
	 * Plugin version.
	 *
	 * @var string
	 */
	public $version = WCDOC_VERSION;

	/**
	 * The single instance of the class.
	 *
	 * @var WCDOC_Plugin
	 */
	protected static $_instance = null;

	/**
	 * Main WCDOC_Plugin Instance.
	 *
	 * Ensures only one instance of WCDOC_Plugin is loaded or can be loaded.
	 *
	 * @return WCDOC_Plugin - Main instance.
	 */
	public static function instance() {
		if ( is_null( self::$_instance ) ) {
			self::$_instance = new self();
		}
		return self::$_instance;
	}

	/**
	 * Cloning is forbidden.
	 */
	public function __clone() {
		wc_doing_it_wrong( __FUNCTION__, __( 'Cloning is forbidden.', 'draft-order-control' ), '1.0.0' );
	}

	/**
	 * Unserializing instances of this class is forbidden.
	 */
	public function __wakeup() {
		wc_doing_it_wrong( __FUNCTION__, __( 'Unserializing instances of this class is forbidden.', 'draft-order-control' ), '1.0.0' );
	}

	/**
	 * Constructor.
	 */
	public function __construct() {
		$this->init_hooks();
	}

	/**
	 * Hook into actions and filters.
	 */
	private function init_hooks() {
		add_action( 'before_woocommerce_init', array( $this, 'declare_feature_compatibility' ) );
		add_action( 'plugins_loaded', array( $this, 'init' ), 0 );
		register_activation_hook( WCDOC_PLUGIN_FILE, array( $this, 'activate' ) );
		register_deactivation_hook( WCDOC_PLUGIN_FILE, array( $this, 'deactivate' ) );
	}

	/**
	 * Declare compatibility with WooCommerce features.
	 */
	public function declare_feature_compatibility() {
		if ( ! class_exists( '\Automattic\WooCommerce\Utilities\FeaturesUtil' ) ) {
			return;
		}

		// Declare compatibility with High-Performance Order Storage (HPOS).
		\Automattic\WooCommerce\Utilities\FeaturesUtil::declare_compatibility( 'custom_order_tables', WCDOC_PLUGIN_FILE, true );
		
		// Declare compatibility with Cart and Checkout Blocks.
		\Automattic\WooCommerce\Utilities\FeaturesUtil::declare_compatibility( 'cart_checkout_blocks', WCDOC_PLUGIN_FILE, true );
	}

	/**
	 * Init plugin when WordPress Initialises.
	 */
	public function init() {
		// Check if WooCommerce is active.
		if ( ! $this->is_woocommerce_active() ) {
			add_action( 'admin_notices', array( $this, 'woocommerce_missing_notice' ) );
			return;
		}

		// Load text domain.
		$this->load_plugin_textdomain();

		// Include required files.
		$this->includes();

		// Initialize plugin components.
		$this->init_components();
	}

	/**
	 * Check if WooCommerce is active.
	 *
	 * @return bool
	 */
	private function is_woocommerce_active() {
		return class_exists( 'WooCommerce' );
	}

	/**
	 * Display notice if WooCommerce is not active.
	 */
	public function woocommerce_missing_notice() {
		?>
		<div class="error">
			<p>
				<?php
				echo esc_html__( 'WooCommerce Draft Order Control requires WooCommerce to be installed and active.', 'draft-order-control' );
				?>
			</p>
		</div>
		<?php
	}

	/**
	 * Load plugin text domain.
	 * Note: For WordPress.org hosted plugins, translations are loaded automatically.
	 */
	private function load_plugin_textdomain() {
		// WordPress.org automatically loads translations for plugins.
		// Only load manually if needed for non-WordPress.org installations.
		if ( ! apply_filters( 'wcdoc_load_textdomain', false ) ) {
			return;
		}

		// phpcs:ignore PluginCheck.CodeAnalysis.DiscouragedFunctions.load_plugin_textdomainFound -- Conditionally executed only for non-WordPress.org installations via filter.
		load_plugin_textdomain(
			'draft-order-control',
			false,
			dirname( WCDOC_PLUGIN_BASENAME ) . '/languages'
		);
	}

	/**
	 * Include required core files.
	 */
	private function includes() {
		require_once WCDOC_PLUGIN_DIR . 'includes/class-wcdoc-plugin.php';
		require_once WCDOC_PLUGIN_DIR . 'includes/class-wcdoc-settings.php';
		require_once WCDOC_PLUGIN_DIR . 'includes/class-wcdoc-controller.php';

		if ( is_admin() ) {
			require_once WCDOC_PLUGIN_DIR . 'admin/class-wcdoc-admin.php';
		}
	}

	/**
	 * Initialize plugin components.
	 */
	private function init_components() {
		WCDOC_Settings::instance();
		WCDOC_Controller::instance();

		if ( is_admin() ) {
			WCDOC_Admin::instance();
		}
	}

	/**
	 * Plugin activation.
	 */
	public function activate() {
		// Set default options if they don't exist.
		if ( ! get_option( 'wcdoc_settings' ) ) {
			$default_settings = array(
				'master_toggle' => true,
				'conditions'   => array(
					'store_api_checkout' => array(
						'enabled' => true,
						'status'  => 'checkout-draft',
					),
					'rest_api_v4_error' => array(
						'enabled' => true,
						'status'  => 'checkout-draft',
					),
					'rest_api_v3_error' => array(
						'enabled' => true,
						'status'  => 'checkout-draft',
					),
					'admin_manual' => array(
						'enabled' => true,
						'status'  => 'auto-draft',
					),
				),
			);
			add_option( 'wcdoc_settings', $default_settings );
		}
	}

	/**
	 * Plugin deactivation.
	 */
	public function deactivate() {
		// Clean up any scheduled events if needed.
		// Note: We keep settings intact on deactivation.
	}
}

/**
 * Main instance of WCDOC_Plugin.
 *
 * Returns the main instance of WCDOC to prevent the need to use globals.
 *
 * @return WCDOC_Plugin
 */
function WCDOC() {
	return WCDOC_Plugin::instance();
}

// Initialize the plugin.
WCDOC();