Icon-Pakete

Icon-Sammlungen als ein ZIP zwischen Websites umziehen: jede Sammlung exportieren, anderswo importieren oder ins Repository legen. Mit dem Manifest-Format.

Ein Icon-Paket ist eine Sammlung, verpackt in eine ZIP-Datei. Damit ziehst du Icons von einer Website auf eine andere, gibst die Icons eines Kunden an eine Kollegin weiter oder hältst Icons im Git-Repository deines Themes. Diese Anleitung zeigt Export, Import und was in einem Paket steckt.

Bevor du loslegst

Deine Pro-Lizenz ist aktiv.
Um ein Paket als bearbeitbares Set zu importieren: Icon-Set-Editor ist unter Icons → Funktionen an.
Um ein Paket als Ordner zu nutzen: Theme- und Ordner-Quellen ist an.

Was steckt in einem Paket?

Ein Paket ist ein ZIP mit zwei Arten von Dateien nebeneinander:

manifest.json, eine kleine Textdatei, die die Sammlung benennt und ihre Icons mit Bezeichnungen auflistet. "Manifest" heißt einfach Inhaltsverzeichnis.
Die SVG-Dateien, eine pro Icon.

house-icons.zip
├── manifest.json
├── front-door.svg
└── window.svg

Dasselbe ZIP funktioniert auf zwei Wegen:

Weg	Wie	Ergebnis
Hochladen	Icons → Pakete → Paket importieren	Ein Icon-Set, das du in WordPress bearbeiten kannst
In einen Ordner entpacken	Entpacken nach `wp-content/easy-svg-icons/house-icons/`	Eine schreibgeschützte Sammlung, die in deinen Dateien lebt, etwa in Git

Eine Sammlung exportieren

Pakete öffnen

Gehe zu Icons → Pakete und scrolle zu Sammlung exportieren. Jede Sammlung steht dort, egal woher sie kommt: ein Set, ein Ordner, das Theme oder die kostenlose Icon-Bibliothek. Unter jeder steht ihre Herkunft, zum Beispiel "Icon-Set, auf dieser Website angelegt" oder "Theme Twenty Twenty-Five".

Eine herunterladen

Klicke neben der Sammlung auf Herunterladen. Du bekommst slug.zip.

Oder mehrere

Hake bis zu 25 Sammlungen an und klicke auf Als ein ZIP herunterladen.

Du kannst auch nur einzelne Icons exportieren: Klicke in Icons → Icon-Bibliothek auf Mehrere auswählen, hake bis zu 100 Icons an und klicke auf Exportieren.

Ein Paket auf einer anderen Website importieren

Pakete öffnen

Gehe auf der anderen Website zu Icons → Pakete.

ZIP wählen

Klicke unter Paket importieren auf Paket auswählen… oder lege das ZIP ab.

Vergebenen Namen klären

Gibt es schon eine Sammlung mit diesem Namen, siehst du "Eine Sammlung dieses Namens existiert bereits. Stattdessen als ... importieren?" Klicke auf Unter diesem Namen importieren, um den freien Namen zu übernehmen.

Die Icons werden wie jeder Upload bereinigt und als neues Set gespeichert. Nichts aus dem ZIP wird in die Dateien deines Servers geschrieben.

Wenn ein Name schon vergeben ist

Weg	Was passiert
Hochladen	Dir wird ein freier Name angeboten, und du entscheidest.
Ordner	Niemand kann gefragt werden, also weicht der Ordner selbst aus: Er nimmt den `slug` aus seiner `manifest.json`, wenn der frei ist, sonst den Namen des Ordners, sonst diesen Namen mit einer Zahl.

Der Name eines Ordners wird bei jedem Seitenaufruf neu ermittelt. Verschwindet die Sammlung, der er ausgewichen ist, bekommt der Ordner seinen Wunschnamen zurück.

Schlagwörter (keywords) bleiben in einem Ordner erhalten, bei einem Upload nicht. Ein Set speichert nur Namen und Bezeichnung jedes Icons.

Das Manifest

{
  "version": 1,
  "slug": "house-icons",
  "label": "House icons",
  "icons": {
    "front-door": {
      "file": "front-door.svg",
      "label": "Front door",
      "keywords": ["entrance", "door"]
    }
  },
  "license": "CC0-1.0",
  "author": "Deine Agentur",
  "source": "https://example.com/packs/house-icons"
}

Feld	Pflicht?	Bedeutung
`version`	Ja	Das Format des Manifests. Lass es bei `1`. Ein Paket mit einer neueren Nummer, als dein Plugin kennt, wird als Ganzes abgelehnt.
`slug`	Empfohlen	Die Adresse der Sammlung, zum Beispiel `house-icons`. Icons heißen dann `house-icons/front-door`.
`label`	Empfohlen	Der Name der Sammlung, den Menschen sehen.
`icons`	Ja, nicht leer	Ein Eintrag pro Icon. Jeder kann `file`, `name`, `label` und `keywords` angeben. Ohne `file` wird die Datei mit dem Namen des Eintrags genommen: `"alpha"` heißt `alpha.svg`.
`license`, `author`, `source`	Nein	Freier Text. Wird auf dem Bildschirm Pakete unter der Sammlung gezeigt, aber nie ausgewertet. `source` wird nie geöffnet.

Ein Manifest beschreibt den Ordner, es beschränkt ihn nicht. Eine SVG ohne Eintrag wird trotzdem importiert, benannt nach ihrer Datei.

Gut zu wissen

Die Lizenzfelder zählen. Kommentare in SVG-Dateien entfernt der Sanitizer, ein Urhebervermerk in den Dateien überlebt also nicht. Schreib ihn in license, author und source.
Probleme werden aufgelistet. Unter jeder Ordner-Sammlung listet der Bildschirm Pakete Dateien, die nicht genutzt werden konnten, mit Grund, zum Beispiel "die Datei ist größer als erlaubt" oder "es ist kein sicheres SVG".
WP-CLI. Entwickler machen dasselbe auf der Kommandozeile mit wp easy-svg pack list, export und import.

Häufige Fragen

Passende Anleitungen

Icons importieren

ZIPs, Schriften, Font Awesome und fertige Sets.

Icon Pack Starter

Ein Paket als eigenes Plugin ausliefern.

Für Entwickler: Das vollständige Format steht in Das Manifest, die Befehle in WP-CLI.

Was this page helpful?