Updating installed plugins

Occasionally, plugin developers may provide a new version of their plugin. If you’ve already installed such a plugin in a plugin set, you have to update it to use the new version. Since this means changing your plugin set, you should create a copy of your plugin set before updating the plugin.

Backup

If you want to edit your plugin set, create a backup copy first. This way, you can easily discard changes.

To create a copy of a plugin set, open the Plugins » Plugin set overview menu. Then, click in the Actions column on the Copy plugin set button ().

Creating new plugin sets:

Go to Plugins » Plugin set overview.
Click on Create new plugin set ().
→ The New plugin set window opens.
Enter a name for the plugin set.
Click Create. → The plugin set is created and appears in the list of plugin sets.

Depending on whether you purchased the plugin from plentyMarketplace or added it to your system via Git, the possibilities you have for updating are different.

1. Marketplace plugins

If there is an update for a plugin, under Action, the Update button of the plugin is highlighted.

Updating marketplace plugins:

To update a plugin, click on the Update available button ().
→ The Update menu opens.
Select the version you want to install from the Select version drop-down list. The newest version is selected by default.
To update the plugin, click on Update.
→ The plugin is installed in the new version. → After installation has finished, the plugin set opens.
Save () the plugin set.
→ If there’s a problem with saving the plugin set, click on View details to receive further information.

Marketplace plugins cannot be downgraded to an older version. If you want to use an older version of the plugin, you have to delete and then reinstall it.

2. Git plugins

You can update a Git plugin in different ways. To use a newer version of the current branch, you can pull the branch. But, you can also use a different branch by changing branches or use an older version of the plugin by checking out any commit.

2.1. Pulling branches

If your Git repository contains a newer state of the plugin and you want to use it in plentymarkets, you can pull the branch.

To pull a Git plugin, open the Plugins » Plugin set overview menu. Open () the plugin set you want to edit, then click in the Actions column on the Pull button ().

Alternatively, you can pull Git plugins in the Git detail view. Here, you can also view the latest 50 commits of the selected branch.

Pulling Git plugins

Pulling Git plugins:

Go to Plugins » Plugin set overview.
Open () the plugin set you want to edit.
→ The plugin set opens.
Open the settings () of the Git plugin you want to edit.
→ The plugin detail view for the selected plugin opens.
Click on Git.
Click on Pull ().

2.2. Switching branches

You can switch between branches of a Git repository. 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.

Switching branches:

Go to Plugins » Plugin set overview.
Open () the plugin set you want to edit.
→ The plugin set opens.
Open the settings () of the Git plugin you want to edit.
→ The plugin detail view for the selected plugin opens.
Click on Git.
Click on Pull ().
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.

2.3. Switching commits

If you want to use a different state of your repository, but didn’t create a branch for it, you can also access individual commits.

Switching commits:

Go to Plugins » Plugin set overview.
Open () the plugin set you want to edit.
→ The plugin set opens.
Open the settings () of the Git plugin you want to edit.
→ The plugin detail view for the selected plugin opens.
Click on Git.
Click on Pull ().
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 Copy commit ID to clipboard. () 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.
Paste the copied ID into the Commit ID field.
Click on Checkout.
→ *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 Ok.
→ 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.