# Kódrészletek (PHP, CSS, JS, HTML)

> Saját kódrészletek hozzáadása a Kód fülön: helyek, prioritás, optimalizálás, feltételek, shortcode, export, import és biztonságos mód.

A **Kód** fülön PHP-, CSS-, JS- és HTML-kódrészleteket adhatsz az oldalhoz, így nem kell külön kódrészlet-bővítményt használnod. A kódrészletek fájlokban tárolódnak, ezért a látogatói oldalon nincs hozzájuk adatbázis-lekérdezés, és a PHP gyorsítótára (OPcache) is használni tudja őket. Beépített hibaellenőrzés is van: ha egy kódrészletben hibát talál, automatikusan kikapcsolja, így nem tudod tönkretenni vele az oldalt.

A Perfmatters megszokott teljesítménybeállításai (fájlként vagy beágyazva betöltés, minifikálás, késleltetés, előtöltés, halasztás, aszinkron betöltés) kódrészletenként is elérhetők. A feltételszerkesztővel pedig megadhatod, hol fusson az adott kód.

## Új kódrészlet hozzáadása

1. Nyisd meg a **Beállítások → Perfmatters** oldalt, és kattints a **Kód** menüpontra.
2. A **Kódrészletek** nézetben kattints az **Új kódrészlet** gombra.
3. Adj nevet a kódrészletnek, és válaszd ki a típusát: **PHP**, **JS**, **CSS** vagy **HTML**. Beállíthatod még a helyet, a prioritást, az optimalizálásokat, a feltételeket, a címkéket és a leírást.
4. Írd be a kódot a **Kód** mezőbe.
5. Ha azonnal futtatni szeretnéd, kapcsold be az aktív állapotot a kapcsolóval, és mentsd el a kódrészletet. Ha egyelőre nem kell futnia, hagyd kikapcsolva, és úgy mentsd.

![Új PHP-kódrészlet szerkesztője](./kepek/adatbazis-eszkozok-uj-kodreszlet.webp)

*Új PHP-kódrészlet szerkesztője* (https://minta-bolt.hu/wp-admin/options-general.php?page=perfmatters&snippet=create)

A képen az új kódrészlet űrlapja látszik: név, hely, típus, kódmező, prioritás, feltételek, címkék és leírás. A HTML-kódrészletek PHP-t és HTML-t is támogatnak egyszerre.

## Hely

A hely mondja meg, hol fusson a kód. A választható helyek a típustól függnek:

| Típus | Lehetséges helyek |
| --- | --- |
| PHP | Mindenhol (alapérték), csak a látogatói oldalon, csak az admin felületen |
| JS | Webhelyfejléc (alapérték), webhelylábléc, admin fejléc, admin lábléc |
| CSS | Webhelyfejléc (alapérték), webhelylábléc, admin fejléc, admin lábléc |
| HTML | Webhelyfejléc (alapérték), webhelytörzs, webhelylábléc, tartalom előtt, tartalom után, shortcode |

Ha ennél finomabb szabály kell, használd a feltételeket.

## Prioritás

A prioritás a futtatás sorrendjét adja meg. Alapértéke minden kódrészletnél `10`. Ha egy kódnak korábban kell futnia, adj neki kisebb számot (például `1`), mert a kisebb értékű kódrészletek előbb futnak. A nulla és a negatív szám is megengedett.

## Optimalizálások

A JS- és CSS-kódrészleteknél beállíthatod, hogyan töltődjenek be. A kínált lehetőségek a típustól függnek, és egyszerre több is használható (ha az adott kombináció támogatott). A Perfmatters más fülein lévő globális optimalizálások szándékosan nem érintik a JS/CSS-kódrészleteket, így kódrészletenként teljes az irányításod.

![CSS-kódrészlet optimalizálási beállításokkal](./kepek/adatbazis-eszkozok-kodreszlet-css.webp)

*CSS-kódrészlet optimalizálási beállításokkal* (https://minta-bolt.hu/wp-admin/options-general.php?page=perfmatters&snippet=create)

A képen a CSS típus van kiválasztva: az **Optimalizálások** sorban a **Kimenet módja**, a **Betöltési viselkedés**, a **Minifikálás** és a **Betöltés a blokkszerkesztőben** látszik.

### Kimenet módja (JS, CSS)

- **Inline** (alapérték): a kódrészlet az oldal HTML-jének része. Az azonosítója `pmcs` (Perfmatters code snippets) előtaggal, majd a fájlnévvel és a típussal készül, például `<script id="pmcs-snippetname-js">`. Előnye, hogy nem blokkolja a megjelenítést. Hátránya, hogy növeli a HTML méretét, és külön nem gyorsítótárazódik. Kis és közepes kódrészleteknél ajánlott.
- **Fájl**: a kódrészlet külön fájlból töltődik be, a fájlnév után verziószöveggel (például `snippetname.js?ver=…`). Előnye, hogy a gyorsítótár-bővítmények és a CDN-ek a JS- és CSS-fájlokat hosszabb ideig tárolják, így gyorsabb lehet a betöltés.

### Betöltési viselkedés (JS, CSS)

- **Előtöltés** (JS, CSS): jelzi a böngészőnek, hogy a fájlra azonnal vagy hamarosan szükség lesz, így előrébb kerül a betöltési sorrendben és nem blokkol. Ehhez egy `rel="preload"` hivatkozás kerül az oldal fejlécébe.
- **Halasztás** (JS): a JavaScript az oldal feldolgozása közben letöltődik, és az oldal betöltése után fut le. A `defer` attribútumot kapja, így nem blokkolja a megjelenítést. Beágyazott és fájl módban is működik.
- **Késleltetés** (JS, CSS): a kód csak felhasználói interakció után töltődik be. JavaScriptnél beágyazott és fájl módban is megy, CSS-nél csak fájl módban. CSS-t csak akkor érdemes késleltetni, ha az első betöltéskor rejtett vagy a látható terület alatt van, különben elmozdulhat az elrendezés (CLS).
- **Aszinkron** (CSS): a CSS az oldal betöltése közben, párhuzamosan töltődik be, `onload` attribútum segítségével, így nem blokkol.

### Minifikálás (JS, CSS)

A felesleges karakterek (szóközök, megjegyzések, hosszú nevek) eltávolítása, így kisebb lesz a fájl és gyorsabb a feldolgozás. Beágyazott és fájl módban is működik.

### Betöltés a blokkszerkesztőben (CSS)

A látogatói oldalra szánt CSS-kódrészleteknél bekapcsolhatod, hogy a stílus a WordPress blokkszerkesztő vásznán is megjelenjen.

## Feltételek

A feltételszerkesztővel megadhatod, hol fusson a kódrészlet. Korlátlan számú szabályt hozhatsz létre.

- **Bevonás**: alapból csak a hely beállítása érvényes. Ha pontosabb irányítás kell, itt adhatod meg, hol fusson.
- **Kizárás**: itt adhatod meg, hol ne fusson. Sokszor nem kell, ha a bevonás már pontosan meghatározza a helyeket.
- **Felhasználók**: szerepkör (például adminisztrátor, szerkesztő) vagy állapot (bejelentkezett vagy kijelentkezett) alapján szűr.

Új szabályhoz kattints a **Feltétel hozzáadása** gombra, és ismételd, ahányszor szükséges. Például egy CSS-kódrészlet csak bizonyos oldalakon és csak kijelentkezett látogatóknak töltődhet be.

![Feltételek hozzáadása](./kepek/adatbazis-eszkozok-kodreszlet-feltetelek.webp)

*Feltételek hozzáadása* (https://minta-bolt.hu/wp-admin/options-general.php?page=perfmatters&snippet=create)

A képen a **Bevonás** és a **Felhasználók** sorban egy-egy új feltétel látszik, a **Válassz egy opciót** legördülő menüvel.

### Használható célzások

| Csoport | Lehetőségek |
| --- | --- |
| Általános | Főoldal, blog, minden önálló tartalom, minden archívum, szerzői archívum, dátumarchívum, keresési találatok, nincs keresési találat, 404-es oldal, lapozott találatok |
| URL | Az elérési út tartalmazza, az elérési út egyenlő, az elérési út reguláris kifejezése |
| Bejegyzések | Bejegyzés, bejegyzéskategória, bejegyzéscímke |
| Bejegyzésarchívumok | Bejegyzésarchívum, kategóriaarchívum, címkearchívum |
| Oldalak | Oldal |
| Média | Média |

## Shortcode

A shortcode arra való, hogy a kódot kézzel, a feltételektől függetlenül, tetszőleges helyre tedd. A shortcode a HTML-kódrészletekkel használható (ezek PHP-t és HTML-t is támogatnak).

1. Hozz létre egy HTML-kódrészletet.
2. Válaszd a **Shortcode** helyet.
3. Mentsd el. A mentés után a **Shortcode** szakaszban automatikusan létrejön a shortcode. Másold a vágólapra, és illeszd be oda, ahol a kódnak futnia kell.

## Címkék és leírás

A **Címkék** és a **Leírás** mezővel könnyebben azonosíthatod a kódrészleteket a listában. Mindkettőre kereshetsz is, ez sok kódrészletnél hasznos. A leírás általában rövid jegyzet a kódrészlet céljáról.

## Képernyőbeállítások

A **Képernyő opciók** a kódrészletek listájának megjelenését módosítja:

- Alapból a **Típus**, a **Leírás** és a **Módosítva** oszlop látszik. Bekapcsolható még a **Címkék**, a **Szerző**, a **Létrehozva** és a **Prioritás**.
- A lapozásnál oldalanként megjelenő kódrészletek számát adhatod meg.
- A rendezésnél a szempontot (név, létrehozás, módosítás) és az irányt (csökkenő, növekvő) választhatod.

## Szerkesztő sablonja

A bővítmény kódszerkesztői 10 beépített sablon közül választhatnak, ez a kódrészletekre és a globális szkriptekre is érvényes. A sablonok a CodeMirror 5 szerkesztőn alapulnak.

1. A **Kód → Beállítások** nézetben a **Szerkesztő sablonja** menüből válaszd ki a sablont.
2. Görgess le, és kattints a **Módosítások mentése** gombra.

![A Kód fül Beállítások nézete](./kepek/adatbazis-eszkozok-kod-beallitasok.webp)

*A Kód fül Beállítások nézete* (https://minta-bolt.hu/wp-admin/options-general.php?page=perfmatters)

A képen a **Beállítások** nézet látszik: a kódrészletek exportja és importja, a **Szerkesztő sablonja**, és a **Biztonságos mód** szakasz.

### Saját sablon feltöltése

Ha egyik beépített sablon sem tetszik, feltölthetsz saját, CodeMirror 5-höz készült `.css` sablonfájlt.

1. A **Szerkesztő sablonja** menüben válaszd az **Egyéni** lehetőséget.
2. Az **Egyéni sablon stíluslapja** résznél kattints a **Fájl kiválasztása** gombra, és töltsd fel a sablon `.css` fájlját.
3. Kattints a **Módosítások mentése** gombra.

Más sablonra váltáshoz ismételd meg a lépéseket, a feltöltés felülírja a régit.

## Biztonságos mód

A biztonságos mód arra való, ha olyan hibába futsz, amelyből a rendszer maga nem tud kilábalni. Ilyenkor a kódrészletek akkor sem futnak, ha aktívak. Három módon kapcsolhatod be:

### A beállításokból

1. Nyisd meg a **Beállítások → Perfmatters → Kód** oldalt.
2. Kattints a **Beállítások** nézetre.
3. A **Biztonságos mód** szakaszban kattints a **Biztonságos mód bekapcsolása** gombra.

A kódrészletek képernyőin ezután értesítés jelenik meg a kikapcsoláshoz. A beállítások oldalon is kikapcsolhatod.

### Helyreállítási URL-ről

Az első kódrészlet létrehozása után a Perfmatters egyedi helyreállítási URL-t készít (**Helyreállítási URL**, **Másolás** gombbal). Ezt tárold biztos helyen. Ha egy kódrészlet olyan hibát okoz, amelyből nem lehet visszatérni, ennek az URL-nek a megnyitásával bekapcsolhatod a biztonságos módot.

### wp-config.php állandóval

A `PMCS_SAFE_MODE` állandó bekapcsolja a biztonságos módot. Add hozzá a `wp-config.php` fájlhoz, általában a `WP_DEBUG` állandó alá:

```php
define('PMCS_SAFE_MODE', true );
```

Ezzel a módszerrel a rendes úton nem tudod kikapcsolni a biztonságos módot: a sort el kell távolítani a `wp-config.php` fájlból.

## Kódrészletek exportálása

A kódrészleteket `.json` fájlba exportálhatod, így egy másik, Perfmatters-es oldalra is átviheted őket. Három módszer van:

- **Összes exportálása**: a **Beállítások** nézetben kattints az **Összes kódrészlet exportálása** gombra. A fájlneve `perfmatters-snippets-export-éééé-hh-nn.json`.
- **Egyetlen kódrészlet**: a kódrészlet alatti **Exportálás** hivatkozással. A fájlneve `perfmatters-snippet-név-éééé-hh-nn.json`.
- **Tömeges exportálás**: jelöld ki a kívánt kódrészleteket, válaszd a **Csoportos műveletek** menüből az **Exportálás** műveletet, majd kattints az **Alkalmaz** gombra. A fájlneve `perfmatters-snippets-bulk-export-éééé-hh-nn.json`.

## Kódrészletek importálása

Az importálás az oldalszintű, az egyedi és a tömeges exportot is fogadja. A **Beállítások** nézetben kattints a **Fájl kiválasztása** gombra, válaszd ki az exportált `.json` fájlt, majd kattints a **Kódrészletek importálása** gombra.

Jelenleg csak a Perfmatters által exportált fájl importálható. Más bővítmények (például WPCode, Code Snippets) exportját még nem támogatja.

## A Kód szakasz letiltása

Ha nem szeretnéd, hogy ügyfeled kódot adjon az oldalhoz, a `PERFMATTERS_DISABLE_CODE` állandóval teljesen kikapcsolhatod a **Kód** szakaszt, vagyis a kódrészlet-kezelőt és a globális szkripteket is. Add hozzá a `wp-config.php` fájlhoz, általában a `WP_DEBUG` alá:

```php
define('PERFMATTERS_DISABLE_CODE', true);
```

## Hibaelhárítás

### Hol tárolódnak a kódrészletek

A kódrészletek ebben a mappában vannak:

```
/wp-content/uploads/perfmatters/code-snippets/
```

Ennek az az előnye, hogy a megváltoztathatatlan fájlrendszerű tárhelyeken (például Pantheon) is működik. Oldalköltöztetéskor viszont az `uploads` mappát (a médiatár nélkül) gyakran kihagyják, ezért ezt a mappát külön másold át.

### Hibás kódrészlet

A beépített hibaellenőrzés miatt elvileg nem tudod tönkretenni az oldalt: ha hibát talál, a kódrészletet automatikusan kikapcsolja. Ha egy problémáról azt gyanítod, hogy kódrészletből ered, kapcsold be a biztonságos módot. Így egyszerre kizárhatod az összes kódrészletet, anélkül hogy egyenként kapcsolnád ki őket.

## Gyakori kérdések

### Mi a fájlalapú tárolás előnye?

A hagyományos, adatbázisra épülő megoldás minden oldalbetöltéskor lekérdezi az aktív kódrészleteket, majd dinamikusan futtatja őket, ami adatbázis-késleltetést okoz, és kihagyja az OPcache-t. A Perfmatters mentéskor lemezre írja a kódrészletet, így minden kérés egy szokásos PHP-beillesztés, amit az OPcache egyszer lefordít és memóriából szolgál ki. A lényeg az adatbázis-lekérdezés elmaradása.

### Hogyan adjak hozzá követőkódot?

A követőkódok (GTM, Google Analytics stb.) gyakran több kódrészletből és megjegyzésből állnak, ezért HTML-kódrészletként érdemes felvenni őket. Megadhatod a **Globális szkriptek** nézetben is.

### Mi történik a kódrészletekkel, ha kikapcsolom a Perfmatterst?

A bővítmény kikapcsolásakor a kódrészletek is leállnak. Ha más hibát keresel, és a Perfmatters nélkül kell tesztelned, használhatod a tesztelő lekérdezési paramétereket, amelyek a kódrészleteket nem érintik.
