Pagelean - Conditional Script and Style Loading
| 开发者 |
wppoland
motylanogha |
|---|---|
| 更新时间 | 2026年10月30日 19:34 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
wp_dequeue_script / wp_dequeue_style), so there is no page-builder lock-in and nothing proprietary to learn.
What it does
- Remove any registered script or style handle by name.
- Choose where it is removed: everywhere, the front page, the blog posts index, single posts/pages (by ID), single entries of any public post type, the WooCommerce shop, product, cart or checkout page (when WooCommerce is active), or only mobile / only desktop.
- Test mode: the rules apply only to logged-in administrators while everyone else gets the untouched page, with a notice in the admin until you turn it off.
- Dequeue by default; tick "Also deregister" on a rule only when you want the handle gone even where another script depends on it.
- Autocomplete from the handles your front-end pages actually load, recorded while you browse the site as an administrator (up to 500, with their source file).
- Runs late on the front end so it removes handles reliably, and never touches the admin.
安装:
- Upload the plugin to
/wp-content/plugins/pagelean, or install it from the Plugins screen. - Activate it.
- Go to Pagelean in the main admin menu.
- Add a rule: type the handle, pick script or style, and choose where to remove it.
- Save, then check the front end.
常见问题:
How do I find a handle name?
Visit a few pages of your site while logged in as an administrator. Pagelean records the scripts and styles each page loads and offers them as autocomplete in the Handle field, with the file each one loads. You can still look it up by hand: the id attribute of a <script> / <link> tag usually ends in -js or -css, and the handle is that value without the suffix.
What does test mode do?
With test mode on, the rules run only for logged-in users who can manage options (administrators). Every other visitor gets the page with all its scripts and styles. Check your pages, then turn test mode off to apply the rules to everyone. A notice in the admin reminds you while it is on.
What is the difference between dequeue and "Also deregister"?
Dequeue (the default) takes the handle off the page, but WordPress still prints it when another script on that page depends on it, so nothing breaks. "Also deregister" removes the handle from WordPress entirely for that request: it is gone even as a dependency, and every script that depends on it is dropped too. Use it only when you know nothing on the page needs the handle.
When do the Post/Page IDs apply?
Only to the two single posts/pages conditions. The other conditions (everywhere, front page, blog index, mobile, desktop) decide from the request alone, so the IDs box is greyed out for them and a rule set that way removes the handle on every page it matches.
Will this break my site?
It only removes what you configure. A dequeued handle that another script depends on is still printed for that script; with "Also deregister" ticked, scripts that depend on it are dropped as well. Use test mode to check the result before visitors see it. Change one rule at a time and verify the front end. You can remove a rule to restore the asset instantly.
Does it work without a page builder or WooCommerce?
Yes. It uses WordPress core functions only and works on any theme.
Does it run in the admin?
No. Rules apply on the front end only.
更新日志:
- Fixed: deleting the plugin now removes its settings, rules and the list of seen script and style handles, on every site of a multisite network. While an add-on that stores rules in the same settings is installed, those settings stay.
- Links point at the new plogins.com address.
- Test mode: a new setting applies the rules only to logged-in administrators, while everyone else gets the untouched page. An admin notice shows while it is on.
- Behaviour change: a rule now only dequeues its handle. Until 1.1.2 every rule also deregistered it, which silently dropped every script that depends on that handle. A new per-rule "Also deregister" box keeps the old behaviour, and rules saved before this update have it ticked automatically, so they keep working exactly as before. New rules start on dequeue only.
- New conditions: single entries of a chosen public post type, and the WooCommerce shop, product, cart and checkout pages (offered while WooCommerce is active).
- Handle autocomplete now lists the scripts and styles your front-end pages actually load, recorded while you browse the site as an administrator (up to 500, with their source file). Before, it only knew the handles registered on the admin screen.
- The settings form sanitises every rule field as it is read, and the saved notice only shows for the exact value the plugin sets.
- Renamed to Pagelean, a plain English name in place of the Esperanto one. The text domain and the plugin folder follow the name; the stored settings, options and every hook are unchanged.
- The autoloader no longer leaves a global variable behind.
- Renamed to Malpezo. The WordPress.org review team asks a plugin name to lead with a distinctive, coined identifier rather than a generic descriptive word. Malpezo is Esperanto for lightness. The text domain follows the name; the stored rules, the settings and every hook are unchanged.
- The translation template was regenerated. It still named an older version of the plugin and pointed at source lines that had since moved, which is what translation tools read to show a string in context.
- Tested against WordPress 7.1. Verified by activating this build on a clean 7.1 install with WooCommerce 11.1, not by editing the header.
- The Post/Page IDs box is now available only for the two single posts/pages conditions, the ones that can act on it. With any other condition it is greyed out with a short note, so a rule set to Everywhere or to a device can no longer look as if it were limited to a few pages while the handle is in fact removed across the whole site.
- Version bump to meet the family release floor for the WordPress.org submission.
- Initial release.