Wohin die Dateien gehören
Banner, Icons und Screenshots liegen in einem Ordner namens assets ganz oben in deinem SVN-Repository, neben trunk und tags. Sie gelten für jede Version des Plugins. Du kannst ein Banner also austauschen, ohne ein neues Release zu veröffentlichen.
your-plugin/
├── assets/ ← banners, icons, screenshots
│ ├── banner-772x250.png
│ ├── banner-1544x500.png
│ ├── icon-128x128.png
│ ├── icon-256x256.png
│ └── screenshot-1.png
├── tags/
│ └── 1.2.0/
└── trunk/ ← plugin code and readme.txtEin häufiger Fehler ist trunk/assets oder ein Ordner in einem Tag. Dort sucht WordPress.org nicht, und die Bilder landen stattdessen im Download jedes Nutzers.
Warum du beide Größen brauchst
Die Datei mit 1544 × 500 wird nur auf hochauflösenden Bildschirmen gezeigt, und nur, wenn es auch eine Datei mit 772 × 250 gibt. Allein wird sie ignoriert. Am einfachsten gestaltest du in 1544 × 500 und exportierst eine Kopie in halber Größe.
| Datei | Größe | Wofür |
|---|---|---|
banner-772x250.png | 772 × 250 px | Alle Bildschirme. Pflicht. |
banner-1544x500.png | 1544 × 500 px | Hochauflösende Bildschirme, zusätzlich |
JPG geht unter denselben Namen (banner-772x250.jpg). PNG eignet sich für Flächen und Schrift, JPG für Fotos.
Genaue Größe, genauer Name
Die Maße müssen zu den Zahlen im Dateinamen passen, andere Größen gibt es nicht. Eine Datei namens banner-1544x500.png, die in Wahrheit 1500 × 486 groß ist, wird nicht angezeigt. Schreib die Namen klein.
Auf dem Handy lesbar bleiben
Das Banner schrumpft mit der Seite, auf dem Handy also auf einen Bruchteil von 772 Pixeln. Schrift, die am Monitor gut aussieht, ist dort nicht mehr lesbar. Nimm eine Zeile in großer Schrift oder gar keine, den Rest erledigt der Plugin-Name unter dem Banner.
Für Sprachen, die von rechts nach links laufen, kannst du banner-772x250-rtl.png ergänzen. Sprachversionen bekommen das Locale als Endung, zum Beispiel banner-772x250-de_DE.png. Leg sie nur an, wenn sie sich wirklich unterscheiden: Eine Kopie des englischen Banners unter deutschem Namen verdeckt nur das Original.
Das neue Banner erscheint nicht
Die Bilder werden über ein CDN mit starkem Cache ausgeliefert. Meist ist eine Änderung nach ein paar Minuten zu sehen, rund um ein großes WordPress-Release kann es bis zu sechs Stunden dauern.
Wird das Bild heruntergeladen statt angezeigt, hat SVN es mit dem falschen Dateityp gespeichert. Setz ihn und committe erneut:
svn propset svn:mime-type image/png assets/*.png
svn propset svn:mime-type image/jpeg assets/*.jpgWie oft fehlt es?
Von den 100 zuletzt veröffentlichten Plugins, die wir uns im Oktober 2026 angesehen haben, hatten 27 kein Banner. Ihre Seite beginnt ohne Titelbild, und das ist das Erste, was ein Besucher sieht.