theme-core.php

<?php 
/**
 * Theme Core
 * 
 * @package   Theme_Core
 * @author    Suhag Ahmed
 * @category  Core
 * @copyright 2025 Suhag Ahmed
 * 
 * @wordpress-plugin
 * Plugin Name:       Theme Core
 * Plugin URI:        https://github.com/suhag10/theme-core
 * Description:       The Ultimate Elementor and WooCommerce Customizer Widgets.
 * Version:           1.0.0
 * Requires at least: 6.0
 * Requires PHP:      7.4
 * Author:            Suhag Ahmed
 * Author URI:        https://github.com/suhag10
 * Text Domain:       theme-core
 * License:           GPLv3-or-later
 * License URI:       https://www.gnu.org/licenses/gpl-3.0.html
 */

if ( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly

/**
 * Main Theme Core Class
 *
 */
final class Theme_Core {

	/**
	 * Plugin Version
	 *
	 * @since 1.0.0
	 * @var string The plugin version.
	 */
	const VERSION = '1.0.0';

	/**
	 * Plugin Name
	 *
	 * @since 1.0.0
	 * @var string The plugin name.
	 */
	const PLUGIN_NAME = 'Theme Core';

	/**
	 * Minimum Elementor Version
	 *
	 * @since 1.0.0
	 * @var string Minimum Elementor version required to run the plugin.
	 */
	const MINIMUM_ELEMENTOR_VERSION = '3.0.0';

	/**
	 * Minimum PHP Version
	 *
	 * @since 1.0.0
	 * @var string Minimum PHP version required to run the plugin.
	 */
	const MINIMUM_PHP_VERSION = '7.4';

    /**
     * @var object
     *
     * @since 1.0.0
     */
    private static $instance;

	/**
     * Initializes a singleton instance
     *
     * @return \Theme_Core
     */
	public static function init() {
        if ( ! isset( self::$instance ) && ! ( self::$instance instanceof Theme_Core ) ) {
            self::$instance = new Theme_Core();
            self::$instance->plugin_setup();
        }
        return self::$instance;
    }

    /**
     * Setup the plugin
     *
     * Sets up all the appropriate hooks and actions within our plugin.
     *
     * @since 1.0.0
     *
     * @return void
     */
    private function plugin_setup() {

        // Check if Elementor installed and activated
		if ( ! did_action( 'elementor/loaded' ) ) {
			add_action( 'admin_notices', array( $this, 'missing_main_plugin' ) );
			return;
		}

		// Check for required Elementor version
		if ( ! version_compare( ELEMENTOR_VERSION, self::MINIMUM_ELEMENTOR_VERSION, '>=' ) ) {
			add_action( 'admin_notices', array( $this, 'minimum_elementor_version' ) );
			return;
		}

		// Check for required PHP version
		if ( version_compare( PHP_VERSION, self::MINIMUM_PHP_VERSION, '<' ) ) {
			add_action( 'admin_notices', array( $this, 'minimum_php_version' ) );
			return;
		}

        $this->define_constants();
        $this->includes();
        $this->instantiate();
        $this->init_actions();
    }

	/**
     * Define the required plugin constants
     *
     * @return void
     */
    public function define_constants() {
		define('THEME_CORE_VERSION',  self::VERSION);
		define('THEME_CORE_NAME',  preg_replace('/[^\w \t@]+|@(?!\w)|[0-9_]/','',self::PLUGIN_NAME));
		define('THEME_CORE_DIR', __DIR__);
		define('THEME_CORE_FILE', __FILE__);
		define('THEME_CORE_PATH', plugin_dir_path(THEME_CORE_FILE));
		define('THEME_CORE_URL', plugins_url( '', THEME_CORE_FILE));
		define('THEME_CORE_ASSETS', THEME_CORE_URL . '/assets');
		define('THEME_CORE_TEMPLATE_PATH', THEME_CORE_PATH . 'templates');
		define('THEME_CORE_ACTIVE_THEME_PATH', get_template_directory());
		define('THEME_CORE_ACTIVE_THEME_URL', get_template_directory_uri());
    }

    /**
     * Include the required files
     *
     * @return void
     */
    private function includes() {
        require_once THEME_CORE_DIR . '/autoload.php';
    }

    /**
     * Instantiate classes
     *
     * @since 1.0.0
     *
     * @return void
     */
    private function instantiate() {

        new ThemeCore\Installer();
        new ThemeCore\Assets();
        new ThemeCore\Ajax();
        new ThemeCore\Utils();
        new ThemeCore\Manager();
        new ThemeCore\Frontend();
        
		if ( is_admin() ) {
            new ThemeCore\Admin();
        }
    }

    /**
     * Initialize WordPress action hooks
     *
     * @since 1.0.0
     *
     * @return void
     */
    private function init_actions() {
        // Load theme-core text domain for translation
        load_plugin_textdomain( 'theme-core', false, dirname( plugin_basename( __FILE__ ) ) . '/languages' ); 
    }

    /**
	 * Admin notice
	 *
	 * Warning when the site doesn't have Elementor installed or activated.
	 *
	 * @since 1.0.0
	 * @access public
	 */
	public function missing_main_plugin() {
		if ( isset( $_GET['activate'] ) ) {
			unset( $_GET['activate'] );
		}

		$message = sprintf(
			/* translators: 1: Plugin name 2: Elementor */
			esc_html__( '"%1$s" requires "%2$s" to be installed and activated.', 'theme-core' ),
			'<strong>' . esc_html__( 'Theme Core', 'theme-core' ) . '</strong>',
			'<strong>' . esc_html__( 'Elementor', 'theme-core' ) . '</strong>'
		);

		printf( '<div class="notice notice-warning is-dismissible"><p>%1$s</p></div>', $message );
	}

	/**
	 * Admin notice
	 *
	 * Warning when the site doesn't have a minimum required Elementor version.
	 *
	 * @since 1.0.0
	 * @access public
	 */
	public function minimum_elementor_version() {
		if ( isset( $_GET['activate'] ) ) {
			unset( $_GET['activate'] );
		}

		$message = sprintf(
			/* translators: 1: Plugin name 2: Elementor 3: Required Elementor version */
			esc_html__( '"%1$s" requires "%2$s" version %3$s or greater.', 'theme-core' ),
			'<strong>' . esc_html__( 'Theme Core', 'theme-core' ) . '</strong>',
			'<strong>' . esc_html__( 'Elementor', 'theme-core' ) . '</strong>',
			self::MINIMUM_ELEMENTOR_VERSION
		);

		printf( '<div class="notice notice-warning is-dismissible"><p>%1$s</p></div>', $message );
	}

	/**
	 * Admin notice
	 *
	 * Warning when the site doesn't have a minimum required PHP version.
	 *
	 * @since 1.0.0
	 * @access public
	 */
	public function minimum_php_version() {
		if ( isset( $_GET['activate'] ) ) {
			unset( $_GET['activate'] );
		}

		$message = sprintf(
			/* translators: 1: Plugin name 2: PHP 3: Required PHP version */
			esc_html__( '"%1$s" requires "%2$s" version %3$s or greater.', 'theme-core' ),
			'<strong>' . esc_html__( 'Theme Core', 'theme-core' ) . '</strong>',
			'<strong>' . esc_html__( 'PHP', 'theme-core' ) . '</strong>',
			self::MINIMUM_PHP_VERSION
		);

		printf( '<div class="notice notice-warning is-dismissible"><p>%1$s</p></div>', $message );
	}
}

// Initializes the main plugin
function theme_core() {
	return Theme_Core::init();
}

// Kick off the plugin.
add_action( 'plugins_loaded', 'theme_core' );