# 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](https://hub.hellowp.io/hu/plugins/perfmatters/adatbazis-eszkozok-kodreszletek/) 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

| 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ó).

```php
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.

```php
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).

```php
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.

```php
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.

```php
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.

```php
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;
});
```

## CSS

| 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.

```php
add_filter('perfmatters_used_css_below', '__return_true');
```

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

```php
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.

```php
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

| 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).

```php
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.

```php
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ó.

```php
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.

```php
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.

```php
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

| 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.

```php
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`.

```php
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.

```php
// 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');
```

## CDN

| 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. |

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

## 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:

```php
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.

```php
add_filter('perfmatters_is_woocommerce', '__return_false');
```

## 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:

```php
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):

```php
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):

```php
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):

```php
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:

```php
// 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.
