=== Page Optimize ===
Contributors: aidvu, bjorsch, bpayton, mreishus, rcrdortiz
Tags: performance
Requires at least: 5.3
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 0.6.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Optimize pages for faster load and render in the browser.

== Description ==

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.

== Installation ==

This plugin uses sensible defaults so it can operate without configuration, but there are a number of constants you may use for a custom configuration.

= PAGE_OPTIMIZE_CACHE_DIR =

Page Optimize caches concatenated scripts and styles by default, and this constant controls where the cache files are stored. The default directory is `cache/page_optimize` under your site's `wp-content` folder.

To change the cache location, set this constant to the absolute filesystem path of that location.

To disable caching, set this constant to `false`. Please note that disabling Page Optimize caching may negatively impact performance unless you are caching elsewhere.

= PAGE_OPTIMIZE_CSS_MINIFY =

Page Optimize has CSS Minification capabilities which are off by default.

If you're using caching, and not minifying CSS elsewhere, it is recommended to enable it by setting it to `true`.

== 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](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-defer), 'async' for [async loading](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-async), 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 tests`
* `PHP_VERSION=7.4 docker compose up --build --abort-on-container-exit --exit-code-from tests`
* `PHPUNIT_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 <script> 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. :)