# Taxonomy Filter Lite Widget

Free taxonomy filter widget for Elementor Pro with dropdown filtering and seamless Loop Grid integration.

## Overview

The **Taxonomy Filter Lite** widget provides dropdown filtering functionality for Elementor Pro's Loop Grid. It's the free version of our premium Taxonomy Filter Plus widget.

## Features

### 🎯 Display Types

-   **Dropdown**: Single-select dropdown with placeholder support, hierarchy, and customizable icon

**Want more display types?** [Upgrade to Taxonomy Filter Plus](https://evolutionwidgetsplus.com/widgets/taxonomy-filter-plus/) to unlock:

-   Multi-Select dropdowns
-   Interactive Buttons
-   Checkboxes
-   Radio Buttons

### 🔧 Smart Integration

-   **Dynamic Taxonomy Loading**: Automatically loads taxonomies based on Loop Grid post type
-   **Progressive Setup UX**: Step-by-step widget configuration matching Elementor Pro's behavior
-   **Seamless Loop Grid Integration**: Works perfectly with Elementor Pro's Loop Grid widget
-   **URL Parameter Support**: Bookmarkable filtered states with proper browser navigation

### ⚙️ Advanced Options

-   **Hierarchy Support**: Display parent-child relationships with visual indentation
-   **Hierarchy Depth Control**: Limit the number of hierarchy levels displayed (top level only, 1-10 levels deep, or all levels)
-   **Customizable Hierarchy Indent**: Adjust the indentation spacing for hierarchical terms
-   **Smart Hierarchy Controls**: "Show Hierarchy" toggle automatically disabled for non-hierarchical taxonomies (e.g., tags), with dependent controls hidden via native conditions
-   **Empty Terms Control**: Option to show/hide terms with no associated posts
-   **Ordering Options**: Sort terms by name, slug, or ID in ascending/descending order
-   **Placeholder Text**: Customizable placeholder text for dropdown fields
-   **Unified Select Controls**: Consistent width and height controls
-   **Dropdown Icon Customization**: Choose any icon from Elementor's library

### 🎨 Professional Styling

-   **Full Control Styling**: Typography, colors, borders, padding, margins for all form elements
-   **Dropdown Icon Customization**: Choose any icon from Elementor's library or upload custom SVG with full styling controls (size, color, position)
-   **Responsive Design**: All controls work across mobile, tablet, and desktop breakpoints
-   **Accessibility Features**: Focus states, high contrast support, reduced motion compatibility
-   **Clean Architecture**: Separation between base SCSS styles and dynamic Elementor controls

## Installation & Setup

### Prerequisites

-   WordPress 5.0 or higher
-   PHP 7.4 or higher
-   Elementor 3.0.0 or higher
-   **Elementor Pro OR Pro Elements** (required for Loop Grid functionality)

### Installation Steps

1. Download the plugin from WordPress.org or your account
2. Go to WordPress Admin → Plugins → Add New → Upload Plugin
3. Choose the zip file and click "Install Now"
4. Activate the plugin

### Quick Start

1. **Add a Loop Grid Widget**: First, add an Elementor Pro Loop Grid widget to your page
2. **Add the Taxonomy Filter Lite**:
    - In the Elementor editor, search for "Taxonomy Filter Lite" in the widget panel
    - Or find it in the **General** category
    - Drag it to the same page as your Loop Grid
3. **Configure the Filter**:
    - Select the Loop Grid widget you want to filter
    - Choose the taxonomy to filter by (automatically loaded based on post type)
    - Select your preferred display type
    - Configure additional options as needed

## Upgrade to Plus

Get access to premium display types and advanced features:

-   **Multi-Select**: Multiple term selection with AND/OR logic
-   **Buttons**: Interactive buttons with single or multiple selection modes
-   **Checkboxes**: Checkbox list for multiple term selection
-   **Radio Buttons**: Radio button list for single term selection
-   **Clear Selection Button**: Optional clear button for multi-select types
-   **Advanced Layout Controls**: Flexbox layout system with direction, alignment, spacing controls

[Upgrade to Taxonomy Filter Plus →](https://evolutionwidgetsplus.com/widgets/taxonomy-filter-plus/)

## Technical Implementation

### Widget Class

```php
\RPWS\Plugins\Taxonomy_Filter_Lite\Taxonomy_Filter_Lite
```

### Assets

-   **CSS**: `taxonomy-filter-lite.css` / `taxonomy-filter-lite.min.css`
-   **JavaScript**: `taxonomy-filter-lite.js` / `taxonomy-filter-lite.min.js`
-   **Editor**: `editor.js` / `editor.min.js`

### Dependencies

-   **Elementor**: 3.0.0+ required
-   **Elementor Pro/Pro Elements**: Required for Loop Grid functionality
-   **WordPress**: 5.0+ (tested up to 6.4)
-   **PHP**: 7.4+ (recommended: PHP 8.0+)

## Support & Documentation

-   **Author**: Rodrigo Salles
-   **Company**: R.Project Web Studio
-   **Text Domain**: `rpws-ew-taxonomy-filter-lite`
-   **Support**: [WordPress.org Support Forum](https://wordpress.org/support/plugin/rpws-taxonomy-filter-lite/)

## License

This plugin is licensed under the **GPL v2 or later**.

---

**Ready to enhance your Elementor Pro filtering experience?** The Taxonomy Filter Lite widget provides professional dropdown filtering with seamless integration. [Upgrade to Plus](https://evolutionwidgetsplus.com/widgets/taxonomy-filter-plus/) for advanced display types!