=== Copy Paste Tools for Advanced Custom Fields ===
Contributors: aisakov (aka andrewrccg)
Tags: acf, advanced custom fields, copy, paste, blocks, export, import
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.3.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Advanced copy, paste, and transfer tools for ACF blocks with cross-site image support.

== Description ==

Copy Paste Tools for ACF adds intuitive copy, paste, and clear functionality directly in the WordPress editor for enhanced ACF workflow. Now with powerful cross-site transfer capabilities!

**Key Features:**

* **Copy & Paste ACF Blocks**: Easily copy entire ACF blocks or individual field groups
* **Full & Partial Copying**: Choose between copying everything (including media) or excluding media files
* **Nested Repeater Support**: Handles complex nested repeater fields with multiple levels
* **Configurable Paste Modes**: Choose to append or replace repeater rows
* **Media Field Support**: Copy and paste images, galleries, and file uploads
* **Cross-Site Image Transfer**: Export and import images via ZIP archives (NEW!)
* **Smart Image Detection**: Avoid duplicates by checking existing files (NEW!)
* **One-Click Clear**: Clear all field values with automatic confirmation handling
* **Smart Validation**: Intelligent field matching for safe pasting
* **Settings Page**: Configure paste behavior and cross-site options (NEW!)

**Perfect for:**
* Content managers working with repetitive ACF blocks
* Developers testing ACF field configurations
* Teams sharing ACF block templates across sites
* Migration of content between staging and production
* Anyone who frequently creates similar content structures

The plugin integrates seamlessly with ACF's existing interface, adding a clean toolbar with buttons for all operations. When cross-site transfer is enabled, additional buttons appear for exporting and importing images through ZIP archives.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/copy-paste-tools-for-acf` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. The copy/paste buttons will automatically appear on ACF blocks in the WordPress editor.

**Requirements:**
* Advanced Custom Fields (ACF) plugin must be installed and activated
* WordPress 5.0 or higher
* PHP 7.4 or higher

== Frequently Asked Questions ==

= Do I need ACF Pro? =

Yes, this plugin requires Advanced Custom Fields (ACF) Pro as it uses ACF's JavaScript API for advanced field handling.

= Does it work with nested repeater fields? =

Yes! The plugin fully supports nested repeater fields with unlimited levels of nesting.

= Can I copy between different WordPress sites? =

Yes! The plugin supports cross-site copying in two ways:
1. Standard mode: Using system clipboard for text data
2. Cross-site mode: Export/import images via ZIP archives (enable in Settings)

= What's the difference between full and partial copy? =

Full copy includes all fields including media uploads (images, files, galleries). Partial copy excludes media files but copies all text and other field types.

= How do I transfer images between sites? =

1. Go to Settings > Copy Paste Tools for ACF
2. Enable "Cross-Site Transfer"
3. Use the 🌐 button to export content with images (downloads ZIP)
4. On the destination site, use the 📦 button to import the ZIP

= Will it overwrite existing content in repeater fields? =

You can choose! In plugin settings, select:
- "Append" mode: Adds new rows to existing ones (default)
- "Replace" mode: Clears existing rows and pastes new ones

= How does smart image detection work? =

When importing images, you can configure the plugin to:
- Check by filename and size: Skip upload if exact match found
- Check by filename only: Skip if file with same name exists
- Upload all: Always create new copies (no checks)

= Does it work with all ACF field types? =

The plugin supports most ACF field types including text, textarea, select, checkbox, repeater, flexible content, group, image, gallery, and file fields.

= Where are the plugin settings? =

Go to WordPress admin > Settings > Copy Paste Tools for ACF

== Screenshots ==

1. ACF block with copy/paste toolbar showing four buttons: Copy (Full), Copy (Partial), Paste, and Clear

== Changelog ==

= 1.3.0 =
* **NEW:** Settings page for configuring plugin behavior
* **NEW:** Configurable paste mode for repeater fields (append or replace)
* **NEW:** Cross-site image transfer via ZIP archives
* **NEW:** Smart image duplicate detection (by name, size, or both)
* **NEW:** Export images button with automatic ZIP download
* **NEW:** Import images button with file picker
* **NEW:** Image mapping system for preserving relationships
* **IMPROVED:** Repeater paste logic now respects settings
* **IMPROVED:** Better error handling for export/import operations
* **IMPROVED:** Enhanced translations with all new strings
* **IMPROVED:** More intuitive button icons and labels
* Updated version to 1.3.0

= 1.2.1 =
* Changed slug and naming --> copy-paste-tools-for-acf

= 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

= 1.0.0 =
* Initial release
* Basic copy/paste functionality for ACF blocks
* Support for simple field types
* Clear block functionality

== Upgrade Notice ==

= 1.3.0 =
Major update with settings page and cross-site image transfer! Configure paste behavior and transfer images between sites via ZIP archives. Highly recommended for all users working with media-rich ACF blocks.
