Die Installation von 4TFM xt:Commerce-Plugins unterscheidet sich nicht von der Installation der xt:Commerce-eigenen Plugins. Gehen Sie wie hier beschrieben vor und folgen Sie danach der Anleitung des jeweiligen Plugins.

Voraussetzungen

WasWofür
Plugin-Download (ZIP-Datei)Den Download-Link erhalten Sie nach der Bestellung per E-Mail (kostenfreie Plugins: xt:Commerce Marketplace)
LizenzdateiNur bei kostenpflichtigen Plugins, kommt mit derselben E-Mail (in der Regel innerhalb von 2 Stunden nach der Bestellung)
FTP-Zugang zum WebspaceZum Hochladen der Plugin-Dateien, z.B. mit FileZilla
Zugang zum AdministrationsbereichZum Installieren und Aktivieren des Plugins

Plugin und Lizenz hochladen

  1. Laden Sie das Plugin für die xt:Commerce-Version herunter, die Sie nutzen, und entpacken Sie die ZIP-Datei (z.B. mit der Windows-eigenen Funktion, 7-Zip oder WinRAR).
  2. Laden Sie den Plugin-Ordner mit einem FTP-Programm in den Ordner /plugins/ Ihres Shops. Der Ordner muss direkt dort liegen, z.B. /plugins/tfm_attributes/ mit dem Unterordner installer/ darin – nicht doppelt verschachtelt wie /plugins/tfm_attributes/tfm_attributes/.
  3. Laden Sie bei kostenpflichtigen Plugins die Lizenzdatei aus der E-Mail unverändert in den Ordner /lic/ Ihres Shops.
Unsere kostenfreien xt:Commerce-Plugins benötigen keine Lizenzdatei und können direkt im xt:Commerce Marketplace heruntergeladen werden.

Plugin installieren

Öffnen Sie den Administrationsbereich Ihres Shops und wechseln Sie zu „Plugins“ → „deinstallierte Plugins“ (bis xt:Commerce 4.2: „Inhalte“ → „Plugins“ → „deinstallierte Plugins“).
Wurde das Plugin korrekt hochgeladen, erscheint es in dieser Liste. Geben Sie „tfm“ oder den Namen des Plugins in das Suchfeld ein, um die Liste einzugrenzen – ohne Suche steht das Plugin eventuell erst auf einer späteren Seite (Blättern unten links). Klicken Sie in der Spalte „Aktionen“ auf das Plus-Symbol „Run“.
01_deinstallierte_plugins.png 46.6 KB
Bestätigen Sie die Abfrage „Plugin installieren?“ mit „Ja“.
02_bestaetigen.png 49.98 KB
Das Fenster „Plugin Installieren“ zeigt das Protokoll der Installation. Ab xt:Commerce 6.7 klicken Sie hier auf „Aktivieren & Einstellungen“: Das Plugin wird aktiviert und seine Einstellungen öffnen sich. Mit „Schliessen“ beenden Sie die Installation, ohne das Plugin zu aktivieren.
03_installiert.png 66.93 KB

Plugin aktivieren und einstellen

In den Einstellungen des Plugins prüfen bzw. setzen Sie:
OptionBeschreibung
Plugin StatusSchaltet das Plugin insgesamt ein (Häkchen gesetzt = aktiv)
Für Mandant aktivierenSteht im Abschnitt mit dem Namen Ihres Shops. Schaltet das Plugin für diesen Shop ein. Bei mehreren Shops (Mandanten) gibt es je Shop einen eigenen Abschnitt.
Weitere OptionenPlugin-spezifische Einstellungen, beschrieben in der Anleitung des jeweiligen Plugins
Speichern Sie die Einstellungen und laden Sie den Administrationsbereich anschließend mit der F5-Taste neu, damit neue Menüpunkte des Plugins erscheinen.
04_einstellungen.png 46.16 KB
Später erreichen Sie die Einstellungen unter „Plugins“ → „installierte Plugins“ (bis xt:Commerce 4.2: „Inhalte“ → „Plugins“ → „installierte Plugins“): Suchen Sie das Plugin und klicken Sie in der Spalte „Aktionen“ auf das Stift-Symbol „Bearbeiten“. In der Spalte „Plugin Status“ sehen Sie, ob ein Plugin aktiv (grüner Punkt) oder deaktiviert (rotes Symbol) ist. In xt:Commerce-Versionen vor 6.7 aktivieren Sie das Plugin auf diesem Weg.
05_installierte_plugins.png 75.83 KB
Prüfen Sie jetzt die Anleitung des jeweiligen Plugins. Einige Plugins benötigen weitere Schritte, z.B. einen Hook im Template oder das Leeren des Caches.

Plugin aktualisieren

  1. Laden Sie die neue Version des Plugins wie oben beschrieben per FTP in den Ordner /plugins/ und überschreiben Sie dabei die vorhandenen Dateien.
  2. Öffnen Sie „Plugins“ → „installierte Plugins“ und klicken Sie in der Zeile des Plugins auf das Symbol „Plugin update“ (zwei Pfeile im Kreis) – oder in den Einstellungen des Plugins auf die Schaltfläche „Plugin-Update“.
  3. Prüfen Sie danach, ob das Plugin noch aktiv ist, und lesen Sie das Changelog („Plugin Changelog“) auf neue Optionen.
Deinstallieren Sie ein Plugin für ein Update nicht: Bei der Deinstallation werden in der Regel seine Einstellungen und Daten gelöscht.

Hinweise

  • Das Plugin erscheint nicht unter „deinstallierte Plugins“? Prüfen Sie die Ordnerstruktur in /plugins/ (siehe oben), ob Sie die Version für Ihre xt:Commerce-Version hochgeladen haben und ob das Plugin vielleicht schon unter „installierte Plugins“ steht.
  • Bei Fehlermeldungen zur Lizenz prüfen Sie, ob die Lizenzdatei unverändert im Ordner /lic/ liegt.
  • Ändert sich nach der Aktivierung im Shop nichts, leeren Sie den Cache unter „System“ → „Cache entleeren“.
  • Bei Fragen zur Installation helfen wir gern: Frage stellen.