Theme SCSS Compiler

Theme SCSS Compiler verwaltet beliebig viele SCSS → CSS-Paare deines aktiven Themes direkt aus dem WordPress-Backend (Werkzeuge → Theme SCSS Compiler). Es nutzt die mitgelieferte Library scssphp — kein Node.js, keine Build-Tools, keine Kommandozeile.

• Mehrere File-Pairs — beliebig viele SCSS → CSS Paare relativ zum aktiven Theme.
• Per-Pair Context — jedes Paar läuft entweder im Frontend (wp_enqueue_scripts) oder im Admin (admin_enqueue_scripts).
• Per-File-Versionierung — jedes Paar hat eine eigene Version. Bumps werden automatisch via style_loader_src-Filter angewendet, deine Theme-Files bleiben unangetastet.
• Smart Change-Detection — Version steigt nur, wenn sich der kompilierte CSS-Inhalt eines Paares wirklich geändert hat. Kein Cache-Busting für unveränderte Files.
• @import-aware Auto-Recompile — jeder Partial (@import, @use, @forward) wird verfolgt. Bearbeitest du nur einen Partial, triggert das beim nächsten Admin-Pageload automatisch eine Neukompilierung.
• Compressed (Production) oder Expanded (Development) SCSS-Output.
• Auto-Compile bei geänderter SCSS-Quelle oder fehlendem CSS-Output — keine weißen Layouts nach einem Deploy.
• Auto-Enqueue mit Duplikatserkennung — läuft mit PHP_INT_MAX-Priorität und überspringt bereits registrierte URLs.
• Manueller Compile-Button mit AJAX-Feedback und persistenter Fehleranzeige.
• Concurrent-Compile-Lock — Transient-basiertes Mutex verhindert Race-Conditions auf Multi-Admin-Seiten.
• Code-First-Konfiguration — alle Optionen via PHP-Konstanten in wp-config.php, im Theme oder via .env/Bedrock definierbar.
• Admin-only-Zugriff — alle Endpoints erfordern standardmäßig manage_options. Filterbar über theme_scss_compiler_capability.
• Modern — PHP 8.1+, WCAG 2.1 AA Admin-UI, deutsche Übersetzung out-of-the-box.

Das Plugin macht keine externen HTTP-Requests, setzt keine Cookies, betreibt keine Telemetrie und trackt keine Nutzer. Die gesamte Verarbeitung läuft lokal auf deinem Server. Die mitgelieferten Bibliotheken (scssphp, league/uri, symfony/filesystem, PSR HTTP Interfaces) sind MIT-lizenziert und GPL-kompatibel.

1. Lade den Ordner theme-scss-compiler nach /wp-content/plugins/ hoch.
2. Aktiviere das Plugin unter Plugins.
3. Gehe zu Werkzeuge → Theme SCSS Compiler und konfiguriere deine SCSS-/CSS-Pfade.
4. Klicke Jetzt kompilieren oder lade einfach eine Admin-Seite — Auto-Compile ist standardmäßig aktiv.