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.
JavaScript
Szekció neve “JavaScript”| 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;});Előtöltés
Szekció neve “Előtöltés”| 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;});Késleltetett betöltés
Szekció neve “Késleltetett betöltés”| 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ó tartalmakonadd_filter('perfmatters_exclude_leading_images', function($count) { if(is_singular()) { return 3; } return $count;});
// áttűnés 1000 msadd_filter('perfmatters_fade_in_speed', function($speed) { return 1000;});
// küszöb 500 pxadd_filter('perfmatters_lazyload_threshold', function($threshold) { return '500px';});
// késleltetett betöltés kikapcsolása az oldalakonadd_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ásaadd_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;});WooCommerce
Szekció neve “WooCommerce”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');Egyéb
Szekció neve “Egyéb”| 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éteradd_filter('perfmatters_page_builders', function($page_builders) { $page_builders[] = 'custom-builder'; return $page_builders;});
// REST API kivételekadd_filter('perfmatters_rest_api_exceptions', function($exceptions) { $exceptions[] = 'custom-route1'; $exceptions[] = 'custom-route2'; return $exceptions;});
// a Szkriptkezelő felülete angoluladd_filter('perfmatters_script_manager_locale', function($locale) { return 'en_US';});
// az egyéni bejelentkezési URL kikapcsolása egy végpontonadd_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ásaadd_filter('perfmatters_minify_threshold', '__return_false');
// a helyi analitika után egyéni szkriptadd_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: