PLUGINS FOR WORDPRESS

User Documentation

Expand your design and development possibilities in WordPress with tools built to boost your creativity and streamline your workflow.

Installation

  1. Log in to your WordPress admin dashboard.

  2. Navigate to Plugins → Add New Plugin.

  3. Click Upload Plugin.

  4. Select the Nexu Filter ZIP file.

  5. Click Install Now.

  6. Once installed, click Activate Plugin.

After activation, Nexu Filter will appear in your WordPress admin sidebar.

License Activation

Nexu Filter requires an active, verified license to create or save filters.

  1. Navigate to Nexu Filter → License.

  2. Enter the license key provided after your purchase.

  3. Click Activate.

  4. Verify that the status displays License Active.

You can also check your license status and deactivate your license from this section when necessary.

Creating a Filter

To get started, navigate to Nexu Filter → Add Filter.

General Settings

Filter Name

Enter a descriptive name to identify your filter in the WordPress dashboard.

AND / OR Logic

Choose how active terms should be combined:

  • OR: Displays content matching any of the selected terms.

  • AND: Displays content matching all selected terms.

Loop CSS Selector (Optional)

Connect your filter to a specific Post Loop Builder using a CSS class or ID.
Example: #services-loop

If left empty, Nexu Filter will target the first Oxygen loop located after the shortcode.

Adding Tabs

Tabs allow you to organize groups of categories and terms.

  1. Click Add New.

  2. Enter an internal name to identify the tab.

  3. Define the visible tab label.

  4. Select the categories or terms you want to include.

  5. Enable the Active option to set the tab as the default selection.

You can add multiple tabs, reorder them by dragging, or remove tabs you no longer need.

Selecting Categories and Taxonomies

Nexu Filter detects public taxonomies registered in WordPress, including those created with Secure Custom Fields (SCF).
Select the terms you want to include in each tab.

Once your configuration is complete, click Add Filter or Save Filter, depending on the action.

Design & Customization

Navigate to Nexu Filter → Styles and select the filter you want to customize.

Nexu Filter allows you to configure tab buttons and category buttons independently.

Available Styles

StyleDescription
SquareRectangular buttons
PillFully rounded pill-shaped buttons
Square OutlineRectangular buttons with an outline
Pill OutlineRounded buttons with an outline
Text OnlyButtons without a visible container

Customization Options

Colors

Configure default, hover, active, and background colors.

Typography

Choose the font family, size, and weight for each button group.

Spacing

Control the distance between buttons using the Gap setting, measured in pixels.

Styles are managed independently for tabs and categories, allowing you to establish different visual hierarchies.

Save your changes to apply them to the selected filter.

Interaction Settings

Navigate to Nexu Filter → Interaction and select the filter you want to configure.

Tab Interaction

Each tab includes an activation control and links associated with its terms.
These links use the ?filter= parameter followed by the term slug, allowing direct links to a compatible filter selection.

Filter Selection

Limit the selection to one active category at a time.
When disabled, users can select multiple terms.

Hide Empty Categories

Hides categories that have no available items within the loaded content.

Hide Empty Tabs

Hides tabs whose categories contain no available results.

All

Adds an optional All tab, used as the initial view to display all content.

Hide Clear All

Allows you to hide the control that clears all active filter selections.
After configuring these options, click Save Interaction.

Oxygen Builder Integration

Nexu Filter integrates with Post Loop Builder using a shortcode.

Step 1. Prepare Your Content

Open your page in Oxygen Builder and configure the Post Loop Builder with the content you want to display.
Make sure your posts have the appropriate categories or taxonomy terms assigned.

Step 2. Get the Shortcode

In WordPress, navigate to Nexu Filter → All Filters.
Find your filter and copy its shortcode.

Example:
[nexo_filter id="123"]

The number 123 is for illustration purposes only. Use the actual ID of your filter.

Step 3. Insert the Shortcode

Inside Oxygen Builder, add an element that supports WordPress shortcode execution.
Paste the shortcode and position it before the Post Loop Builder you want to filter.

Step 4. Connect the Loop

If your page contains multiple Post Loop Builders, assign a CSS class or ID to the corresponding loop.
Then enter that selector in the Loop CSS Selector field in Nexu Filter.

This explicitly identifies which loop should respond to the filter.

Step 5. Test the Filter

Save your changes and open the published page.
Select different tabs and categories to verify that the results update correctly.
Nexu Filter uses the Isotope instance associated with Oxygen to reorganize the available elements.

Managing Filters

Navigate to Nexu Filter → All Filters to view your existing filters and their shortcodes.

This section allows you to access, edit, or delete existing filters.
To modify a filter, open its configuration, make the necessary changes, and save.

You can reuse a filter through its shortcode in different compatible locations.

Filtering Limitations

Nexu Filter works with elements that are already loaded on the page.

It does not load additional posts via AJAX.

This means:

  • Filtering happens without reloading the page.

  • Results update among the elements available in the loaded loop.

  • Posts from other pagination pages are not retrieved.

  • Native Oxygen Builder pagination is not modified.

To ensure complete results for a particular set of posts, consider how many elements the Post Loop Builder initially loads.

Troubleshooting

The Filter Does Not Appear

Verify that the shortcode is correct, the filter has configured tabs, and it has been inserted into an element that supports shortcodes.

Results Do Not Update

Make sure you are using a compatible Post Loop Builder, your terms are correctly assigned, and the CSS selector points to the intended loop.

Some Categories Are Missing

Check the Hide Empty Categories and Hide Empty Tabs options in the Interaction settings.

I Cannot Save a Filter

Navigate to License and verify that your license is active and verified. Version requires this condition to create or save filters.

Results Do Not Include Posts from Other Pages

This is expected behavior in Nexu Filter, which filters only the elements currently loaded on the page.

Licenses & Updates

Nexu Filter is available in two licensing plans:

Individual License — 1 Website
Allows activation on one website.

Agency License — 10 Websites
Allows activation on up to ten websites.

Both plans include the same features.

Commercial Update Policy: Your purchase includes updates throughout the 1.x major version lifecycle, with no annual renewal required. Future major releases, such as Nexu Filter 2.0, require a new license.

Technical Support

For questions related to installation, license activation, compatibility, or Nexu Filter functionality, contact technical support.

Email: soporte@manuelrosique.com

When requesting assistance, we recommend including your WordPress version, Oxygen Builder version, Nexu Filter version, and a description of the issue.

Need a Custom Solution?

I also develop custom plugins and tools tailored to your project.
Manuel Rosique / Creative Brand / UX/UI Developer Manuel Rosique / Creative Brand / UX/UI Developer