Optimize pages for faster load and render in the browser.
This plugin supports a few features that may improve the performance of page loading and rendering in the browser:
- Concatenate CSS
- Concatenate JavaScript
- Execution timing of non-critical scripts
- Note: Changing script execution timing can be risky and will not work well for all sites.
Testing
To test features without enabling them for the entire site, you may append query params to a WordPress post or page URL. For example, to test enabling JavaScript concatenation for https://example.com/blog/, you can use the URL https://example.com/blog/?concat-js=1.
Supported query params:
concat-css controls CSS concatenation. Values: 1 for ON and 0 for OFF.concat-js controls JavaScript concatenation. Values: 1 for ON and 0 for OFF.load-mode-js controls how non-critical JavaScript are loaded. Values: ‘defer’ for deferred, ‘async’ for async loading, any other value indicates the feature should be disabled.
PHPUnit (Docker)
You can run the PHPUnit tests locally using Docker (no local MySQL required).
First time (or after changing DB credentials):
docker compose down -v
Run tests:
docker compose up --build --abort-on-container-exit --exit-code-from tests
Optional overrides (examples):
WP_VERSION=6.5 docker compose up --build --abort-on-container-exit --exit-code-from testsPHP_VERSION=7.4 docker compose up --build --abort-on-container-exit --exit-code-from testsPHPUNIT_VERSION=9.6.20 docker compose up --build --abort-on-container-exit --exit-code-from tests
ChangeLog
0.6.2
- Fix: Harden CSS concat
@import hoisting to preserve long Google Fonts-style URLs with semicolons and avoid false positives from @import-like substrings in rule bodies/URL paths.
0.6.1
- Fix: Skip JavaScript concatenation for scripts that request defer or async loading to preserve core loading behavior.
- Fix: Skip JavaScript concatenation for module scripts (type=”module”) and scripts whose tag is modified via the script_loader_tag filter (for example, plugins that add module attributes), improving compatibility.
0.6.0
- Fix: Preserve stylesheet enqueue/document order when concatenating CSS. Concat-eligible styles are now emitted as sequential runs and split around non-concatenated items (e.g. external/excluded/dynamic URLs), media changes, RTL handling, and other boundaries.
- Fix: Inline styles (wp_add_inline_style) now print immediately after their parent stylesheet, including when styles are concatenated.
- Fix: Apply core’s style_loader_tag filter when a concatenation run contains only a single stylesheet (matching core behavior and the JS-side fix from 0.5.0).
- Fix: The css_do_concat filter is now evaluated once per handle.
- Fix: The concat service no longer drops @import directives due to a closure scoping bug. (@charset/@import handling now runs against the intended pre-output buffer.)
- Fix: Stylesheets containing @import now start a new concat run so service-side @import hoisting cannot reorder imports ahead of earlier stylesheets.
- Fix: Treat @import and @charset as case‑insensitive when building concatenated CSS, preventing missed rules in some stylesheets.
0.5.8
- Update Tested Up To Version to 6.9.
0.5.7
- Update Tested Up To Version to 6.8.
0.5.6
- Update Tested Up To version to 6.7.
0.5.5
- Fix: Stop skipping inline scripts when src is empty.
0.5.4
- Bail when editing pages or posts in the Editor. Increased the max concatenated file limit.
0.5.1
- Bail when editing pages in Brizy Editor (it errors when JavaScript load mode is
async).
0.5.0
- Apply the
script_loader_tag filter for scripts that are concatenate-able but have no neighbors to concatenate with. This fixes a case where the TwentyTwenty theme wanted to apply a defer attribute to its script but was never given the opportunity.
0.4.5, 0.4.6
- Force absolute paths for CSS replacements.
- Lower required PHP version to 7.0.
0.4.4
- Don’t queue the cache cleaning WP Cron job if we aren’t caching.
- Cleanup cache if we turned caching off or directory changed.
0.4.3
- gzip in PHP slows stuff down a bit. Simply don’t do this. Any web server can handle this better.
- also remove the output buffering, no need for that anymore
- CSS Minification can sometimes slow things down significantly. Add constant to enable/disable.
0.4.2
- Initial release. No changes yet. 🙂
