Bevor du anfängst
Drei Dinge kurz prüfen. Das erspart dir die meisten Probleme.
Administrator-Zugang
Du brauchst ein WordPress-Konto mit der Rolle Administrator. Nur damit siehst du den Menüpunkt „Plugins“.
ZIP-Datei bereit
Das Plugin kommt als ZIP-Datei. Lade sie herunter und entpacke sie nicht. WordPress braucht die Datei genau so, wie sie ist.
Upload-Grenze
Unter Medien → Datei hinzufügen steht „Maximale Dateigröße für Uploads“. Diese Zahl muss größer sein als deine ZIP-Datei.
So findest du deine Upload-Grenze
Links im Menü Medien → Datei hinzufügen öffnen. Unter dem Feld zum Hochladen steht, wie groß eine Datei höchstens sein darf.
Eine normale Karte ist etwa 1 bis 2 MB groß. Wird deine Karte größer als 2 MB, sagt dir der Editor das schon beim Herunterladen. Manche Hoster erlauben nur 2 MB. Dann nimm den Weg über FTP oder bitte deinen Hoster, die Grenze zu erhöhen.
Die Datei endet auf .zip. So lädst du sie in WordPress hoch.
Ein Ordner statt der ZIP-Datei. Wer ihn selbst wieder zippt, bekommt meist „Es wurden keine gültigen Plugins gefunden“.
Schritt für Schritt
So kommt die Karte auf deine Seite. Alle Bilder stammen aus einem echten WordPress 7.1.
In WordPress anmelden
Öffne den Anmeldebereich deiner Webseite. Meist erreichst du ihn, wenn du hinter deine Adresse /wp-admin schreibst, zum Beispiel www.deine-seite.de/wp-admin.
/wp-admin nicht, probier /wp-login.php. Manche Sicherheits-Plugins verlegen die Anmeldung an eine eigene Adresse. Die kennt dann der, der die Webseite eingerichtet hat.Plugin hochladen
- Links im Menü auf Plugins fahren und Plugin hinzufügen wählen.
- Oben neben der Überschrift auf Plugin hochladen klicken.
- Datei auswählen klicken und die ZIP-Datei aus deinem Download-Ordner wählen.
- Auf Jetzt installieren klicken.
Plugin aktivieren
WordPress lädt die Datei hoch, packt sie aus und meldet „Das Plugin wurde erfolgreich installiert.“ Dann klickst du auf Plugin aktivieren.
Links im Menü steht danach der neue Punkt MapManufaktur-Karten.
Shortcode kopieren und auf die Seite setzen
Der Shortcode ist ein kurzer Text in eckigen Klammern, zum Beispiel [kartenwerk ABC123]. Er sagt WordPress, wo die Karte erscheinen soll.
- Links MapManufaktur-Karten öffnen. Bei deiner Karte steht der Shortcode mit dem Knopf Kopieren.
- Unter Seiten die Seite öffnen, auf der die Karte stehen soll.
- An der gewünschten Stelle auf das Plus klicken, Shortcode eintippen und den Block „Shortcode“ wählen.
- Den Shortcode hineinkopieren und oben rechts auf Speichern klicken.
| Du arbeitest mit … | So geht es |
|---|---|
| Block-Editor (Standard) | Block „Shortcode“ wie oben beschrieben. |
| Klassischer Editor | Den Shortcode einfach an die gewünschte Stelle im Text schreiben. |
| Elementor | Das Widget „Shortcode“ auf die Seite ziehen und den Shortcode einfügen. |
| Anderer Seitenbaukasten | Ein Element für Shortcodes oder Text nehmen, kein Element für „HTML“ oder „Code“. |
[kartenwerk …] funktioniert auch [mapmanufaktur …]. Beides zeigt dieselbe Karte.Speichern und ansehen
Nach dem Speichern die Seite ansehen. Die Karte erscheint dort, wo der Shortcode steht.
Fahr einmal mit der Maus über die Karte und tipp sie am Handy an. Dann siehst du gleich, ob Tooltips und Marker so funktionieren, wie du sie im Editor eingestellt hast.
Karte später ändern
Kleine Änderungen machst du direkt in WordPress. Du musst nichts neu hochladen.
- Links MapManufaktur-Karten öffnen und bei deiner Karte auf Bearbeiten klicken. Oder auf deiner Seite den Stift „Karte bearbeiten“ nutzen.
- Die Karte öffnet sich im MapManufaktur-Editor, direkt in WordPress.
- Farben, Texte, Tooltips, Links, Marker und Daten ändern.
- Oben rechts auf Speichern klicken. Die Änderung ist sofort auf deiner Seite.
Neue Version einspielen
Deine Änderungen aus WordPress bleiben dabei erhalten.
- Das neue Plugin genauso hochladen wie beim ersten Mal (Schritt 2).
- WordPress merkt, dass die Karte schon da ist und zeigt beide Versionen nebeneinander.
- Auf Installiertes durch Hochgeladenes ersetzen klicken.
Weg ohne Hochladen (FTP)
Für den Fall, dass der Upload in WordPress gar nicht klappt, zum Beispiel wegen einer zu kleinen Upload-Grenze.
- Die ZIP-Datei auf deinem Computer entpacken. Heraus kommt ein Ordner, der mit
mapmanufaktur-karte-beginnt. - Mit einem FTP-Programm (zum Beispiel FileZilla) oder dem Dateimanager deines Hosters auf deinen Webspace gehen.
- Im WordPress-Ordner nach
wp-content/plugins/wechseln. - Den ganzen Ordner dorthin hochladen, nicht nur seinen Inhalt.
- In WordPress unter Plugins → Installierte Plugins die Karte suchen und auf Aktivieren klicken.
- Weiter mit Schritt 4.
- wp-content
- plugins
- akismet
- mapmanufaktur-karte-abc123
- mapmanufaktur-karte-abc123.php
- karte
- kern
Direkt im Ordner liegt die PHP-Datei des Plugins.
- wp-content
- plugins
- mapmanufaktur-karte-abc123
- mapmanufaktur-karte-abc123 ✕
- mapmanufaktur-karte-abc123.php
Ein Ordner zu viel. Dann findet WordPress das Plugin nicht.
Falls es hakt
Die häufigsten Meldungen und was du dagegen tun kannst. Gib oben im Suchfeld einfach ein Wort aus deiner Fehlermeldung ein.
Der Upload bricht ab„Der Link, dem du gefolgt bist, ist abgelaufen.“
Ursache
Die ZIP-Datei ist größer als das, was dein Webspace beim Hochladen erlaubt. Sie passt nicht durch die Tür. WordPress zeigt dann leider diese wenig hilfreiche Meldung.
Lösung
- Unter Medien → Datei hinzufügen nachsehen, wie groß Uploads sein dürfen (siehe oben).
- Deinen Hoster bitten, die Werte
upload_max_filesizeundpost_max_sizezu erhöhen. Bei vielen Hostern geht das auch selbst in den PHP-Einstellungen. - Oder den Weg über FTP nehmen. Der klappt unabhängig von dieser Grenze.
WordPress findet kein Plugin in der Datei„Das Paket konnte nicht installiert werden. Es wurden keine gültigen Plugins gefunden.“
Ursache
Fast immer wurde die ZIP-Datei vorher entpackt und wieder neu gezippt, zum Beispiel von Safari auf dem Mac. Dann liegt im Inneren ein Ordner zu viel. Manchmal wurde auch eine andere Datei gewählt.
Lösung
- Die ZIP-Datei neu herunterladen und unverändert hochladen.
- Prüfen, ob die Datei auf
.zipendet und mitmapmanufaktur-beginnt. - Auf dem Mac den Hinweis zu Safari oben beachten.
Das Plugin ist schon vorhanden„Der Zielordner existiert bereits.“
Ursache
Die Karte ist bereits installiert. Das passiert, wenn du eine neue Version einspielst.
Lösung
Darunter auf Installiertes durch Hochgeladenes ersetzen klicken, siehe Neue Version einspielen. Fehlt dieser Knopf, ist dein WordPress sehr alt (vor Version 5.5). Dann bitte zuerst WordPress aktualisieren.
Auf der Seite steht der Shortcode als Text statt der Karte
Ursache
WordPress kennt den Shortcode nicht. Meist ist das Plugin nicht aktiviert oder im Shortcode steckt ein Tippfehler.
Lösung
- Unter Plugins → Installierte Plugins prüfen, ob die Karte aktiviert ist.
- Den Shortcode nicht abtippen, sondern unter MapManufaktur-Karten mit Kopieren holen und neu einfügen.
- Den Shortcode in einen Block „Shortcode“ setzen, nicht in einen Block „Code“ oder „Vorformatiert“.
Die Seite zeigt noch die alte Karte oder gar keine
Ursache
Ein Zwischenspeicher (Cache) zeigt noch die alte Fassung deiner Seite. Das kann ein Cache-Plugin sein, dein Webhoster oder dein Browser.
Lösung
- Den Cache in deinem Cache-Plugin leeren, zum Beispiel WP Rocket, LiteSpeed Cache, W3 Total Cache oder WP Super Cache.
- Die Seite mit Strg + F5 neu laden (Mac: Cmd + Shift + R).
- Fasst ein Plugin oder dein Hoster JavaScript zusammen oder lädt es verzögert? Dann die Dateien von MapManufaktur dort als Ausnahme eintragen.
Rote Meldung auf der Seite „MapManufaktur-Karten“
Ursache
Beim Herunterladen oder Hochladen ist eine Datei des Plugins unvollständig angekommen. Das Plugin merkt das selbst und zeigt deshalb einen roten Hinweis.
Lösung
- Die ZIP-Datei neu herunterladen.
- Hochladen und Installiertes durch Hochgeladenes ersetzen wählen. Deine Änderungen bleiben erhalten.
Es gab einen kritischen Fehler auf deiner Website„Es gab einen kritischen Fehler auf deiner Website.“
Ursache
Meist ist die PHP-Version auf deinem Webspace zu alt oder ein anderes Plugin verträgt sich nicht. Das MapManufaktur-Plugin braucht mindestens PHP 7.2. WordPress schickt dir in diesem Fall eine E-Mail mit einem Link zum Wiederherstellungsmodus.
Lösung
- Den Link aus der E-Mail öffnen und die Karte unter „Plugins“ vorübergehend deaktivieren. Die Seite läuft dann wieder.
- Unter Werkzeuge → Website-Zustand → Bericht nachsehen, welche PHP-Version läuft. Ist sie älter als 7.2, beim Hoster eine neuere einstellen. Empfohlen ist PHP 8.1 oder neuer.
- Hilft das nicht, schick mir den Bericht. Wie, steht ganz unten.
Ich sehe den Menüpunkt „Plugins“ nicht
Ursache
Dein Konto hat keine Administrator-Rechte. Oder deine Webseite läuft bei WordPress.com in einem Tarif ohne eigene Plugins.
Lösung
Den Administrator deiner Webseite bitten, das Plugin zu installieren. Bei WordPress.com prüfen, ob dein Tarif Plugins zulässt. Bei einer eigenen WordPress-Installation, zum Beispiel bei All-Inkl, IONOS oder Strato, geht es immer.
Speichern im Editor klappt nicht
Ursache
Du bist zwischendurch abgemeldet worden oder ein Sicherheits-Plugin blockiert das Speichern.
Lösung
- Die Seite neu laden, neu anmelden und noch einmal speichern.
- Nutzt du ein Sicherheits-Plugin wie Wordfence, dort nachsehen, ob etwas blockiert wurde und es freigeben.
Dazu steht hier noch nichts. Schreib mir einfach, ich helfe dir weiter.
Klappt es trotzdem nicht?
Schreib mir. Damit ich dir schnell helfen kann, schick bitte gleich mit:
- die Kennung deiner Karte (steht in der Kauf-Mail),
- dein System und seine Version,
- die genaue Fehlermeldung oder ein Bildschirmfoto.