# WooCommerce Custom Minimum Order

Персонализиран плъгин за WooCommerce, който добавя възможност за задаване на минимална сума за поръчка с модерен админ интерфейс.

## Описание

Този плъгин позволява на администраторите да зададат минимална сума за поръчка в WooCommerce магазина. Клиентите няма да могат да завършат поръчката, ако не достигнат минималната сума.

## Функционалности

- ✅ Задаване на минимална сума за поръчка от админ панела
- ✅ **Включване/изключване на функционалността с checkbox**
- ✅ Проверка при завършване на поръчката (checkout)
- ✅ Показване на съобщение в кошницата
- ✅ Интерактивен админ интерфейс с JavaScript
- ✅ Съвместимост с последните версии на WooCommerce
- ✅ Красив и интуитивен админ интерфейс
- ✅ Многоезична поддръжка (готов за превод)
- ✅ Responsive дизайн

## Изисквания

- WordPress 5.0 или по-нова версия
- WooCommerce 5.0 или по-нова версия
- PHP 7.4 или по-нова версия

## Инсталация

1. Качете папката `wc-minimum-order-amount` в директорията `/wp-content/plugins/`
2. Активирайте плъгина през менюто "Плъгини" в WordPress админ панела
3. Отидете в "WC Custom Min Order" в админ менюто за да конфигурирате настройките

## Използване

### Настройка

1. След активиране на плъгина, отидете в **WC Custom Min Order** в админ менюто
2. Задайте желаната минимална сума за поръчка
3. Натиснете "Запази настройките"

### Как работи

- **Checkbox за активиране**: Можете да включите/изключите функционалността с едно кликване
- **В кошницата**: Клиентите ще видят съобщение, ако не достигнат минималната сума (само ако е активирано)
- **При checkout**: Ще се покаже грешка, ако сумата е под минимума (само ако е активирано)
- **Деактивирано**: Клиентите могат да завършат поръчката без ограничения

## Съобщения

Плъгинът показва различни съобщения:

- **В кошницата**: "Добавете още X лв. за да достигнете минималната сума за поръчка от Y лв."
- **При checkout**: "Минималната сума за поръчка е X лв. В момента имате Y лв."

## Превод

Плъгинът е готов за превод и използва WordPress системата за интернационализация. Всички текстове са обвити в `__()` и `_e()` функции.

За да преведете плъгина:

1. Извлечете текстовете с инструмент като Poedit
2. Създайте .po и .mo файлове за вашия език
3. Поставете ги в папка `/languages/` в плъгина

## Структура на файловете

```
wc-minimum-order-amount/
├── wc-minimum-order-amount.php    # Главен файл
├── includes/
│   └── class-settings-page.php    # Клас за настройки
├── assets/
│   ├── admin.css                  # Стилове за админ панела
│   └── admin.js                   # JavaScript за интерактивност
└── README.md                      # Документация
```

## Хукове и филтри

### Достъпни хукове

- `wcmoa_before_check_minimum_amount` - Изпълнява се преди проверката
- `wcmoa_after_check_minimum_amount` - Изпълнява се след проверката

### Достъпни филтри

- `wcmoa_minimum_amount` - Позволява промяна на минималната сума
- `wcmoa_checkout_error_message` - Позволява промяна на съобщението за грешка
- `wcmoa_cart_notice_message` - Позволява промяна на съобщението в кошницата

## Примери за използване

### Промяна на минималната сума чрез филтър

```php
add_filter( 'wcmoa_minimum_amount', function( $amount ) {
    // Задаваме различна сума за различни потребители
    if ( is_user_logged_in() ) {
        return 50; // 50 лв. за регистрирани потребители
    }
    return $amount; // Стандартната сума за гости
});
```

### Промяна на съобщението за грешка

```php
add_filter( 'wcmoa_checkout_error_message', function( $message, $minimum, $current ) {
    return sprintf( 
        'За да завършите поръчката, добавете още %s към кошницата си.', 
        wc_price( $minimum - $current ) 
    );
}, 10, 3 );
```

## Поддръжка

За въпроси и поддръжка, моля свържете се с разработчика.

## Лиценз

GPL v2 или по-нова версия

## Съвместимост

✅ **Отлично**: Плъгинът е напълно съвместим с WooCommerce High-Performance Order Storage (HPOS)!

- ✅ Съвместим с HPOS (High-Performance Order Storage)
- ✅ Съвместим с традиционните WordPress таблици за поръчки
- ✅ Автоматично декларира съвместимост с WooCommerce
- ✅ Работи с всички версии на WooCommerce 5.0+

## Changelog

### 1.0.2
- ✅ **Пълна съвместимост с HPOS (High-Performance Order Storage)**
- ✅ **Автоматично деклариране на съвместимост с WooCommerce**
- ✅ **Премахнати предупреждения за несъвместимост**
- ✅ **Подобрена стабилност и производителност**

### 1.0.1
- ✅ **Добавена опция за включване/изключване на функционалността**
- ✅ **Интерактивен админ интерфейс с JavaScript**
- ✅ **Автоматично активиране/деактивиране на полето за сумата**
- ✅ **Валидация и уведомления в реално време**
- Подобрена обработка на сумите на кошницата
- Обновени методи за получаване на общата сума

### 1.0.0
- Първоначално издание
- Основна функционалност за минимална сума за поръчка
- Админ интерфейс за настройки
- Съобщения в кошницата и при checkout