Descripción
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-csscontrols CSS concatenation. Values:1for ON and0for OFF.concat-jscontrols JavaScript concatenation. Values:1for ON and0for OFF.load-mode-jscontrols 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
Instalación
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.
Reseñas
Colaboradores y desarrolladores
«Page Optimize» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores
«Page Optimize» ha sido traducido a 15 idiomas locales. Gracias a los traductores por sus contribuciones.
Traduce «Page Optimize» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
0.6.2
- Fix: Harden CSS concat
@importhoisting 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_tagfilter for scripts that are concatenate-able but have no neighbors to concatenate with. This fixes a case where the TwentyTwenty theme wanted to apply adeferattribute 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. 🙂