# SEOPress és WP-CLI

> A SEOPress kezelése parancssorból: beállítások export és import, metaadatok, AI-generálás, licenc, átirányítás-import és tartalomelemzés.

A SEOPress a WP-CLI-vel parancssorból is kezelhető. A parancsokat a megfelelő WordPress-telepítésben futtasd, vagy add meg a WP-CLI `--path` kapcsolóját. Importálás, törlés vagy migráció előtt mindig készíts adatbázis-mentést. A példákban szereplő azonosítókat és szerverútvonalakat cseréld a sajátjaidra.

A saját beállítás-, AI-, tartalomelemzés-, licenc- és átirányítás-parancsokhoz a SEOPress PRO és a SEOPress alapbővítmény is kell. A `wp post meta`, `wp term meta` és `wp option` parancsokat a WP-CLI adja. Az Insights-parancsokhoz a SEOPress Insights kell.

## Beállítások exportálása privát JSON-fájlba

```bash
wp seopress settings export --destination='/home/example/private/seopress-settings.json' --exclude=license,api_keys
```

Előbb hozd létre a privát célmappát, és tedd írhatóvá a parancsot futtató felhasználónak. A `--destination` JSON-fájlnevet vagy mappát fogad el: mappa esetén a fájl neve `seopress-settings.json`. Ha elhagyod, az aktuális munkakönyvtárba ír. A nyilvános célokat (webgyökér, feltöltések mappája) és a szimbolikus linkeket elutasítja. Ha ugyanazon az útvonalon már van export, felülírja.

Kizárás nélkül az export tartalmazhatja a licenckulcsot és az API-hitelesítő adatokat. Újrahasznosítható beállításfájlhoz használd az `--exclude=license,api_keys` kapcsolót. További kategóriák: `knowledge_graph`, `social_profiles`, `analytics_ids` és `verification_codes`. A `wp seopress settings export --exclude` (érték nélkül) hibaüzenetben kiírja az elérhető kategórianeveket, és nem exportál fájlt. A kiegészítők újabb kategóriákat adhatnak hozzá.

## Globális beállítások importálása

```bash
wp seopress settings import --from='/home/example/private/seopress-settings.json'
```

A `--from` JSON-fájlt vagy olyan mappát fogad el, amelyben van `seopress-settings.json`. Nélküle a parancs az aktuális könyvtárban keres, majd a feltöltések mappájában (a régebbi exportok miatt). Inkább adj meg kifejezett, privát útvonalat. Az import a globális beállításokat alkalmazza, utána nézd át a célwebhely konfigurációját. Nem teljes adatbázis- vagy bejegyzés-metaadat-mentés.

## SEO-metaadatok olvasása, módosítása és törlése

A példák kiolvassák egy bejegyzés címét, lecserélik, majd törlik az egyedi értéket. A törlés után a SEOPress szokásos alapértelmezései érvényesek. Csak azt a műveletet futtasd, amelyre szükséged van.

```bash
wp post meta get 123 _seopress_titles_title
wp post meta update 123 _seopress_titles_title "Példa SEO-cím"
wp post meta delete 123 _seopress_titles_title
```

Taxonómiatagoknál a tag azonosítóját használd ugyanazzal a kulccsal:

```bash
wp term meta get 45 _seopress_titles_title
wp term meta update 45 _seopress_titles_title "Példa kategóriacím"
wp term meta delete 45 _seopress_titles_title
```

A további bejegyzés- és tagkulcsok listáját a [SEOPress egyedi mezői](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/metaadatok-egyedi-mezok-listaja/) fejezetben találod.

## Címek, leírások és alternatív szövegek generálása

A generálás előtt állíts be AI-szolgáltatót a SEOPress PRO-ban (lásd az [AI-szolgáltató beállítása](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/ai-szolgaltatok-beallitasa/) fejezetet). A metaadat-parancsok bejegyzés-azonosítókat használnak, az alternatív szöveg parancsai médiafájl-azonosítókat. Az eredmény azonosítónként kiíródik. A generálás a szolgáltató kreditjeit fogyasztja, és alapból mentésre kerül.

```bash
wp seopress ai metadata --id=123,124 --meta=desc --language=hu_HU
wp seopress ai alt_text --id=456,457 --language=hu_HU
```

Metaadatnál a `--meta=title` a címet, a `--meta=desc` a leírást generálja, ha elhagyod a `--meta` kapcsolót, mindkettőt. A `--language` alapértéke `en_US`; adj meg területi kódot, például `hu_HU`, `fr_FR` vagy `es_ES`. Metaadatnál az `--autosave` elhagyása a szokásos mentést jelenti, az `--autosave=0` mentés nélkül generál.

Az `alt_text` parancsot kezeld írási műveletként: az `--autosave` kapcsolója nem ad megbízható előnézeti módot. A parancs a médiafájl feliratát és leírását is generálhatja és mentheti, és alapból felülírhatja a meglévő értékeket. Az `--update_empty_alt_text=0` kapcsolóval csak az üres mezőket frissíti. Lista feldolgozása előtt próbáld ki egy lementett médiafájlon.

```bash
wp seopress ai metadata --id=123 --meta=title --autosave=0
wp seopress ai alt_text --id=456 --update_empty_alt_text=0
```

## Globális opciók olvasása és módosítása

```bash
wp option get seopress_titles_option_name --format=json
wp option patch update seopress_titles_option_name seopress_titles_home_site_title "Példa főoldali cím"
```

Az első parancs kiolvassa az opciót, a második csak a beágyazott főoldalicím-mezőt módosítja. A teljes „Titles & Metas” opció törléséhez használd a következő parancsot, de csak tudatosan és mentés után: az egész opciót törli, nem csak a főoldali címet.

```bash
wp option delete seopress_titles_option_name
```

## A PRO licenc kezelése

| Parancs | Hatása |
|---|---|
| `wp seopress-pro license activate` | Aktiválja a tárolt kulcsot. A `--key` kapcsolóval kulcsot is megadhatsz. A definiált `SEOPRESS_LICENSE_KEY` állandó elsőbbséget élvez. |
| `wp seopress-pro license deactivate` | Deaktiválja az aktuális webhely licencét. |
| `wp seopress-pro license status` | Megmutatja a tárolt állapotot, a lejáratot és a maszkolt kulcs adatait. |
| `wp seopress-pro license reset` | Törli a tárolt licencbeállításokat és frissíti a gyorsítótárakat. A `wp-config.php`-ban megadott állandót nem távolítja el. |
| `wp seopress-pro license update` | Megkeresi és telepíti az elérhető PRO-frissítést. A licencelt frissítésekhez érvényes licenc kell. |

## Átirányítások importálása csomagokban

Tedd az exportfájlt a szerveren olvasható helyre. Listázd a telepített változat által támogatott formátumokat, és az éles importálás előtt futtass próbafutást. A próbafutás előkészíti és ellenőrzi a fájlt, de nem hoz létre átirányítást.

```bash
wp seopress-pro redirections sources
wp seopress-pro redirections import '/home/example/private/redirects.csv' --dry-run
wp seopress-pro redirections import '/home/example/private/redirects.csv' --batch=1000
wp seopress-pro redirections import '/home/example/private/rankmath.json' --source=rankmath
```

A `--source` értéke `csv`, `redirections_plugin`, `yoast`, `rankmath`, `rankmath_csv`, `slimseo`, `aioseo` vagy `smartcrawl` lehet. Forrás megadása nélkül a CSV-t SEOPress CSV-ként kezeli. A JSON-fájlnál kötelező a forrás, mert a kiterjesztésből nem derül ki, melyik bővítmény exportálta.

A `--separator` értéke `auto` (alapérték), `comma`, `semicolon`, `tab` vagy `pipe`. A `--batch` azt szabja meg, hány átirányítást ír a parancs egy szeletben. Ha az import megszakad, a mentett feladatot új fájl nélkül folytathatod:

```bash
wp seopress-pro redirections import --resume
```

Az importformátumokról bővebben: [Átirányítások importálása más bővítményekből](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/atiranyitasok-import-masik-pluginbol/) és [Átirányítások importálása CSV-fájlból](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/atiranyitasok-csv-import/).

## Tartalomelemzés frissítése a háttérben

```bash
wp seopress content-analysis run
wp seopress content-analysis status
wp seopress content-analysis cancel
```

Előbb kapcsold be a webhelyauditot (lásd a [Webhelyaudit](https://hub.hellowp.io/hu/plugins/wp-seopress-pro/atiranyitasok-webhelyaudit/) fejezetet). A `run` parancs háttérben futó csomagokat sorba állít, és a befejezés előtt visszatér. Ehhez működnie kell a WP-Cronnak, vagy a rendszer ütemezőjének, amely az esedékes WordPress-eseményeket futtatja. A beállított csomagméret és a kizárások érvényesek. A `status` megmutatja az előrehaladást és a munkafolyamat utolsó hibáját. A `cancel` leállítja a közös webhelyaudit-sort, és megtartja a már tárolt pontszámokat.

A `--post_type` nélkül a meglévő auditkör változatlan marad. Ha megadod, az a webhelyaudit mentett tartalomtípus-beállítását módosítja, nem ideiglenes felülbírálás. Regisztrált, nyilvános, az audit által támogatott tartalomtípust használj. Egyszerre csak egy audit futhat.

```bash
wp seopress content-analysis run --post_type=post,page
```

## A SEOPress Insights adatainak migrálása

A SEOPress Insights 3.0-ban a migráció a korábbi helyezéseket és hivatkozásokat a bejegyzés-metaadatokból külön táblákba költözteti. Ezek a parancsok az Insightshoz tartoznak, nem az alapbővítményhez vagy a PRO-hoz. A `--full` nélkül minden parancs egyetlen csomagot dolgoz fel.

```bash
wp seopress-insights migrate-backlinks
wp seopress-insights migrate-backlinks --full
wp seopress-insights migrate-rankings
wp seopress-insights migrate-rankings --full
```

A helyezéseknél a `--force` visszaállítja a mentett eltolást és állapotot, és újraindítja a migrációt. Csak akkor használd, ha adatbázis-mentés után el akarod vetni a mentett migrációs állapotot.

```bash
wp seopress-insights migrate-rankings --full --force
```

## Hibaelhárítás

- Ha egy saját parancs ismeretlen, ellenőrizd, hogy a megfelelő webhely és a szükséges bővítmények töltődnek-e be, és nézd meg a telepített változat súgóját: `wp help seopress` vagy `wp help seopress-pro`.
- Az exporthoz közvetlen WordPress-fájlrendszer-hozzáférés és írható, privát célmappa kell.
- Ha a sorba állított audit nem halad, nézd meg az ütemezett eseményeket és a `status` hibaüzenetét.
