Skip to main content

Installation

The plugin is installed like a classic Shopware 6 plugin in the custom/plugins/ directory.

1. Place the plugin files

Copy the plugin folder into your Shopware project so that the following structure is created:

<shopware-root>/custom/plugins/vlp8n
tip

The folder must be named vlp8n – it matches the technical plugin name (shopware-plugin-class: vlp8n\vlp8n).

2. Install and activate the plugin

Run the following console commands in your Shopware root:

bin/console plugin:refresh
bin/console plugin:install --activate vlp8n
bin/console cache:clear
  • plugin:refresh makes the new plugin known to Shopware.
  • plugin:install --activate vlp8n installs and activates it in one step.
  • cache:clear clears the cache so all routes and services are loaded.

3. Administration assets

The plugin ships a pre-built Administration extension and tries to install the assets automatically on install, update and activation (assets:install). If that fails, the plugin copies the files from Resources/public as a fallback into public/bundles/vlp8n.

If the admin buttons do not appear after installation, install the assets manually:

bin/console assets:install
bin/console cache:clear

4. Only when changing source code: rebuild the Administration

If you change the Administration sources (JavaScript/Twig), the assets must be rebuilt:

./psh.phar administration:build
# or, depending on your setup:
bin/build-administration.sh

Uninstallation

bin/console plugin:deactivate vlp8n
bin/console plugin:uninstall vlp8n

Verification

After a successful installation you will find the plugin in the Administration under Settings → System → Plugins → Pixelfarben n8n. Three configuration cards, each with a webhook URL and a button, should be visible there.

➡️ Continue with the Configuration.