Free edition
The free edition applies no filters or actions of its own.
| What | Name |
|---|---|
| Option | gmpf_feeds — a list of feed rows. This edition reads and writes only the row with id gmpff-google; every other row is left exactly as found. |
| Cron | gmpff_generate (daily, while Rebuild is Daily) |
| Folder | wp-content/uploads/gmpf-feeds/ |
The feed row
Both editions store every feed in this shape:
array(
'id' => 'gmpff-google', // a key
'title' => 'Google Shopping',
'channel' => 'google', // google | meta | bing
'enabled' => 'yes',
'schedule' => 'daily', // hourly | twicedaily | daily | manual
'categories' => array(), // product_cat term IDs
'in_stock_only' => 'no',
'include_variations' => 'yes',
'filename' => 'google-1a2b3c4d.xml',
'last_run' => '2026-10-20 06:00:00', // UTC
'last_written' => 120,
'last_skipped' => 3,
'last_error' => '',
)
Full edition: filters
| Filter | Arguments | What it tunes |
|---|---|---|
gmpf_channels |
$channels |
The declared channels. Add your own. |
gmpf_feed_row |
$row, $product, $channel |
One product's row, before it is checked for required fields and written. |
gmpf_feed_source |
'', $source, $product |
The value of a source the plugin does not know — how a custom channel field gets its value. |
gmpf_feed_query |
$args, $feed |
The wc_get_products() arguments each batch runs. |
gmpf_batch_size |
200, $feed |
How many products one batch reads. |
gmpf_settings |
$settings |
The merged settings. |
gmpf_modules |
$modules |
The module list. |
gmpf_license_api_url, gmpf_update_cache_ttl |
— | The licence endpoint and update cache lifetime. |
A channel is a row of data
A channel is a label, a format (xml or csv), an XML namespace prefix, a map of feed field → source, and the list of required fields. One writer per format serves every channel.
Built-in sources: sku_or_id, parent_sku_or_id, title, description, link, image, gallery, availability, price, sale_price, brand, categories, google_category, gtin, mpn, condition, weight. Any other source name is passed to gmpf_feed_source.
// A Pinterest-style CSV channel with a custom "custom_label_0" source.
add_filter( 'gmpf_channels', function ( $channels ) {
$channels['pinterest'] = array(
'label' => 'Pinterest',
'format' => 'csv',
'fields' => array(
'id' => 'sku_or_id',
'title' => 'title',
'description' => 'description',
'link' => 'link',
'image_link' => 'image',
'price' => 'price',
'availability' => 'availability',
'custom_label_0' => 'season',
),
'required' => array( 'id', 'title', 'link', 'image_link', 'price' ),
);
return $channels;
} );
add_filter( 'gmpf_feed_source', function ( $value, $source, $product ) {
return 'season' === $source ? (string) $product->get_meta( '_season' ) : $value;
}, 10, 3 );
A channel without fields is ignored.
// Drop products marked with a "_no_feed" meta from every feed's rows.
add_filter( 'gmpf_feed_row', function ( $row, $product ) {
// An empty row cannot fill the required fields, so the product is
// left out and counted.
return 'yes' === $product->get_meta( '_no_feed' ) ? array() : $row;
}, 10, 2 );
Full edition: actions
| Action | Arguments | When |
|---|---|---|
gmpf_booted |
$container |
The plugin has finished booting. |
Full edition: data
| What | Name |
|---|---|
| Options | gmpf_feeds, gmpf_settings (product_fields, scheduled), gmpf_license |
| Product meta | _gmpf_gtin, _gmpf_mpn, _gmpf_google_category; _gmpf_condition (refurbished or used; absent means new), written by the Condition field |
| Cron | gmpf_generate with hourly, twicedaily or daily as its argument; gmpf_license_check |
| Transient | gmpf_update_payload |
| Folder | wp-content/uploads/gmpf-feeds/ |
Neither edition creates database tables or touches orders.
