Oli Product Feed

Product feeds for WooCommerce: Google Merchant Center, Pinterest, Meta, TikTok and Microsoft, one feed per language and currency.

Description

Oli Product Feed builds product feed files for shopping platforms from your WooCommerce catalog. Each feed targets one platform, one language and one currency. Files are generated in the background, in small batches, and their URL never changes, so the platform can fetch them on a schedule.

Channels

• Google Merchant Center (XML RSS 2.0, CSV or TSV)
• Pinterest Catalogs (availability preorder for products on backorder)
• Meta catalogs for Facebook and Instagram (Commerce Manager data feed)
• TikTok Catalog (CSV, TSV or XML)
• Microsoft Merchant Center for Bing Shopping (tab-separated TXT or XML)
• Generic CSV, TSV or XML with your own columns, for comparison sites and marketplaces
• Other channels can be added with the oliprfe_channels filter

Feeds

• Simple and variable products: one item per variation, grouped with item_group_id
• Language and currency per feed: with TranslatePress, titles, descriptions, terms and links are taken in the feed language (the locale is set for the whole generation, including translated permalinks such as /fr/); with Price Based on Country, prices come from a pricing zone and links can carry the country parameter
• Attribute mapping: for every attribute, use the automatic rule or pick a product field, a product attribute, a taxonomy, a custom field (meta), a static value or a copy of another final attribute, with prefix, suffix, fallback and value map; a preview column shows the value for a sample product
• Variant color and size sent by default from the pa_color (or pa_colour, Color, Colour) and pa_size (or Size) attributes, in the feed language; an explicit mapping always wins
• Per-product values for the odd product (for example the color of one item)
• Title template such as {brand} {name} {type} - {variation}, with the type set per category
• GTIN validation (check digit); MPN = SKU for all brands or only for a list of brands
• Filters: categories, tags, price range, minimum price (empty or 0: off) on the displayed feed price (g:price / g:sale_price, including Price Based on Country), stock status, product IDs, words in the title, required fields; exclusion rules and availability rules on custom fields; live count of the matching products. Filter: oliprfe_min_price.
• Backorder availability date: optional per-feed lead time (default 21 days) for products on backorder or sold while out of stock. Google, Microsoft (Bing) and Meta receive g:availability = backorder (or preorder if configured), g:availability_date in ISO 8601 with the site time zone, and optional handling time. In-stock items are unchanged. A per-product override (days or a fixed date) can be set on the product and on each variation.
• Google product category per category or per product
• UTM and extra link parameters: per-feed query string (for example wcpbc-manual-country=US) added to each item g:link and to mobile_link when set, never to image_link. Parameter keys are lowercased (sanitize_key). Existing parameters (variation attribute_*, lang) are kept. Filter: oliprfe_link_args.
• Clear log: every generation lists the excluded products and why

Generation and serving

• Background generation with Action Scheduler (WP-Cron fallback), in batches, with a lock and an atomic file swap
• Schedule: hourly, twice a day, daily or weekly, at an off-peak hour; optional regeneration when products change (at most every 15 minutes)
• Static file (default) or served by WordPress with a short cache, X-Robots-Tag: noindex, ETag and Last-Modified, for hosts whose CDN keeps static files too long. The pre-generated file is streamed while the plugins load (never rebuilt during the request)
• Logs in WooCommerce > Status > Logs
• Access: the plugin screens need the manage_woocommerce capability (administrators and shop managers); when shop manager access is turned off in the settings, manage_options (administrators)
• WP-CLI: wp oli-feed list|generate|status|export|import|settings

External services

The plugin itself does not call a remote API, does not load a remote script or font, and does not collect personal data. Feed files stay on the site (wp-content/uploads/). The links and fetches below are the only third-party contacts.

PayPal (donate)

Optional Donate / support links (Plugins screen, a dismissible notice on the plugin screens, the plugin footer, and the WordPress.org Donate link) open https://www.paypal.com/donate/ in the browser when someone clicks them. No server-side request is made. PayPal may then see the visitor’s IP address, browser data and, if they complete a donation, the amount and the payment details they enter.

• Terms: https://www.paypal.com/legalhub/useragreement-full
• Privacy: https://www.paypal.com/legalhub/privacy-full

Author and source links

The plugin header links to the author’s site (https://olivierbigras.com) and to the public repository (https://github.com/olivierbigras/oli-product-feed). Nothing is fetched unless someone clicks those links.

• olivierbigras.com: https://olivierbigras.com
• GitHub terms: https://docs.github.com/site-policy/github-terms/github-terms-of-service
• GitHub privacy: https://docs.github.com/site-policy/privacy-policies/github-general-privacy-statement

Shopping platforms (Google, Pinterest, Meta, TikTok, Microsoft)

The plugin writes local product feed files. It does not call Merchant Center, Pinterest Catalogs, Meta Commerce Manager, TikTok Catalog or Microsoft Merchant Center. After you paste a feed URL into a platform, that platform fetches the file on its own schedule. The file holds public catalog data: titles, descriptions, links, image URLs, prices, availability, GTIN/MPN and the attributes you mapped.

• Google terms: https://policies.google.com/terms — privacy: https://policies.google.com/privacy
• Pinterest terms: https://policy.pinterest.com/terms-of-service — privacy: https://policy.pinterest.com/privacy-policy
• Meta terms: https://www.facebook.com/policies — privacy: https://www.facebook.com/privacy/policy
• TikTok terms: https://www.tiktok.com/legal/page/row/terms-of-service/en — privacy: https://www.tiktok.com/legal/page/row/privacy-policy/en
• Microsoft terms: https://www.microsoft.com/servicesagreement — privacy: https://privacy.microsoft.com/privacystatement

Privacy

No outbound request is made from WordPress. Feeds only contain public product data. Donate and author links are opt-in (click). Platforms receive a feed only after you submit its URL.

Installation

1. Upload the plugin and activate it (WooCommerce is required).
2. Go to WooCommerce > Product Feeds and click Add New Feed.
3. Choose the channel, language, country and currency, then save and generate.
4. Copy the feed URL into the platform (Merchant Center, Pinterest, Commerce Manager) as a scheduled fetch.

Frequently Asked Questions

The platform still sees an old version of the feed

Your host or CDN probably caches static files for a long time. In Settings, choose Through WordPress: the feed is then served with a short cache (one hour by default) and validators, and the URL becomes /?oliprfe_feed=<file>.

How do I generate a feed from the command line?

wp oli-feed generate <id> or wp oli-feed generate --all.

How do I make the WordPress serving faster?

The feed is sent while the plugins load, before WooCommerce, from the pre-generated file.

Who can manage the feeds?

Users with the manage_woocommerce capability: administrators and shop managers. Uncheck "Shop managers" in WooCommerce > Product Feeds > Settings to require manage_options (administrators only).

Where are the files?

In wp-content/uploads/oli-product-feed/ by default. The folder can be changed in Settings or with the oliprfe_output_dir filter (return the same folder on every request). When it changes, the feed files move to the new folder and the previous folder is cleaned: only the files the plugin wrote are deleted, and the folder itself only when the plugin created it and nothing else is in it. A folder that cannot be used (a symbolic link or inside one, real path outside the uploads directory, not writable, cannot be created) is refused: the feeds stay where they are, nothing is moved or deleted, and the plugin screens show a notice. A file of the same name that the plugin did not write is never overwritten or deleted: the feed stays in its previous folder until that file is removed.

What is deleted when the plugin is deleted?

The scheduled tasks and their Action Scheduler history are always removed. When Delete all data when the plugin is deleted is checked, the feeds, the settings, the generated files of every output folder the plugin used and its WooCommerce logs (source oli-product-feed) are deleted too. Files and folders the plugin did not write or create are never touched, and no symbolic link is followed. When it is unchecked (default), the feeds, settings, files and logs are kept.

Screenshots

1. Feed list with status, product count and copyable URL.
2. Feed editor: target, filters and attribute mapping.
3. Settings.

Changelog

0.5.6

• Docs: External services section (PayPal donate, author/source links, shopping platforms that fetch the feed).
• Prefix: leftover admin CSS/HTML/JS opf- identifiers renamed to oliprfe-.
• Prefix: on update, options, transients, the feed post type and meta stored as oli_pf_* (0.3.4 and earlier) are copied to oliprfe_*, then the old keys are deleted.

0.5.5

• Fix: parameter values added to item links are rawurlencoded before add_query_arg, so &, # and spaces stay one valid query value.
• Docs: parameter keys are lowercased (sanitize_key).

0.5.4

• Maintenance : liens GitHub mis à jour vers github.com/olivierbigras (compte renommé, anciennement bigrat95). Aucun changement fonctionnel.

0.5.3

• Traductions FR de toute l’interface (liste, éditeur, canaux, notices, CLI, métabox produit). Fichiers fr_FR et fr_CA bundlés (français québécois : courriel, etc.). Repli fr_CA → fr_FR si le catalogue canadien est absent.

0.5.2

• Traductions FR des réglages Prix minimum et Paramètres ajoutés aux liens.

0.5.1

• NEW: Per-feed “Parameters added to links” query string (for example wcpbc-manual-country=US). Added to each item g:link and to mobile_link when it is set, not to image_link. Existing query parameters are kept. Empty: off. Filter: oliprfe_link_args.

0.5.0

• NEW: Per-feed minimum price. Simple products and variations whose displayed price (sale price when a promotion is active, otherwise the regular price) in the feed currency is below the threshold are excluded. Empty or 0: off. Same amount as g:price / g:sale_price, including Price Based on Country; the threshold is not converted (150 USD on a USD feed, 150 CAD on a CAD feed). Filter: oliprfe_min_price.

0.4.1

• Fix: TranslatePress fr_CA feeds no longer write doubled language slugs (/fr/fr/…, a 404) or http:// on item links and the channel <link>. URLs that already have /fr/ are left as-is; default-language URLs are converted once; force_https is applied after conversion.

0.4.0

• NEW: Automatic availability date for products sold on backorder or while out of stock (lead time in days, default 21). Google, Microsoft (Bing) and Meta; optional handling time; per-product override on the product edit screen and on variations.
• Fix: TranslatePress feed language (e.g. fr_CA) now switches the current language and locale while the feed is generated, so titles, descriptions and /fr/ links are taken from TranslatePress instead of staying in English.

0.3.9

• WordPress.org review: the optional must-use loader is removed (no file outside the plugin is loaded).
• No inline style attribute in the admin footer (moved to the enqueued stylesheet).
• Admin script and style handles use the plugin prefix (oliprfe-admin).

0.3.8

• The support notice dismiss handler is now attached to the enqueued admin script with wp_add_inline_script() (no inline `