SCSS Compiler

SCSS_compiler.png
1.0.6 phpBB 3.3.8
Released:
Sat Dec 10, 2022 1:58 pm
File size:
354.87 KiB
Validated for:
phpBB 3.3.8
MD5 checksum:
12d474a596decd5525313428e66051c0
Install directory:
ext/phpbbservices/scsscompiler
Dependencies:
scssphp/scssphp
Description
Some phpBB styles are written in a SASS (Syntactically Awesome Stylesheets) syntax and generate .scss files. These .scss files are then compiled by a SCSS compiler, generating a CSS file which is used to render the style. The Elegance style by Artodia is one such example. SCSS files offer additional flexibility in configuring and maintaining a style. You make changes to the .scss files then recompile the style.

However, there is no way to compile these styles within phpBB. This extension compiles these files. Once installed, you will find it on the Customise tab: ACP > Customise > Style management > SCSS compiler

You should backup the styles' theme folders before editing any files. Typically the compiled files are placed in the /store/phpbbservices/scsscompiler folder. You then move them manually into the applicable theme folder for the compiled style. But if the theme folder for the compiled styles is writable, the extension will overwrite the old stylesheet.css file; hence the need to make sure it is backed up.

The extension uses the integrated SCSSPHP PHP library to compile these styles. If there is a SCSS syntax error, it will appear on an error screen. You can use this to fix the error.

Only installed SCSS-based styles can be compiled. Inactive styles can be compiled but uninstalled styles cannot be.
  • Revisions
    Version
    phpBB Version(s)