=== User Import with meta - WP Ultimate CSV Importer Add-on ===
Contributors: smackcoders, riswanasmack, premairuthayarajan
Donate link: https://www.paypal.me/smackcoders 
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.6
Version: 1.6
Requires PHP: 7.4
Author: smackcoders
Author URI: https://www.smackcoders.com/wp-ultimate-csv-importer-pro.html
Tags: user import, csv import, user meta import, import users, bulk user import, woocommerce users, customer import, custom fields import, membership import, wp members import, memberpress import, spreadsheet import, user export, user profile import, csv, customers, woocommerce
License: GPLv2 or later

Import and export WordPress and WooCommerce users with full user meta, custom fields, billing & shipping details, and membership data. Supports CSV, XML, Excel, and TSV files.

== Description ==

The **User Import with Meta Add-on** extends the powerful WP Ultimate CSV Importer plugin to help you manage WordPress users and WooCommerce customers at scale. Whether you're migrating from another site, importing customers, or onboarding large user lists, this add-on gives you complete control over user profiles.

It supports importing data from various sources such as your computer, external URLs, cloud platforms like Google Sheets or Dropbox, FTP/SFTP locations.

This add-on allows you to import not only the standard WordPress user fields but also user meta, custom profile data, WooCommerce billing and shipping details, as well as metadata from popular membership plugins like **WP-Members** and **MemberPress**, making it ideal for eCommerce stores, membership sites, LMS platforms, and large business websites.

== Key Features ==

**Flexible Import Sources**
You can import user data from:
- Your desktop  
- FTP/SFTP servers  
- External URLs (Google Sheet / Dropbox)

**Supports Multiple File Formats**
Import from a wide range of file formats including:
- CSV  
- XML  
- Excel (XLS/XLSX)  
- TSV  
- Google Sheets  
- ZIP files containing structured data  

**Import WordPress Users and WooCommerce Customers**
Bring in new users with:
- Standard WordPress fields  
- User meta  
- WooCommerce billing and shipping information  
- Additional customer details like phone, address, notes, and more  

**Membership Plugin Compatibility**
Seamlessly import profile data for:
- WP-Members  
- MemberPress  

**Automatic Password Handling**
If your CSV (or other import file) doesn't include a password, the plugin generates a secure one and automatically emails it to the user.

**Smart Field Mapping**
Use an intuitive drag-and-drop interface or dropdown suggestions to map all your fields correctly. If your file headers and WordPress field headers are same, the plugin will automatically maps them. This makes large and complex imports easier and faster.

**Conditional Filters for Imports**
Apply filters to import only the specific users you want based on conditions like role, status, or any metadata, helping you maintain clean and organized data imports.

**Duplicate Handling**
Prevent duplicate user creation by validating user email.

Use update mode to modify existing users instead of creating new ones. (Pro feature)

**Iteration-Based Import**
Large files are split into smaller manageable chunks (iterations), ensuring that high-volume imports run smoothly without server timeouts.

**Monitor Import Progress**
Track import status in real time, view logs, and quickly resolve any issues. Errors are highlighted clearly for easy debugging.


== Export Capabilities ==

The add-on is not only for importing, it also provides a full user export system.

**Export Users and WooCommerce Customers**
Export:
- WordPress users  
- WooCommerce customers  
- All their meta fields  

**Multiple Export Formats**
Export your user data into file formats like:
- CSV  
- XML  
- XLS  
- XLSX  
- JSON  
- TSV  

**Iteration Export and Date-Based Export**
Export users in batches or export only users created during a specific time period.

**Preview Before Export**
Review your user data before downloading to ensure accuracy.

**One-Click User Migration**
Move users between sites seamlessly with the one-click import & migrate feature. 


== How It Works ==

1. Install WP Ultimate CSV Importer (Free).  
2. Install and activate this add-on.  
3. Upload your source file or choose an external source.  
4. Map fields using the drag-and-drop UI or dropdown mode.  
5. Apply filters if required.  
6. Run the import and track progress live.  


== How to Import Users ==

**1. Prepare Your File**
Create a CSV, Excel, XML, TSV, or Google Sheet containing user fields such as username, email, user meta, and WooCommerce billing/shipping data.

**2. Go to Import Screen**
Navigate to Ultimate CSV Importer Free → Import/Update page.

**3. Choose File Source**
Upload your file from desktop, FTP/SFTP, or external URL. Only fresh import is allowed. For update, you require pro version.

**4. Map Fields**
Match your file columns to WordPress Users fields using drag-and-drop or dropdown mapping mode.

**5. Apply Filters (Optional)**
Apply conditional filters to import only users matching specific roles, dates, or others.

**6. Run Import**
Click Import to instantly run it. You can configure iterations and other settings before proceeding the import. The plugin can processes large files. It shows progress, errors, and completed entries after import.

== How to Export Users ==

**1. Visit Export Screen**
Go to WP Ultimate CSV Importer → Export.

**2. Choose What to Export**
Select Users or WooCommerce Customers from the modules list.

**3. Select Export Format**
Provide a file name and select export file formats like CSV, XML, XLS, XLSX, TSV, or JSON.

**4. Preview (Optional)**
Click Preview button to review selected users and fields before exporting.

**5. Download Export File**
Click Export and the export file will be prepared. Then click Download to save the file to your device.


== WP Ultimate CSV Importer Pro Features ==

WP Ultimate CSV Importer offers many advanced features in its pro version. Here are some listed below:

**Update Existing Users**
Modify existing WordPress users and WooCommerce customers without creating duplicates. Update roles, profile data, and meta fields while keeping user IDs intact.

**Scheduled Imports**
Run cron-based automatic schedule import from FTP/SFTP, and Google Sheets. Useful for sites that receive user data on a regular basis from external systems.

**Mapping Templates**
Save your field mapping once and reuse it for future imports, making repeated or scheduled tasks easier to manage.

**Import and Export All WordPress Data**
Pro supports full-site data handling, including posts, products, orders, taxonomies, custom fields, comments, and SEO fields, enabling complete migrations.

**Advanced Export Options**
Export users and other WordPress data with filters, date ranges, selected fields, user roles, or in iteration mode for large datasets, and much more.

**One-Click Rollback**
Revert an import instantly if needed, helping maintain clean and reliable user data.

Visit [WP Ultimate CSV Importer Pro plugin here](https://www.smackcoders.com/wp-ultimate-csv-importer-pro.html?utmsource=web&utmcampaign=readme&utmmedium=wporg)


= Other Useful Plugins & Addons By Smackcoders =

The Leads Builder for WordPress to capture your webforms as leads to one of the top ranking open source CRM, install the [WordPress Lead Form Data Collection to CRM](https://wordpress.org/plugins/wp-leads-builder-any-crm/) Plugin. Install one of the CRM of your choice with the additional add-ons listed below and keep both parent plugin and CRM addon activated. 
* [Zoho CRM & Zoho CRM Plus](https://wordpress.org/plugins/wp-zoho-crm/)
* [Salesforce](https://wordpress.org/plugins/wp-salesforce/)
* [SugarCRM](https://wordpress.org/plugins/wp-sugar-free/)
* [Freshsales](https://wordpress.org/plugins/wp-freshsales/)
* [Vtiger CRM](https://wordpress.org/plugins/wp-tiger/)

To know more about the premium bundled version, visit [WordPress Lead Form Data Collection to CRM with unlimited features](https://www.smackcoders.com/wp-leads-builder-any-crm-pro.html)


= Helpful links =

Visit [Smackcoders](https://www.smackcoders.com/wordpress.html) to explore more WordPress products. You can write to us your comments, feedback at [support@smackcoders.com](mailto:support@smackcoders.com).

Get to know about other WordPress addons and latest product update news at [www.smackcoders.com/blogs.html](https://www.smackcoders.com/blog/category/wordpress-products).


== Screenshots ==

1. Import file upload screen  
2. Drag-and-drop mapping interface  
3. WooCommerce customer field mapping  
4. Import progress view
5. Users module selection to export
6. Configure Advanced export settings
7. Export completed page


== Installation ==

1. First, install [CSV Importer & Exporter](https://wordpress.org/plugins/wp-ultimate-csv-importer/).
2. Extract the Import-Users.zip in wordpress/wp-content/plugins using FTP or through plugin install in wp-admin.
3. Activate the plugin in the WordPress plugin list.
4. Install Import WooCommerce add-on to import WooCommerce customers.


== Frequently Asked Questions ==

= Do I need WP Ultimate CSV Importer installed? =  
Yes. This add-on works only with the parent plugin [WP Ultimate CSV Importer](https://wordpress.org/plugins/wp-ultimate-csv-importer/).

= Can I import WooCommerce billing and shipping fields? =  
Yes. All WooCommerce customer fields are supported.

= Can I import custom meta fields? =  
Absolutely. But only custom field created with WordPress default can be imported. You can check out [WP Ultimate CSV Importer pro plugin](https://www.smackcoders.com/wp-ultimate-csv-importer-pro.html?utmsource=web&utmcampaign=readme&utmmedium=wporg) if you use other custom fields plugin.

= Is it possible to update existing users? =  
Yes, but you require WP Ultimate CSV Importer pro to update users and customers data.

= Can I import users data from Google Sheets? =  
Yes. You can add your google sheet url in the external urls source of upload interface. Ensure the url is publicly accessible before processing the import.


== Changelog ==

= 1.6 =
* Added: Compatibility with WordPress 6.9.
* Added: Support for the Listeo theme, including import of profile meta fields such as phone, address, social links, and more.

= 1.5 =
* Added: Support for MemberPress Users data import/export.

= 1.4.3 =
* Resolved: Issue with PHP Notice error occurring when installing import-users plugin has been fixed.
* Resolved: Fixed PHP Notice for Undefined index: user_pass iss

= 1.4.2 =
* Checked: Compatibility for WordPress 6.4.1

= 1.4.1 =
* Checked: Compatibility for WordPress 6.3.1

= 1.4 =
* Checked: Compatibility for WordPress 6.2
* Added: BuddyPress Profile Fields Import

= 1.3 =
* Checked: Compatibility for WordPress 6.0

= 1.2.9 =
* Checked: Compatibility for WordPress 5.9

= 1.2.8 =
* Fixed: Plugin activation conflict - file missing issue

= 1.2.7 =
* Checked: Compatibility for WordPress 5.8

= 1.2.6 = 
* Added: WordPress 5.6 compatibility
* Added: PHP 8 compatibility

= 1.2.5 = 
* Fixed: User password import issue.

= 1.2.4 =
* Checked: Compatibility for WordPress 5.5.1
* Fixed: Updated existing user password based on email while import.

= 1.2.3 =
* Checked: Compatibility for WordPress 5.3.2

= 1.2.2 =
* Fixed: Minor issues and warnings

= 1.2.1 =
* Added: new api call to find plugin installed or not
* Fixed: Minor issues and notice/alert for plugin not installed.

= 1.2 =
* Fixed: wp-members image field import issue
* Added: Improved user interface and performance.
* Added: Check mandatory field in mapping section

= 1.1 =
* Added: addon support
* Fixed: send password through email

= 1.0 =
* Initial stable release version.

== Upgrade Notice ==

= 1.6 =
This update adds compatibility with WordPress 6.9 and introduces full support for importing Listeo theme profile meta fields. Updating is recommended to ensure smooth imports and improved user data handling.

= 1.5 =
* Upgrade now to enjoy the import/export compatibility for MemberPress plugin.

= 1.4.3 =
* upgrade for bug fixes

= 1.4.2 =
* upgrade now to get complete WordPress 6.4.1 compatibility.

= 1.4.1 =
* upgrade now to get complete WordPress 6.3.1 compatibility.

= 1.4 =
* upgrade now to get complete WordPress 6.2 compatibility.

= 1.3 =
* Upgrade for latest changes

= 1.2.9 =
* Upgrade for latest changes

= 1.2.8 =
* Upgrade for latest changes

= 1.2.7 =
* Upgrade for latest changes

= 1.2.6 =
* Upgrade for latest changes

= 1.2.5 =
* Upgrade for latest changes

= 1.2.4 =
* Upgrade for latest changes

= 1.2.3 =
* Upgrade for latest changes

= 1.2.2 =
* Upgrade for latest changes

= 1.2.1 =
* Minor upgrade with improvements

= 1.2 =
* Upgrade now for latest 6.0 changes

= 1.1 =
* Upgrade now for WordPress 4.8.1 compatibility.

= 1.0.0 =
* Initial release of plugin.
