en de
Plugins Doku Plugin wünschen Live-Demo ↗ Anmelden feinwerk.io ↗ Connector holen
Anleitungen

Der Feinwerk-Connector

Der Connector ist ein kostenloses Matomo-Plugin mit dem technischen Namen FeinwerkMarketplaceConnector. Er verbindet Ihre Matomo-Instanz mit Feinwerk Plugins. Der offizielle Matomo-Marketplace bleibt dabei unverändert und funktioniert weiter wie gewohnt.

Vorteile

  • Installation mit einem Klick: Alle Plugins finden Sie in Matomo unter Administration → Plugins → Feinwerk Plugins, mit Suche, Kategorien, Preisen und Screenshots.
  • Updates mit einem Klick, auf Wunsch automatisch: Für jedes Plugin können Sie festlegen, dass Updates selbstständig eingespielt werden.
  • Update-Hinweise: Der Connector prüft täglich auf neue Versionen. Zusätzlich bekommen Sie einmal pro Woche eine E-Mail mit allen verfügbaren Updates Ihrer Instanzen.
  • Nur passende Versionen: Angeboten werden nur Versionen, die zu Ihrer Matomo- und PHP-Version passen.
  • Geprüfte Downloads: Jede Datei wird vor der Installation per SHA-256-Prüfsumme kontrolliert.
  • Infos direkt in Matomo: Lizenzstatus und Laufzeit, Funktionen, Pläne und die Versionshistorie jedes Plugins.
  • Warnung vor Datenbankänderungen: Versionen, die Tabellen ändern, sind markiert. So können Sie große Instanzen in einem Wartungsfenster aktualisieren.
  • Support aus Matomo heraus: Mit Problem melden schicken Sie uns einen Fehlerbericht mit bis zu drei Screenshots.
  • Ausfallsicher: Ist der Store nicht erreichbar, zeigt der Connector die zuletzt geladenen Daten. Installierte Plugins laufen in jedem Fall weiter.
  • Lizenzprüfung: Kostenpflichtige Funktionen prüfen ihre Lizenz über den Connector.

Installation

Laden Sie zuerst den Connector herunter: plugins.feinwerk.io/connector/download. Die ZIP-Datei enthält den Ordner FeinwerkMarketplaceConnector. Danach gibt es vier Wege.

Weg A: Upload in Matomo

Matomo erlaubt das Hochladen von Plugins nur, wenn es in der Konfiguration freigeschaltet ist. Tragen Sie dazu in config/config.ini.php ein:

[General]
enable_plugin_upload = 1

Öffnen Sie dann den Matomo-Marketplace unter Administration → Plattform → Marketplace, laden Sie die ZIP-Datei über Plugin hochladen hoch und aktivieren Sie das Plugin.

Weg B: Per SFTP oder SSH

Entpacken Sie die ZIP-Datei in das Verzeichnis plugins/ Ihrer Matomo-Installation, sodass der Ordner plugins/FeinwerkMarketplaceConnector entsteht. Aktivieren Sie den Connector anschließend unter Administration → Plugins → Plugins verwalten.

Weg C: Kommandozeile

cd /pfad/zu/matomo/plugins
wget -O connector.zip https://plugins.feinwerk.io/connector/download
unzip connector.zip && rm connector.zip
chown -R www-data:www-data FeinwerkMarketplaceConnector
cd .. && ./console plugin:activate FeinwerkMarketplaceConnector

Ersetzen Sie www-data durch den Benutzer, unter dem Ihr Webserver läuft.

Weg D: Docker

Binden Sie den Ordner FeinwerkMarketplaceConnector als Volume nach /var/www/html/plugins/FeinwerkMarketplaceConnector ein oder kopieren Sie ihn in Ihr eigenes Image. Aktivieren Sie ihn danach im Container:

docker exec -it <container> ./console plugin:activate FeinwerkMarketplaceConnector

Damit der Connector weitere Plugins mit einem Klick installieren kann, muss das Verzeichnis plugins/ im Container beschreibbar sein. Bei schreibgeschützten Images installieren Sie Plugins wie unter Plugins installieren beschrieben.

Einrichtung

  1. Legen Sie im Kundenkonto unter Meine Instanzen Ihre Matomo-Instanz an und kopieren Sie den Token. Sie finden ihn später jederzeit über Token anzeigen.
  2. Öffnen Sie in Matomo Administration → System → Allgemeine Einstellungen und suchen Sie den Abschnitt FeinwerkMarketplaceConnector.
  3. Tragen Sie bei Marketplace URL die Adresse https://plugins.feinwerk.io ein und bei Instance token Ihren Token. Speichern Sie die Einstellungen.
  4. Öffnen Sie Administration → Plugins → Feinwerk Plugins. Sobald die Plugin-Liste erscheint, ist die Verbindung hergestellt.

Automatische Updates

Im selben Einstellungsabschnitt wählen Sie unter Auto-apply updates for these plugins aus einer Liste die Plugins aus, deren Updates der Connector bei der täglichen Prüfung selbstständig installiert. Alle anderen Plugins aktualisieren Sie mit einem Klick unter Feinwerk Plugins.

Ein Update, das die Datenbank ändert, installiert der Connector nie automatisch, auch nicht bei Plugins aus dieser Liste. Er hält es zurück und zeigt einen Hinweis auf den Plugin-Seiten, im Reiter Verwaltung trägt das Plugin das Kennzeichen Datenbank-Update. Sie installieren es dann selbst unter Feinwerk Plugins, und Matomo führt das Datenbank-Update kontrolliert aus. Größere Datenbank-Änderungen kündigt die Produktseite des Plugins zusätzlich mit einem Hinweis an.

Plugins, die als Git-Checkout oder per Symlink installiert sind (Entwicklungsumgebungen), verändert der Connector nie, weder per Klick noch automatisch. Sie tragen das Kennzeichen Entwicklungs-Checkout.

Connector aktualisieren

Ist eine neue Connector-Version verfügbar, zeigt Feinwerk Plugins einen Hinweis mit einem Knopf zum Aktualisieren. Der Connector aktualisiert sich nie von selbst, nur auf diesen Klick. Einstellungen und Token bleiben erhalten. Alternativ ersetzen Sie wie bei der Installation den Ordner FeinwerkMarketplaceConnector durch den aus dem neuen ZIP.

Connector entfernen

Deaktivieren und deinstallieren Sie den Connector unter Administration → Plugins → Plugins verwalten. Bereits installierte Plugins laufen weiter, Updates spielen Sie dann manuell ein. Den Token können Sie im Kundenkonto widerrufen.