=== AC Advanced Flamingo Settings ===

Contributors: amberCouch
Tags: contact form 7, flamingo, contact form database, import, export
Requires at least: 5.4
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 1.4.2

License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AC Advanced Flamingo Settings enhances and extends the functionality of the CF7 Flamingo plugin by adding customization options and import/export functionality for better contact form data management.

== Description ==

Enhance Flamingo with additional customization options!

This plugin extends Flamingo, the Contact Form 7 database storage plugin, by adding powerful features for better form submission management:

- **Import/Export Feature (Enhanced in 1.3.0)**
  - Export Flamingo messages to a JSON file for backup or migration.
  - Import messages back into Flamingo while preserving all metadata, including the "Channel" column.
  - **Now processes messages in batches for better performance on large imports.**
  - **Significantly faster import with improved duplicate detection using content hashing.**
  - **Clearer and more reliable admin notices for import progress and completion.**

- **Enhanced Inbound Messages**
  - Display submission details directly in the Flamingo Inbound Messages list.
  - Choose which form fields to show in the Inbound Messages table.

- **Better Contact Log Management**
  - Add a "Latest Message" link to each contact in your address book.
  - Reorder the Flamingo menu, setting Inbound Messages as the default view.
  - Rename the Flamingo menu for better organization.
  - Optionally disable the Address Book if not needed.

- **Improved Usability**
  - A **Settings** link has been added to the WordPress **Plugins page** for quick access.

This plugin is perfect for users who rely on Flamingo and need a better-organized contact log with backup and migration capabilities.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/ac-advanced-flamingo-settings/` directory, or install the plugin via the WordPress plugin repository.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **Settings → AC Flamingo** to configure your preferences.
4. For import/export, go to **Flamingo → Message Sync** and follow the instructions.

== Frequently Asked Questions ==

= Does this plugin work without Flamingo? =
No. AC Advanced Flamingo Settings is designed as an extension for Flamingo and requires it to function.

= Can I choose which form fields appear in the Inbound Messages table? =
Yes! You can select the specific fields you want to display from the settings panel.

= Can I disable the Address Book? =
Yes! If you do not use the Address Book, you can disable it entirely via the settings.

= How do I rename the Flamingo menu? =
Go to **Settings → AC Flamingo** and enter your preferred name for the menu.

= How does the import/export feature work? =
- **Export**: Click "Export Messages" in **Flamingo → Message Sync** to download all Flamingo messages in a JSON file.
- **Import**: Upload a previously exported JSON file to restore messages, including the "Channel" column.
- **Duplicate messages are automatically skipped, and a summary is displayed after import.**
- **Large imports are now processed in optimized batches for better performance.**

== Screenshots ==

1. **Settings Page** - Customize Flamingo behavior and menu options.
2. **Enhanced Inbound Messages** - Display form submission details directly in the table.
3. **Import/Export Page** - Export and import Flamingo messages easily.

== Changelog ==

= 1.4.2 =
* Fix missing vendor folder in version 1.4.0.

= 1.4.0 =
* Persist CF7 uploads to permanent URLs and store them in Flamingo.
* Make stored upload URLs clickable on the Flamingo single message screen.
* Performance and background import improvements.
* Internal code quality / autoloading setup.

= 1.3.0 =
- **Performance Improvements:**
  - Import now processes messages in **batches of up to 50** for significant speed gains.
  - Improved duplicate detection using content hashes and bulk SQL matching.
- **Better Admin UX:**
  - Import progress indicator remains active until the process finishes.
  - Import completion notices now expire only after they are displayed.
- **Infrastructure Enhancements:**
  - Improved reliability of transient handling for long-running imports.

= 1.2.0 =
- **Import Function Enhancements:**
  - Messages that already exist in Flamingo are skipped during import.
  - Users are notified about how many messages were imported and how many were skipped.
- **Added a "Settings" link in the WordPress Plugins page.**
- **Improved JSON export to ensure all message metadata is correctly backed up.**

= 1.1.0 =
- **New Import/Export feature**: Backup and restore Flamingo messages.
- **Preserves the "Channel" column** during import.
- **UI improvements** to the settings page.

= 1.0.1 =
- Added required header.

= 1.0.0 =
Initial release with the following features:
- Customizable submission details in Inbound Messages.
- Option to disable the Address Book.
- Menu reordering and renaming for Flamingo.
- Enhanced settings panel.

== Upgrade Notice ==

= 1.4.2 =
Fixes for broken 1.4.0 version.

= 1.3.0 =
Faster imports with batch processing and better duplicate detection. Import progress indicators and notifications are now more reliable for large datasets.

== Support ==
For support or feature requests, visit [https://ambercouch.co.uk/](https://ambercouch.co.uk/)