Every ATA plugin is managed by a central, root Controller. This main controller is the entry point for all plugin functionality and is responsible for managing the plugin’s lifecycle.

1. The Main Plugin File (your-plugin-name.php) This file is very minimal. Its only jobs are to define essential constants, load the ATA framework, and instantiate your main controller.

// in your-plugin-name.php
namespace YourPluginNamespace;

// ... define constants ...

// Load the framework and all its dependencies
require_once  PLUGIN_PATH . '/inc/main.php';

// Instantiate the one and only root controller
$my_plugin = new MainController();

// Hook into WordPress's activation/deactivation events
register_activation_hook(PLUGIN_FILE, [$my_plugin, 'activate']);
register_deactivation_hook(PLUGIN_FILE, [$my_plugin, 'deactivate']);

2. The Main Controller (app/controllers/main-controller.php) This controller contains the activation/deactivation logic and, most importantly, it loads all other controllers. This is where you can conditionally load features based on whether other plugins are active, saving memory and preventing errors.

// in app/controllers/main-controller.php
namespace YourPluginNamespace;

class MainController extends Controller
{
    public function __construct()
    {
        parent::__construct();
        $this->load_features();
    }

    // Load other controllers for specific features
    private function load_features()
    {
        // Always load the admin UI and asset controllers
        (new AdminUiController())->main();
        (new AssetsController())->main();

        // **Conditionally load features**
        // Only load the WooCommerce compatibility layer if WooCommerce is active
        if (is_plugin_active('woocommerce/woocommerce.php')) {
            (new WooCommerceController())->main();
        }
    }

    // Logic for when the plugin is activated (e.g., create DB tables)
    public function activate()
    {
        // ... your activation code ...
    }

    // Logic for when the plugin is deactivated (e.g., remove DB tables)
    public function deactivate()
    {
        // ... your deactivation code ...
    }
}