# WP-CLI parancsok

> A wp fluent-smtp parancsok: teszt e-mail, kapcsolatok ellenőrzése, statisztika és a régi naplók törlése.

A terminál akkor segít, ha az admin felület nem érhető el: az elromlott levél éppen a belépési hivatkozás, a tesztoldal HTTP-hitelesítés mögött van, vagy egy telepítési szkriptnek a végén meg kell győződnie arról, hogy a levélküldés működik.

Szükséged van a szerveren telepített WP-CLI-re és FluentSMTP 2.3.0 vagy újabb kiadásra. A parancsokat a WordPress mappájából futtasd, vagy add meg a `--path=<wordpress-mappa>` kapcsolót.

| Parancs | Mit csinál |
|---|---|
| `wp fluent-smtp test` | Teszt e-mailt küld |
| `wp fluent-smtp health` | Ellenőrzi az összes kapcsolatot |
| `wp fluent-smtp stats` | Elküldött és sikertelen levelek száma |
| `wp fluent-smtp prune-logs` | Törli a régi e-mail naplókat |

A `wp help fluent-smtp <parancs>` kiírja az egyes parancsok beépített súgóját.

## Teszt e-mail küldése

```bash
wp fluent-smtp test [--to=<email>] [--from=<email>] [--text]
```

| Kapcsoló | Leírás |
|---|---|
| `--to=<email>` | A címzett. Alapértelmezés szerint az oldal adminisztrátori e-mail-címe. |
| `--from=<email>` | A feladó címe. A FluentSMTP az ehhez a címhez beállított kapcsolaton küld. Alapértelmezés szerint az alapértelmezett kapcsolat. |
| `--text` | HTML helyett egyszerű szöveget küld. |

```bash
wp fluent-smtp test
wp fluent-smtp test --to=en@example.com --text
wp fluent-smtp test --from=szamla@example.com --to=en@example.com
```

Siker esetén a parancs kiírja a címzettet és a küldés idejét:

```text
Success: Test email handed to the provider for en@example.com in 0.842s.
```

Hiba esetén kiírja a szolgáltató hibaüzenetét, és nem nulla kilépési kóddal áll meg:

```text
Error: Sending failed after 1.203s: Invalid API key
```

A „handed to the provider” azt jelenti, hogy a szolgáltató elfogadta a levelet. Ez nem ugyanaz, mint hogy a beérkezettek közé került. Nézd meg a postafiókot, utána a levélszemetet.

## Az összes kapcsolat ellenőrzése

```bash
wp fluent-smtp health [--format=<formátum>]
```

| Kapcsoló | Leírás |
|---|---|
| `--format=<formátum>` | `table` (alapértelmezett), `csv`, `json` vagy `yaml`. |

A parancs minden beállított kapcsolatot ellenőriz, és kiszűri az olyan hibákat, mint a lejárt OAuth-token vagy a törölt API-kulcs:

```text
+---------------------+----------+---------+------------------------------+
| sender              | provider | status  | message                      |
+---------------------+----------+---------+------------------------------+
| info@example.com    | ses      | healthy |                              |
| szamla@example.com  | gmail    | error   | Token has been expired or... |
+---------------------+----------+---------+------------------------------+
Error: 1 of 2 connection(s) need attention.
```

A `status` értéke `healthy` vagy `error`. Ha bármelyik kapcsolat hibás, a parancs nem nulla kóddal lép ki, így egy telepítési vagy felügyeleti szkript megállhat rajta:

```bash
wp fluent-smtp health || echo "Egy FluentSMTP-kapcsolat hibás"
```

Ugyanezt az ellenőrzést a FluentSMTP naponta egyszer maga is lefuttatja. Kézi futtatáskor a vezérlőpulton látható állapot is frissül. Ha egy kapcsolat az előző ellenőrzés óta kezdett hibázni, a riasztási csatornáidra értesítés megy.

## Elküldött és sikertelen levelek száma

```bash
wp fluent-smtp stats
```

```text
+--------+-------+
| metric | count |
+--------+-------+
| sent   | 1482  |
| failed | 3     |
+--------+-------+
```

A számok az e-mail naplóból származnak. Azok a levelek, amelyeket akkor küldtek, amikor az **E-mailek naplózása** ki volt kapcsolva, vagy amelyek naplóbejegyzését időközben törölték, nem számítanak bele.

## Régi e-mail naplók törlése

```bash
wp fluent-smtp prune-logs [--days=<napok>] [--yes]
```

| Kapcsoló | Leírás |
|---|---|
| `--days=<napok>` | Ennyi napnál régebbi naplókat töröl. Alapértelmezés szerint a Beállításokban megadott **Naplók törlése** időtartamot használja. |
| `--yes` | Kihagyja a megerősítő kérdést. Szkriptekben és időzített feladatokban használd. |

```bash
wp fluent-smtp prune-logs
wp fluent-smtp prune-logs --days=30 --yes
```

```text
Permanently delete every logged email older than 30 day(s)? [y/n] y
Success: Deleted 2417 log entries.
```

A törölt naplók nem állíthatók vissza. Ha elhagyod a `--days` kapcsolót, és nincs megadva **Naplók törlése** időtartam, a parancs hibával megáll, és nem töröl semmit.

A törlés kötegekben történik, ezért több százezer bejegyzésnél is biztonságos.
