=== Custom JSON Export for Gravity Forms ===
Contributors: sflwa
Tags: gravity forms, json
Requires at least: 6.7
Tested up to: 6.8
Stable tag: 2.27
Requires PHP: 8.0
License: GPLv2 or later

A plugin to export individual Gravity Forms entries to a customizable JSON file.

## Description
This plugin enhances Gravity Forms by providing the ability to export individual form entries as a `.json` file directly from the entries list. It allows you to define a custom JSON structure using a template editor within each form's settings, where you can insert Gravity Forms merge tags and even utilize conditional logic shortcodes. A live preview feature helps you validate your JSON template before export.

## Installation
1.  Upload the `custom-json-export-for-gravity-forms` folder to the `/wp-content/plugins/` directory.
2.  Activate the plugin through the 'Plugins' menu in WordPress.
3.  After activation, navigate to **Forms > Forms**, hover over a form, and click 'Settings'. You will find a new 'JSON Export' tab where you can configure the export options and custom JSON template for that specific form.

## Instructions
1.  **Activate the plugin.**
2.  Go to **Forms > Forms**, then select 'Settings' for the desired form.
3.  Click on the **'JSON Export' tab**.
4.  **Enable JSON Export Link:** Check the box to display the "Download JSON Export" link on individual entry pages for this form.
5.  **Custom JSON Output Template:** Enter your desired JSON structure in the textarea.
    * Use standard Gravity Forms merge tags (e.g., `{field_id}`, `{entry_id}`, `{date_created:format:Y-m-d}`).
    * Merge tags will be automatically formatted as `"key":"{merge_tag}"` when inserted from the dropdown.
    * You can also use Gravity Forms conditional shortcodes (e.g., `[gravityforms action='conditional' merge_tag='{Name (First):1.3}' condition='isnot' value='Philip']"custom_field":"conditional_value"[/gravityforms]`) to include dynamic content.
6.  **Preview JSON Export:** Click the 'Preview JSON Export' button to see a live preview of your generated JSON based on the latest entry for that form. This helps in validating your template.
7.  **Save Settings:** Click 'Save Settings' to apply your changes.
8.  To export an entry, go to **Forms > Entries**, hover over an entry, and click the 'Download JSON Export' link.

## Screenshots
1.  Screenshot of the 'JSON Export' settings tab within Gravity Forms.
2.  Screenshot of the merge tag selector and custom JSON template area.
3.  Screenshot of the JSON preview output.
4.  Screenshot of the 'Download JSON Export' link on an entry detail page.

## Change Log

**2025-07-24 v2.27
* Initial stable release.
* Added custom JSON template editor with merge tag insertion.
* Implemented live JSON preview based on the latest entry.
* Added conditional logic shortcode support within templates.
* Option to enable/disable JSON export link per form.
* Added 'JSON Export' meta box to individual entry detail pages for direct download.