=== 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.4
Requires PHP: 7.2
Stable tag: 1.5.0

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, import/export tools, improved uploaded file handling, and optional integration management.

== Description ==

Enhance Flamingo with additional customization options!

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

* **Import/Export Feature**

  * Export Flamingo messages to a JSON file for backup or migration.
  * Import messages back into Flamingo while preserving all metadata, including the "Channel" column.
  * Imports are processed in optimized batches for improved reliability on large datasets.
  * Duplicate messages are automatically detected and skipped using content hashing.
  * Clear and reliable admin notices summarise import results.

* **Persistent File Uploads**

  * Optionally persist Contact Form 7 uploads to permanent URLs.
  * Stored upload URLs can be viewed and accessed from Flamingo messages.
  * Persistent uploads are **disabled by default** to avoid unexpected storage growth.

* **Uploaded Files Management**

  * Dedicated admin screen to view all persisted uploaded files.
  * Image uploads display thumbnail previews.
  * Non-image uploads display file-type icons.
  * Download files directly using a dedicated Download button.
  * Delete individual files or bulk delete all stored uploads.

* **Integrations Management**

  * Dedicated Integrations screen for managing optional add-ons.
  * View activated, installed, and available integrations from one place.
  * See available integration support for Divi, WPBakery, Enfold, and Beaver Builder.
  * Activate installed add-ons where available.
  * Access integration-specific settings when supported by an active add-on.

* **Enhanced Inbound Messages**

  * Display selected submission fields directly in the Flamingo Inbound Messages list.
  * Choose which form fields appear in the table.

* **Better Contact Log Management**

  * Add a "Latest Message" link to each contact in the address book.
  * Reorder the Flamingo menu, setting Inbound Messages as the default view.
  * Rename the Flamingo menu for better organisation.
  * Optionally disable the Address Book entirely.

* **Improved Usability**

  * A **Settings** link is added to the WordPress **Plugins** page for quick access.

This plugin is ideal for sites that rely heavily on Flamingo and need better organisation, safer backups, optional long-term file retention, and easier management of compatible add-ons.

== 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 message import/export, go to **Flamingo → Message Sync**.
5. To manage stored uploads, go to **Flamingo → Uploaded Files**.
6. To view optional add-ons, go to the **Integrations** screen in the Flamingo/ACAFS admin area.

== Frequently Asked Questions ==

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

= Is persistent file upload enabled by default? =
No. Persistent uploads are **disabled by default** and must be explicitly enabled in the settings.

= Can I preview uploaded files? =
Yes. Image uploads show thumbnail previews on the Uploaded Files page. Non-image files show a file-type icon.

= Can I download uploaded files directly? =
Yes. Each uploaded file has a dedicated Download button. Existing file name links also continue to work.

= Can I delete uploaded files after import? =
Yes. You can delete individual files or remove all stored uploads from the Uploaded Files admin page.

= What does the Integrations screen do? =
The Integrations screen helps you view and manage optional add-ons that extend Flamingo support to other form builders and themes.

= Which integrations are shown? =
The Integrations screen can show available support for Divi, WPBakery, Enfold, and Beaver Builder.

= Can I choose which form fields appear in the Inbound Messages table? =
Yes. You can select exactly which fields are displayed via the settings panel.

= Can I disable the Address Book? =
Yes. The Address Book can be disabled entirely from the settings.

= How does the import/export feature work? =

* **Export**: Click "Export Messages" in **Flamingo → Message Sync** to download a JSON backup.
* **Import**: Upload a previously exported JSON file to restore messages.
* Existing messages are automatically skipped, and a summary is shown on completion.

== Screenshots ==

1. **Settings Page** – Configure Flamingo behaviour and plugin options.
2. **Enhanced Inbound Messages** – Display submission details directly in the message list.
3. **Import/Export Page** – Backup and restore Flamingo messages.
4. **Uploaded Files Page** – View, preview, download, and manage persisted file uploads.
5. **Integrations Page** – View and manage optional Flamingo integrations.

== Changelog ==

= 1.5.0 =

* Improve the Uploaded Files admin page with image thumbnails for image uploads.
* Add file-type icons for non-image uploads on the Uploaded Files admin page.
* Add a dedicated Download button for each stored uploaded file.
* Add a dedicated Integrations screen for managing optional add-ons.
* Add integration status sections for activated, installed, and available integrations.
* Add integration cards for Divi, WPBakery, Enfold, and Beaver Builder.
* Add prompts for installed integrations that have not yet been activated.
* Add integration-specific settings when supported by an active add-on.
* Confirm compatibility with WordPress 6.9.4.

= 1.4.3 =

* Add Uploaded Files admin page with secure file deletion controls.
* Add option to disable persistent uploads by default.
* Improve safety and management of stored CF7 uploads.

= 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 and autoloading improvements.

= 1.3.0 =

* Import now processes messages in batches for significant speed gains.
* Improved duplicate detection using content hashes.
* More reliable admin notices for long-running imports.

= 1.2.0 =

* Skip existing messages during import with clear user feedback.
* Add a **Settings** link to the Plugins page.
* Improve JSON export reliability.

= 1.1.0 =

* Introduce Import/Export feature for Flamingo messages.
* Preserve the "Channel" column during import.

= 1.0.0 =

* Initial release with enhanced Flamingo settings and message management.

== Upgrade Notice ==

= 1.5.0 =
Improves the Uploaded Files admin page with thumbnails, file-type icons, and direct download buttons. Also introduces a new Integrations screen for managing optional add-ons.

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