TITANIUM SUITE HEADER
=====================

Reusable Platinum admin header for Titanium plugins.
The package does not hardcode any plugin/product title.

FILES
-----
- titanium-suite-header.php
- assets/titanium-suite-header.css
- assets/titanium-suite-header-head.js
- assets/titanium-suite-header.js

INSTALLATION
------------
1. Copy the whole "titanium-suite-header" folder into the plugin, for example:
   your-plugin/includes/titanium-suite-header/

2. Load the component from the plugin:

   require_once YOUR_PLUGIN_DIR . 'includes/titanium-suite-header/titanium-suite-header.php';

3. Enqueue it only on that plugin's admin pages:

   add_action(
       'admin_enqueue_scripts',
       static function ( $hook_suffix ) {
           if ( 'toplevel_page_your-plugin-slug' !== $hook_suffix ) {
               return;
           }

           Titanium_Suite_Header::enqueue_assets(
               array(
                   'storage_key'      => 'titaniumSuiteDarkMode',
                   'extra_dark_class' => 'your-plugin-admin-dark'
               )
           );
       }
   );

4. Render the header inside the plugin page:

   Titanium_Suite_Header::render(
       array(
           'title'            => 'Your Plugin Name',
           'edition'          => 'Free',
           'version'          => YOUR_PLUGIN_VERSION,
           'storage_key'      => 'titaniumSuiteDarkMode',
           'extra_dark_class' => 'your-plugin-admin-dark'
       )
   );

NOTES
-----
- Use edition "Free" or "Pro" as needed.
- The TITANIUM badge and the Free/Pro version badge are included.
- The product title is supplied through the "title" argument; Maintenance Mode is not included.
- The standard class "titanium-suite-admin-dark" is always toggled for the header itself.
- "extra_dark_class" can also toggle the existing dark-mode class of the host plugin.
- Using the shared storage key makes the preference consistent across Titanium plugins.
