| @@ -1,27 +1,38 @@ | ||
| 1 | -=== User Import with meta - WP Ultimate CSV Importer Add-on === | |
| 2 | -Contributors: smackcoders, riswanasmack, premairuthayarajan | |
| 1 | +=== Import Users & Customers with Meta | WP Ultimate CSV Importer Add-on === | |
| 2 | +Contributors: smackcoders, premairuthayarajan | |
| 3 | 3 | Donate link: https://www.paypal.me/smackcoders |
| 4 | 4 | Requires at least: 5.0 |
| 5 | 5 | Tested up to: 7.0 |
| 6 | -Stable tag: 1.7 | |
| 7 | -Version: 1.7 | |
| 6 | +Stable tag: 2.1 | |
| 7 | +Version: 2.1 | |
| 8 | 8 | Requires PHP: 7.4 |
| 9 | 9 | Author: smackcoders |
| 10 | 10 | Author URI: https://www.smackcoders.com/wp-ultimate-csv-importer-pro.html |
| 11 | -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 | |
| 11 | +Tags: import users, user import, import users from csv, wordpress user import, user meta import, import user meta wordpress, woocommerce customer import, user import with meta, wordpress user csv import, user export, memberpress import, buddypress import, membership import | |
| 12 | 12 | License: GPLv2 or later |
| 13 | 13 | |
| 14 | -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. | |
| 14 | +Import export WordPress users and WooCommerce customers with user meta, custom fields, billing & shipping details, and membership data. | |
| 15 | 15 | |
| 16 | 16 | == Description == |
| 17 | 17 | |
| 18 | -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. | |
| 18 | +Migrating users to a new WordPress site, onboarding a customer database into WooCommerce, or managing members across a membership platform — all of it requires moving user data at scale, accurately and without duplicates. The **Import Users & Customers with Meta Add-on** makes this straightforward. | |
| 19 | 19 | |
| 20 | -It supports importing data from various sources such as your computer, external URLs, cloud platforms like Google Sheets or Dropbox, FTP/SFTP locations. | |
| 20 | +This add-on extends [WP Ultimate CSV Importer](https://wordpress.org/plugins/wp-ultimate-csv-importer/) — the free parent plugin to support bulk WordPress user import and WooCommerce customer import from CSV, XML, Excel, TSV, and Google Sheets files. It handles standard WordPress user fields, user meta, WooCommerce billing and shipping details, and profile data from popular membership plugins including **WP-Members**, **MemberPress**, **BuddyPress**, and the **Listeo** theme. | |
| 21 | 21 | |
| 22 | -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. | |
| 22 | +It also includes a full user export system, so you can export WordPress users and WooCommerce customers to CSV, XML, XLS, XLSX, JSON, or TSV. | |
| 23 | 23 | |
| 24 | +[youtube https://www.youtube.com/watch?v=pK2lKrNEnkQ&feature=youtu.be] | |
| 25 | + | |
| 26 | +**This add-on requires the free [WP Ultimate CSV Importer](https://wordpress.org/plugins/wp-ultimate-csv-importer/) plugin.** It is part of a complete data management ecosystem for WordPress and WooCommerce: | |
| 27 | + | |
| 28 | +* **[WP Ultimate CSV Importer](https://wordpress.org/plugins/wp-ultimate-csv-importer/)** (Free, required) — Import posts, pages, custom post types, and more. | |
| 29 | +* **Import Users & Customers with Meta** (This plugin) — Bulk import and export WordPress users and WooCommerce customers with full meta support. | |
| 30 | +* **[Import WooCommerce Suite](https://wordpress.org/plugins/import-woocommerce/)** — Import WooCommerce products, orders, coupons, and reviews. | |
| 31 | +* **[WP Ultimate Exporter](https://wordpress.org/plugins/wp-ultimate-exporter)** — Export any WordPress or WooCommerce data to CSV, XML, or other formats. | |
| 32 | + | |
| 33 | +Install just what you need, or use all four together for a complete import/export solution. | |
| 34 | + | |
| 24 | 35 | == Key Features == |
| 25 | 36 | |
| 26 | 37 | **Flexible Import Sources** |
| 27 | 38 | You can import user data from: |
| @@ -48,8 +59,9 @@ | ||
| 48 | 59 | **Membership Plugin Compatibility** |
| 49 | 60 | Seamlessly import profile data for: |
| 50 | 61 | - WP-Members |
| 51 | 62 | - MemberPress |
| 63 | +- BuddyPress | |
| 52 | 64 | |
| 53 | 65 | **Automatic Password Handling** |
| 54 | 66 | 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. |
| 55 | 67 | |
| @@ -99,8 +111,19 @@ | ||
| 99 | 111 | **One-Click User Migration** |
| 100 | 112 | Move users between sites seamlessly with the one-click import & migrate feature. |
| 101 | 113 | |
| 102 | 114 | |
| 115 | +== Use Cases == | |
| 116 | + | |
| 117 | +* **Migrate users from another WordPress site** — Export users from your old site and bulk import them into your new one, including all meta fields and roles. | |
| 118 | +* **Import WooCommerce customers** — Bring in a customer database with billing addresses, shipping addresses, phone numbers, and notes in one import run. | |
| 119 | +* **Onboard members from a spreadsheet** — Import a list of new members into WP-Members, MemberPress, or BuddyPress from a CSV or Excel file. | |
| 120 | +* **Sync users from an external system** — Import user data from a CRM, LMS, or HR system exported as CSV or Google Sheets. | |
| 121 | +* **Import users after a platform switch** — Moving from Shopify, Magento, or another CMS? Import your customer list directly into WooCommerce. | |
| 122 | +* **Bulk update user roles or meta** — Use update mode (PRO) to change roles, update profile fields, or assign membership levels across hundreds of users at once. | |
| 123 | +* **Migrate membership site data** — Import MemberPress or WP-Members subscriber data including subscription levels and profile fields. | |
| 124 | +* **Export users for backup or audit** — Export your full WordPress user database or WooCommerce customer list to CSV, Excel, or JSON at any time. | |
| 125 | + | |
| 103 | 126 | == How It Works == |
| 104 | 127 | |
| 105 | 128 | 1. Install WP Ultimate CSV Importer (Free). |
| 106 | 129 | 2. Install and activate this add-on. |
| @@ -212,26 +235,50 @@ | ||
| 212 | 235 | |
| 213 | 236 | |
| 214 | 237 | == Frequently Asked Questions == |
| 215 | 238 | |
| 216 | -= Do I need WP Ultimate CSV Importer installed? = | |
| 217 | -Yes. This add-on works only with the parent plugin [WP Ultimate CSV Importer](https://wordpress.org/plugins/wp-ultimate-csv-importer/). | |
| 239 | += Do I need WP Ultimate CSV Importer installed? = | |
| 240 | +Yes. This add-on works only with the free parent plugin [WP Ultimate CSV Importer](https://wordpress.org/plugins/wp-ultimate-csv-importer/). Install and activate it first. | |
| 218 | 241 | |
| 219 | -= Can I import WooCommerce billing and shipping fields? = | |
| 220 | -Yes. All WooCommerce customer fields are supported. | |
| 242 | += How do I bulk import WordPress users from CSV? = | |
| 243 | +Prepare a CSV file with your user fields (username, email, role, user meta, etc.), then go to Ultimate CSV Importer → Import. Upload your file, select "Users" as the post type, map your columns to the corresponding WordPress user fields using the drag-and-drop interface, and click Import. The plugin processes large files in iterations to prevent server timeouts. | |
| 221 | 244 | |
| 222 | -= Can I import custom meta fields? = | |
| 223 | -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. | |
| 245 | += Can I import WooCommerce customers with billing and shipping details? = | |
| 246 | +Yes. All WooCommerce customer fields are supported, including billing name, billing address, billing city, billing country, shipping address, phone number, and customer notes. Map these fields in the import screen and they will be populated on the WooCommerce customer profile. | |
| 224 | 247 | |
| 225 | -= Is it possible to update existing users? = | |
| 226 | -Yes, but you require WP Ultimate CSV Importer pro to update users and customers data. | |
| 248 | += Can I import WordPress user meta fields? = | |
| 249 | +Yes. Standard WordPress user meta fields are supported. For custom meta fields created with third-party plugins, the PRO version of WP Ultimate CSV Importer supports extended custom field compatibility. | |
| 227 | 250 | |
| 228 | -= Can I import users data from Google Sheets? = | |
| 229 | -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. | |
| 251 | += Can I import users from Google Sheets? = | |
| 252 | +Yes. Paste your publicly accessible Google Sheet URL into the external URL field in the import screen. Make sure the sheet is set to "Anyone with the link can view" before running the import. | |
| 230 | 253 | |
| 254 | += Is it possible to update existing users without creating duplicates? = | |
| 255 | +Update mode (modifying existing users by email without creating duplicates) requires the [WP Ultimate CSV Importer Pro plugin](https://www.smackcoders.com/wp-ultimate-csv-importer-pro.html). The free add-on supports fresh imports with duplicate detection by email. | |
| 231 | 256 | |
| 257 | += Can I import MemberPress or WP-Members data? = | |
| 258 | +Yes. The add-on supports importing profile data for both MemberPress and WP-Members users, including membership levels and custom profile fields. | |
| 259 | + | |
| 260 | += Can I import BuddyPress profile fields? = | |
| 261 | +Yes. BuddyPress extended profile fields are supported from version 1.4 onwards. | |
| 262 | + | |
| 263 | += What file formats are supported? = | |
| 264 | +CSV, XML, Excel (XLS/XLSX), TSV, Google Sheets, and ZIP files containing structured data are all supported for both import and export. | |
| 265 | + | |
| 266 | + | |
| 232 | 267 | == Changelog == |
| 233 | 268 | |
| 269 | += 2.1 = | |
| 270 | +* Fixed: User and BuddyPress media imports reject files with executable extensions (e.g. .php, .phtml). | |
| 271 | +* Fixed: BuddyPress file fields store a sanitized file name and only accept known file types. | |
| 272 | + | |
| 273 | += 2.0 = | |
| 274 | +* Improved: Aligned with WP Ultimate CSV Importer 9.0. | |
| 275 | +* Fixed: An SQL injection vulnerability and hardened database queries across user import and export operations. | |
| 276 | + | |
| 277 | += 1.7.1 = | |
| 278 | +* Added PHP 8.3 compatibility support | |
| 279 | +* Fixed minor bugs and stability issues | |
| 280 | + | |
| 234 | 281 | = 1.7 = |
| 235 | 282 | * Added: compatibility for WordPress 7.0 |
| 236 | 283 | |
| 237 | 284 | = 1.6 = |
| @@ -301,63 +348,9 @@ | ||
| 301 | 348 | * Initial stable release version. |
| 302 | 349 | |
| 303 | 350 | == Upgrade Notice == |
| 304 | 351 | |
| 305 | -= 1.7 = | |
| 306 | -This update ensures compatibility with WordPress 7.0. It is recommended for all users to update for smooth performance on the latest WordPress version. | |
| 352 | += 2.1 = | |
| 353 | +Security update for media imports. Update alongside WP Ultimate CSV Importer 9.2. Recommended for all users. | |
| 307 | 354 | |
| 308 | -= 1.6 = | |
| 309 | -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. | |
| 310 | - | |
| 311 | -= 1.5 = | |
| 312 | -* Upgrade now to enjoy the import/export compatibility for MemberPress plugin. | |
| 313 | - | |
| 314 | -= 1.4.3 = | |
| 315 | -* upgrade for bug fixes | |
| 316 | - | |
| 317 | -= 1.4.2 = | |
| 318 | -* upgrade now to get complete WordPress 6.4.1 compatibility. | |
| 319 | - | |
| 320 | -= 1.4.1 = | |
| 321 | -* upgrade now to get complete WordPress 6.3.1 compatibility. | |
| 322 | - | |
| 323 | -= 1.4 = | |
| 324 | -* upgrade now to get complete WordPress 6.2 compatibility. | |
| 325 | - | |
| 326 | -= 1.3 = | |
| 327 | -* Upgrade for latest changes | |
| 328 | - | |
| 329 | -= 1.2.9 = | |
| 330 | -* Upgrade for latest changes | |
| 331 | - | |
| 332 | -= 1.2.8 = | |
| 333 | -* Upgrade for latest changes | |
| 334 | - | |
| 335 | -= 1.2.7 = | |
| 336 | -* Upgrade for latest changes | |
| 337 | - | |
| 338 | -= 1.2.6 = | |
| 339 | -* Upgrade for latest changes | |
| 340 | - | |
| 341 | -= 1.2.5 = | |
| 342 | -* Upgrade for latest changes | |
| 343 | - | |
| 344 | -= 1.2.4 = | |
| 345 | -* Upgrade for latest changes | |
| 346 | - | |
| 347 | -= 1.2.3 = | |
| 348 | -* Upgrade for latest changes | |
| 349 | - | |
| 350 | -= 1.2.2 = | |
| 351 | -* Upgrade for latest changes | |
| 352 | - | |
| 353 | -= 1.2.1 = | |
| 354 | -* Minor upgrade with improvements | |
| 355 | - | |
| 356 | -= 1.2 = | |
| 357 | -* Upgrade now for latest 6.0 changes | |
| 358 | - | |
| 359 | -= 1.1 = | |
| 360 | -* Upgrade now for WordPress 4.8.1 compatibility. | |
| 361 | - | |
| 362 | -= 1.0.0 = | |
| 363 | -* Initial release of plugin. | |
| 355 | += 2.0 = | |
| 356 | +Aligned with WP Ultimate CSV Importer 9.0. Update the core plugin to get the redesigned interface, Pre-Flight Validation, and Auto Recovery for user imports. | |
