FacetWP Plugin Overview

—

## **Key Features of FacetWP**
1. **Dynamic Filtering:** Filters posts/products without reloading the page (AJAX-based).
2. **Multiple Facet Types:** Offers checkboxes, dropdowns, sliders, search boxes, date pickers, and more.
3. **Works with Custom Post Types & Custom Fields:** Compatible with Advanced Custom Fields (ACF), WooCommerce, and other custom setups.
4. **Supports Shortcodes & Widgets:** Easily integrates with WordPress themes using shortcodes.
5. **Performance-Oriented:** Uses its own index table for **fast filtering**, even on large datasets.
6. **Integration with Popular Plugins:** Works well with Elementor, Beaver Builder, Oxygen, WP Grid Builder, and more.

—

## **How to Use FacetWP in WordPress**
### **1. Install and Activate FacetWP**
– Purchase and download **FacetWP** from [facetwp.com](https://facetwp.com/).
– Go to **WordPress Admin → Plugins → Add New** and upload the FacetWP ZIP file.
– Activate the plugin.

—

### **2. Create Facets (Filters)**
– Navigate to **WP Admin → FacetWP → Facets**.
– Click **"Add New"** and set the following:
– **Name:** (e.g., "Category Filter")
– **Type:** (Dropdown, Checkbox, Range, etc.)
– **Data Source:** Select the taxonomy, custom field, or meta key to filter.
– **Other settings:** Customize based on your needs.
– Click **"Save Changes"** and then **"Re-index"** to update data.

—

### **3. Add FacetWP Filters to a Page**
– **Using Shortcodes:**
– Add `[facetwp facet="your_facet_name"]` where you want the filter.
– Example:

<h3>Filter by Category:</h3>
    [facetwp facet="category_filter"]

– **Using Elementor/Oxygen/Other Page Builders:**
– Add a "Text" or "Shortcode" widget.
– Insert the `[facetwp facet="your_facet_name"]` shortcode.

—

### **4. Set Up a Listing Template**
– Go to **FacetWP → Settings → Template** and choose:
– **WordPress Archive:** Default post loop.
– **Page Builders:** Works with Elementor, Oxygen, etc.
– **Custom Query:** If you're using a custom WP_Query.

—

### **5. Enable AJAX Filtering**
– FacetWP automatically updates results via AJAX.
– No page refresh is needed when selecting filters.

—

## **Example: Using FacetWP with WooCommerce**
To filter WooCommerce products:
1. **Create a Facet for Product Categories**
– Name: `product_category`
– Type: **Checkbox**
– Data Source: `product_cat` (WooCommerce category)
2. **Create a Facet for Price Range**
– Name: `price_filter`
– Type: **Slider**
– Data Source: `_price`
3. **Add Shortcodes on Shop Page**

<h3>Filter Products</h3>
   [facetwp facet="product_category"]
   [facetwp facet="price_filter"]

—

## **Final Thoughts**
FacetWP is an **excellent solution for advanced filtering** on WordPress sites, especially if you are working with WooCommerce, custom post types, or large datasets. It speeds up filtering with AJAX and works seamlessly with **ACF, Elementor, and Gutenberg**.

Would you like help setting it up for a specific use case? 🚀

—

## **🔍 1. Check if FacetWP is Installed and Activated**
– Go to **WP Admin → Plugins** and ensure that **FacetWP** is **active**.
– If using a **page builder** (Elementor, Oxygen, etc.), check if **FacetWP Integration** is enabled in the plugin settings.

—

## **🔍 2. Confirm Facet Settings**
– Navigate to **WP Admin → FacetWP → Facets**.
– Click on your facet (dropdown type) and ensure:
– **Facet Type** is set to **Dropdown**.
– **Data Source** is correctly assigned (e.g., **Taxonomy: Categories** or **Custom Field**).
– **Values exist** in the chosen data source.

💡 **Example Configuration:**
– **Name:** category_filter
– **Type:** Dropdown
– **Data Source:** `category` (or `product_cat` for WooCommerce)
– **Sort Order:** Display options correctly

🚀 **Re-index after changes**:
Go to **FacetWP → Settings → Re-index** and click **"Re-index"** to update data.

—

## **🔍 3. Ensure the Dropdown is Placed Inside a FacetWP Loop**
FacetWP **only works within its loop**. If the dropdown is placed outside a valid query, it won't display.

– **Correct Placement (Inside WP Query or Archive Page)**:

[facetwp template="your_template"]

[facetwp facet="category_filter"]

– **If using Elementor**:
– Add **FacetWP Listing Widget**.
– Insert **Facet Shortcode** `[facetwp facet="your_facet_name"]`.

—

## **🔍 4. Check for JavaScript Errors**
FacetWP relies on JavaScript (AJAX) for dropdowns.
– Open **Developer Console** (Press **F12 → Console**).
– Look for any **JS errors** related to FacetWP.
– If errors exist, try **disabling caching and minification**.

—

## **🔍 5. Enable FacetWP Auto-Initialization**
If dropdowns are not appearing, **force FacetWP to load properly**:
1. Go to **WP Admin → FacetWP → Settings**.
2. Enable **"Auto-Initialize on Page Load"**.

Alternatively, manually trigger initialization in JavaScript:

(function($) {
    $(document).on('facetwp-loaded', function() {
        FWP.auto_refresh();
    });
})(jQuery);

Place this in **footer.php** or add it via a custom script.

—

## **🔍 6. Clear Cache and Re-index**
– If using **Cloudflare, WP Rocket, or W3 Total Cache**, **purge cache**.
– Go to **FacetWP → Settings → Re-index**.
– Click **"Re-index"** and refresh the page.

—

## **🔍 7. Try a Default WordPress Theme**
– Some themes may conflict with FacetWP.
– Switch to a default theme (e.g., **Twenty Twenty-Four**).
– Test if the dropdown appears.

—

### **💡 Conclusion**
✅ If the dropdown still does not show:
– **Re-index** FacetWP.
– **Ensure correct placement** inside a **FacetWP template**.
– **Disable caching/minification**.
– **Check JS console for errors**.
– **Try a default theme**.

Let me know if you need specific debugging help! 🚀

### **1. Ensure FacetWP is Active and Indexed**
– **Go to:** `WP Admin → FacetWP → Settings`
– Click **"Re-index"** to update FacetWP data.
– Clear the **cache** if using caching plugins.

—

### **2. Correct Placement of Shortcode**
You need to place the facet inside a FacetWP template or a post loop:

✅ **Example Placement:**

[facetwp facet="marke_copy"]

Make sure this is **inside a FacetWP template**:

[facetwp template="your_template"]
[facetwp facet="marke_copy"]
[/facetwp]

—

### **3. Check Data Source (Kategorie)**
Your facet uses **"Kategorien (category)"**. If there are no assigned terms, it won't show options.

**Steps to verify:**
– **Go to:** `Posts → Categories`
– Check if categories exist and are assigned to posts.
– If using WooCommerce, ensure `product_cat` is selected instead of `category`.

—

### **4. Check JavaScript Errors**
FacetWP uses AJAX for filters. If JavaScript is broken, the dropdown won't appear.

1. Open **Developer Console** (`F12` → `Console`).
2. Look for errors related to `facetwp.js`.
3. Try disabling caching or minification plugins.

—

### **5. Try a Default Theme**
Sometimes, themes conflict with FacetWP.

– Switch to **Twenty Twenty-Four**.
– Check if the dropdown appears.

—

### **6. Enable FacetWP Auto-Initialization**
– Go to **WP Admin → FacetWP → Settings**.
– Enable **"Auto-Initialize on Page Load"**.

Alternatively, trigger it manually:

(function($) {
    $(document).on('facetwp-loaded', function() {
        FWP.auto_refresh();
    });
})(jQuery);

Place this in **footer.php** or a custom script.

—

### **7. Check Parent Term Setting**
– You left **Parent Term** empty.
– If the taxonomy is hierarchical, try **setting a parent category**.

—

### **8. Clear Cache & Re-index**
– **Purge Cloudflare / WP Rocket / W3 Total Cache**.
– **Re-index FacetWP** (`WP Admin → FacetWP → Settings → Re-index`).

—

### **Conclusion**
✅ **Try these steps in order:**
1. **Re-index FacetWP**.
2. **Check if categories exist**.
3. **Ensure shortcode is inside a FacetWP template**.
4. **Check for JavaScript errors**.
5. **Switch to a default theme**.
6. **Enable Auto-Initialize**.

If the issue persists, let me know your **theme and page builder (Elementor, Divi, etc.)**, and I’ll suggest more fixes! 🚀

—

## ✅ **1. Ensure FacetWP is Indexed**
Go to **WP Admin → FacetWP → Settings** and click **"Re-index"**. This refreshes FacetWP’s data.

—

## ✅ **2. Check if Data Exists**
Your facet is using **"Kategorien (category)"** as the data source. If there are no assigned posts, it won’t show options.

– **Go to:** `Posts → Categories`
– **Make sure categories have posts assigned.**
– If using WooCommerce, ensure it’s using `product_cat` instead of `category`.

—

## ✅ **3. Manually Trigger FacetWP**
FacetWP uses AJAX, and sometimes it doesn’t auto-initialize. Try adding this script in the footer:

(function($) {
    $(document).on('facetwp-loaded', function() {
        FWP.auto_refresh();
    });
})(jQuery);

This ensures FacetWP initializes properly.

—

## ✅ **4. Test in a FacetWP Template**
Try placing the facet inside a FacetWP template:

[facetwp template="your_template"]
    [facetwp facet="marke_copy"]
[/facetwp]

If the dropdown shows inside a template but not outside, the issue is theme-related.

—

## ✅ **5. Check Console Errors**
1. Open **Developer Tools** (`F12` → `Console`).
2. Look for JavaScript errors, especially from `facetwp.js`.
3. If errors exist, try disabling caching and minification plugins.

—

## ✅ **6. Ensure FacetWP is Loaded**
Manually force FacetWP’s JavaScript to load by adding this to **functions.php**:

add_filter( 'facetwp_load_assets', '__return_true' );

If this fixes the issue, your theme was preventing FacetWP from loading.

—

## ✅ **7. Check Theme or Page Builder Conflicts**
If using **Elementor, Divi, or Avada**, try switching to **Twenty Twenty-Four** and see if the dropdown appears.

—

## 🔍 **Final Checks**
– **Re-index FacetWP** (important).
– **Ensure categories have assigned posts**.
– **Check for JavaScript errors** (`F12 → Console`).
– **Try a default theme**.
– **Manually trigger FacetWP with JS**.

If it’s still empty, let me know:
– Your **theme**
– If using **Elementor, Divi, or another builder**
– If using **WooCommerce or custom post types**.

I’ll help with more tailored fixes! 🚀

—

## ✅ **Fix 1: Wrap Your Facet in a FacetWP Template**
FacetWP needs a listing template to function. Try this:

[facetwp template="your_template"]
    [facetwp facet="marke_copy"]
[/facetwp]

### **How to Create a Template:**
1. **Go to:** `WP Admin → FacetWP → Templates`
2. **Create a new template**
– Name: `your_template`
– Set **Query Type** (e.g., "Posts" or "Products" for WooCommerce).
– Configure filters as needed.
3. **Click Save & Re-index Facets.**
4. Use `[facetwp template="your_template"]` in your page.

—

## ✅ **Fix 2: Add FacetWP Class to Your Loop**
If you’re using a custom WP_Query loop, wrap it in `facetwp-template`:

<div class="facetwp-template">
    <?php while (have_posts()) : the_post(); ?>
        <h2><?php the_title(); ?></h2>
    <?php endwhile; ?>
</div>

This tells FacetWP where to apply filtering.

—

## ✅ **Fix 3: Ensure AJAX is Enabled**
– **Go to:** `WP Admin → FacetWP → Settings`
– **Enable** "Auto-refresh" and "Use AJAX".

—

## ✅ **Fix 4: Check for JavaScript Conflicts**
1. **Open Console (`F12` → Console)**
2. Look for errors from `facetwp.js`
3. Try disabling caching/minification plugins.

—

### **Final Steps:**
1. **Ensure a FacetWP template exists**.
2. **Wrap your post loop in `facetwp-template`**.
3. **Enable AJAX in settings**.
4. **Re-index FacetWP**.

Let me know if you need help applying this in your theme or page builder! 🚀

### ✅ **Fix: Force FacetWP to Recognize the Listing**
Try adding this CSS class inside your Avada Theme Builder **Code Block** where your listing (blog/grid/portfolio) appears:

<div class="facetwp-template">
    <!-- Your Avada Post/Portfolio/Products Grid -->
    [your_avada_grid_shortcode]
</div>

If you’re using Avada’s Post or Product Grid, wrap it like this:

<div class="facetwp-template">
    [fusion_blog layout="grid" columns="3"]
</div>

—

### ✅ **Fix: Use FacetWP’s Avada Integration**
FacetWP has a dedicated integration for Avada. Try this:
1. **Go to:** `WP Admin → FacetWP → Settings`
2. **Check for an Avada integration setting.**
3. If it exists, enable it and re-index FacetWP.

—

### ✅ **Fix: Manually Initialize FacetWP in Avada**
If your dropdown still doesn’t show, add this **JavaScript** inside Avada's Custom Scripts area:

(function($) {
    $(document).on('facetwp-loaded', function() {
        FWP.auto_refresh();
    });
})(jQuery);

– Go to **Avada → Options → Custom Scripts**.
– Add the script in the **Footer Scripts** section.

—

### ✅ **Final Steps:**
1. **Wrap your Avada grid inside `facetwp-template`**.
2. **Re-index FacetWP** (`WP Admin → FacetWP → Settings → Re-index`).
3. **Ensure AJAX is enabled** in FacetWP.
4. **Check JavaScript errors** in Console (`F12 → Console`).

If it still doesn’t work, let me know:
– Are you filtering **Posts, Products (WooCommerce), or Portfolio items**?
– Are you using Avada's **Blog/Portfolio/Product Grid** or a custom loop?

I’ll provide more specific help! 🚀