Skip to content
Polski for WooCommerce

Plugin configuration

Plugin main dashboard

Section titled “Plugin main dashboard”

After activating the plugin, go to WooCommerce > Polski. You will see the main dashboard with sections:

  • Compliance status - quick overview of which legal requirements are met
  • Active modules - list of enabled modules with links to their settings
  • Required actions - notifications about missing configurations
  • Quick links - shortcuts to the most important settings

Polski for WooCommerce modules dashboard

Enabling and disabling modules

Section titled “Enabling and disabling modules”

The plugin is modular - after installation all modules are disabled. You enable only the ones you need.

How to enable a module

Section titled “How to enable a module”
  1. Go to WooCommerce > Polski > Modules
  2. Find the module you are interested in on the list
  3. Click the toggle next to the module name to enable it
  4. Click Save changes at the bottom of the page

How to disable a module

Section titled “How to disable a module”

Click the toggle on an active module to disable it. Disabling does not delete data - you can re-enable the module without losing settings.

Section titled “Recommended modules for getting started”

For a typical Polish store, enable at least these modules:

ModuleWhy it is important
OmnibusLegally required - price history display
Order buttonLegally required - “Order with obligation to pay”
Legal checkboxesLegally required - consents when placing an order
Legal pagesTerms and conditions and privacy policy
Right of withdrawalLegally required - withdrawal form and information
Delivery timeRecommended - estimated delivery time on product page
GPSRRequired from 13.12.2024 - product safety data

Compliance dashboard

Section titled “Compliance dashboard”

Check whether your store meets legal requirements here. Go to WooCommerce > Polski > Compliance.

Status indicators

Section titled “Status indicators”

Each legal requirement has one of three statuses:

  • Compliant (green) - requirement is met, configuration is complete
  • Needs attention (yellow) - module is enabled but some configuration is missing
  • Non-compliant (red) - module is disabled or configuration is incomplete

Checklist

Section titled “Checklist”

The dashboard shows a checklist with steps to complete:

[x] Order button - text compliant with law
[x] Omnibus - price history display enabled
[ ] Terms and conditions - terms page not assigned
[ ] Privacy policy - page not assigned
[ ] GPSR - missing manufacturer data on 12 products

Click any checklist item to go directly to the relevant settings.

Configuring individual module groups

Section titled “Configuring individual module groups”
Section titled “Legal requirements”

Go to WooCommerce > Polski > Legal Compliance to configure:

Omnibus (price directive)

  1. Enable the Omnibus module
  2. Set the price tracking period (default 30 days)
  3. Choose the display format for the lowest price
  4. Save changes

The plugin starts recording price history from the moment the module is enabled.

GPSR (product safety)

  1. Enable the GPSR module
  2. Fill in the default manufacturer data in global settings
  3. For individual products - edit data in the “GPSR” tab on the product edit page

Legal pages

  1. Enable the legal pages module
  2. Use the generator to create terms and conditions, privacy policy and return policy
  3. Assign generated pages in WooCommerce > Settings > Advanced > Page setup

Prices and product information

Section titled “Prices and product information”

Go to WooCommerce > Polski > Prices to configure:

Unit prices

  1. Enable the unit prices module
  2. Choose the default unit of measurement (kg, l, m, pcs)
  3. On the product page, fill in the “Base quantity” and “Unit of measurement” fields

Example configuration in the product editor:

Product price: 15.99 PLN
Base quantity: 500
Unit of measurement: g
Reference unit: kg


Result: 15.99 PLN / 500g (31.98 PLN/kg)

Delivery time

  1. Enable the delivery time module
  2. Set the default delivery time (e.g. “1-3 business days”)
  3. Optionally - set individual times for specific products

Checkout and orders

Section titled “Checkout and orders”

Go to WooCommerce > Polski > Checkout to configure:

Order button

  1. Enable the module
  2. The default text is “Zamawiam z obowiazkiem zaplaty” (Order with obligation to pay)
  3. You can customize the text, but it must meet the requirements of Article 17 of the Consumer Rights Act

Legal checkboxes

  1. Enable the checkboxes module
  2. Add required consents (terms and conditions, privacy policy)
  3. Configure the content of each checkbox, including links to legal pages
  4. Mark which checkboxes are mandatory

Example checkbox configuration:

Label: terms
Content: I have read the [terms and conditions] and accept their provisions.
Required: Yes
Link: /terms/
Position: Before order button

NIP lookup

  1. Enable the NIP module
  2. The NIP field will automatically appear on the checkout page
  3. After entering a NIP and clicking “Check”, company data will be automatically filled from the GUS database

Food products

Section titled “Food products”

Modules for food stores. Go to WooCommerce > Polski > Food.

  1. Enable the modules you need (nutritional values, allergens, Nutri-Score)
  2. New tabs will appear on the product edit page for filling in data
  3. Data will automatically display on the product page in the store

Storefront modules

Section titled “Storefront modules”

Go to WooCommerce > Polski > Storefront to enable additional features:

  • Wishlist, compare, quick view - enable and customize appearance
  • AJAX search - enable and configure the number of displayed results
  • AJAX filters - enable and choose attributes for filtering
  • Slider and badges - configure style and behavior

Global settings

Section titled “Global settings”

In the WooCommerce > Polski > Settings tab you will find global options.

Company data

Section titled “Company data”

Fill in your basic company data:

  • Company name
  • NIP (Tax Identification Number)
  • REGON
  • Registered address
  • Contact email address
  • Phone number

This data is used by various modules (legal pages, GPSR, DSA).

Performance

Section titled “Performance”
  • Resource loading - CSS and JS loaded only on pages where they are needed
  • Cache - the plugin uses WordPress Transients API for data caching
  • Minification - front-end resources are minified

Compatibility

Section titled “Compatibility”

If your theme or another plugin causes a conflict:

  1. Go to WooCommerce > Polski > Settings > Compatibility
  2. Enable compatibility mode for problematic modules
  3. Adjust hook priorities if elements display in the wrong order

Verifying configuration

Section titled “Verifying configuration”

After configuration, check that everything works:

  1. Compliance dashboard - go to WooCommerce > Polski > Compliance and check that all indicators are green
  2. Product page - open any product in the store and check that new elements appear (Omnibus price, delivery time, GPSR data)
  3. Checkout page - place a test order and check that checkboxes and the button are correct
  4. Legal pages - open terms and conditions and privacy policy and check their content

You can also run an automatic audit: WooCommerce > Polski > Tools > Site Audit.

Next steps

Section titled “Next steps”

Have a question? Write on GitHub Discussions. Found a bug? Report it on GitHub Issues.

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.