# Bizzmudra

A powerful, lightweight multi-currency switcher plugin for WooCommerce that allows customers to view prices in their preferred currency.

## Features

- 🌍 Add multiple currencies to your WooCommerce store
- 💱 Manually set and manage exchange rates
- 🔄 Simple and intuitive currency switcher
- 🛒 Automatic price conversion across shop, cart, and checkout
- 📱 Responsive and mobile-friendly
- ⚡ Lightweight and performance-optimized
- 🎨 Compatible with all WooCommerce themes
- 🧩 Widget and shortcode support
- 📍 **Flexible display positions** (Shop Page, Footer, Floating Left/Right)
- 🎯 **Product page control** - Show/hide on individual product pages
- 🔧 **Fully customizable** - Complete control over switcher placement
- ✅ **Currency selection** - Choose which currencies to display on frontend
- ⬆️ **Smart dropdown** - Opens upward in footer to stay visible

## Installation

1. Upload the plugin files to `/wp-content/plugins/bizzmudra`
2. Activate the plugin through the WordPress admin panel
3. Navigate to **WooCommerce → Multi Currency**
4. Add currencies and set exchange rates
5. Display the switcher using `[bizzmudra_currency_switcher]` shortcode or widget

## Usage

### Display Settings

Configure where the currency switcher appears:

**WooCommerce → Multi Currency → Display Settings**

**Display Position Options:**
- **None** - Use only shortcode or widget
- **Shop Page Start** - Automatically display at the top of shop pages
- **Footer** - Show in the website footer (dropdown opens upward for better visibility)
- **Floating Left** - Fixed position on the left side (stays visible while scrolling)
- **Floating Right** - Fixed position on the right side (stays visible while scrolling)

**Product Page Option:**
- ☑ **Display below product title** - Show currency switcher on individual product pages

**Currency Selection:**
- ☑ Check currencies you want to display on frontend
- ☐ Uncheck currencies to hide them from customers
- Only enabled currencies appear in the currency switcher dropdown

### Shortcode

Add the currency switcher anywhere using:
```
[bizzmudra_currency_switcher]
```

### Widget

Go to **Appearance → Widgets** and add the "Currency Switcher" widget to any widget area.

## Documentation

Complete documentation is available in the `doc/` folder (in Bengali):

- **[Installation Guide](doc/installation.md)** - Step-by-step installation instructions
- **[User Guide](doc/user-guide.md)** - How to configure and use the plugin
- **[Developer Guide](doc/developer-guide.md)** - Technical documentation and API reference
- **[Hooks & Filters](doc/hooks-filters.md)** - Complete hooks and filters reference
- **[Display Settings](doc/display-settings.md)** - Guide to display position controls
- **[AJAX Fix](doc/ajax-fix.md)** - WordPress AJAX best practices
- **[Changelog](doc/changelog.md)** - Detailed changelog of all changes

## Requirements

- WordPress 5.8 or higher
- WooCommerce 5.0 or higher
- PHP 7.4 or higher

## For Developers

### File Structure

```
bizzmudra/
├── admin/              # Admin interface
├── assets/             # JavaScript and CSS files
├── doc/                # Documentation (Bengali)
├── includes/           # Core classes
├── public/             # Frontend handlers
└── readme.txt          # WordPress.org readme
```

### Key Classes

- `BIZZMUDRA_Loader` - Main plugin class
- `BIZZMUDRA_Currency_Data` - Currency data management
- `BIZZMUDRA_Price_Converter` - Price conversion logic
- `BIZZMUDRA_Public` - Frontend handler
- `BIZZMUDRA_Switcher` - Shortcode handler
- `BIZZMUDRA_Currency_Widget` - Widget class

### Hooks & Filters

The plugin provides numerous hooks and filters for customization. See [Hooks & Filters documentation](doc/hooks-filters.md) for complete reference.

## Support

- **Issues:** [GitHub Issues](https://github.com/codersaiful/bizzmudra/issues)
- **Author:** [Saiful Islam](https://profiles.wordpress.org/codersaiful/)

## License

GPL v3 or later - [http://www.gnu.org/licenses/gpl.html](http://www.gnu.org/licenses/gpl.html)

## Changelog

### Version 1.1.0
- **New:** Currency selection checkboxes - Choose which currencies to display on frontend
- **New:** Smart dropdown direction - Opens upward in footer position for better visibility
- **Improved:** User experience with cleaner currency options
- **Updated:** Documentation with new features
- Backward compatible with version 1.0.0

### Version 1.0.0
- Initial release
- Multi-currency support with manual exchange rates
- Frontend currency switcher
- Automatic price conversion
- Widget and shortcode support
- **Display position controls** (Shop Page, Footer, Floating Left/Right)
- **Product page display option**
- Floating switcher with elegant design
- Responsive mobile support
- Complete Bengali documentation

---

**Note:** Documentation files in the `doc/` folder are written in Bengali (বাংলা) for Bengali-speaking developers and users.