Gatemi Product Feed Developer Reference

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.

Shopping Cart
Scroll to Top