SimpleAsset.module.php

<?php

declare(strict_types=1);

namespace ProcessWire;

/** @property \ProcessWire\ProcessWire $wire */
class SimpleAsset extends WireData implements Module, ConfigurableModule
{
    /** @var \SimpleWire\Asset\AssetManager */
    protected $assetManager;

    public static function getModuleInfo(): array
    {
        return [
            'title'    => 'SimpleAsset',
            'version'  => '0.1.0',
            'summary'  => 'Asset management for ProcessWire. Resolves, groups, and renders CSS/JS assets from CDN sources or local paths with cache-busting, SRI, and inline threshold support.',
            'icon'     => 'file-code-o',
            'author'   => 'WireCodex',
            'autoload' => true,
            'singular' => true,
            'requires' => 'ProcessWire>=3.0.200,PHP>=8.1',
        ];
    }

    // ========================================
    // Lifecycle
    // ========================================

    public function init(): void
    {
        spl_autoload_register(function (string $class): void {
            $prefix = 'SimpleWire\\Asset\\';
            if (!str_starts_with($class, $prefix)) return;
            $file = __DIR__ . '/classes/' . substr($class, strlen($prefix)) . '.php';
            if (file_exists($file)) require_once $file;
        });

        $config = array_merge(
            \SimpleWire\Asset\AssetManager::getDefaults(),
            (array) $this->wire('modules')->getConfig($this)
        );

        $this->assetManager = new \SimpleWire\Asset\AssetManager($config, $this->wire);

        $this->wire('simpleasset', $this->assetManager);

        require_once __DIR__ . '/functions.php';
    }

    // ========================================
    // Config UI
    // ========================================

    public static function getModuleConfigInputfields(array $data): InputfieldWrapper
    {
        $modules = wire()->modules;
        $defaults = \SimpleWire\Asset\AssetManager::getDefaults();
        $data = array_merge($defaults, $data);

        /** @var InputfieldWrapper $wrapper */
        $wrapper = $modules->get('InputfieldWrapper');

        // ---- Asset Settings ----

        /** @var InputfieldFieldset $fieldset */
        $fieldset              = $modules->get('InputfieldFieldset');
        $fieldset->label       = 'Asset Settings';
        $fieldset->description = 'Asset management configuration';
        $fieldset->icon        = 'file-code-o';

        /** @var InputfieldText $field */
        $field              = $modules->get('InputfieldText');
        $field->name        = 'destination_url';
        $field->label       = 'Destination URL';
        $field->description = 'URL path where combined/minified assets are stored';
        $field->columnWidth = 50;
        $field->value       = $data['destination_url'];
        $fieldset->add($field);

        /** @var InputfieldText $field */
        $field              = $modules->get('InputfieldText');
        $field->name        = 'destination_cdn';
        $field->label       = 'CDN URL';
        $field->description = 'Set to CDN URL when using external CDN (leave empty for local)';
        $field->columnWidth = 50;
        $field->value       = $data['destination_cdn'];
        $fieldset->add($field);

        /** @var InputfieldInteger $field */
        $field              = $modules->get('InputfieldInteger');
        $field->name        = 'inline_threshold';
        $field->label       = 'Inline Threshold (bytes)';
        $field->description = 'Inline files smaller than this size';
        $field->columnWidth = 33;
        $field->value       = $data['inline_threshold'];
        $fieldset->add($field);

        /** @var InputfieldSelect $field */
        $field              = $modules->get('InputfieldSelect');
        $field->name        = 'cache_buster';
        $field->label       = 'Cache Busting';
        $field->description = 'Method for cache busting asset URLs';
        $field->columnWidth = 33;
        $field->value       = $data['cache_buster'];
        $field->addOptions([
            'auto'      => 'Auto (file hash)',
            'timestamp' => 'Timestamp',
            'false'     => 'Disabled',
        ]);
        $fieldset->add($field);

        /** @var InputfieldCheckboxes $field */
        $field              = $modules->get('InputfieldCheckboxes');
        $field->name        = 'asset_flags';
        $field->label       = 'Asset Flags';
        $field->columnWidth = 34;
        $field->addOptions([
            'minify'  => 'Minify combined files (coming soon — not yet active)',
            'combine' => 'Combine multiple files into one (coming soon — not yet active)',
            'sri'     => 'Generate Subresource Integrity hashes',
            'defer'   => 'Add defer attribute to scripts',
            'async'   => 'Add async attribute to scripts',
        ]);
        $checked = [];
        foreach (['minify', 'combine', 'sri', 'defer', 'async'] as $flag) {
            if (!empty($data[$flag])) $checked[] = $flag;
        }
        $field->value = $checked;
        $fieldset->add($field);

        $wrapper->add($fieldset);

        return $wrapper;
    }
}