{"id":10568,"date":"2026-05-16T18:32:08","date_gmt":"2026-05-16T10:32:08","guid":{"rendered":"https:\/\/aeosub.com\/theme-scss-compiler\/"},"modified":"2026-05-16T18:32:08","modified_gmt":"2026-05-16T10:32:08","slug":"theme-scss-compiler","status":"publish","type":"post","link":"https:\/\/aeosub.com\/zh\/theme-scss-compiler\/","title":{"rendered":"Theme SCSS Compiler"},"content":{"rendered":"
\"Theme<\/div>\n
\n\n\n\n\n\n\n\n
Developer<\/th>\nSimon Mista<\/a><\/td>\n<\/tr>\n
Version<\/th>\nv1.0.0<\/td>\n<\/tr>\n
Active Installs<\/th>\n0 +<\/td>\n<\/tr>\n
Requires \/ Tested<\/th>\n6.3 \/ 6.9.4<\/td>\n<\/tr>\n
Last Updated<\/th>\n2026-05-16 9:38am GMT<\/td>\n<\/tr>\n
Official Link<\/th>\nView Details \u2192<\/a><\/td>\n<\/tr>\n<\/table><\/div>\n
Compile SCSS \/ Sass to CSS in the WP admin. Multiple file pairs, per-file versioning, @import-aware change detection, optional auto-compile.<\/div>\n

Theme SCSS Compiler lets you manage multiple SCSS \u2192<\/span> CSS pairs<\/strong> in the active theme directly from the WordPress admin (Tools \u2192<\/span> Theme SCSS Compiler). It uses the bundled scssphp library \u2014 no Node.js, no build tools, no command line. SCSS is the modern Sass syntax (CSS-superset with braces and semicolons).<\/p>\n

Features<\/h4>\n
    \n
  • Multiple file pairs<\/strong> \u2013 configure as many SCSS \u2192<\/span> CSS pairs as your theme needs (paths relative to the active theme).<\/li>\n
  • Per-pair Context<\/strong> \u2013 each pair runs on either the Frontend (wp_enqueue_scripts<\/code>) or the Admin (admin_enqueue_scripts<\/code>).<\/li>\n
  • Per-file versioning<\/strong> \u2013 each pair has its own version. Bumps are applied automatically via the style_loader_src<\/code> filter, so your theme files stay untouched.<\/li>\n
  • Smart change detection<\/strong> \u2013 the version only bumps when the compiled CSS content of that specific pair actually changed. No cache busting for files you didn’t touch.<\/li>\n
  • @import<\/code>-aware auto-recompile<\/strong> \u2013 every SCSS partial (@import<\/code>, @use<\/code>, @forward<\/code>) is tracked. Editing a partial alone triggers a recompile on the next admin page load \u2014 no need to touch the entry SCSS file.<\/li>\n
  • Compressed (production) or expanded (development)<\/strong> SCSS output.<\/li>\n
  • Auto-compile<\/strong> when an SCSS source (or any of its imports) changes or the CSS output is missing \u2013 no white layouts after a fresh deployment.<\/li>\n
  • Auto-enqueue<\/strong> \u2013 the plugin runs wp_enqueue_style()<\/code> for every configured pair on its respective context. Skips files that are already registered, so it never duplicates output.<\/li>\n
  • Manual compile button<\/strong> with live AJAX feedback and persistent error display in the admin.<\/li>\n
  • Concurrent-compile lock<\/strong> \u2013 a transient-based mutex prevents two admins triggering compiles at the same time from corrupting the CSS output.<\/li>\n
  • Code-first configuration<\/strong> \u2013 every option (pairs, output style, auto-compile, auto-enqueue, bump version) can be defined as a PHP constant in wp-config.php<\/code>, in your theme, or via your .env<\/code> \/ Bedrock workflow.<\/li>\n
  • Admin-only access<\/strong> \u2013 every endpoint requires the manage_options<\/code> capability by default. Filterable via tscsscompiler_capability<\/code> if you need to grant access to a custom role.<\/li>\n
  • Modern codebase<\/strong> \u2013 PHP 8.1+, WCAG 2.1 AA compliant admin UI, fully translated to German out of the box.<\/li>\n<\/ul>\n

    Privacy \/ GDPR<\/h4>\n

    This plugin makes no external HTTP requests<\/strong>, sets no cookies<\/strong>, runs no telemetry<\/strong>, and does not<\/strong> track users. All processing happens locally on your server. The bundled libraries (scssphp, league\/uri, symfony\/filesystem, PSR HTTP interfaces) are MIT licensed and GPL-compatible. Source code is included in the plugin’s vendor\/<\/code> directory.<\/p>","protected":false},"excerpt":{"rendered":"

    Compile SCSS \/ Sass to CSS in the WP admin. Multiple file pairs, per-file versioning, @import-aware change detection, optional auto-compile.<\/p>","protected":false},"author":1,"featured_media":9317,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[252],"tags":[935,936,937,938,939,555],"class_list":["post-10568","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-trends","tag-compiler","tag-css","tag-sass","tag-scss","tag-theme","tag-wordpress-plugin"],"_links":{"self":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts\/10568","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/comments?post=10568"}],"version-history":[{"count":0,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts\/10568\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/media\/9317"}],"wp:attachment":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/media?parent=10568"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/categories?post=10568"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/tags?post=10568"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}