# 🚀 Advanced Widget Kit - Free Version

[![WordPress](https://img.shields.io/badge/WordPress-5.0%2B-blue.svg)](https://wordpress.org/)
[![Elementor](https://img.shields.io/badge/Elementor-3.0%2B-pink.svg)](https://elementor.com/)
[![PHP](https://img.shields.io/badge/PHP-7.4%2B-purple.svg)](https://php.net/)
[![License](https://img.shields.io/badge/License-GPL%20v2-green.svg)](https://www.gnu.org/licenses/gpl-2.0.html)

**Powerful Elementor widgets collection to supercharge your website building experience with advanced features and beautiful designs.**

---

## 📋 Table of Contents

- [Features](#-features)
- [Installation](#-installation)
- [Free Widgets](#-free-widgets)
- [Usage](#-usage)
- [Requirements](#-requirements)
- [Screenshots](#-screenshots)
- [Development](#-development)
- [Contributing](#-contributing)
- [Support](#-support)
- [License](#-license)

---

## ✨ Features

### 🎯 **Core Features**
- **5 Professional Widgets** - Advanced functionality without complexity
- **Easy to Use** - Drag and drop interface with Elementor
- **Fully Responsive** - Perfect on all devices and screen sizes
- **Performance Optimized** - Lightweight and fast loading
- **Translation Ready** - Compatible with WPML and translation plugins
- **Regular Updates** - Continuous improvements and new features

### 🎨 **Design Features**
- **Modern UI** - Clean and professional admin dashboard
- **Customizable** - Extensive styling options for each widget
- **Widget Toggle System** - Enable/disable widgets for better performance
- **Live Preview** - See changes instantly in Elementor editor

### 🔧 **Technical Features**
- **OOP Architecture** - Clean, maintainable code structure
- **WordPress Standards** - Follows all WordPress coding guidelines
- **Security Focused** - Proper sanitization and security measures
- **Extensible** - Ready for Pro version integration

---

## 📦 Installation

### Automatic Installation (Recommended)
1. Download the plugin zip file
2. Go to `WordPress Admin → Plugins → Add New`
3. Click "Upload Plugin" and select the zip file
4. Click "Install Now" and then "Activate"

### Manual Installation
1. Download and extract the plugin files
2. Upload the `advanced-widget-kit` folder to `/wp-content/plugins/`
3. Activate the plugin through the WordPress admin

### After Installation
1. Go to `Advanced Widget Kit → Dashboard` in WordPress admin
2. Enable the widgets you want to use
3. Start building with new widgets in Elementor editor

---

## 🎨 Free Widgets

### 1. 🔘 **Advanced Button Widget**
- **Gradient Backgrounds** - Beautiful color transitions
- **Custom Icons** - Font Awesome integration with positioning
- **Hover Effects** - Multiple animation options
- **Size Variants** - XS, SM, MD, LG, XL sizes
- **Advanced Styling** - Borders, shadows, typography control

### 2. 💬 **Testimonial Widget**
- **Single & Carousel Modes** - Display one or multiple testimonials
- **Star Ratings** - Visual rating system (0-5 stars)
- **Client Photos** - Professional image display
- **Carousel Features**:
  - Autoplay with speed control
  - Navigation arrows and dots
  - Touch/swipe support
  - Multiple slides display (1-3)
  - Pause on hover

### 3. 💰 **Pricing Table Widget**
- **Professional Design** - Clean pricing display
- **Feature Lists** - Highlight plan benefits
- **Call-to-Action Buttons** - Integrated button system
- **Responsive Layout** - Mobile-optimized design

### 4. 🖼️ **Image Box Widget**
- **Hover Effects** - Zoom, slide-up, fade animations
- **Overlay Content** - Text over images
- **Link Integration** - Clickable image boxes
- **Responsive Images** - Optimized for all devices

### 5. 📋 **Icon List Widget**
- **Custom Icons** - Font Awesome support
- **Repeater Field** - Add unlimited list items
- **Link Support** - Clickable list items
- **Flexible Styling** - Colors, spacing, typography

---

## 🚀 Usage

### Basic Usage
1. **Open Elementor Editor** on any page/post
2. **Find "Advanced Widget Kit"** category in the widget panel
3. **Drag widgets** to your desired location
4. **Customize settings** in the left panel
5. **Publish** your changes

### Widget Management
- Go to `Advanced Widget Kit → Dashboard`
- Use toggle switches to enable/disable widgets
- Disabled widgets won't load (better performance)
- View system information and plugin stats

### Pro Version
- **15+ Premium Widgets** available in Pro version
- **Advanced Templates** and design options
- **Priority Support** and regular updates
- [**Upgrade to Pro →**](https://awk.ainixit.com/)

---

## 📋 Requirements

- **WordPress:** 5.0 or higher
- **Elementor:** 3.0.0 or higher (Free or Pro)
- **PHP:** 7.4 or higher
- **MySQL:** 5.6 or higher
- **Memory:** 128MB minimum (256MB recommended)

---

## 📸 Screenshots

### Dashboard
![Advanced Widget Kit Dashboard](https://via.placeholder.com/800x500/667eea/ffffff?text=Dashboard+Screenshot)

### Button Widget
![Advanced Button Widget](https://via.placeholder.com/800x300/4caf50/ffffff?text=Button+Widget+Demo)

### Testimonial Carousel
![Testimonial Carousel](https://via.placeholder.com/800x400/ff9800/ffffff?text=Testimonial+Carousel+Demo)

### Pricing Table
![Pricing Table Widget](https://via.placeholder.com/600x500/e91e63/ffffff?text=Pricing+Table+Demo)

---

## 🛠️ Development

### File Structure
```
advanced-widget-kit/
│
├── 📄 advanced-widget-kit.php          # Main plugin file
├── 📄 readme.txt                  # WordPress.org description
├── 📄 uninstall.php              # Cleanup on uninstall
│
├── 📁 assets/                     # CSS, JS, Images
├── 📁 includes/                   # Core PHP classes
├── 📁 widgets/free/               # Free widget classes
├── 📁 widgets/pro/                # Pro widgets (empty in free)
├── 📁 templates/free/             # Demo templates
└── 📁 admin/                      # Dashboard files
```

### Development Setup
1. Clone this repository
2. Install WordPress locally
3. Symlink or copy plugin to `/wp-content/plugins/`
4. Activate plugin and start developing

### Coding Standards
- **WordPress Coding Standards** - All PHP code follows WP standards
- **Elementor Best Practices** - Widget development guidelines
- **Security First** - Proper sanitization and validation
- **Performance Optimized** - Efficient database queries and asset loading

---

## 🤝 Contributing

We welcome contributions! Here's how you can help:

### 🐛 **Bug Reports**
- Use GitHub Issues to report bugs
- Include WordPress, Elementor, and PHP versions
- Provide steps to reproduce the issue

### 💡 **Feature Requests**
- Suggest new widgets or improvements
- Explain the use case and benefits
- Check existing issues to avoid duplicates

### 🔧 **Pull Requests**
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

### 📝 **Development Guidelines**
- Follow WordPress coding standards
- Add proper documentation and comments
- Test on multiple WordPress/Elementor versions
- Ensure backward compatibility

---

## 🆘 Support

### 📚 **Documentation**
- [Plugin Documentation](https://awk.ainixit.com/docs/advanced-widget-kit)
- [Video Tutorials](https://www.youtube.com/c/AinixIT)
- [Troubleshooting Guide](./TROUBLESHOOTING.md)

### 💬 **Community Support**
- [WordPress.org Support Forum](https://wordpress.org/support/plugin/advanced-widget-kit)
- [GitHub Issues](https://github.com/ainixit/Free-advanced-widget-kit/issues)

### 🎯 **Premium Support**
- Pro users get priority email support
- [Upgrade to Pro](https://awk.ainixit.com/) for premium support

---

## 🏢 About Ainix IT

**Advanced Widget Kit** is developed by [**Ainix IT**](https://awk.ainixit.com) - a team of experienced WordPress developers dedicated to creating high-quality plugins and themes.

### 🌐 **Connect With Us**
- **Website:** [awk.ainixit.com](https://awk.ainixit.com)
- **Twitter:** [@ainixit](https://twitter.com/ainixit)
- **Facebook:** [Ainix IT](https://facebook.com/ainixit)
- **YouTube:** [Ainix IT Channel](https://www.youtube.com/c/AinixIT)

---

## 📄 License

This project is licensed under the **GPL v2 or later** - see the [LICENSE](LICENSE) file for details.

```
Advanced Widget Kit - Free Version
Copyright (C) 2024 Ainix IT

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
```

---

## 🎉 Thank You!

Thank you for using **Advanced Widget Kit**! If you find this plugin helpful, please:

- ⭐ **Star this repository**
- 🔄 **Share with others**
- 📝 **Leave a review** on WordPress.org
- 🚀 **Consider upgrading to Pro** for more features

---

<div align="center">

**Made with ❤️ by [Ainix IT](https://awk.ainixit.com)**

[![WordPress](https://img.shields.io/badge/WordPress-Ready-blue?style=for-the-badge&logo=wordpress)](https://wordpress.org/)
[![Elementor](https://img.shields.io/badge/Elementor-Compatible-pink?style=for-the-badge&logo=elementor)](https://elementor.com/)

</div>