Page Optimizers - Football Leagues Docs

Many page optimizer plugins offer a Remove Unused CSS (also called Used CSS) feature. It loads a page, keeps only the CSS selectors it sees in the HTML at that moment, and deletes the rest. Football Leagues adds a lot of its classes with JavaScript after the page loads – live score updates, sliders, sortable stat tables, tooltips, tabs, and modal windows. The optimizer can’t see those classes when it scans, so it strips their CSS and the Football Leagues UI loses its styling.

🎯 What you need to do

Football Leagues handles the common optimizers for you. Three are fully automatic; one needs a single manual step because it only exposes the setting in its own interface.

Optimizer	Removes unused CSS?	What you need to do
Perfmatters	Yes	Nothing – automatic
WP Rocket	Yes	Nothing – automatic
LiteSpeed Cache	Yes (UCSS)	Nothing – automatic
FlyingPress	Yes	One manual step (below)

The automatic protection is on by default and needs no setup. It also covers the free Football Leagues styles, so a premium site is fully protected. Each rule is inert when its optimizer isn’t installed, so it never interferes with anything else.

Manual step for FlyingPress

FlyingPress doesn’t offer a way for a plugin to register an exclusion, so you add it once yourself. Paste this value into its stylesheet-exclude field:

football-leagues-by-anwppro

That single value matches every Football Leagues stylesheet – core and premium – so you only need to add it once.

1. Open Settings > FlyingPress and find the CSS section.
2. Confirm Remove Unused CSS is on. If it’s off, none of this applies.
3. In the Exclude Stylesheets box, add football-leagues-by-anwppro.
4. Save and purge the cache so the CSS is rebuilt.

Turning it off or extending it (developers)

The automatic protection is safe to leave on – it only tells optimizers to skip Football Leagues CSS. If you need to change it, use the constant or filters below.

Disable it entirely

// In wp-config.php:
define( 'ANWPFL_DISABLE_OPTIMIZER_COMPAT', true );

// Or from a theme / plugin:
add_filter( 'anwpfl/optimizer_compat/enabled', '__return_false' );

Filters

Filter	Purpose
anwpfl/optimizer_compat/enabled	Return false to turn the whole feature off.
anwpfl/optimizer_compat/path_fragments	Add extra CSS path fragments to exclude – useful for an add-on that ships its own Football Leagues stylesheets.
anwpfl/optimizer_compat/manual_optimizers	Add another UI-only optimizer to the admin notice, as slug => [ 'name' => ..., 'field' => ... ].

For example, to also protect an add-on’s stylesheets:

add_filter( 'anwpfl/optimizer_compat/path_fragments', function ( $fragments ) {
    $fragments[] = 'my-fl-addon';
    return $fragments;
} );

📚 Related

• Troubleshooting – other common issues and fixes.