Skip to main content

Adding plugins to the system

1. Purchasing marketplace plugins

The plentyMarketplace is our platform for distributing software extensions for plentymarkets developed by plentymarkets or external developers. This platform makes plugins easily accessible and ensures that you can benefit from the advantages the new technology offers. To purchase a plugin, proceed as follows.

Purchasing a plugin:

  1. Go to Plugins » Plugin overview.

  2. Click on plentyMarketplace ().
    → The market place will open 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. For an overview of all categories, see the Table 1 table.

  4. In the detail view of the plugin, click on Go to checkout. For an overview of all purchase options, see the Table 2 table.
    → 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.

Table 1. plentyMarketplace categories
Category Explanation

Channels » Marketplaces

Plugins that connect to other market places like Rakuten or idealo. For further information on how to set up market places developed by plentymarkets, see the manual category Markets.

Channels » Online stores

Connect your plentymarkets system to other shop systems like Shopify. Also includes templates, which form the foundation of your online store. For further information on templates developed by plentymarkets, see the manual category Online store.

Channels » Price comparisons

Add export formats to the Elastic Export. For an overview of all export formats, see here.

Storefront » Themes

Use themes to change the design of your online store.

Storefront » Widgets

Add new elements like social media buttons or contact information to your online store.

Payment

Use payment plugins, so that your customers can pay for your products in different ways. For further information on how to install and set up these plugins, see their descriptions on plentyMarketplace.

Integration

Add functionality to your system using external tools.

Services » Support
Services » Setup

External agencies offer various services tailored to your specific needs.

Services » Hardware

Purchase cash registers and other hardware for plentyPOS. For further information, see POS.

Table 2. 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.

2. Adding plugins via Git

If you cannot find the plugin you need on plentyMarketplace, you can also add plugins from Git repositories. External developers may provide their plugins this way. For further information on available plugins, contact these developers directly. You can find an overview of certified partners here, post in the search/offer category on the forums or create a new enquiry on plentyMarketplace.

Table 3. 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. 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 include a valid plugin JSON. This input is required for initial installation.

Table 4. Table view of the Plugins » Plugin overview » Plugin detail view » Git menu
Setting Explanation

Fetch

Downloads all commits on the selected branch. The list of commits is updated accordingly.

Pull

Downloads all commits on the selected branch and updates all files. The list of commits is updated accordingly.

Branch

Drop-down list to switch between branches of the repository. Displays the currently selected branch.

Commit ID

Text field for selecting specific commits.

Checkout

Switches branch to the commit specified in the Commit ID text field.

Name of the commit

You can switch to a commit by clicking on it. Requires confirmation.

Copy commit ID to clipboard.

Copies the ID of the commit to the clipboard, so that you can paste it into the Commit ID field.

View on GitHub

Opens a new tab to display the changes made in the commit.

2.1. Adding Git repositories to the system

For private repositories, you need a personal access token in addition to the repository URL. This page only describes how to generate a personal access token on GitHub. However, the process is similar on other sites like GitLab. Refer to the respective site’s documentation for details.

GitHub access token

Creating a personal access token for private GitHub repositories:

  1. Go to your token settings on GitHub.

  2. Click on Generate new token.
    → GitHub will ask you to confirm your password.

  3. Enter a Token description.

  4. Under Select scopes, activate repo:status.

  5. Click on Generate new 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.

Bitbucket access token

Creating a personal access token for private Bitbucket repositories:

  1. Open your Bitbucket account settings.

  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.

Now you have all the necessary information to add the repository to your system.

Public repositories

When adding a public repository, you do not need to enter any real credentials as user name and token. However, the respective text fields must not be empty, so enter arbitrary values, e.g. "guest".

Adding a Git repository 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.

  4. Enter the name of the branch you want to select by default into the Branch name for installation (Must contain valid plugin.json) field. 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.

Valid plugin JSON

Trying to build a plugin set with plugins that do not contain a valid plugin JSON results in an error. To prevent this, we verify that all plugins added via git contain a valid plugin JSON.

For further information on the plugin JSON, see our developers page. .

2.2. Switching between branches of a Git repository

When working with git repositories, it is normal to use multiple branches. This way, you can change files without affecting your primary code base and check new code again before really implementing it. plentymarkets also supports working with different branches of a repository.

Switching branches:

  1. Go to Plugins » Plugin overview.

  2. Click on the plugin set you want to edit.
    → The plugin overview for the selected set opens.

  3. Click on the Git plugin you want to edit.
    → The plugin detail view for the selected plugin opens.

  4. Go to Git.

  5. From the Branch drop-down list, select the branch you want to switch to.
    → A message confirms that you have successfully switched to the selected branch. These settings are saved automatically.

Branches are local settings. In other words, you can use the same plugin in multiple sets, but work with different branches. This is useful if you want to, for example, use a stable branch in your active plugin set and test a new feature in an inactive plugin set at the same time.

2.3. Switching to commits

If you want to work with a different version of your repository, but did not create a branch for that version, you can also switch to individual commits.

Switching to commits:

  1. Go to Plugins » Plugin overview.

  2. Click on the plugin set you want to edit.
    → The plugin overview for the selected set opens.

  3. Click on the Git plugin you want to edit.
    → The plugin detail view for the selected plugin opens.

  4. Go to Git.

  5. Copy the commit ID of the commit you want to switch to. The last 50 commits of the selected branch are displayed in the detail view. You can copy a commit ID by clicking on the Copy commit ID to clipboard. () button in the row of the commit. If you want to switch to an older commit, you can perform the same steps in the commit overview of your Git repository.

  6. Paste the copied ID into the Commit ID field.

  7. Click on the Checkout button.
    Or: If you want to switch to one of the last 50 commits, you can also click on the name of the commit and confirm the switch by clicking on the Ok button.
    → A message confirms that you have successfully switched to the provided commit and Head@Commit_ID is displayed as branch. These settings are saved automatically.

2.4. Removing Git repositories from the system

If you longer need a git plugin, you can completely remove it from the system. Note that you cannot remove plugins that are still installed in any plugin sets.

Deleting a Git repository:

  1. Go to Plugins » Git.

  2. Click on the Delete () button to remove the repository from your system.

To top