# Séma bevezetése lépésről lépésre, tesztelés és összekapcsolás

> Mi a strukturált adat, kézi és automatikus séma, GYIK- és helyi vállalkozás séma, azonosítók (@id), egyetlen @graph blokk, tesztelés és ellenőrzés a Search Console-ban.

## Mi a strukturált adat?

A strukturált adat (séma) szabványos módszer a tartalom besorolására. Sok séma létezik, a legismertebbek a Termék, Cikk, Helyi vállalkozás, GYIK és Videó. Ezeket a schema.org írja le, minden sémához tulajdonságokkal és lehetséges értékekkel. Érdemes a Google által támogatott típusokat nézni, mert felesleges olyan sémát felvenni, amelyet a Google nem használ.

A tulajdonságok egy része kötelező, más része csak ajánlott. Ha a kötelező tulajdonságok értékét nem adod meg, a Google nem használja a strukturált adatot. Az ajánlott tulajdonságokat csak akkor töltsd ki, ha van hozzájuk valódi tartalom.

Egy Organization séma JSON-LD formában például így néz ki az oldal forráskódjában:

```html
<script type="application/ld+json">{"@context":"https://schema.org","@type":"Organization","name":"Minta Kft.","url":"https://example.com","logo":"https://example.com/logo.png"}</script>
```

A strukturált adatnak három formátuma van:

- **JSON-LD**: az oldal fejlécébe vagy törzsébe szúrt JavaScript-kód. A Google ezt ajánlja, a SEOPress is ezt használja.
- **Microdata**: HTML-címkékhez adott attribútumok.
- **RDFa**: öt egyszerű attribútumra épülő HTML-jelölés (`vocab`, `typeof`, `property`, `resource`, `prefix`).

A JSON-LD kell hozzá a legkevesebb kód, egyszerű bevezetni, és csak a keresők látják. A Microdata és az RDFa a már látható tartalom jelölésére épül, ami WordPressben nehéz, főleg ha a jelölendő tartalom a sablonban van.

Ha a tartalmat helyesen jelölted meg, a Google rich snippetként is megjelenítheti, például a GYIK sémából. A rich snippet nagyobb láthatóságot, így több forgalmat és konverziót hozhat. A SEOPress PRO ezt néhány kattintással kezeli, programozás vagy HTML-módosítás nélkül.

## Előfeltételek

- Használd a SEOPress legfrissebb Free és PRO változatát. A strukturált adatokhoz a PRO kell.
- A keresőket ne tiltsd ki a sémát tartalmazó oldalakról: nézd meg a `robots.txt` fájlt és a robots meta címkét.
- A **SEO → PRO → Strukturált adattípusok** fülön kapcsold be a funkciót, és jelöld be a metabox bekapcsolását a bejegyzésekhez, oldalakhoz és egyedi bejegyzéstípusokhoz.
- A logódat sok séma felhasználja: töltsd fel a **Töltsd fel a kiadó logóját** mezőbe, a mező alatti követelmények szerint.
- Töltsd ki a **SEO → Social Networks → Knowledge Graph** adatait is, mert több séma hivatkozik rá (lásd [A Tudásgráf beállítása](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/strukturalt-adatok-tudasgraf/)).
- Közben ne felejts el menteni.

## Kézi és automatikus séma

| | Kézi | Automatikus |
| --- | --- | --- |
| Hol adod meg | Az SEO metabox **Schemas → Manual** fülén | A **SEO → Sémák → Új séma hozzáadása** oldalon |
| Hatókör | Csak az éppen szerkesztett tartalom | Globálisan, tartalomtípus szerint (például az összes bejegyzés) |

A létrehozott automatikus sémák az egyes tartalmak metaboxában is megjelennek. Részletek: [Automatikus séma](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/strukturalt-adatok-automatikus-sema/).

### A metabox bekapcsolása

1. Nyisd meg a **SEO → PRO** oldalt, és kapcsold be a **Strukturált adattípusok** kapcsolót.
2. Jelöld be a metabox bekapcsolását a bejegyzéstípusokhoz, és mentsd.
3. A szerkesztőben megjelenik a sémametabox, a **SEO** menüben pedig a **Sémák** menüpont.

### Kézi séma hozzáadása

1. Szerkeszd a megjelölendő bejegyzést, oldalt vagy egyedi bejegyzéstípust.
2. A metaboxban válassz adattípust, például Eseményt.
3. Töltsd ki helyesen az összes mezőt, és mentsd.
4. Ellenőrizd a Google hivatalos tesztjével, és javítsd a hibákat.

## 1. példa: Helyi vállalkozás egy címhez

Egy étteremnek helyi vállalkozás sémával Tudáskártya jelenhet meg a Google-ben, amikor a nevére keresnek. Ez a nyitvatartást, címet, telefonszámot, fotókat és értékeléseket emeli ki.

Ha a cégnek egy címe van, a **SEO → PRO → Helyi vállalkozás** oldalon add meg a sémát:

1. Válaszd ki a vállalkozás típusát (például „Étterem”). Ha nincs megfelelő, hagyd az alapértelmezett Helyi vállalkozást.
2. Töltsd ki a többi mezőt a mintában látható formátumban. A telefonszám például nemzetközi formátumú: pluszjel, országkód, szóközök nélkül.
3. A Google minden mezőt kér. Mentsd a módosítást, és ürítsd a gyorsítótárat.

![A Helyi vállalkozás beállításai](./kepek/strukturalt-adatok-helyi-vallalkozas.webp)

*A Helyi vállalkozás beállításai* (https://minta-bolt.hu/wp-admin/admin.php?page=seopress-pro-page)

Nyitvatartás: ha a vállalkozás egész nap, a hét minden napján nyitva van, minden napnál add meg a 0:00 és 23:59 időpontot. Ha ebédidőben zár, kapcsold ki a Helyi vállalkozás funkciót az oldal tetején lévő kapcsolóval, és használj kézi sémát: a kezdőlap szerkesztésekor a sémametaboxban válaszd a Helyi vállalkozást, ahol a nyitvatartást délelőttre és délutánra külön is megadhatod.

Több cím esetén kézi helyi vállalkozás sémát adhatsz egy tartalomhoz többször is: hozz létre minden címnek külön oldalt, mindegyikhez a metaboxból egy-egy helyi vállalkozás sémát, és kapcsold ki a globális helyi vállalkozás funkciót. Minden kézi helyi vállalkozás saját azonosítót kap, így a keresők nem keverik össze az ugyanazon az oldalon szereplő vállalkozásokat. Bővebben: [Helyi vállalkozás](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/strukturalt-adatok-helyi-vallalkozas/).

## 2. példa: GYIK-séma a gyakori kérdések oldalra

A GYIK-séma plusz láthatóságot adhat az oldalnak a keresési találatok között.

1. Szerkeszd az oldalt, és a sémametaboxban nyisd meg a **Manual** fület.
2. Válaszd a „GYIK” lehetőséget.
3. Add meg az oldalon szereplő kérdéseket és válaszokat, minden újabb kérdéshez a **Kérdés hozzáadása** gombbal.
4. Frissítsd a cikket, és ürítsd a gyorsítótárat.

## 3. példa: automatikus Termék séma WooCommerce-hez

A lépéseket a [Automatikus séma](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/strukturalt-adatok-automatikus-sema/) fejezet írja le. A WooCommerce saját, hiányos Termék sémáját a **SEO → PRO → WooCommerce** fülön kapcsolhatod ki.

## Hogyan köti össze a SEOPress a sémákat

A SEOPress minden sémához azonosítót (`@id`) ír. A keresők ennek segítségével értik meg, hogy két séma ugyanarról a dologról szól. Például a cikk kiadója ugyanaz a szervezet, mint a Tudásgráf szervezete, még akkor is, ha a sémák külön `script` címkében vannak.

- A **SEO → PRO → Helyi vállalkozás** helyi vállalkozása ugyanazt az azonosítót használja, mint a Tudásgráf szervezete, mert ugyanazt a vállalkozást írják le.
- Az automatikus Cikk és Videó séma kiadója is ezt az azonosítót használja, megtartva a nevét és a kiadó logóját.
- A kézi Helyi vállalkozás és Szolgáltatás séma saját azonosítót kap az oldal URL-jéből (`#localbusiness`, `#service`). Ha egy oldalon ugyanabból a típusból több van, sorszámot kapnak (`-2`, `-3`…), így sosem olvadnak össze.
- A navigációs morzsa sémának minden oldalon van azonosítója, a kategóriaarchívumokon, a szerzői oldalakon, a bejegyzések oldalán és a bolt oldalán is, és minden morzsát az oldalának URL-je azonosít.

A Tudásgráfhoz kapcsolás csak akkor történik meg, ha a Social Networks funkció be van kapcsolva, és a Tudásgráf szervezetet ír le: a **SEO → Social Networks → Knowledge Graph** oldalon válassz a Nincs és a Személy kivételével más típust. A Cikk és a Videó kiadója csak akkor kerül be, ha a szervezet neve ki van töltve.

### A WebSite és a Tudásgráf séma egyetlen @graph blokkban

Alapértelmezetten minden séma saját `<script type="application/ld+json">` címkében kerül ki. A kezdőlap WebSite és Tudásgráf (Organization vagy Person) sémáját egyetlen blokkba, `@graph` alá is vonhatod.

1. Nyisd meg a **SEO → Advanced** oldalt, az **Advanced** fület.
2. A **Structured data** részben kapcsold be a **Single @graph output** beállítást (a WebSite és a Tudásgráf séma egyetlen @graph blokkba olvad).
3. Kattints a **Save changes** gombra, és ürítsd a gyorsítótárat.

![A SEO → Advanced oldal Structured data része a Single @graph output beállítással](./kepek/strukturalt-adatok-halado-graf.webp)

*A SEO → Advanced oldal Structured data része a Single @graph output beállítással* (https://minta-bolt.hu/wp-admin/admin.php?page=seopress-advanced)

A beállítás alapból ki van kapcsolva. Bekapcsolva a két séma egyetlen `<script id="seopress-schema-graph" type="application/ld+json">` címkében jelenik meg. A keresők minden JSON-LD blokkot beolvasnak, és a blokkok közötti hivatkozásokat is feloldják, ezért ez csak a megjelenítést változtatja, a jelentést nem. A többi séma (helyi vállalkozás, navigációs morzsa, termékek, GYIK-blokk, a bejegyzéseidhez adott sémák) továbbra is saját címkét kap.

### Fejlesztőknek: szűrők az egyetlen @graph mellett

Bekapcsolt egyetlen @graph kimenetnél:

- az adatot módosító szűrők, például a `seopress_schemas_website` és a `seopress_get_json_data_organization`, a megszokott módon működnek;
- a `seopress_schemas_website_html` a teljes `<script>` címkét kapja, amely az összeolvasztás után már nem létezik. Üres szöveggel visszatérve továbbra is eltávolítja a WebSite sémát, de bármilyen más módosítást figyelmen kívül hagy;
- a `seopress_schemas_organization_html` a JSON-tartalmat kapja: üres szöveg eltávolítja a Tudásgráfot, `@type`-ot tartalmazó érvényes JSON lecseréli a csomópontot a gráfban;
- az összeolvasztott kimenet módosításához használd a `seopress_schemas_graph` szűrőt (a csomópontok tömbje nyomtatás előtt; üres tömb esetén nem íródik ki semmi) vagy a `seopress_schemas_graph_html` szűrőt (a teljes `<script>` címke, a csomópontok a második paraméter);
- a `seopress_schemas_graph_enabled` az aktuális kérésre be- vagy kikapcsolja az egyetlen @graph kimenetet, a beállítástól függetlenül.

```php
// Az egyetlen @graph kimenet kényszerítése a beállítástól függetlenül.
add_filter( 'seopress_schemas_graph_enabled', '__return_true' );

// A WebSite csomópont eltávolítása a gráfból.
add_filter( 'seopress_schemas_graph', function( $nodes ) {
	return array_values( array_filter( $nodes, function( $node ) {
		return 'WebSite' !== $node['@type'];
	} ) );
} );
```

### Egyéni sémák: idézőjel nélküli változók

A **SEO → Sémák** oldalon létrehozott automatikus egyéni sémában a dinamikus változót idézőjel nélkül is írhatod, hogy tömböt, objektumot vagy számot adjon, például `"workLocation": %%_cf_clinician_locations%%`. A szerkesztő ezt a szintaxist elfogadja, és nem jelzi érvénytelen JSON-nak: „Valid JSON-LD (@type: …)”. Az idézőjel nélküli változónak minden oldalon érvényes JSON-t kell adnia, például üres értéknél `[]`-t. Ha nem ad semmit, a tulajdonságnak nincs értéke, és az oldal teljes sémája érvénytelen lesz. Lásd még: [Egyéni séma JSON-LD-ben](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/strukturalt-adatok-egyedi-json-ld/).

## A sémák tesztelése

Sok sablon és bővítmény önállóan is ír sémát az oldalakra, ami duplikált, elavult vagy üres értékű jelölést okozhat. Két ingyenes eszközzel ellenőrizheted az oldalakat:

- **Google Rich Results Test**: csak a Google rich result típusait jelzi.
- **Schema Markup Validator**: minden schema.org jelölést ellenőriz, a Google által nem megjelenített típusokat (például Szolgáltatás vagy egyéni sémák) is.

Egy bejegyzés szerkesztésekor a sémák alatt a **Validate my schema** gombbal a Google tesztjét nyithatod meg az adott bejegyzés URL-jével, a **Schema Markup Validator** gombbal a Schema Markup Validatort. A bejegyzésnek közzétettnek kell lennie, mert az eszközök csak élő, nyilvános URL-t tudnak tesztelni. A **Schema Markup Validator** gomb a metabox **Manual** fülén is ott van a **Validate my schema** mellett.

A metaboxban a **Manual** fülön az **Expand** / **Close** hivatkozásokkal az összes séma nyitható, zárható, az **Add a schema** gombbal újabbat vehetsz fel.

Ha egy típus hiányzik a Google tesztjéből, az még nem jelenti, hogy a jelölés nincs ott: ellenőrizd a Schema Markup Validatorral. Add meg az URL-t, futtasd a tesztet, és pár másodperc múlva megjelenik a találatok listája az oldalon észlelt sémákkal. Egy séma nevére kattintva a részletes eredmény, a hibák és figyelmeztetések is látszanak.

## Ellenőrzés a Google Search Console-lal

A Search Console megmondja, hogy a Google megtalálta és érvényesítette-e a strukturált adataidat. Külön jelentései vannak például a Termék, GYIK, Navigációs morzsa és Logó sémákhoz. Hiba esetén részletes jelentés mutatja, mit kell javítani. A javítás után a **Javítás érvényesítése** gombbal kérheted, hogy a Google újra ellenőrizze az oldalakat.

Az érvényesítés napokat, sőt heteket is igénybe vehet. Az állapotát a Search Console mutatja, a haladásról e-mailt is kapsz.

## Összefoglaló tanácsok

Teszteld a sémákat gyakran, és rendszeresen nézd meg a Search Console-t hibák és figyelmeztetések miatt. A javítás érvényesítésekor légy türelmes. Ne vidd túlzásba: csak azt jelöld meg sémával, ami szükséges.