=== DMC CSV Mapper ===
Contributors: bendm
Tags: csv, import, importer, acf, advanced custom fields
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Import CSV data into WordPress post types and Advanced Custom Fields (ACF).

== Description ==

DMC CSV Mapper is a WordPress plugin that allows you to import CSV data into your WordPress site. It supports both standard WordPress post fields and Advanced Custom Fields (ACF).

= Features =

* Multi-step wizard interface
* Import into any public post type
* CSV upload with validation
* Smart column-to-field auto-mapping
* Map one CSV column to multiple fields
* Batch processing for large files
* Advanced Custom Fields (ACF) support
* Extensible via actions and filters

= Requirements =

* WordPress 6.0 or higher
* PHP 8.0 or higher
* Advanced Custom Fields (optional, for ACF field mapping)

= Developer Documentation =

See `docs/HOOKS.md` in the plugin directory for available filters and actions.

== Installation ==

1. Upload the `dmc-csv-mapper` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Navigate to 'CSV Mapper' in the WordPress admin menu
4. Start importing your CSV files

== Frequently Asked Questions ==

= Does this plugin work with Advanced Custom Fields? =

Yes! The plugin integrates with Advanced Custom Fields (ACF) when the plugin is active.

= What file formats are supported? =

Currently, the plugin supports CSV (Comma-Separated Values) files.

= Can I import into custom post types? =

Yes! The plugin allows you to select any registered public post type on your WordPress site.

= Can I customize who can access the importer? =

Yes. Use the `dmc_csv_mapper_capability` filter to change the required capability (default: `manage_options`).

= Can I extend the import behavior? =

Yes. The plugin exposes hooks for post data, field values, batch size, and more. See `docs/HOOKS.md`.

= Where are uploaded CSV files stored? =

Uploaded files are saved temporarily in `wp-content/uploads/csv-imports/`. They are automatically deleted after 24 hours. Uninstalling the plugin also removes any remaining files in that directory.

= Does importing the same CSV twice create duplicates? =

Yes. The free version always creates new posts. Updating existing posts instead of creating duplicates is planned for a separate Pro add-on.

= Does this plugin send data to external servers? =

No. All CSV processing happens on your WordPress site. No import data is transmitted to third-party services.

== Screenshots ==

1. Step 1 — Choose any public post type to import into, including custom post types.
2. Step 2 — Upload a CSV file and preview the first rows before you import.
3. Step 3 — Map CSV columns to WordPress fields and Advanced Custom Fields with smart suggestions.
4. Step 4 — Review the import summary, track progress, and see success and error results.

== Changelog ==

= 1.2.0 =
* Rebranded to DMC CSV Mapper (De Meillon Consultants)
* Renamed plugin slug and text domain to `dmc-csv-mapper`
* Renamed hooks to use the `dmc_csv_mapper_` prefix

= 1.1.1 =
* WordPress Plugin Check compliance improvements
* Renamed hooks to use the `custom_csv_importer_` prefix
* Switched CSV uploads to `wp_handle_upload()`
* Added `.distignore` for WordPress.org packages
* Updated GitLab repository URL

= 1.1.0 =
* Added PHP namespaces (`DmcCsvMapper`)
* Added developer hooks (actions and filters)
* Added translation template (`languages/dmc-csv-mapper.pot`)
* Hardened input validation and XSS protection
* Added uninstall cleanup
* Updated requirements (WordPress 6.0+, PHP 8.0+)

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.2.0 =
Rebrand to DMC CSV Mapper. Hook prefix changed from `custom_csv_importer_` to `dmc_csv_mapper_`.

= 1.1.1 =
Plugin Check and WordPress.org packaging improvements.

= 1.1.0 =
Security and extensibility update. Recommended for all users.
