Custom facet types

You can create your own facet types with FacetWP.

To demonstrate this, we created an example plugin that lets users filter by future or past date. You can see/clone the code in this GitHub repo:

https://github.com/FacetWP/facet-future-past

Anatomy of a facet type

Each facet type consists of 2 main parts:

1. The facet class
2. The facet registration (using the facetwp_facet_types hook)

The facet class

Each facet type inherits from the FacetWP_Facet class and contains most (if not all) of these methods:

The above (GitHub) example uses all of the above methods, except for admin_scripts.

Registering the facet type

Here’s how we’re registering the future_past facet type:

How to use custom PHP code?
PHP code can be added to your (child) theme's functions.php file. Alternatively, you can use the Custom Hooks add-on, or a code snippets plugin. More info
add_filter( 'facetwp_facet_types', function( $types ) {
  include( dirname( __FILE__ ) . '/facet-future-past/class-facet.php' );
  $types['future_past'] = new FacetWP_Facet_Future_Past();
  return $types;
});

See also

• The facetwp_facet_types hook
• How to add a “Has featured image?” facet
• How to add a “Percent discount” facet
• The facetwp_facets hook
• The facetwp_facet_html hook
• The facetwp_shortcode_html hook
• The facetwp_facet_display_value hook
• The facetwp_index_row hook