Tovább a tartalomhoz

Szűrők a bővítmény testreszabásához

A Perfmatters PHP-szűrőinek és műveletkapcsolóinak (filter, action) listája példákkal.

A Perfmatters szűrői (filter hook) lehetővé teszik, hogy a bővítmény működését kóddal, feltételekhez kötve testre szabd. A szűrőket legegyszerűbben a Kódrészletek funkcióval adhatod hozzá: hozz létre egy PHP-kódrészletet, és illeszd be a példákat. Más módon is felveheted őket, például a sablon functions.php fájljába.

Szűrő Mit tesz
perfmatters_defer_jquery A jQuery halasztását szabályozza (igaz/hamis).
perfmatters_defer_js A JavaScript halasztását kapcsolja ki vagy be.
perfmatters_defer_js_exclusions A halasztásból kizárt szkriptek listáját módosítja.
perfmatters_delayed_scripts A késleltetett szkriptek listáját módosítja.
perfmatters_delay_js A JavaScript késleltetését teljesen kikapcsolja vagy bekapcsolja.
perfmatters_delay_js_behavior A késleltetés viselkedését módosítja (például all az összes szkript késleltetéséhez).
perfmatters_delay_js_delay_click Kikapcsolja a kattintáskésleltetést, ha az interaktív elemekhez szükséges JavaScriptet kézzel kizártad.
perfmatters_delay_js_exclusions A késleltetésből kizárt szkriptek listáját módosítja.
perfmatters_delay_js_fastclick Szabályozza, hol töltődjön be a FastClick.
perfmatters_delay_js_timeout A késleltetés időkorlátját módosítja (másodpercben).
perfmatters_inline_scripts Megadott JS-fájlok beágyazását kéri.
perfmatters_minify_js A JavaScript-minifikálást szabályozza.
perfmatters_minify_js_exclusions A minifikálásból kizárt JS-fájlok listáját módosítja.

Példa: a halasztás kikapcsolása csak az oldalakon (a perfmatters_defer_js és a perfmatters_delay_js ugyanígy használható).

add_filter('perfmatters_defer_js', function($defer) {
if(is_singular('page')) {
return false;
}
return $defer;
});

Példa: kizárások csak egyetlen bejegyzéstípuson. Ez akkor hasznos, ha az Összes szkript késleltetése be van kapcsolva, és például a WooCommerce termékgalériájához kell néhány szkript, de nem akarod, hogy ez az egész oldal teljesítményét rontsa.

add_filter('perfmatters_delay_js_exclusions', function($exclusions) {
if(is_singular('product')) {
$exclusions[] = 'jquery.min.js';
$exclusions[] = 'flexslider';
$exclusions[] = 'single-product.min.js';
$exclusions[] = 'slick';
}
return $exclusions;
});

Példa: kizárás csak akkor, ha az URL tartalmaz egy részletet (itt a SureCart a /buy/ oldalakon).

add_filter('perfmatters_delay_js_exclusions', function($exclusions) {
if(strpos($_SERVER['REQUEST_URI'], 'buy/')) {
$exclusions[] = 'surecart';
$exclusions[] = 'hooks.min.js';
$exclusions[] = 'i18n.min.js';
}
return $exclusions;
});

Példa: az összes szkript késleltetésének kényszerítése az önálló bejegyzéseken, a kattintáskésleltetés kikapcsolása, és az időkorlát 7 másodpercre állítása. Az időkorlátot ne állítsd túl rövidre, különben a késleltetés nem működik rendesen. Az esetek túlnyomó részében úgyis a felhasználói interakció indítja el a szkripteket.

add_filter('perfmatters_delay_js_behavior', function($behavior) {
if(is_singular('post')) {
$behavior = 'all';
}
return $behavior;
});
add_filter('perfmatters_delay_js_delay_click', '__return_false');
add_filter('perfmatters_delay_js_timeout', function($timeout) {
return '7';
});

Példa: egy szkript kizárása a késleltetésből, de csak asztali gépen.

add_filter('perfmatters_delayed_scripts', function($scripts) {
if(($key = array_search('name_of_your_script', $scripts)) !== false) {
if(!wp_is_mobile()) {
unset($scripts[$key]);
}
}
return $scripts;
});

Példa: beágyazás és minifikálási kizárás.

add_filter('perfmatters_inline_scripts', function($scripts) {
$scripts[] = 'jquery';
return $scripts;
});
add_filter('perfmatters_minify_js_exclusions', function($exclusions) {
if(is_single()) {
$exclusions[] = 'example.js';
}
return $exclusions;
});
Szűrő Mit tesz
perfmatters_inline_stylesheets Megadott stíluslapok beágyazását kéri. (A régi neve perfmatters_rucss_inline_stylesheets volt, az még működik.)
perfmatters_local_stylesheet_url A stíluslapok gyökér-URL-jét adja meg. Alapból az oldal URL-je, de CDN-átírásnál, ha azt nem a Perfmatters végzi, eltérhet.
perfmatters_minify_css A CSS-minifikálást szabályozza.
perfmatters_minify_css_exclusions A minifikálásból kizárt CSS-fájlok listáját módosítja.
perfmatters_remove_unused_css Szabályozza, hol távolítsa el a nem használt CSS-t.
perfmatters_rucss_async_stylesheets A nem használt CSS alól már kizárt stíluslapokat aszinkron töltésre állítja.
perfmatters_rucss_delay_stylesheets A nem használt CSS alól már kizárt stíluslapokat késleltetésre állítja.
perfmatters_rucss_excluded_selectors Egyéni szelektorokat ad a Kizárt szelektorok beállításhoz.
perfmatters_rucss_excluded_stylesheets Stíluslapokat zár ki a nem használt CSS generálásából.
perfmatters_rucss_logged_in Bejelentkezett kéréseknél is futtatja a nem használt CSS-t (csak a látogatói oldalon), külön példányokkal.
perfmatters_rucss_per_id_post_types Megadott bejegyzéstípusoknál bejegyzésenként külön használt CSS-fájlt készít. Alapból csak a szokásos oldalak kapnak külön fájlt. Hírek, blogbejegyzések esetén nem ajánlott, mert minden új bejegyzéshez külön stíluslap készülne.
perfmatters_used_css A generált használt CSS-t módosítja mentés előtt (főleg harmadik fél fejlesztőinek).
perfmatters_used_css_below A használt CSS-t a </head> elé teszi a <title> utáni hely helyett.

A perfmatters_used_css_below akkor segít, ha a beágyazott CSS nagy, és a közösségi oldalak nem érik el a meta címkéket. A Facebook például csak az oldal forrásának első 60 KB-jában keresi az og:image címkét, és ha nem éri el, az „Inferred Property” hibát jelzi, az előnézeti kép pedig nem jelenik meg.

add_filter('perfmatters_used_css_below', '__return_true');

Példa: nem használt CSS kikapcsolása az oldalakon és a keresési oldalakon.

add_filter('perfmatters_remove_unused_css', function($boolean) {
if(is_page() || is_search()) {
return false;
}
return $boolean;
});

Példa: kizárt szelektor és stíluslap, beágyazás, egyedi használt CSS egy bejegyzéstípusnál.

add_filter('perfmatters_rucss_excluded_selectors', function($selectors) {
$selectors[] = '.wp-block-column';
return $selectors;
});
add_filter('perfmatters_rucss_excluded_stylesheets', function($stylesheets) {
$stylesheets[] = 'style.css';
return $stylesheets;
});
add_filter('perfmatters_inline_stylesheets', function($stylesheets) {
$stylesheets[] = 'elementor/css/post-';
return $stylesheets;
});
add_filter('perfmatters_rucss_per_id_post_types', function($post_types) {
$post_types[] = 'landing_page';
return $post_types;
});
Szűrő Mit tesz
perfmatters_critical_image_exclusions Egy képet kizár a kritikus képek előtöltéséből.
perfmatters_critical_image_parent_exclusions A megadott szülőelemben lévő képeket kizárja a kritikus képek előtöltéséből.
perfmatters_fetch_priority Kézzel megadott elemekhez lekérési prioritást rendel.
perfmatters_preload_critical_images A kritikus képek előtöltésénél felvett képek számát módosítja.
perfmatters_preloads Az előtöltéseket módosítja vagy bővíti.
perfmatters_preloads_array Az aktuális URL előtöltéseit adatként adja át egyéni kódnak.
perfmatters_preloads_ready A DOM-ba kerülő előtöltő címkék HTML-tömbjét módosíthatod vele.

Példa: előtöltés hozzáadása különböző erőforrásokhoz (CSS, JS, betűtípus, kép).

add_filter('perfmatters_preloads', function($preloads) {
$preloads[] = array('as' => 'style', 'url' => 'https://example.com/style.css');
$preloads[] = array('as' => 'script', 'url' => 'https://example.com/script.js');
$preloads[] = array('as' => 'font', 'url' => 'https://example.com/font.woff2');
$preloads[] = array('as' => 'image', 'url' => 'https://example.com/image.jpg', 'priority' => 'high');
return $preloads;
});

Példa: egy előtöltés eltávolítása.

add_filter('perfmatters_preloads', function($preloads) {
foreach($preloads as $key => $preload) {
if($preload['url'] == 'https://example.com/style.css') {
unset($preloads[$key]);
}
}
return $preloads;
});

Példa: lekérési prioritás kézzel megadott elemekhez. Az url kötelező, a priority értéke high vagy low, a device (például mobile) és a parent választható.

add_filter('perfmatters_fetch_priority', function($fetchpriority) {
$fetchpriority[] = array(
'url' => 'https://example.com/style.css',
'priority' => 'high'
);
$fetchpriority[] = array(
'url' => 'https://example.com/image.jpg',
'priority' => 'low',
'device' => 'mobile',
'parent' => 1
);
return $fetchpriority;
});

Példa: a kritikus képek számának csökkentése oldalakon, kizárások.

add_filter('perfmatters_preload_critical_images', function($critical_images) {
if(is_page()) {
return 2;
}
return $critical_images;
});
add_filter('perfmatters_critical_image_exclusions', function($exclusions) {
$exclusions[] = 'example.png';
return $exclusions;
});
add_filter('perfmatters_critical_image_parent_exclusions', function($exclusions) {
$exclusions[] = 'example-div-class';
return $exclusions;
});

Példa: a perfmatters_preloads_ready szűrővel az első kivételével minden előtöltéshez médialekérdezést adhatsz, hogy kisebb felbontáson ne töltődjenek be.

add_filter('perfmatters_preloads_ready', function($preloads) {
if(!empty($preloads) && is_array($preloads)) {
foreach($preloads as $index => $preload) {
if($index < 1) {
continue;
}
$new_preload = preg_replace('#media=([\'"]).+?\1#', '', $preload);
$new_preload = str_replace('<link', '<link media="(min-width: 769px)"', $new_preload);
$preloads[$index] = $new_preload;
}
}
return $preloads;
});
Szűrő Mit tesz
perfmatters_css_background_selectors Szelektorokat ad a háttérképek késleltetett betöltéséhez.
perfmatters_exclude_leading_images A késleltetésből kizárt első képek számát módosítja.
perfmatters_fade_in_speed Az áttűnés sebességét módosítja ezredmásodpercben (alapérték: 500).
perfmatters_image_dimensions_exclusions Képeket zár ki a hiányzó méretek ellenőrzéséből (fájlnév vagy osztály).
perfmatters_lazy_elements A késleltetett elemek funkciót kapcsolja ki vagy be.
perfmatters_lazy_element_selectors Egyéni szelektorokat ad az elemszelektorok beállításhoz.
perfmatters_lazyload A késleltetett betöltést teljesen szabályozza.
perfmatters_lazyload_data_src Kikapcsolja, hogy a data-src attribútumú képeket a Perfmatters is a sajátjaként kezelje.
perfmatters_lazyload_exclude_attributes Attribútum (vagy egy részlete) szerint zár ki képeket.
perfmatters_lazyload_force_attributes Attribútum szerint kényszeríti a késleltetést (az elem nem kerül kizárási ellenőrzésre).
perfmatters_lazyload_noscript Visszakapcsolja a <noscript> címkéket az elemek alatt.
perfmatters_lazyload_parent_exclusions Szülőelem szelektora szerint zár ki képeket.
perfmatters_lazyload_youtube_autoplay Kikapcsolja az automatikus lejátszást a YouTube-beágyazásban.
perfmatters_lazyload_youtube_thumbnail_resolution A YouTube előnézeti kép minőségét állítja.
perfmatters_lazyload_threshold A küszöböt módosítja (px vagy %).
perfmatters_leading_image_exclusions Egy képet kizár az első képek kizárásából.
perfmatters_leading_image_parent_exclusions A megadott szülőelemben lévő képeket nem tekinti első képnek.

A YouTube-előnézet lehetséges minőségei: default (120×90, alacsony felbontás), mqdefault (320×180), hqdefault (480×360, ez az alapérték), sddefault (640×480), maxresdefault (1280×720, nagy felbontás). A maxresdefault nem mindig érhető el, csak ha egyéni előnézeti képet töltesz fel a videóhoz.

add_filter('perfmatters_lazyload_youtube_thumbnail_resolution', function($resolution) {
if(!wp_is_mobile()) {
$resolution = 'maxresdefault';
}
return $resolution;
});

Példa: attribútum szerinti kizárás és kényszerítés. A szűrés egyszerű szövegegyezés, az attribútum bármely része megadható, de pontosan egyeznie kell a kizárandó képpel. Figyelj rá: a példákban a hook neve perfmatters_lazyload_excluded_attributes, illetve perfmatters_lazyload_forced_attributes.

function perfmatters_lazyload_exclude_attributes($attributes) {
$attributes[] = "title='Perfmatters'";
$attributes[] = "class='size-full";
$attributes[] = 'src="https://domain.com/image.png"';
return $attributes;
}
add_filter('perfmatters_lazyload_excluded_attributes', 'perfmatters_lazyload_exclude_attributes');
function perfmatters_lazyload_force_attributes($attributes) {
$attributes[] = "title='Perfmatters'";
return $attributes;
}
add_filter('perfmatters_lazyload_forced_attributes', 'perfmatters_lazyload_force_attributes');

Példa: további egyszerű beállítások.

// három első kép kizárása az önálló tartalmakon
add_filter('perfmatters_exclude_leading_images', function($count) {
if(is_singular()) {
return 3;
}
return $count;
});
// áttűnés 1000 ms
add_filter('perfmatters_fade_in_speed', function($speed) {
return 1000;
});
// küszöb 500 px
add_filter('perfmatters_lazyload_threshold', function($threshold) {
return '500px';
});
// késleltetett betöltés kikapcsolása az oldalakon
add_filter('perfmatters_lazyload', function($lazyload) {
if(is_singular('page')) {
return false;
}
return $lazyload;
});
// kizárás szülőelem alapján, háttérkép-szelektor, YouTube automatikus lejátszás kikapcsolása
add_filter('perfmatters_lazyload_parent_exclusions', function($exclusions) {
$exclusions[] = 'example-div-class';
return $exclusions;
});
add_filter('perfmatters_css_background_selectors', function($selectors) {
$selectors[] = 'example-div-class';
return $selectors;
});
add_filter('perfmatters_lazyload_youtube_autoplay', '__return_false');
Szűrő Mit tesz
perfmatters_cdn A CDN-átírást szabályozza (például kikapcsolható az oldalakon).
perfmatters_cdn_extensions Kizárja bizonyos fájltípusokat az átírásból.
perfmatters_cdn_url Programból módosítja a CDN-címet, például több domainnel működő telepítésnél, ahol minden domainhez más CDN-cím kell.
add_filter('perfmatters_cdn_extensions', function($extensions) {
if(($key = array_search('js', $extensions)) !== false) {
unset($extensions[$key]);
}
return $extensions;
});

A perfmatters_disable_woocommerce_scripts szűrő a WooCommerce-szkriptek letiltásához ad több irányítást, például kivehetsz egy oldalt a letiltásból:

add_filter('perfmatters_disable_woocommerce_scripts', function($boolean) {
if(is_page(123)) {
return false;
}
return $boolean;
});

A perfmatters_is_woocommerce kikapcsolja a WooCommerce-ellenőrzést, így az optimalizálások a WooCommerce-oldalakon is futnak. Saját függvénnyel te dönthetsz arról, mi számít WooCommerce-oldalnak.

add_filter('perfmatters_is_woocommerce', '__return_false');
Szűrő vagy művelet Mit tesz
perfmatters_after_local_analytics Műveletkapcsoló (action): a helyi analitika beágyazott szkriptje után fut, így további eseményekhez kiírhatsz egyéni szkriptet.
perfmatters_allow_buffer A Perfmatters kimeneti pufferét szelektíven kikapcsolja.
perfmatters_buffer_excluded_extensions A puffer által kihagyott kiterjesztések listáját módosítja.
perfmatters_cache_path A gyorsítótár alapértelmezett mappáját (cache) cseréli egy wp-content alatti másikra.
perfmatters_get_current_ID A Szkriptkezelő által használt azonosítót módosítja.
perfmatters_login_url Egy helyen vagy végponton kikapcsolja az egyéni bejelentkezési URL-t.
perfmatters_minify_threshold Kikapcsolja a méretküszöb-ellenőrzést, amely eldönti, hogy a minifikált vagy az eredeti fájl menjen ki.
perfmatters_page_builders A kihagyott lekérdezési paraméterek listáját bővíti, például egyéni oldalszerkesztővel.
perfmatters_rest_api_exceptions Egyéni útvonal-kivételeket ad a REST API-hoz.
perfmatters_script_manager_locale A Szkriptkezelő felületének nyelvét állítja, a WordPress nyelvétől függetlenül.

A kimeneti puffer kikapcsolása egy végponton:

if(strpos($_SERVER['REQUEST_URI'], 'endpoint/')) {
add_filter('perfmatters_allow_buffer', '__return_false');
}

A .php kiterjesztés kivétele a puffer kihagyott kiterjesztéseiből (így a .php URL-eken is fut):

add_filter('perfmatters_buffer_excluded_extensions', function($extensions) {
if(($key = array_search('.php', $extensions)) !== false) {
unset($extensions[$key]);
}
return $extensions;
});

A gyorsítótár mappája, például szigorúbb jogosultságú tárhelyeken (ez érinti a nem használt CSS-t és a helyi Google Fonts betűtípusokat):

add_filter('perfmatters_cache_path', function($path) {
return 'uploads/cache';
});

Az aktuális azonosító felülírása a Szkriptkezelőben (ha az oldal beállításai miatt nem a megfelelő azonosítót veszi):

function perfmatters_filter_current_ID($currentID) {
$currentID = 123;
return $currentID;
}
add_filter('perfmatters_get_current_ID', 'perfmatters_filter_current_ID');

Egyéb példák:

// egyéni oldalszerkesztő paraméter
add_filter('perfmatters_page_builders', function($page_builders) {
$page_builders[] = 'custom-builder';
return $page_builders;
});
// REST API kivételek
add_filter('perfmatters_rest_api_exceptions', function($exceptions) {
$exceptions[] = 'custom-route1';
$exceptions[] = 'custom-route2';
return $exceptions;
});
// a Szkriptkezelő felülete angolul
add_filter('perfmatters_script_manager_locale', function($locale) {
return 'en_US';
});
// az egyéni bejelentkezési URL kikapcsolása egy végponton
add_filter('perfmatters_login_url', function($bool) {
if(strpos($_SERVER['REQUEST_URI'], '?excludeme=true') !== false) {
return false;
}
return $bool;
});
// minifikálási méretküszöb kikapcsolása
add_filter('perfmatters_minify_threshold', '__return_false');
// a helyi analitika után egyéni szkript
add_action('perfmatters_after_local_analytics', function() {
echo '<script>
//egyéni szkript
</script>';
});

A perfmatters_minify_threshold kikapcsolása akkor hasznos, ha sok stíluslapod tartalmaz háttérképet, amelyet minifikáláskor beágyaz a rendszer a további kérések elkerülésére, így a minifikált fájl nagyobb lesz az eredetinél.

Készült:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások