Mit WP-CLI automatisieren

Easy SVG Pro bringt sieben WP-CLI-Befehle mit. Zusammen kannst du damit Icons prüfen, bevor sie live gehen, Icon-Sets von einer Seite auf viele kopieren und nach einem Deploy bestätigen, dass jede Sammlung da ist. Dieses Tutorial zeigt dir, wie du eine Seite dafür einrichtest, auf welche Exit-Codes du dich verlassen kannst, und drei Pipelines zum Kopieren.

Die Befehle im Überblick

Die Seite vorbereiten

Jeder Befehl prüft zuerst zwei Dinge: Die Lizenz ist aktiv, und die Funktion WP-CLI ist unter Icons → Funktionen eingeschaltet. Fehlt eins davon, bekommst du Turn on WP-CLI under Icons → Features (a license is required). und Exit-Code 1. Einen WordPress-Benutzer brauchen die Befehle nicht, sie laufen ohne Anmeldung.

wp plugin activate easy-svg easy-svg-pro

define( 'EASY_SVG_PRO_LICENSE_KEY', getenv( 'EASY_SVG_PRO_LICENSE_KEY' ) );

wp eval '
$flags        = (array) get_option( "easy_svg_pro_features", array() );
$flags["cli"] = true;
update_option( "easy_svg_pro_features", $flags );
'

wp easy-svg icons list

Exit-Codes, auf die du dich verlassen kannst

Drei Lücken solltest du kennen:

• validate --strict geht bei einem Ordner durch, den es nicht gibt oder der keine .svg-Dateien hat. Zähl die Dateien vorher selbst.
• icons problems scheitert nie. Such nach der Zeile Success:.
• pack import weicht bei einer Kollision auf slug-2 aus und endet trotzdem mit 0. Such in der Ausgabe nach was taken.

Pipeline 1: Icons bei jedem Pull Request prüfen

Die Prüfung muss gegen ein echtes WordPress mit den Sanitizer-Einstellungen der Seite laufen. Der Job kopiert die Icons also auf Staging und prüft sie dort.

name: Icons
on:
  pull_request:
    paths:
      - "theme/assets/icons/**"

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: SSH-Schlüssel einrichten
        run: |
          mkdir -p ~/.ssh
          echo "${{ secrets.STAGING_SSH_KEY }}" > ~/.ssh/id_ed25519
          chmod 600 ~/.ssh/id_ed25519
          ssh-keyscan staging.example.com >> ~/.ssh/known_hosts
      - name: Icons auf Staging kopieren
        run: |
          rsync -a --delete theme/assets/icons/ deploy@staging.example.com:/tmp/icons-pr-${{ github.event.number }}/
      - name: Prüfen
        run: |
          ssh deploy@staging.example.com bash -s <<'SH'
          set -euo pipefail
          DIR=/tmp/icons-pr-${{ github.event.number }}
          n=$(find "$DIR" -maxdepth 1 -name '*.svg' | wc -l)
          if [ "$n" -eq 0 ]; then echo "Keine SVG-Dateien zum Prüfen"; exit 1; fi
          wp --path=/var/www/staging easy-svg icons validate "$DIR" --strict
          SH

Der Job scheitert mit der Tabelle im Log, sobald ein Icon übersprungen würde, und nennt den Grund: not-svg, no-drawing, duplicate, bad-name oder unreadable.

Pipeline 2: ein Icon-Set, viele Kundenseiten

Bau das Set einmal auf Staging, exportiere es und importiere es überall.

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

SLUG="agency-ui"
PACK="/tmp/$SLUG.zip"

wp @staging easy-svg pack export "$SLUG" --file="$PACK"
scp staging:"$PACK" "$PACK"

for site in client-a client-b client-c; do
	scp "$PACK" "$site":/tmp/
	out="$(wp @"$site" easy-svg pack import "/tmp/$SLUG.zip" --as="$SLUG" 2>&1)" || {
		echo "[$site] Import fehlgeschlagen: $out" >&2
		continue
	}
	if grep -q 'was taken' <<<"$out"; then
		echo "[$site] $SLUG gibt es schon, eine Kopie liegt unter einem anderen Slug. Bitte entfernen." >&2
	fi
	echo "[$site] $out"
done

Gut zu wissen:

• pack import legt immer ein neues Set an. Zweimal ausgeführt hast du agency-ui und agency-ui-2. Um ein Set zu aktualisieren, änderst du es im Set-Editor oder entfernst vorher das alte.
• Der Import löst easy_svg_pro_set_icons_written aus, also legt der Icon-Verlauf eine Revision an und deine eigenen Listener laufen. Siehe Auf Set-Änderungen reagieren.
• Schlagwörter aus dem Manifest überleben den Weg in ein Icon-Set nicht.

Pipeline 3: einen Deploy prüfen

Nach einem Theme- oder Drop-in-Deploy bestätigst du, dass die Sammlungen da und vollständig sind:

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

expected=("theme" "acme")
list="$(wp easy-svg pack list --format=json)"

for slug in "${expected[@]}"; do
	jq -e --arg s "$slug" 'any(.[]; .slug == $s and .icons > 0)' <<<"$list" >/dev/null \
		|| { echo "Sammlung $slug fehlt oder ist leer" >&2; exit 1; }
done

problems="$(wp easy-svg icons problems)"
grep -q '^Success:' <<<"$problems" || { echo "$problems"; exit 1; }

Stolperfallen

• Funktionen verstecken Sammlungen. Icon-Sets gibt es als Sammlungen nur, solange der Icon-Set-Editor an ist, Ordner nur mit Theme- und Ordner-Quellen. Fehlt nach einem Deploy eine Sammlung, ist oft eine Funktion aus.
• icons import legt den Zielordner zuerst an. Ein Tippfehler im Quellpfad hinterlässt einen leeren Ordner und endet mit 0.
• Pfade liegen auf dem Server. Mit einem Alias wie @staging lesen und schreiben validate, import und export Pfade auf dem Staging-Server, nicht auf deinem Rechner.
• Deaktivieren hält nicht, solange die Konstante gesetzt ist. Gibst du den Platz unter Icons → Lizenz frei, bindet der nächste Besuch in wp-admin ihn wieder aus EASY_SVG_PRO_LICENSE_KEY. Entferne zuerst die Konstante.

Siehe auch

• EASY_SVG_PRO_LICENSE_KEY
• easy_svg_pro_import_max_entries
• Icons aus einem Theme oder Plugin ausliefern