# Sablonváltozók listája

> A Yoast SEO SEO-cím és metaleírás sablonjaiban használható változók, az egyéni mezők és taxonómiák változói, a WooCommerce-változók és az alapértelmezett sablonok.

A Yoast SEO a kezdőlapra, a tartalomtípusokra, a taxonómiákra (kategóriák, címkék, saját taxonómiák) és más oldalakra automatikusan ad SEO-cím és metaleírás sablont. A sablonokban **változókat** használhatsz: a Yoast ezeket az adott oldal értékére cseréli. A sablonokat a **Yoast SEO → Beállítások** megfelelő oldalán szerkesztheted, a változókat a **Változó beillesztése** gombbal szúrhatod be, vagy közvetlenül be is gépelheted őket (`%%változó%%` alakban).

Négy csoportot különböztetünk meg: alapváltozók, haladó változók, egyéni változók és WooCommerce-változók.

## Alapváltozók

| Változó | Mire cserélődik |
|---|---|
| `%%date%%` | a bejegyzés vagy oldal dátuma |
| `%%title%%` | a bejegyzés vagy oldal címe |
| `%%parent_title%%` | a szülőoldal címe |
| `%%archive_title%%` | a WordPress által generált archívum szokásos címe |
| `%%sitename%%` | a webhely címe (**Beállítások → Általános**) |
| `%%sitedesc%%` | a webhely jelmondata (**Beállítások → Általános**) |
| `%%excerpt%%` | a kivonat; ha nincs, automatikusan készül |
| `%%excerpt_only%%` | a kivonat, automatikus generálás nélkül |
| `%%tag%%` | az aktuális címke vagy címkék |
| `%%category%%` | a bejegyzés kategóriái, vesszővel elválasztva |
| `%%primary_category%%` | a bejegyzés elsődleges kategóriája |
| `%%category_description%%` | a kategória leírása |
| `%%tag_description%%` | a címke leírása |
| `%%term_description%%` | a taxonómia-elem leírása |
| `%%term_title%%` | a taxonómia-elem neve |
| `%%searchphrase%%` | az aktuális keresőkifejezés |
| `%%sep%%` | az elválasztó jel, amelyet a **Címelválasztó** beállításnál adtál meg |

A `%%term_title%%` és a hozzá hasonló „term” változókat saját taxonómiáknál használd. Ha nincs saját taxonómiád, elég a címke- vagy kategóriaváltozó.

## Haladó változók

Ezekhez jobban kell ismerni a keresőoptimalizálást. Ha nem tudod, mire jók, ne használd őket.

| Változó | Mire cserélődik |
|---|---|
| `%%pt_single%%` | a tartalomtípus egyes számú neve |
| `%%pt_plural%%` | a tartalomtípus többes számú neve |
| `%%modified%%` | a módosítás ideje |
| `%%id%%` | a bejegyzés vagy oldal azonosítója |
| `%%name%%` | a szerző „nicename” neve |
| `%%user_description%%` | a szerző **Életrajzi adatok** szövege |
| `%%page%%` | az aktuális oldalszám a környezettel együtt (például „2. oldal, összesen 4”) |
| `%%pagetotal%%` | az oldalak száma összesen |
| `%%pagenumber%%` | az aktuális oldal száma |
| `%%caption%%` | a melléklet képaláírása |
| `%%focuskw%%` | a bejegyzés fókuszkulcsszava |
| `%%term404%%` | a 404-es hibát okozó slug |
| `%%cf_<mezőnév>%%` | egyéni mező értéke |
| `%%ct_<taxonómianév>%%` | a bejegyzéshez rendelt saját taxonómia-elemek, vesszővel elválasztva |
| `%%ct_desc_<taxonómianév>%%` | egy saját taxonómia leírása |

Az utolsó három változónál a `<` és `>` jeleket el kell hagyni.

## Egyéni változók

Az utolsó három haladó változóval nem szabványos WordPress-elemek adatait is kiírhatod, például a WooCommerce-termékekét.

### Egyéni mezők

Az egyéni mező nevét behelyettesíted a `%%cf_<mezőnév>%%` alakba. Ha a mező neve `sajatmezo`, a változó `%%cf_sajatmezo%%`. Ha a név aláhúzásjellel kezdődik, például `_masikmezo`, az aláhúzás is bekerül: `%%cf__masikmezo%%`.

Tömböt (összetartozó adatok listáját) tartalmazó egyéni mezőknél ez a változó nem működik. Ilyenkor a fejlesztőd készítsen saját sablonváltozót.

### Saját taxonómiák

A saját taxonómia nevét a szerkesztőoldal címsorából olvashatod ki. Például az `edit-tags.php?taxonomy=sajatkategoria&post_type=sajattipus` cím egy `sajatkategoria` nevű taxonómiát jelent a `sajattipus` tartalomtípuson. A tartalomtípus oldalán a hozzárendelt elemek listáját a `%%ct_sajatkategoria%%` adja, az egyes elemek archívumoldalán a leírást pedig a `%%ct_desc_sajatkategoria%%`.

### A `%%category%%` nem cserélődik le

Ha a SEO-cím sablonjában a `%%category%%` változó nem a kategória nevére cserélődik, valószínűleg olyan saját taxonómiánál használod, amely nem a WordPress beépített kategóriája. Cseréld le a `%%term_title%%` változóra. Ha ezzel sem működik, használj egyéni változót a fent leírtak szerint.

## WooCommerce-változók

| Változó | Mire cserélődik |
|---|---|
| `%%ct_product_cat%%` | a termékkategóriák, vesszővel elválasztva |
| `%%ct_product_tag%%` | a termékcímkék, vesszővel elválasztva |
| `%%ct_pa_<tulajdonság-slug>%%` | egy termék-tulajdonság értékei, vesszővel elválasztva (a `<` és `>` jelek nélkül) |

Ha a keresett változó nincs a listában, az egyéni változók leírása alapján találd meg a szükséges mező- vagy taxonómianevet.

A Yoast WooCommerce SEO bővítménnyel további változók is elérhetők:

| Változó | Mire cserélődik |
|---|---|
| `%%wc_shortdesc%%` | a termék rövid leírása |
| `%%wc_sku%%` | a termék cikkszáma (SKU) |
| `%%wc_brand%%` | a márka neve; csak a „WooCommerce Brands” és a „Perfect WooCommerce Brands” bővítménnyel működik |
| `%%wc_price%%` | a termék ára |

## Elavult változók

Ezeket a Yoast SEO 7.7-es verziója óta nem ajánlott használni. A szerkesztőben nem jelennek meg az előnézetben, a forráskódban viszont a visszafelé kompatibilitás miatt még látszanak.

| Változó | Mire cserélődik |
|---|---|
| `%%userid%%` | a szerző azonosítója |
| `%%currenttime%%` | az aktuális idő |
| `%%currentdate%%` | az aktuális dátum |
| `%%currentday%%` | az aktuális nap |
| `%%currentmonth%%` | az aktuális hónap |
| `%%currentyear%%` | az aktuális év |

## Alapértelmezett sablonok

Ha vissza akarod állítani az SEO-cím sablonokat az alapértékre, használd az alábbiakat. A metaleírás alapértéke üres. A sablonokat a **Yoast SEO → Beállítások** megfelelő oldalán adhatod meg.

| Sablon | Hol használatos |
|---|---|
| `%%title%% %%page%% %%sep%% %%sitename%%` | bejegyzések, oldalak, termékek, média és saját tartalomtípusok |
| `%%pt_plural%% Archive %%page%% %%sep%% %%sitename%%` | bejegyzések, termékek és más tartalomtípusok archívumoldalai |
| `%%term_title%% Archives %%page%% %%sep%% %%sitename%%` | taxonómiák |
| `You searched for %%searchphrase%% %%page%% %%sep%% %%sitename%%` | keresési oldal |
| `Page Not Found %%sep%% %%sitename%%` | 404-es oldal |
| `%%name%%, Author at %%sitename%% %%page%%` | szerzői archívumok |
| `%%date%% %%page%% %%sep%% %%sitename%%` | dátumarchívumok |
| `The post %%POSTLINK%% appeared first on %%BLOGLINK%%.` | RSS-hírcsatorna |
| `%%sitename%% %%page%% %%sep%% %%sitedesc%%` | nyitólap |

## Fejlesztőknek

- Saját sablonváltozót a `wpseo_register_extra_replacements` szűrővel regisztrálhatsz a `functions.php` fájlban.
- A sablonváltozók programozott módosításához a bővítmény kódjában több szűrő is dokumentálva van.
- Ha nem akarod, hogy a Yoast által létrehozott címek megjelenjenek, ezeket is szűrőkkel kapcsolhatod ki.