WooCommerce to Skroutz Feed Tools

This repository now contains two companion tools for producing Skroutz-compatible product feeds from WooCommerce data:

• a Windows desktop app for working from WooCommerce CSV exports
• a WordPress plugin for generating the XML feed directly from WooCommerce

Relevant Skroutz resources:

• XML spec: https://developer.skroutz.gr/products/xml_feed/
• Validator: https://validator.skroutz.gr/

Repository layout

• src/skroutz_feed_builder/ contains the desktop app source.
• plugin/skroutz-xml-feed-for-woocommerce/ contains the WordPress plugin.
• scripts/build.ps1 builds the Windows executable.
• scripts/build-plugin.ps1 packages the WordPress plugin ZIP.
• readme.txt and skroutz-xml-feed-for-woocommerce.php at the repo root are release metadata files for the plugin updater.

Windows desktop app

The desktop app loads a WooCommerce product CSV, helps fill missing Skroutz fields, validates each item, and exports only compliant products to XML.

Run locally:

$env:PYTHONPATH = (Resolve-Path .\src)
python -m skroutz_feed_builder

Build the Windows executable:

.\scripts\build.ps1 -Clean

The build script creates a virtual environment, installs pyinstaller, runs the test suite, and packages the GUI app into dist\SkroutzFeedBuilder\.

Desktop app log locations:

• %LOCALAPPDATA%\SkroutzFeedBuilder\logs\skroutz-feed-builder.log on Windows
• ~/.skroutz-feed-builder/logs/skroutz-feed-builder.log as a fallback

WordPress plugin

The WordPress plugin adds a WooCommerce admin screen, a public feed endpoint at /skroutz-feed.xml, per-product and per-variation override fields, caching, validation reports, and a file log inside the uploads directory.

Plugin source:

• plugin/skroutz-xml-feed-for-woocommerce/

Build the distributable ZIP:

.\scripts\build-plugin.ps1

That script validates the plugin metadata, optionally runs php -l when PHP is available, and creates a versioned ZIP in dist\.

The plugin uses yahnis-elsts/plugin-update-checker and this GitHub repository as its update source. The packaged ZIP is intended to be attached to GitHub releases named with version tags such as v1.0.0.

For feed freshness, the public endpoint is the canonical URL to share with Skroutz. It sends no-cache headers and the plugin invalidates its XML cache when relevant WooCommerce product, stock, price, and settings events occur. If the site also uses a cache plugin or CDN, exclude /skroutz-feed.xml from those cache layers.

Important note about the sample CSV

The included WooCommerce export is missing several fields that Skroutz typically expects for a compliant feed, especially manufacturer/brand, MPN/SKU, and EAN/barcode values. That is why both tools expose validation and manual overrides instead of doing a blind export.

ELLIA barcode helper

For the 2025 ELLIA PRICE LIST.xlsx sheet in this repository there is now a curated helper that fills the missing WooCommerce SKU and GTIN, UPC, EAN, or ISBN columns for the current ELLIA catalog export, without changing prices.

$env:PYTHONPATH = (Resolve-Path .\src)
python .\scripts\generate_ellia_barcode_updates.py .\wc-product-export-29-3-2026-1774786776454.csv

It writes three CSV files into build\:

• an import-ready copy of the WooCommerce export with the matched SKU and GTIN values filled in
• a smaller SKU/GTIN-only CSV for quick review
• a match report showing which rows were matched, skipped, or left for manual review