# WP-CLI

> A TrustOrder minden admin funkciója wp trustorder parancsként.

Az admin felület minden funkciója elérhető `wp trustorder` parancsként is, ugyanazokkal a szolgáltatásokkal, mint az admin felület.

Kilépési kód: a `0` siker, az `1` szolgáltatási vagy ellenőrzési hiba. Hibánál az üzenet csak a hibakód vagy egy rögzített szöveg, soha nem a vásárlóid adata vagy az API-kulcs.

## Állapot

```bash
wp trustorder status [--format=table|json]
```

Megmutatja a kulcsot (csak az első 12 karakterét), a kapcsolattesztet (bolt, fiókállapot, napi keret, mai ellenőrzések), az utolsó hibát, az intl, a rendeléstárolás és a pénztártípus állapotát, és mindkét környezet visszatöltési haladását. Ha a szolgáltatás nem érhető el, `1`-gyel lép ki.

## Beállítások

```bash
wp trustorder settings get [<key>] [--format=table|json]
```

Megmutatja a beállításokat. Kulcsok: `api-key` (csak az eleje), `strictness`, `hidden-gateways`, `fallback-gateways`, `pickup-methods`, `enabled`, `share-geo`, `silent`.

```bash
wp trustorder settings set <key> <value>
```

Egy beállítást módosít, pontosan úgy ellenőrizve, mint az admin felületen.

- A listákat vesszővel válaszd el.
- Az `enabled`, a `share-geo` és a `silent` értéke lehet `true`/`false`, `on`/`off`, `yes`/`no` vagy `1`/`0`.

Példák:

```bash
wp trustorder settings set strictness normal
wp trustorder settings set silent on
wp trustorder settings set share-geo off
```

### Az API-kulcs csak STDIN-ről

Az API-kulcsot a parancs csak csövön (pipe) érkező STDIN-ről olvassa, így soha nem jelenik meg a parancssorban vagy a shell előzményeiben:

```bash
printf '%s' "$KEY" | wp trustorder settings set api-key -
```

- Az `api-key` utáni bármely más értéket, a `--api-key=...` kapcsolót és a WP-CLI `--prompt` kapcsolóját a parancs elutasítja.
- Ha a bemenet terminál, vagy 5 másodpercen belül nem jön bemenet, az hiba.
- Az üres STDIN törli a kulcsot.
- Ha a kulcsot a `TRUSTORDER_API_KEY` konstans adja meg, itt nem módosítható.

## Egy vásárló ellenőrzése

```bash
wp trustorder check --email=<email> [--phone=<phone>] [--country=<ISO2>] [--postcode=<postcode>] [--address=<address>] [--strictness=lenient|normal|strict] [--format=table|json]
```

Megkérdezi a szolgáltatást egy vásárlóról, és megmutatja a döntést, a szintet, a pontszámot, az okokat és az ellenőrzés azonosítóját. Ez admin eszköz: kihagyja az eredmény-gyorsítótárat, és nem számít bele a pénztári keretekbe. Az értékekből helyben készül kód, csak a kódok mennek ki, és semmi nem kerül naplóba.

## Visszatöltés

```bash
wp trustorder backfill start [--env=live|test]
```

Elindítja vagy folytatja a visszatöltést az elmentett kulcs környezetében. Másik környezetre nem indul el.

```bash
wp trustorder backfill status [--format=table|json]
```

Mindkét környezet állapotát megmutatja.

```bash
wp trustorder backfill run [--limit=<orders>]
```

A háttér helyett a terminálban futtatja a visszatöltést, folyamatjelzővel. A függőben lévő háttérlépést átveszi. A `--limit` annak a 200 rendelésből álló oldalnak a végén áll meg, amelyben a megadott számú rendelés feldolgozásra került; a `backfill start` folytatja. Ha a szolgáltatás nem érhető el, az újrapróbálás visszakerül a háttérbe.

## Rendelések jelentése

```bash
wp trustorder signal send <order-id>... [--format=table|json]
```

Azonnal elküldi a rendelések aktuális kimenetelét. Ha a szolgáltatásnál már megvan, nem küld semmit. `1`-gyel lép ki, ha egy rendelés nem létezik, vagy a jelentése sikertelen, illetve újrapróbálásra vár.

```bash
wp trustorder signal status <order-id> [--format=table|json]
```

Kérés nélkül megmutatja a tárolt állapotot, a rendelés jelenlegi állapotához tartozó kívánt kimenetellel együtt (visszatérített rendelésnél `refund`).

## Kivételek

```bash
wp trustorder exceptions list [--limit=<1-100>] [--cursor=<cursor>] [--format=table|json]
wp trustorder exceptions add --kind=email|phone|address --action=allow|deny [--value=<value>] [--country=<ISO2>] [--postcode=<postcode>] [--address=<address>] [--address-2=<address-2>] [--note=<note>]
wp trustorder exceptions remove --kind=email|phone|address [--value=<value>] [--country=<ISO2>] [--postcode=<postcode>] [--address=<address>] [--address-2=<address-2>]
```

Ugyanazok a mindig engedélyező és mindig tiltó kivételek, mint az admin felületen.

- E-mail-címhez vagy telefonszámhoz a `--value` kell.
- Címhez a `--country`, a `--postcode` és az `--address`.
- Az értékből helyben készül kód; a lista soha nem mutat értéket.

## Vásárlói adat ne maradjon a shell előzményeiben

A `check --email` / `--phone` és az `exceptions add` / `remove --value` a vásárló adatát parancssori argumentumként kapja, amit a naplózó shell megőriz az előzményekben. Ezeket olyan shellben futtasd, amely nem naplóz, vagy utána töröld az előzményeket.

## API

A TrustOrder API leírása itt van: [TrustOrder API](https://docs.uptools.io/hu/trustorder/api/).
