Plugins dem System hinzufügen

Du hast verschiedene Möglichkeiten, um Plugins zu deinem PlentyONE System hinzuzufügen. Mit dem Integrationen-Assistenten setzt du schnell und unkompliziert deinen Webshop auf. Über plentyMarketplace kannst Plugins sowohl kostenlos als auch kostenpflichtig erwerben. Benötigst du ein Plugin, das speziell auf deine Anforderungen zugeschnitten ist, steht dir das Hinzufügen über Git zu Verfügung.

1. Integrationen-Assistent

In einem neuen PlentyONE System sind zunächst keine Plugins vorhanden. Wenn du deinen eigenen Webshop betreiben oder Verbindungen zu den Shopsystemen Shopify oder WooCommerce einrichten möchtest, kannst du den Integrationen-Assistenten durchlaufen, um die wichtigsten Plugins gebündelt auszuwählen und zu installieren.

Folgende Plugins sind über den Assistenten verfügbar:

  • Webshops

    • plentyShop (Plugins: plentyShop LTS & IO)

    • Shopify

    • WooCommerce

  • Zahlungsarten

    • PayPal

    • Mollie

    • Klarna

    • PAYONE

    • Vorkasse

    • Nachnahme

    • Kauf auf Rechnung

    • EBICS

  • Versanddienstleister

    • DHL (DE)

    • DHL Wunschpaket (DE)

    • DHL Retoure Online

    • Hermes (DE)

    • DPD (DE)

    • DPD (UK)

Wenn du die Plugins über den Assistenten auswählst, sind keine weiteren Schritte für das Installieren erforderlich und du kannst direkt mit dem Konfigurieren der Plugins weitermachen.

2. Marketplace-Plugins

Die meisten Plugins werden dem System über plentyMarketplace hinzugefügt. plentyMarketplace bietet dir eine reiche Auswahl unterschiedlicher Plugins, die du direkt kaufen und nutzen kannst. Gehe wie folgt vor, um ein Plugin auf plentyMarketplace zu kaufen.

Plugin kaufen:

  1. Öffne das Menü Plugins » plentyMarketplace.
    → Der Marktplatz wird in einem neuen Tab geöffnet.
    → Oder: Melde dich direkt auf plentyMarketplace mit deinen Zugangsdaten aus dem Mein Konto-Bereich an.

  2. Wähle ein Plugin aus einer Kategorie.

  3. Klicke in der Detailansicht des Plugins auf Plugin kaufen. Eine Übersicht aller Kaufoptionen findest du in Tabelle 1.
    → Das Fenster Kasse wird geöffnet.

  4. Nimm die Nutzungsbedingungen zur Kenntnis.

  5. Klicke auf Jetzt kaufen.
    → Nach einigen Minuten kannst du das Plugin in einem Plugin-Set installieren.

Hinzugefügte Plugins installieren

Wenn du ein Plugin deinem System hinzugefügt hast, musst du es noch in einem Plugin-Set installieren bevor du es nutzen kannst.

Wie du Plugins installieren kannst erfährst du auf der Seite Hinzugefügte Plugins in Plugin-Sets installieren.
Tabelle 1. plentyMarketplace-Kaufoptionen
Option Erläuterung

Testen

Plugin kann in vollem Umfang 30 Tage lang umsonst genutzt werden. Nicht mehr möglich, nachdem das Plugin bereits abonniert wurde. Ablaufdatum kann im Mein Konto-Bereich eingesehen werden.

Kaufen

Einmalkauf. Plugins werden teilweise in verschiedenen Umfängen angeboten. Welche Funktionalitäten in welchem Umfang enthalten sind, kann der Artikelbeschreibung entnommen werden.

Abonnement

Plugins können abonniert werden, um sie in vollem Umfang für einen begrenzten Zeitraum zu nutzen. Je nach Plugin stehen unterschiedliche Zahlungszeiträume zu Verfügung. Abgerechnet wird immer am Anfang eines Zahlungszeitraums. Abonnements laufen nicht automatisch aus, sondern müssen im Mein Konto-Bereich gekündigt werden.

3. Git-Plugins

Wenn du PlentyONE erweitern möchtest, aber kein Plugin mit der entsprechenden Funktionalität auf plentyMarketplace findest, kannst du deinem System Plugins über Git hinzuzufügen. Manche externen Entwickler:innen bieten Plugins auf diesem Weg an. Wenn du weitere Informationen zu Git-Plugins erhalten möchtest, nimm direkt mit diesen Entwickler:innen Kontakt auf. Nutze dafür entweder die Partnerübersicht, schreibe eine Nachricht im Community-Bereich im Service Desk oder erstelle eine neue Projektanfrage auf plentyMarketplace.

Keine Prüfung durch PlentyONE

Wenn ein Plugin auf plentyMarketplace hochgeladen wird, wird es durch Mitarbeiter:innen von PlentyONE geprüft. Bei Plugins, die nicht über plentyMarketplace vertrieben werden, findet keine Prüfung statt. Das heißt, dass PlentyONE die Funktionalität des Plugins in diesen Fällen nicht sicherstellen kann.

Möchtest du ein Plugin von einem Drittanbieter aus einer anderen Quelle als plentyMarketplace in deinem System einbinden, empfehlen wir dir, dich datenschutzrechtlich abzusichern und den Funktionsumfang des Plugins nach dem Einbinden gründlich zu prüfen.

3.1. Zugriffstoken für private Repositorys erzeugen

Fügst du deinem System ein privates Repository hinzu, wird zusätzlich zur URL des Repositorys ein persönlicher Zugriffstoken benötigt. Dabei unterscheidet sich der Vorgang zum Erzeugen des Tokens leicht von Seite zu Seite.

Unterstützte Anbieter

Aktuell werden folgende Anbieter unterstützt: GitHub, Bitbucket, GitLab.

Wenn du ein Plugin über einen anderen Anbieter hinzufügst, leisten wir bei Fehlverhalten keinen Support.

  • GitHub

  • Bitbucket

  • GitLab

Einen persönlichen Zugriffstoken für private Repositorys auf GitHub erzeugen:

  1. Öffne die Tokeneinstellungen auf GitHub.

  2. Klicke auf Generate new token.
    → Gib dein Passwort ein, um fortzufahren.

  3. Gib in das Feld Token description eine Beschreibung ein.

  4. Aktiviere im Menü Select scopes das Kontrollkästchen repo.

  5. Klicke auf Generate token.
    → Es wird ein neuer Token erzeugt. Dieser wird im nächsten Schritt benötigt, lass die Seite also geöffnet oder speicher den Token lokal. Wenn du den Token lokal speicherst, solltest du ihn nach dem Hinzufügen des Repositorys zu PlentyONE wieder löschen.

Einen persönlichen Zugriffstoken für private Repositorys auf Bitbucket erzeugen:

  1. Öffne deine Kontoeinstellungen auf Bitbucket.

  2. Öffne im Bereich Zugriffsverwaltung das Menü App-Passwörter.

  3. Klicke auf App-Passwort erstellen.

  4. Gib einen Namen für das Passwort ein und aktiviere das Kontrollkästchen in den folgenden Bereichen:

    • Repositories: Read

    • Webhooks: Read and write

  5. Klicke auf Erstellen.
    → Es wird ein neuer Token erzeugt. Dieser wird im nächsten Schritt benötigt, lass die Seite also geöffnet oder speichere den Token lokal. Wenn du den Token lokal speicherst, solltest du ihn nach dem Hinzufügen des Repositorys zu PlentyONE wieder löschen.

Einen persönlichen Zugriffstoken für private Repositorys auf GitLab erzeugen:

  1. Klicke auf deinen Avatar in GitLab.

  2. Bearbeite dein Profil.

  3. Klicke auf Access Tokens in der linken Navigationsleiste.

  4. Gib dem Token einen Namen.
    Optional: Gib ein Ablaufdatum ein.

  5. Aktiviere das Kontrollkästchen in folgendem Bereich:

    • read_repository

  6. Erstelle Deinen Personal Access Token.
    → Es wird ein neuer Token erzeugt. Der Token wird im nächsten Schritt benötigt, lass die Seite also geöffnet oder speichere den Token lokal. Wenn du den Token lokal speicherst, solltest du ihn nach dem Hinzufügen des Repositorys zu PlentyONE wieder löschen.

3.2. Git-Repository hinzufügen

Im Folgenden wird beschrieben, wie du ein Git-Repository zu deinem System hinzufügst. Dadurch nutzt du das im Repository verwaltete Plugin.

Wenn du ein privates Repository hinzufügen möchtest, generiere zunächst einen Zugriffstoken wie zuvor beschrieben. Bei öffentlichen Repositorys benötigst du keinen Zugriffstoken.

Git-Repository dem System hinzufügen:

  1. Öffne das Menü Plugins » Git.

  2. Klicke auf Neues Repository hinzufügen ().
    → Die Repository-Einstellungen werden angezeigt.

  3. Gib in die entsprechenden Felder den Kontonamen deines Git-Kontos, den zuvor erzeugten Zugriffstoken sowie die URL des Repositorys in die dafür vorgesehenen Felder ein.
    Hinweis: Achte bei der URL darauf, die HTTPS-Adresse ohne die Endung .git zu verwenden.

    Öffentliche Repositorys

    Bei öffentlichen Repositorys müssen keine tatsächlichen Zugangsdaten als Benutzername und Token eingegeben werden. Die beiden Felder dürfen aber auch nicht leer sein. Gib also jeweils eine beliebige Zeichenfolge ein, beispielsweise „Gast“.

  4. Gib in das Feld Name des zu installierenden Branch (Muss gültige plugin.json enthalten) den Namen eines Branches, auf dem es eine Datei namens plugin.json. Diese Datei muss so formatiert sein, wie in den Anforderungen beschrieben.
    Standardmäßig ist der master-Branch angegeben. Je nach Benennungskonvention der Entwickler:in kann es jedoch zu Abweichungen kommen. In diesen Fällen muss die Angabe entsprechend angepasst werden. Du kannst nach der Installation zwischen den Branches des Repositorys wechseln.

  5. Speichere () die Einstellungen.
    → Die Verbindung zum Git-Repository wird geprüft und hergestellt.
    → Konnte die Verbindung hergestellt werden, kannst du das Plugin in einem Plugin-Set installieren.

Hinzugefügte Plugins installieren

Wenn du ein Plugin deinem System hinzugefügt hast, musst du es noch in einem Plugin-Set installieren bevor du es nutzen kannst.

Wie du Plugins installieren kannst erfährst du auf der Seite Hinzugefügte Plugins in Plugin-Sets installieren.

3.3. Menü-Übersicht

Tabelle 2. Tabellenansicht des Menüs Plugins » Git
Einstellung Erläuterung

Neues Repository hinzufügen

Öffnet eine Ansicht, in der Einstellungen für ein neues Repository vorgenommen werden können.

Plugin-Name

Name des installierten Plugins.

Plugin-Sets

Alle Plugin-Sets, in denen das Plugin installiert ist.

Quelle

Quelle des Plugins.

Erstellt am

Datum, an dem das Plugin hinzugefügt wurde.

Hinzugefügt von

Benutzer:innen-Konto, welches das Plugin hinzugefügt hat.

Webhook-Token

Token für die Authentifizierung von Webhook Calls.

Aktion

Aktionen, die für jedes Plugin ausgeführt werden können.
Repository bearbeiten (edit): Kontoname, Zugriffstoken, Repository und Branchname können bearbeitet werden.
Repository löschen (delete): Entfernt das Repository aus dem System. Nicht auswählbar, wenn das Plugin noch in mindestens einem Plugin-Set installiert ist.