# XML-webhelytérkép hibaelhárítás

> A webhelytérkép állapotvizsgálata, és a leggyakoribb hibák: üres oldal, 404, gyorsítótár, Google Search Console hibák.

Ha az XML-webhelytérkép nem működik, vagy hibát ad, kezdd a beépített állapotvizsgálattal, utána nézd végig az alábbi eseteket.

![Az XML - HTML Sitemap oldal General füle a vizsgálat gombbal](./kepek/oldalterkepek-xml-html-altalanos.webp)

*Az XML - HTML Sitemap oldal General füle a vizsgálat gombbal* (https://minta-bolt.hu/wp-admin/admin.php?page=seopress-xml-sitemap)

A képen a **Sitemap health check** blokk és a **Test my sitemap** gomb látszik; fölötte a térkép címe (`/sitemaps.xml`) a **Copy** és **View** gombbal.

## Állapotvizsgálat

1. Menj a **SEO → XML - HTML Sitemap** oldalra, **General** fül.
2. Kattints a **Test my sitemap** gombra.

Az eredmény háromféle lehet: a térkép rendben van, működik, de van figyelmeztetés, vagy hibát találtál. Minden ellenőrzéshez állapot és magyarázat tartozik, ahol lehet, egykattintásos javítás is (például 404-nél a permalinkek frissítése).

A vizsgálat ellenőrzi, hogy:

- az XML-térkép funkció be van kapcsolva,
- a térkép elérhető (HTTP 200, nincs 404, 5xx, 401, 403),
- XML-ként érkezik, nem HTML-ként (gyorsítótár vagy CDN beavatkozása),
- az XML érvényes (nincs BOM és üres sor a `<?xml` előtt),
- a gyökérelem valódi térkép (`<sitemapindex>` vagy `<urlset>`),
- a térkép nem üres, és nem lépi át az 50 000 URL-es korlátot,
- az XSL stíluslap betöltődik,
- az al-térképek (bejegyzések, taxonómiák, szerzők, videó, hírek) válaszolnak,
- a permalinkek szép szerkezetűek,
- a keresőmotorok nincsenek kizárva (**Beállítások → Olvasás**),
- a robots.txt hirdeti a térképet, és nem tiltja,
- nincs ütköző SEO- vagy gyorsítótár-bővítmény,
- NGINX-szerveren a rewrite-szabályokra vonatkozó megjegyzés.

A SEOPress PRO **SEO Alerts** moduljával ez a vizsgálat automatikusan is futhat, és e-mailben vagy Slacken értesít, ha a térkép meghibásodik.

## Ne gyorsítótárazd a térképet

Ha nem látod a térképet, vagy a Google Search Console azt írja: „Your file appears to be an HTML page”:

- zárd ki az XML és XSL fájlokat a gyorsítótár-bővítményekből (lásd lent),
- zárd ki őket a Weglot bővítményből és a CDN-ből is,
- frissítsd a Really Simple SSL bővítményt a legújabb kiadásra.

### Kizárási szabályok gyorsítótár-bővítményenként

Az XML-térképet és az XSL stíluslapot soha nem szabad gyorsítótárazni. A legtöbb bővítmény ezt magától megteszi, de nem mind.

| Bővítmény | Teendő |
| --- | --- |
| WP Rocket | Nincs teendő, teljesen kompatibilis, az előtöltés is működik. |
| Autoptimize | Nincs teendő. |
| WP-Optimize | Nincs teendő. |
| W3 Total Cache | A lenti szabályokat add hozzá: **Performance → Page cache → Never cache the following pages**, **Performance → Minify → Never minify the following pages**, **Performance → Database cache → Never cache the following pages**, **Performance → Browser cache → 404 error exception list**. |
| Hummingbird | A szabályokat a **Hummingbird → Caching** oldal **Exclusions** részébe írd. |
| WP Super Cache | A szabályokat a **Settings → WP Super Cache → Advanced** részbe írd. |
| Swift Performance | **Tools → Swift Performance → Settings → Caching → General**: a **Cache sitemap** legyen kikapcsolva. |
| LiteSpeed Cache | **LiteSpeed Cache → Cache → Excludes** fül, **Do Not Cache URIs** mező. |

A szabályok (soronként egy):

```text
[a-z0-9_\-]*[a-z0-9_\-]*\.(xml|xsl|html)(\.gz)?
([a-z0-9_\-]*?)([a-z0-9_\-]*)?\.xml
```

Mentsd a beállítást, és ürítsd a gyorsítótárat.

Divi témánál ütközés lehet a Google-betűtípusok betöltésének javításával: kapcsold ki a **Improve Google Fonts loading** beállítást a Divi **Theme Options → General → Performance** részén.

## 404-es hiba

Az XML-térkép bekapcsolásakor vagy a térképbeállítások módosításakor a permalinkeket (az URL-átírást) frissíteni kell. A SEOPress ezt mentéskor magától megteszi, de ha mégis 404-et kapsz:

1. Nyisd meg a **Beállítások → Közvetlen hivatkozások** oldalt. A frissítéshez nem kell menteni, a megnyitás is elég.
2. Ellenőrizd, hogy a térképet nem gyorsítótárazza semmi (a legtöbb gyorsítótár-bővítmény magától kizárja).
3. Ellenőrizd, hogy a karbantartási mód (például egy bővítményből) ki van kapcsolva.

Ha TranslatePress-t használsz, a SEO-csomagot tartalmazó fizetős változatot telepítsd. NGINX-en a rewrite-szabályokat a szerver konfigurációjába kell felvenni, ebben kérd a tárhelyszolgáltatód segítségét.

## „Couldn't fetch sitemaps” a Google Search Console-ban

1. Győződj meg róla, hogy az XML-térkép be van kapcsolva, a böngészőben megnyitva nem ad 404-et vagy üres oldalt, és érvényes XML.
2. Csak a fő (index) térképet küldd be, az al-térképeket nem kell külön: a Google megtalálja őket.
3. Ha a hiba marad, próbáld URL-átírás nélküli címmel: `https://example.com/index.php?seopress_sitemap=1`. Beküldés után frissítsd az oldalt (F5), néha ez segít, hogy az adatok megjelenjenek.
4. A Google akár hetekig is tarthat, mire beolvassa vagy frissíti a térkép adatait: légy türelmes.

## Google Search Console hibák a képtérképnél

- Tiltsd le a shortcode-ok futtatását a képtérképekben egy horoggal (a gyermektéma `functions.php` fájlján át).
- Vagy kapcsold ki az **Enable XML Image Sitemap** beállítást a **SEO → XML - HTML Sitemap → General** fülön.

## Üres térkép

- **XSL-hiba:** a térképhez tartozó stíluslap nem töltődik be, vagy a téma vagy egy bővítmény módosította. A stíluslap címe: `https://example.com/sitemaps_xsl.xsl`; a forráskódja általában gyorsan elárulja a hibát.
- **WP Debug:** ha az index és/vagy az al-térképek forráskódja is üres, kapcsold be a `WP_DEBUG` naplózást; a térkép újratöltése után a hiba a `debug.log` fájlban lesz.

## Hiányzik egy URL a térképből

Ellenőrizd, hogy nem jelölted noindexre. Az az URL is kimarad, amelynek egyéni kanonikus címe eltér a permalinkjétől.

## „Extra kód” a térkép forrásában

A SEOPress 9.0 óta a shortcode-ok alapból tiltottak. Ha harmadik féltől származó PHP- vagy JS-kód látszik, tiltsd le a shortcode-ok futtatását a térképekben egy kódrészlettel (gyermektéma `functions.php`, vagy must-use bővítmény, ha nincs ilyen fájl, például Oxygen buildernél).

## Lassú térkép

Kapcsold ki a képtérképet (**Enable XML Image Sitemap**) a **General** fülön.

## „XML declaration allowed only at the start of the document”

A térkép forrásának első sora üres. Ezt általában egy rosszul nyitott vagy zárt `<?php` címke okozza. Nézd át a téma `header.php` és `functions.php` fájlját, és a `wp-config.php` fájlt.

## Időtúllépés az index térkép betöltésekor

Az indexlekérdezést egy kódrészlettel 10 ezer bejegyzésre korlátozhatod (gyermektéma `functions.php` vagy mu-plugins).

## Ha semmi nem segít

A PRO-felhasználók a vevői fiókjukból nyithatnak támogatási jegyet, az ingyenes bővítmény használói a wordpress.org fórumán írhatnak.