FAIR

Federated and Independent Repositories

Discover, trust, install: FAIR 1.0 is here

Plugin Banner

WP-SCSS

by Connect Think

Version: 4.0.4

Download
Description

Compiles .scss files on your wordpress install using ScssPhp. Includes settings page for configuring directories, error reporting, compiling options, and auto enqueuing.

The plugin only compiles when changes have been made to the scss files. Compiles are made to the matching css file, so disabling this plugin will not take down your stylesheets. In the instance where a matching css file does not exist yet, the plugin will create the appropriate css file in the css directory.

Get detailed instructions on github

Looking for a new maintainer

If you are interested in giving back to the open source plugin respond here with your interest

  1. Upload plugin to plugins directory
  2. Active plugin through the ‘Plugins’ menu in WordPress
  3. Configure plugin options through settings page settings -> WP-SCSS.
Can I use a child theme?

Yes, absolutely. Make sure you define your directories relative to your child theme and that your child theme is active. Otherwise you’ll see an error regarding missing directories.

What version of PHP is required?

PHP 7.2 is required to run WP-SCSS

How do I @import subfiles

You can import other scss files into parent files and compile them into a single css file. To do this, use @import as normal in your scss file. All imported file names must start with an underscore. Otherwise they will be compiled into their own css file.

When importing in your scss file, you can leave off the underscore.

@import 'subfile';

Does this plugin support Compass?

Currently there isn’t a way to fully support compass with a php compiler. If you want limited support, you can manually import the compass framework. You’ll need both the _compass.scss and compass directory.

compass / frameworks / compass / stylesheets /@import ‘compass’;`

Alternatively, you can include Bourbon in a similar fashion.

Can I use .sass syntax with this Plugin?

This plugin will only work with .scss format.

It’s not updating my css, what’s happening?

Do you have errors printing to the front end? If not, check your log file in your scss directory. The css will not be updated if there are errors in your sass file(s).

Make sure your directories are properly defined in the settings. Paths are defined from the root of the theme.

I’m having other issues and need help

If you are having issues with the plugin, create an issue on github, and we’ll do our best to help.

Doent do anything

By rhavin0 on August 17, 2024

  • The settings for "auto enque" and "always recompile" dont get saved.
  • It doesnt do anything. I configured two folders /precompile/css/ and precompile/scss/ and created a scss in the scss-folder, but i cant find a button or setting to actually compile that into css.

Is there a documentation? How does this work!?

Latest update breaks the site - but here is the fix!

By abda53 on November 30, 2022

The latest update breaks the site.. but if this happens it's a fairly easy fix. Go to github.com/scssphp/scssphp Click on Code (in green) then Download Zip Extract the zip Upload everything in scssphp-master/src/* to your wp-content/plugins/wp-scss/src/ folder Refresh the page and you should be good. It looks like the author someone didn't get all of the src folder added into the plugin in the latest update

Breaking updates

By baskuipers on November 25, 2022

Unfortunately this plugin had some updates in the past that broke several websites. Updates were slow and manual rollbacks were necessary.

Great, when it's not breaking the site

By James W (uxjw) on November 23, 2022

Been using this for years and when it works, it works well. But after it broke client sites yet again with the most recent update, I have to question the QA on this plugin.

Very Useful plugin but maybe not well maintained

By stormhill on November 21, 2022

I have a hard time not using this plugin in my projects since it makes implementing SCSS just SO easy for my dev team. On the other hand, there have been 2 times in the past year where a major issue occurred with an update resulting in lots of broken websites. In both cases the developers were slow to address the issue. At this date, the plugin fails catastrophically if "always recompile" is selected.

DO NOT USE THIS PLUGIN

By wagonmonster on November 18, 2022

They just upgraded it to version 3.0 and it DOES NOT WORK, it will crash your entire site. Developer has been unresponsive to everyone's pleas to fix the catastrophic bug

Plugin doesn't work, doesn't give any errors

By FrogDesk Strategy (frogdesk) on January 1, 2022

Unfortunately although this used to be extremely useful the current version does not compile reliably, provides no errors or logs with which to investigate, and no support is available.

Unstable

By gwberto on December 27, 2021

This plugin was used when our site was first built. The last update caused a critical failure which took out the site for a few days.

1 Minor Issue, 1 Enhancement Request, but still 5 stars

By imincognito on December 12, 2021

This plugin works exactly as advertised - the ability to auto-compile scss is invaluable. There are actually 2 enhancements that could be useful: 1. The base dir is limited to uploads (not a logical location), the wp-scss plugin (also not logical) and the current theme dir (most logical). I would personally prefer a separate dir under themes so that in the event that the theme is updated or switched, scss files are preserved. 2. Although there are plenty of workarounds, a pro version with a built-in scss editor/syntax checker would be enormously valuable - just make changes in the editor, save and view the changes... But, still it's a 5 star plugin...

Broken, not regularly updated

By kvangorden on May 11, 2021

I continue have issues with this plugin. Every time we make an update to any page, I have to go back to the WP-CSS plugin settings and click "save" to rewrite whatever bug it has. This works to correct my staging and production environments, but my dev environment breaks every single time. The WP-SCSS plugin changes the code when the staging or prod environment gets copied to dev. Then it creates a critical error and won't allow me to overwrite it. I wish the developers would correct this issue and/or find a comparable alternative for us to use.

4.0.4

  • Fix: Avoid usage of dynamic property for cache_file. Thanks to FreddyFY
  • Actually update PHP deprecated notices. Missed files in early version bump, svn to wp fail (not a fan of SVN)
  • Add Github Actions deploy script, because dealing with SVN is not fun. #260
  • Add Claude init files, because it knows PHP better than I do. #258

4.0.3

  • Remove PHP Deprecated notices
  • WP version bump to 6.4.2

4.0.2

  • Full SVN commit to WordPress
  • With version bump

4.0.0

  • DO NOT USE, missing commited files on WP SVN
  • Updates ScssPHP to version 1.11.0 thanks to fabarea

3.0.1

  • Full SVN commit to WordPress

3.0.0

  • DO NOT USE, missing commited files on WP SVN
  • Updates ScssPHP to version 1.10.0 thanks to fabarea

2.4.0

  • Changes the base_compiling_folder to store key not path to directory shadoath
  • This allows deploying from local or staging to production by not saving absolute paths in DB.

2.3.5

  • Add ‘selected’ to wp_kses on select() shadoath

2.3.4

2.3.3

  • Fix params passed to wp_kses() shadoath

2.3.2

  • Add wp_kses() to echos with potential user input shadoath

2.3.1

  • Wrap check for WP_SCSS_ALWAYS_RECOMPILE with () niaccurshi

2.3.0

2.2.0

2.1.6

  • When enqueueing CSS files Defer to WordPress for URLs instead of trying to guess them. Change by mmcev106
  • Allow setting Base Directory to Parent theme folder. Shadoath

2.1.5

  • Enqueue CSS files using realpath function. Addition by mmcev106

2.1.4

  • Set source URL to be home_url(‘/’) not simply /. Issue found by realjjaveweb

2.1.3

  • Must declare global to use it for $base_compiling_folder.

2.1.2

  • Correction for enqueueing styles not defaulting to get_stylesheet_directory() Issue

2.1.1

  • Bug fixes after merging 2.0.2 and 2.1.0 defaults worked, but new options did not. Shadoath

2.1.0

  • Settings dropdown added for choosing additional base compile locations outside of current theme. Suggestion by pixeldesignstudio

2.0.2

  • Added option in settings to enable an ‘always recompile’ flag. Suggestion by bick

2.0.1

  • Bugfix to add filter for option_wpscss_options to remove Leafo if stored in DB. Thanks to kinky-org for pointing this out
  • Saving plugin settings will update DB with the correct value.

2.0.0

1.2.6

  • Create cache dir if it doesn’t exist [@XNBlank](https://github.com/ConnectThink/WP-SCSS/pull/135
  • Add cache dir as default @mhbapcc

1.2.5

1.2.4

  • Updated scssphp to version 0.7.5
  • Added source map @iannacone
  • Always define $wpscss_compiler in the global scope @jazbek

1.2.3

  • Updated scssphp to version 0.7.2 @hellerbenjamin
  • Removed depricated screen_icon()

1.2.2

  • Updated scssphp to version 0.6.6

1.2.1

  • Changed set version option to update if already exists

1.2.0

  • Fixed a bug where directory inputs were not getting sanitized @mmcev106
  • Made the missing directory warning also display if a specified path is a file @mmcev106
  • Added /vendor to .gitignore @mmcev106
  • Dont enqueue already enqueued stylesheets @bobbysmith007

1.1.9

  • Added filter to set variables via PHP @ohlle
  • Added option to minify CSS output @mndewitt

1.1.8

Various improvements from pull requests by @jbrains and @brainfork

1.1.7

  • Update scssphp to 0.0.12 – pull from #16 @GabrielGil

1.1.6

  • Upgraded scss.inc.php to version 0.0.10; via pull request from kirkhoff

1.1.5

  • Added option to only show errors to logged in users; via pull request from tolnem

1.1.4

  • Add suport for subfolders in scss directory

1.1.3

  • Hotfix for a accidental character

1.1.2

  • Added support for moved wp-content directories

1.1.1

  • Added error handling for file permissions issues
  • Changed error log to .log for auto updating errors

1.0.0

  • Initial Build
  • Version:Version: 4.0.4
  • Active installs:Active installs: 40K
  • Last updated:Last updated: 4 months ago
  • Requires:Requires: 3.0.1
  • Tested:Tested: 6.4.5
Average rating:4.3 out of 5 stars.
  • Number of ratings: 48 ratings
  • Number of ratings: 1 ratings
  • Number of ratings: 2 ratings
  • Number of ratings: 3 ratings
  • Number of ratings: 7 ratings
Back to top