Zum Inhalt springen
MapManufaktur

Deine Karte in TYPO3 einbauen

Erweiterung hochladen, aktivieren, Inhaltselement „MapManufaktur-Karte“ einfügen. Die Bilder stammen aus einem echten TYPO3 13.4. Für TYPO3 14 steht dabei, wo es anders heißt.

⏱ ca. 10 Minuten✓ TYPO3 13.4 LTS und 14 LTS✓ mit Erweiterungsverwaltung oder Composer
1
ZIP herunterladennicht entpacken, nicht umbenennen
2
HochladenErweiterungen → Erweiterung hochladen
3
Aktivierenfalls TYPO3 es nicht selbst tut
4
InhaltselementSpezielle Elemente → MapManufaktur-Karte
5
FertigKarte steht auf deiner Seite

Bevor du anfängst

Diese Punkte kurz prüfen.

Administrator

Erweiterungen hochladen dürfen nur Administratoren. TYPO3 fragt dabei eventuell noch einmal nach deinem Passwort.

Dateiname nicht ändern

Die Datei heißt mapmanufaktur_…zip. TYPO3 liest den Namen der Erweiterung aus dem Dateinamen. Umbenannt klappt der Upload nicht.

TYPO3 13 oder 14

Die Erweiterung läuft mit TYPO3 13.4 LTS und 14 LTS. Deine Version steht oben links im Backend unter dem Seitennamen.

TYPO3 mit Composer? Wurde dein TYPO3 mit Composer eingerichtet, gibt es keinen Knopf zum Hochladen. Dann geht es wie unter Mit Composer beschrieben. Frag im Zweifel den, der dein TYPO3 eingerichtet hat.

Schritt für Schritt

Alle Bilder stammen aus einem echten TYPO3 13.4.

Erweiterungsverwaltung öffnen

Im Backend links die Erweiterungsverwaltung öffnen:

  • TYPO3 13: Admin-Werkzeuge → Erweiterungen
  • TYPO3 14: System → Erweiterungen

Oben links steht dann der Knopf Erweiterung hochladen.

Oben links: Erweiterung hochladen.

ZIP-Datei hochladen

  1. Auf Erweiterung hochladen klicken.
  2. Die ZIP-Datei auswählen.
  3. Ist die Erweiterung schon da, weil du schon eine Karte hast, den Haken bei Überschreiben setzen.
  4. Auf Hochladen! klicken.
Datei wählen, bei einer zweiten Karte „Überschreiben“ ankreuzen, dann „Hochladen!“.

Aktivieren

Meistens aktiviert TYPO3 die Erweiterung gleich selbst. Dann meldet es „Erweiterung hochladen: mapmanufaktur hochgeladen“ und die Zeile MapManufaktur-Karten steht in der Liste.

Ist sie noch grau, klickst du in ihrer Zeile ganz links auf das Symbol zum Aktivieren.

Meldung „Extension mapmanufaktur is not available“? Das passiert in einem TYPO3, in dem noch keine eigene Erweiterung liegt. Die Lösung steht unten unter Falls es hakt. Sie dauert zwei Minuten.
Aktiv: MapManufaktur-Karten steht in der Liste, links im Menü ist das Modul dazugekommen.

Inhaltselement einfügen

  1. Links Seite öffnen und im Seitenbaum die Seite wählen, auf der die Karte stehen soll.
  2. An der gewünschten Stelle auf Neuen Inhalt erstellen klicken.
  3. Im Fenster links den Reiter Spezielle Elemente wählen.
  4. Auf MapManufaktur-Karte klicken.
Im Seitenmodul: Neuen Inhalt erstellen.
Reiter „Spezielle Elemente“, dann „MapManufaktur-Karte“.

Karte wählen und speichern

  1. Unter Karte deine Karte auswählen.
  2. Eine maximale Breite brauchst du nur, wenn die Karte schmaler sein soll als die Spalte, zum Beispiel 800px.
  3. Oben auf Speichern klicken und die Seite ansehen.
Bist du im Backend angemeldet, siehst du auf der Webseite an der Karte den Stift „Karte bearbeiten“. Er führt direkt zu deiner Karte im Backend.
Im Feld „Karte“ die Karte wählen.
Fertig: Die Karte steht auf der Seite.

Karte später ändern

Farben, Texte, Tooltips, Links, Marker und Daten änderst du direkt in TYPO3.

  1. Links das Modul MapManufaktur-Karten öffnen. In TYPO3 13 steht es unter „Web“, in TYPO3 14 unter „Inhalt“.
  2. Bei deiner Karte auf Bearbeiten klicken.
  3. Ändern und oben rechts auf Speichern klicken.

Unter Weitere Karte hinzufügen lädst du hier auch weitere Karten hoch.

Das Modul MapManufaktur-Karten mit deinen Karten.
Der MapManufaktur-Editor im TYPO3-Backend.
Neue Regionen oder mehr Marker? Die änderst du im MapManufaktur-Editor auf meiner Webseite. Danach lädst du die neue ZIP-Datei wie in Schritt 2 hoch, mit Haken bei „Überschreiben“ oder im Modul unter „Weitere Karte hinzufügen“. Deine Änderungen bleiben erhalten.

Für Redakteure ohne Adminrechte

Sollen auch Redakteure die Karte einfügen und ändern, brauchen sie zwei Rechte in ihrer Benutzergruppe (Benutzer → Benutzergruppe bearbeiten):

  • unter „Module“ das Modul MapManufaktur-Karten,
  • unter „Explizit erlauben/verbieten“ den Inhaltstyp MapManufaktur-Karte.

TYPO3 mit Composer

Nur nötig, wenn dein TYPO3 mit Composer eingerichtet ist. Das erledigt meist dein Webentwickler.

  1. Den Inhalt der ZIP-Datei nach packages/mapmanufaktur in deinem Projektordner entpacken.
  2. Im Projektordner ausführen:
composer config repositories.lokal path 'packages/*'
composer require mapmanufaktur/karten:@dev
vendor/bin/typo3 extension:setup

Neue Version: den Ordner packages/mapmanufaktur ersetzen und composer update mapmanufaktur/karten ausführen.

Erweiterung entfernen

In der Erweiterungsverwaltung erst deaktivieren, dann löschen. Die Karten und deine Anpassungen liegen in fileadmin/mapmanufaktur/ und bleiben erhalten. Brauchst du sie nicht mehr, löschst du den Ordner in der Dateiliste. Die beiden Felder in der Datenbank entfernt Wartung → Datenbank analysieren.

Falls es hakt

Die häufigsten Meldungen und was du dagegen tun kannst. Gib oben im Suchfeld einfach ein Wort aus deiner Fehlermeldung ein.

Fehler beim ersten Hochladen„Extension mapmanufaktur is not available“

Ursache

Das passiert in einem TYPO3, in dem noch keine eigene Erweiterung liegt. TYPO3 versucht, die Erweiterung sofort zu aktivieren, findet sie aber in diesem Moment noch nicht. Ich habe es in einem frischen TYPO3 13.4 nachgestellt: Es liegt an TYPO3, nicht an deiner Karte.

Lösung

  1. Links Einstellungen öffnen (TYPO3 13: Admin-Werkzeuge → Einstellungen) und Erweiterungen konfigurieren wählen.
  2. Bei extensionmanager den Haken bei der automatischen Installation entfernen und speichern.
  3. Die ZIP-Datei noch einmal hochladen, mit Haken bei „Überschreiben“.
  4. In der Liste bei MapManufaktur-Karten auf Aktivieren klicken.
  5. Den Haken bei der automatischen Installation wieder setzen.
So sieht die Meldung aus.
Der Upload wird abgelehnt

Ursache

Meist wurde die Datei umbenannt (zum Beispiel mapmanufaktur_….zip (1) vom Browser) oder sie ist größer als die Upload-Grenze deines Webspace.

Lösung

  1. Die Datei so umbenennen, dass sie mapmanufaktur_ plus Versionsnummer plus .zip heißt, also ohne „(1)“ oder Leerzeichen.
  2. Bei einer Größenmeldung den Hoster bitten, upload_max_filesize und post_max_size zu erhöhen.
„MapManufaktur-Karte“ fehlt unter Spezielle Elemente

Ursache

Die Erweiterung ist nicht aktiv oder deine Benutzergruppe darf den Inhaltstyp nicht verwenden.

Lösung

  1. In der Erweiterungsverwaltung prüfen, ob MapManufaktur-Karten aktiv ist.
  2. Als Redakteur: die Rechte wie unter Redakteure beschrieben freischalten lassen.
Die Karte erscheint nicht auf der Seite

Ursache

Meist ist die Seite noch im Cache oder das Inhaltselement ist versteckt beziehungsweise steht in einer Spalte, die dein Layout nicht ausgibt.

Lösung

  1. Oben im Backend auf den Blitz klicken und Frontend-Caches leeren.
  2. Im Seitenmodul prüfen, ob das Element sichtbar ist und in der richtigen Spalte steht.
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

  1. In TYPO3 oben auf den Blitz klicken und alle Caches leeren.
  2. Die Seite mit Strg + F5 neu laden (Mac: Cmd + Shift + R).
  3. Fasst ein Plugin oder dein Hoster JavaScript zusammen oder lädt es verzögert? Dann die Dateien von MapManufaktur dort als Ausnahme eintragen.

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.
Zum Kontaktformular