WooCommerce Products Meta Data Filters

Here is a complete settings example for WooCommerce Products Meta Data Filters:

Filter Settings

In the filter_settings array, you can configure the filters that will be applied to the products' metadata. Each filter has the following options:

• enabled: A boolean indicating whether the filter is enabled or not.
• key: The key of the filter (e.g. "product_name", "product_price", etc.).
• type: The type of filter (e.g. "exact", "like", etc.).
• value: The value of the filter.

Example:

'filter_settings' => array(
    array(
        'enabled' => true,
        'key' => 'product_name',
        'type' => 'like',
        'value' => '%shirt%'
    ),
    array(
        'enabled' => true,
        'key' => 'product_price',
        'type' => 'range',
        'value' => array(
            'min' => 10,
            'max' => 20
        )
    ),
)

Operator Settings

In the operator_settings array, you can configure the operators that will be used for the filters. Each operator has the following options:

• enabled: A boolean indicating whether the operator is enabled or not.
• key: The key of the operator (e.g. "AND", "OR", etc.).
• value: The value of the operator.

Example:

'operator_settings' => array(
    array(
        'enabled' => true,
        'key' => 'AND',
        'value' => 'AND'
    ),
    array(
        'enabled' => true,
        'key' => 'OR',
        'value' => 'OR'
    ),
)

Group Settings

In the group_settings array, you can configure the groups that will be used for the filters. Each group has the following options:

• enabled: A boolean indicating whether the group is enabled or not.
• key: The key of the group (e.g. "product_categories", "product_tags", etc.).
• value: The value of the group.

Example:

'group_settings' => array(
    array(
        'enabled' => true,
        'key' => 'product_categories',
        'value' => array(
            'key' => 'Electronics',
            'key' => 'Gadgets'
        )
    ),
    array(
        'enabled' => true,
        'key' => 'product_tags',
        'value' => array(
            'key' => 'discount',
            'key' => 'new'
        )
    ),
)

Cache Settings

In the cache_settings array, you can configure the cache settings for the filters. Each cache setting has the following options:

• enabled: A boolean indicating whether the cache is enabled or not.
• expiration: The expiration time for the cache in seconds.

Example:

'cache_settings' => array(
    'enabled' => true,
    'expiration' => 3600 // 1 hour
)

Here are the features, requirements, usage, and other information about WooCommerce Products Meta Data Filters:

Features:

1. No complicated settings page. Simple and easy administration via Widgets.
2. Works out of the box.
3. Auto discovers all default and custom meta keys.
4. You can create unlimited product filters and combine them.
5. Extensible / developer friendly. You can alter the plugin without hacking it, but via WordPress filters and actions.
6. Works on all WooCommerce setups and themes.
7. Easily translatable via.po /.mo files.

Requirements:

1. WordPress 4.0+
2. WooCommerce 3.0+
3. PHP 5.4+

Usage:

1. Add the "Filter products by Meta" widget to a sidebar on your WordPress site.
2. Configure the widget options, including the title, label, meta key, filter type, order options, and order autorefresh.

Options:

1. Title: Enter the title of the widget.
2. Label: Put the label of the element you are filtering (e.g. "Width:").
3. Meta Key: Select the meta key you want to filter by.
4. Filter type: Select "List" to display all available values of this meta key or "range" to create a slider if you are filtering by a numeric value.
5. Order options: Select the order of the filter's values.
6. Order Autorefresh: This will remove the submit button from a "range" filter and will auto submit the filter when it has been changed.

For Developers:

1. Some hooks are in place. Please search the code for a full list.
2. You can make the filters display in every page you want by using the wmf_display_condition filter.
3. You can change the list of the filter types by using the wmf_filter_types filter.
4. You can add your own behaviour on your filter type by using the wmf_widget_end action.

Frequently Asked Questions:

1. Can I filter by any custom field (meta data)? Yes, you can.
2. How do I add my custom meta data on a product? Edit the product in wp-admin and add your custom meta data in the custom fields metabox.
3. Can I put this anywhere in my site? You can put it on any sidebar on your website.
4. What default fields can I filter by? Some of the default filter fields are: weight, length, width, height, visibility, stock status, total sales, sales price, regular price, tax status, tax class, featured, sku, reviews count, average rating.

Changelog:

1. 1.0.5 11/03/2021: Feature: Added touch/drag slider support for mobile devices.
2. 1.0.4 10/25/2021: Fix: Added missing jQuery UI images.
3. 1.0.3 05/02/2021: Fix: Removed some PHP warnings.
4. 1.0.2 09/12/2019: Feature: Added support for float range filters.
5. 1.0.1 04/26/2019: Fix: Added support for all meta key values.
6. 1.0.0 04/24/2019: Initial release.

Sources and Credits:

1. This plugin uses the jQuery-ui-Slider-Pips library.