CssCompiler.php

Go to the documentation of this file.

<?php

namespace Elgg\Assets;

use CssCrush\Crush;
use Elgg\Config;
use Elgg\EventsService;
use Elgg\Includer;
use Elgg\Project\Paths;

class CssCompiler {

    protected Config $config;

    protected EventsService $events;

    public function __construct(Config $config, EventsService $events) {
        $this->config = $config;
        $this->events = $events;
    }

    public function compile($css, array $options = []): string {
        $defaults = [
            'minify' => false, // minify handled by \Elgg\Views\MinifyHandler::class
            'formatter' => 'single-line', // shows lowest byte size
            'versioning' => false, // versioning done by Elgg
            'rewrite_import_urls' => false,
            'boilerplate' => false,
        ];

        $config = (array) $this->config->css_compiler_options;

        $options = array_merge($defaults, $config, $options);
        $options['vars'] = $this->getCssVars($options);
    
        Crush::$process = new CssCrushProcess($options, ['type' => 'filter', 'data' => $css]);
        return Crush::$process->compile()->__toString();
    }
    
    public function getCssVars(array $compiler_options = [], bool $load_config_vars = true): array {
        $default_vars = array_merge($this->getCoreVars(), $this->getPluginVars());
        $custom_vars = (array) elgg_extract('vars', $compiler_options, []);
        $vars = array_merge($default_vars, $custom_vars);
        
        $results = (array) $this->events->triggerResults('vars:compiler', 'css', $compiler_options, $vars);
        
        if (!$load_config_vars) {
            return $results;
        }
        
        return array_merge($results, (array) elgg_get_config('custom_theme_vars', []));
    }

    protected function getCoreVars(): array {
        $file = Paths::elgg() . 'engine/theme.php';
        return Includer::includeFile($file);
    }

    protected function getPluginVars(): array {
        $return = [];
        
        $plugins = elgg_get_plugins('active');
        foreach ($plugins as $plugin) {
            $plugin_vars = $plugin->getStaticConfig('theme', []);
            if (empty($plugin_vars)) {
                continue;
            }
            
            $return = array_merge($return, $plugin_vars);
        }
        
        return $return;
    }
}