Plugin installation

Prerequisites

Check that your server meets the requirements. Polski for WooCommerce 1.3.2 requires:

Component	Minimum version	Recommended version
WordPress	6.4+	6.7+
WooCommerce	8.0+	9.x
PHP	8.1+	8.2+
MySQL	5.7+	8.0+
MariaDB	10.3+	10.11+

Checking PHP version

Not sure which PHP version you have? Check in the WordPress dashboard:

Go to Tools > Site Health
Click the Info tab
Expand the Server section
Find the PHP version field

You can also find the PHP version in your hosting panel (cPanel, DirectAdmin) under domain settings.

Checking WooCommerce version

Go to Plugins > Installed Plugins
Find WooCommerce in the list
The version is displayed below the plugin name

Method 1: Installation from the WordPress dashboard (recommended)

This is the simplest and recommended installation method.

Step 1 - open the plugins panel

Step 2 - search for the plugin

In the search field, type:

Polski for WooCommerce

The plugin should appear as the first result. The author is wppoland.com.

Step 3 - install the plugin

Click the Install Now button next to the “Polski for WooCommerce” plugin. Wait for WordPress to download and unpack the files.

Step 4 - activate the plugin

After installation completes, the button will change to Activate. Click it to activate the plugin.

Step 5 - proceed to configuration

After activation, a notification will appear with a link to the configuration wizard. Click Configure plugin or manually navigate to WooCommerce > Polski.

Method 2: Manual installation from a ZIP file

Use this method when you want to install a specific version or the server cannot connect to WordPress.org.

Step 1 - download the ZIP package

Download the latest version of the plugin from one of the following sources:

WordPress.org: https://wordpress.org/plugins/polski/
GitHub Releases: https://github.com/wppoland/polski/releases

Step 2 - upload the ZIP file

Go to Plugins > Add New Plugin
Click the Upload Plugin button at the top of the page
Click Choose File and select the downloaded ZIP file
Click Install Now

Step 3 - activate the plugin

After uploading and unpacking the files, click Activate Plugin.

Method 3: Installation via FTP/SFTP

Use this method when the WordPress panel does not allow file uploads (e.g. due to size limits).

Step 1 - extract the archive

Extract the downloaded ZIP file on your computer. You will get a folder called polski.

Step 2 - upload to the server

Connect to the server via FTP/SFTP and upload the entire polski folder to the directory:

/wp-content/plugins/

The structure after upload should look like this:

wp-content/
  plugins/
    polski/
      polski.php
      includes/
      assets/
      ...

Step 3 - activate in the dashboard

Go to Plugins > Installed Plugins in the WordPress dashboard and click Activate next to “Polski for WooCommerce”.

Installation via WP-CLI

If you have terminal access to the server, you can install the plugin with a single command:

wp plugin install polski --activate

To update the plugin to the latest version:

wp plugin update polski

Check the current version:

wp plugin get polski --fields=name,version,status

Verifying installation

After activating the plugin, check that everything works correctly:

New menu item - a Polski item should appear in the WooCommerce menu
Compliance dashboard - go to WooCommerce > Polski to see the main dashboard
No errors - check that no PHP error messages appeared on the page

Verification using a shortcode

To verify that the plugin is active, insert this shortcode on any page:

[polski_version]

The shortcode displays the plugin version (e.g. “1.3.2”) - this means the installation works.

Troubleshooting

The plugin does not appear in the search

Check that your WordPress has a connection to the WordPress.org repository
Make sure you are searching for exactly “Polski for WooCommerce”
Try manual installation from a ZIP file

Error “Plugin requires a newer PHP version”

Your server is using an unsupported PHP version. Solution:

Log in to your hosting panel
Find PHP settings (usually in the “Domains” or “Hosting” section)
Change the PHP version to 8.1 or newer
Wait a few minutes for the changes to take effect
Try activating the plugin again

Error “WooCommerce is required”

The plugin requires active WooCommerce version 8.0 or newer:

Make sure WooCommerce is installed and active
Update WooCommerce to the latest version
Reactivate the Polski for WooCommerce plugin

White screen after activation

If you see a white screen after activation:

Enable WordPress debug mode - add to wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Check the log file: wp-content/debug.log
If the problem is a conflict with another plugin, deactivate other plugins and activate them one by one

File permission issues

If manual installation does not work, check permissions:

# Recommended permissions for directories
chmod 755 wp-content/plugins/polski/

# Recommended permissions for files
chmod 644 wp-content/plugins/polski/*.php

Updating the plugin

The plugin updates through the standard WordPress mechanism. When a new version is available:

You will see a notification in Plugins > Installed Plugins
Click Update Now or use bulk update
After updating, check that the store works correctly

Next steps

After installation, proceed to plugin configuration to enable modules and adjust settings.

Have a problem not listed here? Report it on GitHub Issues or ask on GitHub Discussions.

This page is for informational purposes only and does not constitute legal advice. Consult a lawyer before implementation. Polski for WooCommerce is open source software (GPLv2) provided without warranty.