Marketplace

Resource Filter for XenForo 2.x

Yearly: $69.99 USD (Renewal: $40.00 USD)
Trial: 7 Days

Performance-optimized resource filter and search based on custom fields

Add-On Overview

The add-on allows to filter and search resources based on Custom thread fields. The idea is to allow admins to utilize the power of custom thread fields to turn XenForo Resource Manager into Directory, Classifieds, Shop or other types of content, for which filtering the data based on custom fields is vital.

The controls to filter the resources are added in Filters popup in home/category views of Resource Manager, and can be optionally changed to be in the sidebar or as a separate form above the list.

Search Resources page is also enhanced to show filter controls when the category being searched currently has custom fields associated with it. In case of searching all categories, only the fields that belong to all categories are shown.

Each field can be configured separately to be shown in the filter list and/or in the search form.

Choice fields can be configured to be shown in the forms using Check boxes and Multiple-choice drop down (allow searching/filtering by multiple values) or Drop down selection/Radio buttons (allow searching/filtering only by single value).

Date fields and numeric fields are shown as interval inputs (from... to...) where both fields are optional, so it is possible to search any values higher/lower than the defined values or in some particular interval.

Color fields are also supported and color similarity algorithm is implemented. All items with visually similar colors are found and listed. An example search listing resources filtered by color similarity can be seen here - https://xf2.addonslab.com/index.php?resources/categories/resource-filter-test.2/&resource_fields[field_1_5]=rgb%282%2C+248%2C+60%29

Text fields are searched and indexed just like thread text itself. Full-text search is executed with fuzzy matching, meaning the phrase searched does not have to be in exactly the same order as in the query.

Resource list shows all active filters. Clicking each filter will remove the field and re-run the search with the remaining filters:

Xenforo Enhanced Search and Elastic Search support

The add-on has special support for Enhanced Search add-on with Elasticsearch back-end. Custom field information is indexed as separate content type in Elasticsearch. A high-performance algorithm is implemented to filter millions of records and show only resources matching filter criteria. Even though the product performs completely fine without Enhanced Search add-on, it is highly recommended to use this add-on and Elasticsearch on large databases.

Planned Features

In coming versions we will implement filtering resources by tags, as well as ordering the results by custom field values.

Pricing

Add-on costs $49.99 USD that includes one year of support and updates with permanent access to product versions released in license validity period. Yearly extension costs $40.00 USD

The add-on has a visible branding with a link to our website which can be removed for additional $30.00 USD payment.

Trial Version

We offer seven days free trial version on our website. No credit card is required, the service is approved automatically upon registration and confirmation of order.

IonCube Loader and PHP 5.6+ version is required to run trial version of the product. The full version does not have such requirement and does not have any encoded code in it.

Demo

The product is active on our forums at https://xf2.addonslab.com/index.php and can be tested at https://xf2.addonslab.com/index.php?resources/

Registered user accounts Username: user1 Password: userpass

Username: user2 Password: userpass

Admin account Username: admin1 Password: adminpass

Licensing Information

You will get a License Key upon purchase/trial subscription, which will be available in My Services page at https://customers.addonslab.com/marketplace.php/my-services/

The key should be entered in product's Options page in XenForo Admin Panel. Once entered and saved you will see full details about your current license status. The key can be used only on one board and one server, so if you move the board you need to Reissue the license in My Services page.

The product does not include any callbacks, that execute on page load time on front-end or via cron jobs. License check is done only when you edit/save product's options or upgrade the product to the next version.

We require valid XenForo license to purchase the product. You will be asked for XenForo License validation information during the purchase.

Full details at https://addonslab.com/threads/product-licensing-information.81/

Support

Support will be provided in the Discussion Thread at XenForo.com and in our Support System at https://customers.addonslab.com/submitticket.php

Feel free to contact us with any issues you find in the product or any suggestions.

Check out our free and paid XenForo add-ons in our Marketplace at https://customers.addonslab.com/marketplace.php

Screenshots

Field Options.png

Product Options.png

Search results with fields.png

Enhanced search with filters.png

Filtered results with active filters.png

Resource filter above thread list.png

Resource filters in the sidebar.png

Filters in popup.png

Custom fields in resource list.png

Category field options.png

Options for choice fields.png

Field Options.png

Product Options.png

Version: 4.1.0 Release date: 2026-07-29

Version: 4.0.2 Release date: 2025-07-29

Version: 3.4.0 Release date: 2021-09-20

In this release, we have implemented a Clear button in the filter form, next to the Filter button. Pressing the button resets filters. The button is not shown in the filter form until some filters are applied.

Version: 3.3.1 Release date: 2021-08-08

This version fixes a bug appearing when admins use the option "Value display HTML" for a custom field using HTML that breaks the layout in the Active filters bar. The HTML will be stripped away now and only the raw value will be shown in the bar.

Version: 3.3.0 Release date: 2021-06-07

This version enhances location support using the latest upgrade of Location custom field add-on. Now you can choose to hide the default distance unit in the filter form. From this version on, Google API key should be specified in the Location custom field add-on options. Please verify these options after upgrade. It also fixes a bug with the option Maximum result count that would not allow 0 as a value.

Version: 3.2.6 Release date: 2021-03-11

This is a fix for a regression in the latest version, which would cause the Auto Reload not to work with a JavaScript error logged.

Version: 3.2.5 Release date: 2021-03-04

Release contains updated files from the shared Filter Framework package used by all our filter products. Please install this release if you are using any other filter product created by us.

Version: 3.2.4 Release date: 2020-09-12

This version fixes the following PHP error when rebuilding custom fields:

Error: Call to undefined method XF\Util\Arr::arrayColumn()

Version: 3.2.3 Release date: 2020-08-28

The release fixes a bug, that would cause ES search error "Elasticsearch error: all shards failed". This would happen only if you have Multiple prefix search option activated, and if a user/bot manually modifies the URL to include invalid prefix IDs (which are normally numeric). This is not a security issue as attacker would not get any error message except that searching failed.

Version: 3.2.2 Release date: 2020-08-21

This version fixes a PHP error on the general search page introduced in version 3.4.0:

> TypeError: Argument 1 passed to XF\Search\Search::getResultSet()

Version: 3.2.1 Release date: 2020-08-21

This version fixes a PHP error on the general Search page on XenForo 2.2.x

Version: 3.2.0 Release date: 2020-08-17

This version implements compatibility with XenForo 2.2.

Version: 3.1.4 Release date: 2020-05-25

If the filter URL is modified and the values of multiple-selection fields are changed intentionally (e.g. with an attempt to cause an error in the website or execute SQL injection), there would be a PHP error logged in the admin panel. However, this would not cause any visible errors or unexpected SQL queries. With this release, we have made sure these invalid values don't make their way to built-in XenForo functions that expect only valid values.

This version also fixes a compatibility issue with Elasticsearch 7.x versions.

Version: 3.1.3 Release date: 2020-04-16

The release fixes an accidental issue in version 3.1.0 including older files that caused JavaScript errors in the filter form. Please apply the version asap if you have installed the version 3.1.0. or above.

Version: 3.1.2 Release date: 2020-04-01

Text: The update fixes the error logged in the Server Error - "Unsupported operand types". The error would accure in cases of a forum not having configured any filterable custom fields.

Version: 3.1.1 Release date: 2020-03-28

The release fixes an accidental issue in the last version including older files that caused different PHP errors. Please apply the version asap if you have installed the version 3.1.0.

Version: 3.1.0 Release date: 2020-03-26

In some cases number type fields are used for data that does not require number formatting (eg if the custom field represents years, it should not be shown as &quot;2.020&quot; but &quot;2020&quot;. We have added an option that allows admins to list the IDs of such custom fields, and they will not be formatted in the output.

The release also fixes a bug that would log a PHP error in some cases if the option &quot;Total count indicator is active&quot;.

Important Note: If you are using several of our Filter add-ons, please disable them before applying the upgrade. Upgrade all add-ons and only after that enable the products.

Version: 3.0.4 Release date: 2020-03-13

The release fixes a bug with a Facet search showing the wrong number of matching results. The issue was related to Elasticsearch optimization considering only the top results, so the options that had fewer matching items would be shown as having no documents. The issue does not affect you if you are using MySQL as a search index or you are not using the Facet search option.

Version: 3.0.3 Release date: 2020-01-02

PHP error fix: Error: Call to undefined method XF\Mvc\Reply\Redirect::getParams() src/addons/AL/ResourceFilter/XFRM/Pub/Controller/Category.php:36

Version: 3.0.2 Release date: 2019-10-18

The version removes an accidental dependency on Thread Filter add-on.

Version: 3.0.1 Release date: 2019-10-18

This is a bug-fix release that removes the reference to Thread filter add-on

Version: 3.0.0 Release date: 2019-10-18

This is a major update with facet search support, total count indicator, location field support etc. Please check XenForo.com resource page for further details.

Version: 2.1.2 Release date: 2019-09-21

This release fixes a PHP error related to changes in Overview.php that were meant to be part of the major update but were accidently included in the minor update.

Version: 2.1.1 Release date: 2019-09-16

This is a minor release, that changes the way the add-on is using some of our shared PHP classes. From now on, the add-on will require a core library package from https://xenforo.com/community/resources/al-core-package.7382/ to be installed. Please download the package and install it before upgrading the add-on. Please upgrade all other AddonsLab add-ons you are using to their latest versions if you see an error in the Admin Panel about files with unexpected content.

Version: 2.1.0 Release date: 2019-05-03

The version fixes a PHP error caused by Elasticsearch 2.x incompatibility. Your installation is not affected by the issue if filtering brings any results with ES enabled. We have also implemented a new option to set Cache TTL controlling how long the results of the search should be cached in the MySQL database. Setting the option to 0 will disable the cache. The option should be used only to troubleshoot issues that could be caused by invalid cache.

Due to a limitation on how many items are returned by the initial search based on keywords (200 by default), their further filtering by category and custom fields could end up with a missing or incomplete list of found items. The issue is fixed now by raising the limit based on option "Maximum result count" (10000 by default).

Version: 2.0.0 Release date: 2019-04-25

This is a major update that implements all features and fixes we applied recently to our Thread Filter add-on. Here is the list of changes:

Enhancement: Multiple prefix filter
Enhancement: Show "Clear All" link in the filter bar when there are active filters or sorting
Enhancement: Support HTML in custom field option values in the list of active fields
UI enhancement: Show the label for numeric fields in active filter list in the mobile view
UI.X compatibility - Compatibility fix for UI.X themes, where custom field values would not be shown under resource title on mobile browsers.
New option: Disable some of the default fields - "Sort by" and "Created by"
Bug-fix: Sorting by a custom field requires "Allow Filter" to be active for the field
Bug-fix: Sorting by any custom field does not show the link to revert to the default sorting order as it does for default sorting options
Bug-fix: Sorting by a field shows items that don't have any value specified for the field
Bug-fix: direction=desc added to the URL when removing an active custom field filter
Bug-fix: Allow sorting by sortable fields only
Bug-fix: Prevent a PHP error from being shown in case star ratings are shown with an empty string value
Bug-fix: Prevent PHP error when field cache is missing for a category
Bug-fix: PHP error when saving resource category with the add-on being disabled
Bug-fix: resource list layout broken when removing on a page with "There are no resources matching your filters." message

Version: 1.6.1 Release date: 2019-03-12

The version includes a compatibility fix for Resource Manager 2.1.x. Due to the nature of the issue from now on each release will contain two files, one for Resource Manager 2.0.x and one for 2.1.x. Please make sure to download the correct package for your version.

Version: 1.6.0 Release date: 2019-02-03

The add-on is now tested and verified with XenForo 2.1.0 + XenForo Resource Manager 2.1.0 + XenForo Enhanced Search 2.1.0. This release also contains a minor fix for our customers who use Resource Filter with Thread Filter, which would cause one of the add-ons breaking when another one is uninstalled. This version is also fully compatible with XenForo 2.0.x version.

Version: 1.5.1 Release date: 2018-11-22

This is a bug-fix release the fixes the case of having incorrect results shown when two custom fields have identical values. As a result, the cache from the search results executed against one of the custom fields could be used when searching for the second custom field.

Version: 1.5.0 Release date: 2018-10-19

This version is further improvement of multiple choice field search configuration. Now, admins are able to set if the default match type for a field should be "Match all options" or "Match any option". This can be set in add/edit field page, under the sector "Options for choice fields".

Version: 1.4.0 Release date: 2018-10-12

The default behavior of the product to search multiple values of the same custom field is to find any items which match to any of the options selected. For example, if a resource item is created with the values of a custom field put as "option 1" and "option 2", and another resource item is created with the same custom field having a value "option 1" only, then a user filtering the list checking both "option 1" and "option 2" in the form would see both resource items in the results. With this update, we detect such cases and give users an additional selection field under the checkboxes allowing to change this behavior and find only the resources which have ALL instead of ANY selected options checked.

In this version, we have also changed the name of the URL parameter from "resource_fields" to "rf" so that the resulting URL is shorter. The old URLs will redirect to the new format using the 301 Permanent Redirect header.

Version: 1.3.3 Release date: 2018-10-10

This is a stability enhancement fixing PHP errors logged in the Admin Panel in the cases when a bot or a user would intentionally supply filter values which don't exist in the choices of a multiple-choice field. The error would be generated due to the system trying to find the phrase for the option and resulting in "Undefined index..." error.

Version: 1.3.2 Release date: 2018-07-26

This is a bug-fix release resolving some errors that customers may experience immediately after installation of the add-on when the information about the fields is not available yet (e.g. no custom fields configured yet).

Version: 1.3.1 Release date: 2018-07-01

This is a bug-fix release that solves the issue with Featured Resource block missing when Resource Filter add-on is activated.

Version: 1.3.0 Release date: 2018-06-27

This version introduced two substantial enhancements - ability to filter resources by keywords and by tags. Both features are configurable and can be turned off in product's options. Keyword search can be configured to search in resource title only or both title and the description. Both fields support AJAX mode. In the background, XenForo search engine and the cache is used to filter the resources.

Version: 1.2.2 Release date: 2018-05-14

In this release we have optimized the product for the boards which use custom fields with thousands of possible choices.

Version: 1.2.1 Release date: 2018-05-05

This is a bug fix release, that solves the issue with filter form disappearing when Auto Reload is enabled and the form is above resource list.

Version: 1.2.0 Release date: 2018-03-30

This is the next version with another enhancement planned - sorting resource list by custom field values. The fields with numeric representation (numbers, date, rating) will now be available in sort options for a category where they are available. The fields can be chosen to be added to the list from Edit Field page.

Here is a link showing sorted resource list - https://xf2.addonslab.com/index.php?resources/categories/filter-in-sidebar.6/&order=resource_fields_field_8&direction=desc

This version also implements a setting for admins to choose where in Filters form to show the custom fields. The possible options are:

Before "Type" Before "Prefixes" Before "Created By" Before "Sort By" After "Sort By"

Version: 1.1.1 Release date: 2018-03-10

This is a bug-fix version, which solves the problem of auto-reloading not working due to a missing JavaScript file

Version: 1.1.0 Release date: 2018-03-08

In this version, we have implemented Auto Reload option via AJAX.

Any change in the filter form will update the list of resources via AJAX and show the filtered list along with active filters. Clicking on active filters on top of the list will remove the filter and update the list without a full page reload as well.

At the same time, current URL keeps updating with the latest filter data, so users can just copy the URL and send it via IM and the URL will represent their currently filtered list (supported in modern browsers only).

Please note, that activating "Auto Reload" feature server load will increase considerably if you have too many resources. Every update of the list causes two AJAX queries, one of them running the search engine to get the filtered resource list.

Feel free to test the filtering on our demo board at https://xf2.addonslab.com/index.php?resources/&direction=desc

This version already fixes a bug with missing prefix and other built-in filters when the filter form is moved to the sidebar.

Version: 1.0.0 Release date: 2018-02-28

Initial version