# Copy Paste Tools for Advanced Custom Fields

Плагін для WordPress, що додає можливість копіювання та вставки блоків ACF (Advanced Custom Fields) між різними сторінками та постами.

## Особливості

- ✅ **Копіювання блоків ACF** - повне та часткове (без медіа)
- ✅ **Вставка блоків** - з автоматичною валідацією структури
- ✅ **Підтримка всіх типів полів** - текст, текстова область, repeater, group, flexible content
- ✅ **Автоматичне додавання рядків** в repeater поля
- ✅ **Очищення блоків** - видалення всіх даних та рядків
- ✅ **Безпечне збереження** - в sessionStorage та системному буфері
- ✅ **Сумісність** - працює з будь-якими версіями ACF

## Встановлення

1. Завантажте файли плагіна в папку `/wp-content/plugins/copy-paste-tools-for-acf/`
2. Активуйте плагін в адмін-панелі WordPress
3. Плагін автоматично додасть кнопки до всіх ACF блоків

## Використання

### Кнопки плагіна

Кожен ACF блок отримує панель з кнопками:

- **📋** - Повне копіювання (включаючи медіа)
- **📄** - Часткове копіювання (без медіа)
- **📥** - Вставка даних з буфера
- **🧹** - Очищення блоку

### Процес роботи

1. **Копіювання**:
   - Натисніть 📋 або 📄 на блоці, який хочете скопіювати
   - Дані збережуться в локальному буфері

2. **Вставка**:
   - Перейдіть на іншу сторінку/пост
   - Натисніть 📥 на блоці, куди хочете вставити дані
   - Підтвердіть вставку в діалозі

3. **Очищення**:
   - Натисніть 🧹 для видалення всіх даних з блоку

## Підтримувані типи полів

- **Текстові поля** - text, textarea, email, url, number
- **Repeater поля** - з автоматичним додаванням рядків
- **Group поля** - вкладені групи полів
- **Flexible Content** - лейаути з полями
- **Select та Radio** - списки та радіо-кнопки
- **Медіа поля** - image, gallery, file (тільки в повному копіюванні)

## Технічні деталі

### Зберігання даних

- **Session Storage** - локальне зберігання в браузері
- **System Clipboard** - системний буфер обміну
- **JSON формат** - читабельна структура даних

### Автоматичні функції

- **Валідація структури** - перевірка відповідності полів
- **Додавання рядків** - автоматичне створення рядків в repeater
- **Очищення рядків** - видалення всіх рядків repeater
- **Оновлення кнопок** - динамічний стан кнопки вставки

### Сумісність

- **ACF API** - використання офіційного API з fallback до DOM
- **Всі версії ACF** - від 5.0 до останніх
- **Всі теми** - незалежно від теми WordPress

## Структура файлів

```
copy-paste-tools-for-acf/
├── copy-paste-tools-for-acf.php    # Основний файл плагіна
├── assets/
│   ├── admin.css        # Стилі кнопок
│   └── admin.js         # JavaScript функціональність
└── README.md            # Документація
```

## Безпека

- ✅ Валідація всіх вхідних даних
- ✅ Перевірка прав користувача
- ✅ Безпечне збереження в браузері
- ✅ Захист від XSS атак

## Підтримка

Плагін підтримує:
- WordPress 5.0+
- ACF 5.0+
- Всі сучасні браузери

## Ліцензія

MIT License - вільно використовувати, змінювати та розповсюджувати.

## Версія

**1.2.0**
- Added internationalization (i18n) support
- Added Ukrainian and English translations
- Improved localization for all user interface elements
- Enhanced accessibility with proper text domains
- Updated plugin structure for WordPress.org standards

**1.1.0**
- Added support for media field copying and pasting
- Improved nested repeater field handling
- Added cross-site copy/paste functionality
- Enhanced field validation and error handling
- Fixed visual updates for media fields after pasting
- Added partial copy mode (excluding media files)
- Improved DOM manipulation for better compatibility

**v1.0.0** - Перший реліз з повною функціональністю копіювання/вставки ACF блоків.