WP-CLIwp easy-svg pack list

wp easy-svg pack list

Listet jede Sammlung, die sich als Paket exportieren lässt, mit Slug, Bezeichnung und Anzahl der Icons, als Tabelle oder als JSON, CSV oder YAML für Skripte.

WP-CLI-Befehl · Easy SVG Pro · Status: Stabil

Dieser Befehl listet jede Sammlung, die du als Paket exportieren kannst: die kostenlose Icon-Bibliothek, deine Icon-Sets und jede Ordnerquelle. Du bekommst Slug, Bezeichnung und Anzahl der Icons. Mit --format=json liest du dieselbe Liste bequem aus einem Skript.

Verwendung

wp easy-svg pack list [--format=<format>]

Wann du es brauchst

  • Vor wp easy-svg pack export, um den genauen Slug zu finden.
  • In einem Skript, das jede Sammlung einer Seite exportiert, als Backup oder um Icons auf eine andere Seite zu bringen.
  • Um zwei Seiten zu vergleichen: beide als JSON ausgeben und vergleichen.

Für Herkunft und Problemzahl pro Sammlung nimm stattdessen wp easy-svg icons list.

Parameter

query
--formatoption

Das Ausgabeformat, das direkt an den Formatter von WP-CLI geht: table (Standard), json, csv, yaml, count oder ids. Die Option funktioniert, steht aber nicht in der Hilfe des Befehls.

Rückgabewert

stdouttable|json|csv|yaml

Ein Eintrag pro Sammlung mit den Feldern slug, label und icons (Anzahl der Icons). In der Reihenfolge des Paket-Index, nicht sortiert.

exit codeint

0 bei Erfolg. 1, wenn die Lizenz nicht aktiv ist oder die Funktion WP-CLI aus ist.

Standardwert

--format=table.

Beispiele

Die Liste anzeigen

wp easy-svg pack list
+----------+-------------+-------+
| slug     | label       | icons |
+----------+-------------+-------+
| easy-svg | Icons       | 12    |
| acme     | ACME        | 48    |
| theme    | Theme icons | 20    |
+----------+-------------+-------+

Jede Sammlung einer Seite exportieren

#!/usr/bin/env bash
set -euo pipefail

mkdir -p packs
for slug in $(wp easy-svg pack list --format=json | jq -r '.[].slug'); do
	wp easy-svg pack export "$slug" --file="packs/$slug.zip"
done

Staging und Produktion vergleichen

wp @staging easy-svg pack list --format=json | jq -S . > staging.json
wp @production easy-svg pack list --format=json | jq -S . > production.json
diff staging.json production.json && echo "Auf beiden Seiten dieselben Sammlungen."

Defensiv: prüfen, ob ein Slug existiert, bevor du ihn nutzt

SLUG="acme"
if wp easy-svg pack list --format=json | jq -e --arg s "$SLUG" 'any(.[]; .slug == $s)' >/dev/null; then
	wp easy-svg pack export "$SLUG"
else
	echo "Keine Sammlung namens $SLUG auf dieser Seite." >&2
	exit 1
fi

So funktioniert es

Der Befehl passiert die Prüfung auf Lizenz und Funktion WP-CLI und liest dann den Paket-Index. Der entsteht aus dem kompletten Icon-Bestand, demselben, den der Tab Pakete und die Auswahlen nutzen. Deshalb steht die kostenlose Bibliothek als easy-svg neben deinen Pro-Sammlungen. Jede Quelle darin hängt an ihrer eigenen Funktion: Icon-Sets erscheinen nur mit eingeschaltetem Icon-Set-Editor, Theme- und Drop-in-Ordner nur mit Theme- und Ordner-Quellen.

icons zählt die Icons, die ein Export schreiben würde. --format wird direkt aus den Argumenten gelesen und an WP_CLI\Utils\format_items() übergeben, also funktioniert jedes Format, das WP-CLI kennt.

Stolperfallen

  • Undokumentierte Option. --format wird vom Code gelesen, fehlt aber im Docblock des Befehls. wp help easy-svg pack list erwähnt sie deshalb nicht.
  • Eine ausgeschaltete Funktion versteckt Sammlungen. Fehlt ein Set oder ein Ordner, ist meistens seine Funktion unter Icons → Funktionen aus.
  • Ordner, die nichts registriert haben, fehlen. Ein Drop-in mit kaputtem Manifest hat keine Icons und erscheint nicht. wp easy-svg icons list zeigt ihn mit 0 an.
  • Nimm den Slug von hier. Auf älteren Seiten kann ein Icon-Set unter einem Slug mit -x am Ende registriert sein. Exportiere mit dem Slug, den dieser Befehl ausgibt, nicht mit dem Post-Slug des Sets.

Siehe auch