wp easy-svg icons list

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

Dieser Befehl zeigt dir jede Icon-Sammlung, die die Website kennt, in einer Tabelle. Du siehst den Slug, den du in Templates verwendest, die Bezeichnung, die Zahl der Icons, die Herkunft und wie viele Dateien nicht verwendet werden konnten. So beantwortest du am schnellsten die Frage „Welche Icons hat diese Seite eigentlich?“, ohne wp-admin zu öffnen.

Verwendung

wp easy-svg icons list

Der Befehl kennt keine Argumente und keine Optionen. Ausgegeben wird immer eine Tabelle.

Wann du es brauchst

• Nach einem Deploy, um zu prüfen, ob der Theme-Ordner oder ein Drop-in-Ordner die erwartete Sammlung mit der erwarteten Zahl an Icons registriert hat.
• Bei einem Agentur-Audit über viele Seiten, um zu sehen, welche Sammlungen jede Seite hat und woher sie kommen (Theme, Drop-in-Ordner, Icon-Set, Code).
• Um einen kaputten Ordner zu finden: Ein Wert über null in problems heißt, dass Dateien auf der Platte nicht in der Sammlung gelandet sind.
• Um den genauen Slug für easy_svg_icon( 'slug/icon' ) oder für wp easy-svg pack export herauszufinden.

Nicht geeignet ist der Befehl, wenn:

• du maschinenlesbare Ausgabe brauchst. Er gibt immer eine Tabelle aus. Nimm stattdessen wp easy-svg pack list --format=json.
• du wissen willst, warum Dateien abgelehnt wurden. Hier steht nur die Zahl, die Gründe liefert wp easy-svg icons problems.

Parameter

Der Befehl hat keine Parameter und keine Optionen.

Rückgabewert

Standardwert

Ohne Argumente listet der Befehl alles aus dem Paket-Index: die kostenlose Icon-Bibliothek, veröffentlichte Icon-Sets und Ordnerquellen.

Beispiele

Sehen, was die Seite hat

wp easy-svg icons list

+------------+-------------+-------+---------------------+----------+
| collection | label       | count | origin              | problems |
+------------+-------------+-------+---------------------+----------+
| acme       | ACME Icons  | 48    | dropin acme         | 0        |
| easy-svg   | Icons       | 12    | library             | 0        |
| theme      | Theme icons | 20    | theme acme-theme    | 2        |
+------------+-------------+-------+---------------------+----------+
theme: run `wp easy-svg icons problems` to see why.

Einen Deploy prüfen, bevor du ihn abhakst

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

# Deploy abbrechen, wenn die Theme-Sammlung nach dem Release fehlt.
if ! wp easy-svg icons list | grep -qE '^\| theme '; then
	echo "Die Theme-Icon-Sammlung wurde nicht registriert." >&2
	exit 1
fi

Jede Seite eines Multisite-Netzwerks prüfen

for url in $(wp site list --field=url); do
	echo "== $url"
	wp easy-svg icons list --url="$url" || echo "Easy SVG Pro CLI auf $url nicht verfügbar"
done

Defensiv: nur dort laufen lassen, wo der Befehl funktionieren kann

if wp plugin is-active easy-svg-pro && wp plugin is-active easy-svg; then
	wp easy-svg icons list
else
	echo "Easy SVG Support und Easy SVG Pro müssen beide aktiv sein." >&2
fi

So funktioniert es

1. Zuerst läuft die Prüfung: Ist die Lizenz aktiv und die Funktion WP-CLI unter Icons → Funktionen eingeschaltet? Wenn nicht, bricht der Befehl mit Turn on WP-CLI under Icons → Features (a license is required). ab (in deiner Sprache, falls übersetzt). Eine Berechtigung wird nicht geprüft, weil WP-CLI ohne angemeldeten Benutzer läuft.
2. Die Zeilen kommen aus dem Paket-Index, demselben Bestand, den der Tab Pakete und jede Auswahl nutzen. Deshalb taucht die kostenlose Icon-Bibliothek hier als easy-svg auf.
3. Jede Quelle im Index gibt es nur, solange ihre eigene Funktion an ist. Icon-Sets erscheinen nur mit eingeschaltetem Icon-Set-Editor, Theme- und Drop-in-Ordner nur mit Theme- und Ordner-Quellen. Ist eine Funktion aus, fehlen ihre Sammlungen in der Tabelle, obwohl Dateien oder Posts noch da sind.
4. count ist die Zahl der Icons der Sammlung. origin ist eine kurze Zeile wie library, set, theme acme-theme, dropin acme oder plugin acme-icons. Überschreibt ein Child-Theme Icons seines Eltern-Themes, steht dort etwa theme child > parent, und ein importiertes Set ergänzt, wie es entstanden ist, zum Beispiel set ACME (import-cli).
5. problems zählt Dateien, die ein Quellordner nicht verwenden konnte. Ein Ordner mit kaputtem Manifest registriert gar keine Sammlung, bekommt aber trotzdem eine Zeile mit count 0. Ein kaputter Ordner ist also nie unsichtbar.

Die Ordner-Scans liegen pro Ordner einen Tag in einem Transient und werden neu gebaut, sobald sich eine Datei, das Manifest oder der Sanitizer des kostenlosen Plugins ändert. Du kannst den Befehl also oft laufen lassen.

Stolperfallen

• Eine ausgeschaltete Funktion sieht aus wie fehlende Icons. Fehlen theme oder deine Icon-Sets in der Tabelle, schau zuerst unter Icons → Funktionen nach. Der Befehl sagt dir nicht, dass eine Funktion aus ist.
• Kein anderes Format. Hier gibt es keine Option --format. Die ASCII-Tabelle in Skripten zu parsen geht, sicherer ist aber wp easy-svg pack list --format=json.
• Ein Icon-Set kann zweimal auftauchen. Sind Mehrere Sammlungen und Icon-Set-Editor beide an, kann ein Set auf älteren Seiten unter einem Slug mit -x am Ende stehen. Kopiere den Slug immer aus dieser Tabelle, nicht aus dem Post-Slug des Sets.
• Die Hinweiszeilen landen auch auf stdout. Wenn du die Ausgabe weiterleitest, filtere auf Zeilen, die mit | beginnen.

Siehe auch

• wp easy-svg icons problems
• wp easy-svg pack list
• easy_svg_pro_source_dirs
• Mit WP-CLI automatisieren