=== Czech Product Feeds for WooCommerce ===
Contributors: socionet
Tags: heureka, zbozi, product feed, xml, woocommerce
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Free XML product feeds for the Czech comparison sites Heureka and Zboží.cz. Czech carriers, a ready file, and a check of what is missing.

== Description ==

Every Czech e-shop wants to be on Heureka and Zboží.cz, the two price comparison sites Czech shoppers use. Both read a product feed, an XML file with your catalogue, prices, stock and delivery. WooCommerce does not make one for them. The ready-made solutions are paid, or abandoned. **Czech Product Feeds** is free and does it properly.

**What you get**

* **Two feeds in the right format.** Heureka and Zboží.cz each get the elements and the identifiers its specification asks for (the Zboží.cz namespace, the carrier codes, the dispatch days, `PARAM` for attributes, variations).
* **Czech carriers built in.** Choose Zásilkovna, Balíkovna, Česká pošta, PPL, DPD, GLS and more once, with the price, the cash-on-delivery price and a "free from" amount. Each service gets the identifier it knows; a carrier one of them does not know is left out of that feed.
* **Prices the way the customer pays them.** Final price including VAT, sale prices included, optionally rounded to whole crowns.
* **Variable products.** Every variation is its own item with its own address, price, stock and barcode; variations are grouped with `ITEMGROUP_ID` for Zboží.cz.
* **Barcodes checked.** EAN/GTIN is validated by its check digit; an invalid one is left out rather than sent wrong.
* **Dispatch days that are true.** In stock, backorder, or your own number per product. Out-of-stock, hidden, password-protected and price-less products stay out.
* **A feed check.** After every build you see how many items are in the feed, what was left out and why, and what would make the listing better (missing EAN, manufacturer, category, image, description), with links to the products.
* **Categories of each service.** Heureka and Zboží.cz have different category trees. Write the path once on a product category, or override it on a product.
* **Fast and safe on a big shop.** The feed is built in the background into a file and served from it with `Last-Modified` and `ETag`, so Heureka's check before a download costs nothing. Memory stays flat, the file is replaced atomically.
* **Czech and English interface** (cs_CZ translation included).

**Built to be a good neighbour**

* No external requests. Heureka and Zboží.cz download the file from your site; the plugin sends nothing anywhere.
* No tracking, no ads, no upsell. Everything stored (settings, the feed files, the fields on products and categories) is removed when you delete the plugin.
* Works with the High-Performance Order Storage and the block checkout (it does not touch orders).

**Not in this version**

Gift and voucher elements, the "lowest price in 30 days" element, energy label identifiers and used-goods conditions are not sent yet.

The plugin is made by [Socionet](https://socionet.cz/), a Czech web design studio. It is not affiliated with Heureka or Seznam.cz.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`, or install it from Plugins > Add New. WooCommerce must be active.
2. Activate it and open WooCommerce > Price comparison feeds.
3. Under Settings switch on the feed, under Carriers add your carriers, save, press "Build now".
4. Copy the address of the feed and add it in your Heureka account and in Sklik (Zboží.cz) as the XML feed of the shop.

== Frequently Asked Questions ==

= What is the address of the feed? =

`https://your-site.cz/czech-product-feeds/heureka.xml` and `https://your-site.cz/czech-product-feeds/zbozi.xml`. Without pretty permalinks the plugin shows an address of the form `?socionet_feed=heureka`. The page under WooCommerce has a copy button.

= Heureka or Zboží.cz says my feed has an error. =

Open the feed check under WooCommerce > Price comparison feeds first: it lists missing data per product. The services' own report names the rest. The most common causes are a category path that is not in the service's tree, an EAN that is an internal number, and a price that differs from the one in the shop.

= How do I set the category of Heureka and Zboží.cz? =

Under Products > Categories each category has two fields. Write the whole path from the service's category tree. Subcategories use their parent's path when they have none of their own. Heureka sends the shop's own category path when nothing is set; Zboží.cz has its own tree and without a path the product appears only in its text search.

= Which EAN field is used? =

The WooCommerce field "GTIN, UPC, EAN or ISBN" on the product and on each variation.

= Does it work with my currency? =

The services take Czech crowns. If your shop uses another currency the feed contains the prices as the shop has them and the settings page warns you.

= The feed says 503, "not ready yet". =

The first build is queued when you switch a feed on. Press "Build now", or wait a minute. On a very large shop the first build can take a few minutes.

= Does it slow down my shop? =

No. The file is built in the background (WP-Cron, hourly by default) and the download is served from the file.

== Screenshots ==

1. The feed addresses, the state of each feed and the feed check.
2. Settings and carriers.
3. The Price comparison tab of a product.
4. The two category fields on a product category.
5. The settings page on a phone.

== Changelog ==

= 1.0.0 =
* First release.

== Upgrade Notice ==

= 1.0.0 =
First release.
