Skip to content

Plugins on Piwigo: Presentation

If you are already using Piwigo, and you have already gone through this documentation, you surely understand that plugins are a major part of Piwigo.

However, we thought it would be useful to go over the subject again in this article.

What is a plugin for Piwigo ?

A plugin is an extension that adds or changes Piwigo's base features.

When installing Piwigo for the first time, you have access to Piwigo’s core system, the technical and functional foundation on which the whole software stands:

  • Piwigo’s administration
  • The gallery with the default Modus theme

By default, some plugins are already installed on your Piwigo, depending on whether it is a self hosted gallery or a Piwigo cloud account.

  • Self-hosted galleries

    If you install the last version of Piwigo on your environment, the following plugins will be installed by default, but not activated:

    • Admin Tools (allows admins to perform some administration actions from the gallery)
    • Language Switch (allows to change the gallery’s language easily)
    • LocalFiles Editor (allows to edit local configuration files from the administration)
    • Take A Tour of Your Piwigo (adds an interactive guided tour of Piwigo’s administration for new users)
    • Galleries hosted on Piwigo cloud

    If you create an account on Piwigo cloud, the following plugins will be activated by default:

    • Stop Spammer (a plugin to avoid spam, not to be deactivated)
    • VideoJS (the video management plugin, activated by default for Piwigo cloud customers since March 2023).

But you shouldn't stop with the pre-installed plugins.

Piwigo is a modular tool to which you can choose whether or not to add features: this is what plugins are for.

If you know WordPress, this is the exact same principle. By the way, you will notice that very few websites created using WordPress work without any plugins. Similarly, it would really be a shame to use Piwigo without enhancing it with the plugins that correspond to your needs.

Plugin management: difference between Piwigo cloud customers and self-hosting

The way plugins work is different whether you have an account on Piwigo cloud or are using a self-hosted Piwigo gallery.

You are a Piwigo cloud customer

If you are a customer for a hosting plan on Piwigo cloud, you don't need to install or update plugins.

You have access to a limited list of plugins, depending on the subscription plan you chose. They are already installed on your Piwigo gallery, and you can activate or deactivate them as you wish.

Plugin list

To find your plugins, go to the administration of your Piwigo gallery, in the Plugins menu.

The List tab lets you view the plugins that are already activated in your Piwigo gallery, and search among all the plugins.

Liste des plugins.jpg

To activate a new plugin, simply click on the activation button: the plugin is activated instantly. You then have access to its configuration.

Plugins by pricing plan

The second tab lists the plugins available for each pricing plan. You can only activated plugins that are within your plan.

Plugins par prix.jpg

On this page, the plugins are sorted by plan; the icons on the right let you know which plans a plugin is available on at all times.

If you are searching for a specific plugin, combine the Ctrl+F keys on your keyboard to search for the plugin's name or a specific feature in the page.

Example: for the User Custom Fields plugin, the first icon is shaded, since it is only accessible from the Team plan.

image.png

If you are using a Piwigo gallery that is installed on your own hosting platform, and not on Piwigo cloud, things are a little bit different.

In order to use a new plugin, you first need to install it on your server, then activate it.

List of plugins installed

To find the plugins installed on your Piwigo gallery, go to Piwigo's administration, in the Plugins menu.

The List tab lets you view the plugins that are already activated in your Piwigo gallery, and search among the plugins that are installed but deactivated.

Plugins auto hébergement.jpg

Updating the plugins

Unlike Piwigo cloud customers, you need to update your plugins yourself when a new version is available. The Search for updates tab is available to you for this purpose, allowing you to see if updates are available and install them.

Plugins mise à jour.jpg

If an update is available for a plugin, you can install it right away by clicking on "Install". You can also download the plugin file, or choose to ignore the update.

Installing a plugin

If you want to install a plugin, you need to go to the third "Add a plugin" tab.

This page lets you browse all of the plugins published on piwigo.org, which you can also find on the website's Extensions page.

You can search for a plugin by keyword or filter the plugins (by date, author, tag, rating...).

Ajouter un plugin.jpg

In this list are some plugins that aren't available on Piwigo cloud. These are community-made plugins, which the Piwigo developer team hasn't always tested or approved: therefore, we can't guarantee that they work correctly, nor that they are compatible!

Info :

The plugins we are showcasing in the current documentation are the ones available on Piwigo Cloud, which our team has tested and approved. However, of course, this does not mean that the other plugins available aren't interesting.

To install a new plugin, click on Add.

Bouton ajouter plugin.jpg

You can activate a plugin right after installing it by clicking on the "Activate now" link in the banner.

Activation plugin special.jpg

If you don't, the plugin is now available in the List tab, in the "Deactivated" category. Simply click on the activation button in order to activate it.

Plugins désactivés.jpg

Plugin configuration

Most of the time, plugins have their own configuration page. You have access to them from the list of plugins activated in your Piwigo gallery, by clicking on the Configuration button when it is orange-colored.

Exemple plugin activé.jpg

Sometimes, this configuration page only contains a few settings, and you will very rarely need to visit it..

But in some cases, the plugin's configuration gives access to a whole set of important features brought by this plugin. Visiting the configuration page is therefore crucial. Besides, within this documentation, we show a preview of the settings page each time we introduce a plugin.

On the other hand, some plugins don't offer a settings page: in this case, the Configuration button is shaded.

This is the case when the plugin doesn't need a user interface in order to work and offers no settings.

For example, the Stop Spammers plugin works on its own as a background task: therefore, it doesn't need a configuration page.

Stop spammers.jpg

This is also the case when the plugin adds a feature available from another screen in Piwigo.

For example, the Rotate Image plugin adds an image rotation feature on a photo's editing page: therefore, it doesn't require a settings page.

Rotate Image.jpg

Plugins for all your needs

All throughout this documentation, we are introducing plugins every time it is relevant.

You will find some plugin selections in the articles below to answer your needs.