View Categories

Hooks and filters

Waseem
Updated on November 4, 2026

2 min read

0:00 2:13

Gemelune provides the filters below. Put the code in the child theme‘s functions.php or in a small plugin.

gemelune_swatch_attributes

The attributes shown as colour swatches. Default pa_metal, pa_metal-color, pa_metal-colour, pa_color and pa_colour.

add_filter( 'gemelune_swatch_attributes', function ( $taxonomies ) {
	$taxonomies[] = 'pa_finish';
	return $taxonomies;
} );

gemelune_size_guide_attributes

The attributes that get the Size guide link. Default pa_ring-size, pa_size, and the custom attribute names ring-size and ring size.

gemelune_info_pages

The slugs of your information pages, by key: size-guide (ring-size-guide), delivery (delivery-returns) and care (jewelry-care).

add_filter( 'gemelune_info_pages', function ( $slugs ) {
	$slugs['delivery'] = 'shipping';
	return $slugs;
} );

gemelune_new_badge_days

How many days after publishing a piece shows the New badge. Default 30; 0 turns the badge off.

gemelune_card_hover_image

Whether a product card shows the second gallery image on hover. Default true. The second argument is the WC_Product.

add_filter( 'gemelune_card_hover_image', '__return_false' );

gemelune_thumbnail_ratio

The height-to-width ratio of catalog images. Default 1.25 (4:5 portrait); 1 makes them square.

gemelune_filter_chip_attributes

The attribute slugs whose filter options show as chips instead of a checklist. Default ring-size, size, necklace-length and length.

gemelune_newsletter_form

The newsletter form’s HTML. Gemelune returns MailPoet’s first form when MailPoet is active, and an empty string otherwise. Return your provider’s form to show it in the homepage newsletter section and the footer:

// A Mailchimp for WordPress form, through its shortcode.
add_filter( 'gemelune_newsletter_form', function () {
	return do_shortcode( '' );
} );

When the filter returns an empty string, no form is shown.

The URL a homepage section links to, found by slug. Arguments: the URL (empty when nothing matched), the type (page or a taxonomy such as product_cat) and the slug.

// Send the Rings card to a page instead of the category.
add_filter( 'gemelune_link', function ( $url, $type, $slug ) {
	return ( 'product_cat' === $type && 'rings' === $slug ) ? home_url( '/rings-guide/' ) : $url;
}, 10, 3 );

The links in a footer column, as a list of array( label, url ). The second argument is the column: shop, care, house or legal.

The Documentation, Get support and Your WPRuby account links on Appearance → Gemelune, as an array with the keys docs, support and account.