Skip to main content

Adding plugins to the system


There are multiple ways of adding plugins to your plentymarkets system. Using the Integrations assistant, you can set up your online store quick and easy. You can purchase plugins on plentyMarketplace, some for free, others for additional costs. If you need a custom plugin designed to satisfy your particular needs, you can add it via Git.

1. Integrations assistant

A new plentymarkets system does not come with any plugins pre-installed. If you want to run your own online store or set up a connection to the store systems Shopify or WooCommerce, you can use the Integrations assistant to select and install the most important plugins in one go.

The following plugins are available via the assistant:

  • Online stores

    • Ceres & IO
      → These plugins form the basis of your own plenty online store.

    • Shopify

    • WooCommerce

  • Payment methods

    • PayPal

    • Cash in advance

    • Cash on delivery

    • Invoice

    • EBICS

  • Shipping service providers

    • DHL (DE)

    • Hermes (DE)

    • DPD (DE)

    • DPD (UK)

If you select the plugins via the assistant, the installation process does not include any more steps and you can continue with configuring the plugins.

2. Marketplace plugins

You will add most plugins to your system via plentyMarketplace.plentyMarketplace offers a great selection of different plugins that you can purchase and use right away. To purchase a plugin on plentyMarketplace, proceed as follows:

Purchasing plugins:

  1. Go to Plugins » Plugin overview.

  2. Click on plentyMarketplace ().
    → plentyMarketplace opens in a new tab.
    Or: Log in directly on plentyMarketplace using your service centre credentials.

  3. Open a category and select the plugin you want to purchase.

  4. In the detail view of the plugin, click on Go to checkout. You can find an overview of all purchase options in [tabelle-kaufoptionen].
    → The Checkout window opens.

  5. Accept the terms and conditions.

  6. Click on Order now.
    → The purchased plugin is now available as an uninstalled plugin in the Plugins » Plugin overview menu. It might take a few minutes until purchases plugins become available.

Installing added plugins

After adding a plugin to the system, you have to install it in a plugin set before you can use it.

For more information on how to install plugins, see Installing added plugins in plugin sets.

Table 1. plentyMarketplace purchase types
Type Explanation

Free trial

Test the full plugin for free for 30 days. You can no longer test a plugin after subscribing to it at least once. You can check when your trial period expires in the My Account area.

Purchase

Buy the plugin once for a set price and use it forever. Developers may distinguish between different versions of the plugin, which may only offer limited functionality. Check the description to see which features are included in which version.

Subscription

Subscribing to a plugin allows you to use all of its features for a limited period of time. Depending on the plugin, you may be able to choose between different billing periods. Payment is always due at the beginning of a billing period. Subscriptions do not expire automatically, you have to cancel the contract in the My Account area if you want to discontinue it.

3. Git plugins

If you cannot find the plugin you need on plentyMarketplace, you can also add plugins from Git repositories. Some external developers also provide their plugins this way. For more information on available plugins, contact these developers directly. To contact a developer, either use the partner overview, write a message in the Suche/Biete forum category or create a new project request on plentyMarketplace.

3.1. Creating access tokens for private repositories

For private repositories, you need a personal access token in addition to the repository URL. How to create the token varies slightly from site to site. This page only describes how to generate a personal access token on GitHub and Bitbucket. If you use a different site, refer to the documentation of the provider for more information.

Creating a personal access token for private GitHub repositories:

  1. Go to your token settings on GitHub.

  2. Click on Generate new token.
    → To proceed, enter your password.

  3. Enter a Token description.

  4. Under Select scopes, activate repo:status.

  5. Click on Generate token.
    → GitHub will generate a new token. You will need this token in the next step, so either stay on the page or save the token locally. If you save it, you should delete it again after adding your repository to plentymarkets.

Creating a personal access token for private Bitbucket repositories:

  1. Open your account settings on Bitbucket.

  2. Under Access Management, open the App passwords menu.

  3. Click on Create app password.

  4. Enter a name for the password and check the box next to Webhooks.

  5. Click on Create.
    → Bitbucket will generate a new token. You will need this token in the next step, so either stay on the page or save the token locally. If you save it, you should delete it again after adding your repository to plentymarkets.

3.2. Adding Git repositories

This section describes how to add a Git repository to your system. By adding the repository to the system, you can use the plugin managed in the repository.

If you want to add a private repository, first generate an access token as described above. When adding a public repository, you don’t need an access token.

Adding Git repositories to the system:

  1. Go to Plugins » Git.

  2. Click on Add new repository ().
    → The repository settings are displayed.

  3. Enter the repository URL and user name, as well as the access token you generated earlier, into the respective fields.

    Public repositories

    When adding a public repository, you do not need to enter any real credentials as user name and token. But the fields cannot be empty either. Enter any character sequence, e.g. “guest”.

  4. Into the field Branch name for installation (must include valid plugin.json), enter the name of a branch that has a file called plugin.json. The file has to be formatted as described in the requirements.
    master is entered as branch name by default. Some developers may use different naming conventions for their branches. In these cases, you must update the branch name accordingly. You can switch between branches of your repository after installing the plugin.

  5. Save () the settings.
    → plentymarkets validates and establishes the connection to the Git repository.
    → Once a connection was established, the plugin is available as an uninstalled plugin in the Plugins » Plugin overview menu.

Installing added plugins

After adding a plugin to the system, you have to install it in a plugin set before you can use it.

For more information on how to install plugins, see Installing added plugins in plugin sets.

3.3. Functional overview

Table 2. Table view of the Plugins » Git menu
Setting Explanation

Add new repository

Opens a view for setting up a new repository.

Git repository name

Opens a view for changing the settings of the selected repository.

Delete

Removes the repository from the system. You cannot delete repositories if they are installed in any plugin sets.

Repository URL

HTTPS or HTTP URL of the Git repository.

Username

The user name is part of the user data of the hosting provider (e.g. GitHub) of your Git repository.
For public repositories, enter any value into the field, e.g. guest.

Token

The token is part of the user data of the provider (e.g. GitHub) for the Git repository. You can create new tokens in your provider’s settings.
For public repositories, enter any value into the field, e.g. guest.

Name of branch to be installed (must contain valid plugin.json file).

The Git repository has to contain a valid plugin.json file. This input is required for initial installation.


To top