| 1 |
=== Import WP - Import and Export WordPress data to XML or CSV files === |
| 2 |
Contributors: jcollings |
| 3 |
Tags: wordpress csv import, wordpress xml import, wordpress csv export, wordpress xml export, csv, xml, bulk edit, migrate, wordpress importer, wordpress exporter, import xml file, import csv file, xml importer, csv importer, csv to wordpress, xml to wordpress |
| 4 |
Requires at least: 4.0 |
| 5 |
Tested up to: 6.1 |
| 6 |
Requires PHP: 5.4 |
| 7 |
Stable tag: 2.7.1 |
| 8 |
License: GPLv3 |
| 9 |
License URI: http://www.gnu.org/licenses/gpl.html |
| 10 |
Donate link: https://www.importwp.com/ |
| 11 |
|
| 12 |
Import WP is a powerful Importer & Exporter with a visual data selection tool that makes it easy to Export or Import any XML or CSV file to WordPress. |
| 13 |
|
| 14 |
== Description == |
| 15 |
|
| 16 |
Import WP makes it easy to import any xml or csv files to WordPress, and export any wordpress data to xml, csv or json. |
| 17 |
|
| 18 |
Import WP is a WordPress Importer and Exporter plugin that makes importing and exporting wordpress content easy, fast and straightforward. |
| 19 |
|
| 20 |
Each import has been optimised to the following steps: |
| 21 |
|
| 22 |
1. Attach an XML or CSV file. |
| 23 |
2. Select each part of a WordPress post, page, category, taxonomy or user and mapping it to the file. |
| 24 |
3. Set what is used to identify each record, and select what the importer can insert, update and delete. |
| 25 |
4. Run the importer. |
| 26 |
|
| 27 |
Import WP importer fully supports all core WordPress data types such as Posts, Pages, Attachments, Tags, Categories, and Users. This means you can easily import data from any xml or csv into all core WordPress data types using our data selection tool to visually map every field. |
| 28 |
|
| 29 |
Each export is comprised of the following steps: |
| 30 |
|
| 31 |
1. Select what WordPress fields should be exported. |
| 32 |
2. Select the desired output format. |
| 33 |
3. Run the exporter. |
| 34 |
|
| 35 |
Import WP exporter allows you to export posts, pages, custom post types, attachment urls and details, tags, categories, custom taxonomies, users, and custom fields. This means you can easily generate csv, xml or json files containing only the data you need. |
| 36 |
|
| 37 |
**What if you want to import xml or csv to custom post types, custom fields or custom taxonomies?** |
| 38 |
|
| 39 |
[With the pro version of Import WP](https://www.importwp.com/pricing/?utm_campaign=Import%2BWP%2BPro%2BUpgrade&utm_source=wordpress.org&utm_medium=free%2Bplugin%2Blisting), you can import xml or csv to any custom post types, custom fields or custom taxonomies created by themes or plugins. |
| 40 |
|
| 41 |
|
| 42 |
**What is Pro?** |
| 43 |
|
| 44 |
The Pro version adds the following extra features: |
| 45 |
|
| 46 |
* Import any post type, taxonomy or user custom fields. |
| 47 |
* Import WordPress custom post types. |
| 48 |
* Import WordPress custom taxonomies |
| 49 |
* Speed imports by importing chunks in parallel using the WordPress cron system. |
| 50 |
* Schedule importers |
| 51 |
|
| 52 |
Find out more [about Import WP Pro on our websie](https://www.importwp.com/?utm_campaign=Import%2BWP%2BPro%2BUpgrade&utm_source=wordpress.org&utm_medium=free%2Bplugin%2Blisting). |
| 53 |
|
| 54 |
== Installation == |
| 55 |
|
| 56 |
1. Upload 'jc-importer' to the '/wp-content/plugins/' directory |
| 57 |
2. Activate the plugin through the 'Plugins' menu in WordPress |
| 58 |
3. A new menu item under Tools > Import WP should appear where you can access the plugin. |
| 59 |
|
| 60 |
For further documentation on installing and using Import WP features can be found [here](https://www.importwp.com/documentation/). |
| 61 |
|
| 62 |
== Frequently Asked Questions == |
| 63 |
|
| 64 |
= How do i create an importer = |
| 65 |
|
| 66 |
Documentation on adding an importer can be viewed [here](https://www.importwp.com/documentation/how-to-add-an-importer/) |
| 67 |
|
| 68 |
= What settings does each importer have = |
| 69 |
|
| 70 |
Documentation on using the importer settings can be found [here](https://www.importwp.com/documentation/importer-file-settings/) |
| 71 |
|
| 72 |
= How to import from an XML/CSV files = |
| 73 |
|
| 74 |
A guide to importing data from an xml file can be viewed [here](https://www.importwp.com/documentation/template-fields/) |
| 75 |
|
| 76 |
= How do i run an importer once it is setup = |
| 77 |
|
| 78 |
A guide to running and pausing an import can be viewed [here](https://www.importwp.com/documentation/run-import/) |
| 79 |
|
| 80 |
== Screenshots == |
| 81 |
|
| 82 |
1. Import WP, New importer screen |
| 83 |
2. Import WP, Post template setup screen |
| 84 |
3. Import WP, Run import page |
| 85 |
4. Import WP, Import history page |
| 86 |
|
| 87 |
== Changelog == |
| 88 |
|
| 89 |
= 2.7.1 = |
| 90 |
|
| 91 |
* FIX - Revert default exporter delimiter back to "," |
| 92 |
|
| 93 |
= 2.7.0 = |
| 94 |
|
| 95 |
* ADD - Extend exporter field select options with ability to rename and structure output. |
| 96 |
* FIX - Multiline custom method matching. |
| 97 |
* FIX - Fix missing wp_read_audio_metadata dependency when importing audio files. |
| 98 |
|
| 99 |
= 2.6.5 = |
| 100 |
|
| 101 |
* ADD - new helper function iwp_fn_get_posts_by. |
| 102 |
* FIX - Add memory usage escape check, hard limit of 90%. |
| 103 |
|
| 104 |
= 2.6.4 = |
| 105 |
|
| 106 |
* FIX - Importer CSV file settings page disable flag not changing when fields are updated. |
| 107 |
* ADD - Imported Record tracking is moved from meta tables to own table. |
| 108 |
* ADD - Allow custom text entry on repeater base node field. |
| 109 |
|
| 110 |
= 2.6.3 = |
| 111 |
|
| 112 |
* FIX - Importer session has changed fatal importer error during import initialization. |
| 113 |
|
| 114 |
= 2.6.2 = |
| 115 |
|
| 116 |
* FIX - AddonBasePanel save callback was not following permission rules. |
| 117 |
* FIX - PHP error caused by , at end of arrays. |
| 118 |
* FIX - Importer session has changed fatal importer error during import initialization. |
| 119 |
|
| 120 |
= 2.6.1 = |
| 121 |
|
| 122 |
* FIX - Importer state to work with WP Multisite. |
| 123 |
|
| 124 |
= 2.6.0 = |
| 125 |
|
| 126 |
* ADD - Simplified importer runner, import chunks removed in faviour of state locking. |
| 127 |
|
| 128 |
= 2.5.5 = |
| 129 |
|
| 130 |
* ADD - New action `iwp/importer/mapper/init` run before a record has been imported. |
| 131 |
* ADD - New action `iwp/importer/mapper/before` to modify data before importing a record. |
| 132 |
* ADD - New action `iwp/importer/mapper/before_insert` to modify data before inserting a record. |
| 133 |
* ADD - New action `iwp/importer/mapper/before_update` to modify data before updating a record. |
| 134 |
* ADD - New action `iwp/importer/mapper/after` run after a record has been imported. |
| 135 |
|
| 136 |
= 2.5.4 = |
| 137 |
|
| 138 |
* ADD - New filter `iwp/allowed_file_types` to allow different file types apart from the default xml / csv. |
| 139 |
* ADD - New filter `iwp/get_filetype_from_ext` to allow setting the file type based on the attached file name. |
| 140 |
|
| 141 |
= 2.5.3 = |
| 142 |
|
| 143 |
* FIX - Addon Panel, Core template fields are no longer excluded from processing due to missing enabled flag. |
| 144 |
|
| 145 |
= 2.5.2 = |
| 146 |
|
| 147 |
* FIX - Hash geneartion on local files now match correctly. |
| 148 |
* ADD - Downloaded media without extensions, attempt to get extension from content-type header. |
| 149 |
|
| 150 |
= 2.5.1 = |
| 151 |
|
| 152 |
* FIX - Restore old method of loading woocomerce / yoast addon |
| 153 |
* FIX - Only the importer that deletes a record, can restore that record unless you use the post_status field. |
| 154 |
|
| 155 |
= 2.5.0 = |
| 156 |
|
| 157 |
* ADD - 1st release of `iwp_register_importer_addon` api |
| 158 |
* ADD - File encoding dropdown added to xml imports under file settings step. |
| 159 |
* FIX - Issue where 2 fields can match with the same prefix on a group e.g. gallery-id vs gallery-id-url. |
| 160 |
|
| 161 |
= 2.4.10 = |
| 162 |
|
| 163 |
* FIX - Custom methods no longer break when the character ")" is present. |
| 164 |
|
| 165 |
= 2.4.9 = |
| 166 |
|
| 167 |
* FIX - fix js load issue on some installs with ReferenceError: regeneratorRuntime is not defined. |
| 168 |
* FIX - Add missing term description field to exporter. |
| 169 |
* FIX - Term importer now displays list of private taxonomies. |
| 170 |
* FIX - Post taxonomies section hierachy follows stricter rules allowing for multiple terms with the same name if nested under a different parent e.g. "Term 1 > Term 1" |
| 171 |
|
| 172 |
= 2.4.8 = |
| 173 |
|
| 174 |
* FIX - Update importer filter row functionality. |
| 175 |
|
| 176 |
= 2.4.7 = |
| 177 |
|
| 178 |
* FIX - Allow for zip, and gz file extensions to work with previously forced file extensions. |
| 179 |
* ADD - Add new addon registration function `iwp_register_importer_addon` |
| 180 |
|
| 181 |
= 2.4.6 = |
| 182 |
|
| 183 |
* ADD - New setting to limit the number of log files stored, by default this is set to unlimited. |
| 184 |
* FIX - Fix RCE issue by forcing correct extensions on imported data files. |
| 185 |
|
| 186 |
= 2.4.5 = |
| 187 |
|
| 188 |
* ADD - New "Media Library" option added to attachment download field, allowing you to search for attachments previously uploaded to your media library. |
| 189 |
|
| 190 |
= 2.4.4 = |
| 191 |
|
| 192 |
* ADD - Add filters to allow addons to extend the exporter custom field list and alter data before being exported. |
| 193 |
|
| 194 |
= 2.4.3 = |
| 195 |
|
| 196 |
* ADD - Add contains-in, not-contains-in importer filters. |
| 197 |
* FIX - Fix contains and not contains filters. |
| 198 |
|
| 199 |
= 2.4.2 = |
| 200 |
|
| 201 |
* ADD - Edit name of importer by clicking the importers name on single importer screen. |
| 202 |
|
| 203 |
= 2.4.1 = |
| 204 |
|
| 205 |
* ADD - Attachment fields now have an option to fetch fresh images, instead of always using a found image from media library. |
| 206 |
* ADD - export parent id, slug, and names for taxonomies. |
| 207 |
* FIX - Tweak interface, and add upgrade notice to importer page. |
| 208 |
|
| 209 |
= 2.4.0 = |
| 210 |
|
| 211 |
* ADD - Added new exporter section to interface, allowing the exporting of wordpress data to XML / CSV / JSON. |
| 212 |
* FIX - Fix upload error causing white screen. |
| 213 |
|
| 214 |
= 2.3.0 = |
| 215 |
|
| 216 |
* ADD - Add option to move posts / pages to trash instead of forceful deletion. |
| 217 |
* ADD - Add `iwp/custom_field_label` filter to alter custom field label on importer log. |
| 218 |
* ADD - Add data mapper and serialization tool. |
| 219 |
* ADD - Add unique identifier field on permissions step for templates using user or post mapper. |
| 220 |
|
| 221 |
= 2.2.5 = |
| 222 |
|
| 223 |
* ADD - Add `iwp/register_events` hook to allow extension of the event system. |
| 224 |
|
| 225 |
= 2.2.4 = |
| 226 |
|
| 227 |
* FIX - Update custom method handler to work with xml with large amounts of whitespace. |
| 228 |
|
| 229 |
= 2.2.3 = |
| 230 |
|
| 231 |
* FIX - Unable to create new importer due to null file settings merge. |
| 232 |
|
| 233 |
= 2.2.2 = |
| 234 |
|
| 235 |
* FIX - Importer files are now prefixed with id-file_id- |
| 236 |
* FIX - Downloading remote files now return not found, or empty file errors. |
| 237 |
|
| 238 |
= 2.2.1 = |
| 239 |
|
| 240 |
* ADD - New setting field for file rotation |
| 241 |
* FIX - Replace php data flushing with manual ajax fetching of importer status. |
| 242 |
* FIX - Make it easier to select csv fields with empty values. |
| 243 |
* FIX - Properly log skipped records |
| 244 |
* FIX - Fixed issue on windows file uploads causing File Not Found Error. |
| 245 |
* FIX - Allow '.' in field name when using permissions. |
| 246 |
* FIX - Attempt to skip php output in ajax/rest response. |
| 247 |
|
| 248 |
= 2.2.0 = |
| 249 |
|
| 250 |
* ADD - Ability to split imports into sections/chunks. |
| 251 |
* ADD - filter iwp/importer/chunk_size |
| 252 |
* ADD - iwp/importer/datasource |
| 253 |
* ADD - Ability to use custom methods when importing, [custom_fun("arg1", ...)] |
| 254 |
* FIX - Fixed an issue with repeater sections displaying wrong data on front end. |
| 255 |
* FIX - Fixed double serialization on term meta and user meta when updating records. |
| 256 |
|
| 257 |
= 2.1.0 = |
| 258 |
|
| 259 |
* ADD - Ability to filter records/rows before being imported. |
| 260 |
* FIX - Fixed post_status bugs |
| 261 |
* ADD - Ability to add multiple schedules per importer |
| 262 |
* ADD - Ability to import/export importers. |
| 263 |
* FIX - Fixed issue with cron scheduling, now uses local time |
| 264 |
* ADD - new filter to override the default timeout length |
| 265 |
|
| 266 |
= 2.0.23 = |
| 267 |
|
| 268 |
* ADD - Update importer.custom_fields.process_field to return values |
| 269 |
* ADD - Send xml / csv headers when downloading file |
| 270 |
* FIX - Fix issue with duplicate nested xml tags prematurely closing record. |
| 271 |
* FIX - File process now checks x amount of records when processing file for importer editor. |
| 272 |
* FIX - Template fields are now fetched via REST, passing importer model to get_fields() |
| 273 |
|
| 274 |
= 2.0.22 = |
| 275 |
* ADD - Ability to download debug log on import screen. |
| 276 |
* FIX - Enable field label uses Field label instead of key. |
| 277 |
|
| 278 |
= 2.0.0 = |
| 279 |
|
| 280 |
* ADD - Rewrite of PHP code to use namespaces, and WordPress Rest API. |
| 281 |
* ADD - New User Interface, Moved plugin menu item from top level to under tools. |
| 282 |
* ADD - Update frontend code to use ReactJS library. |
| 283 |
* ADD - Debug panel on edit importer screen. |
| 284 |
* ADD - Importer logs to Debug panel. |
| 285 |
* ADD - Importer Settings base64 encoded string. |
| 286 |
* FIX - Remove taxonomy field from term template, now pick taxonomy at start. |
| 287 |
* FIX - AJAX load in field options. |
| 288 |
* FIX - Importer Speed increases. |
| 289 |
|
| 290 |
= 1.1.8 = |
| 291 |
|
| 292 |
* FIX - Permissions bug |
| 293 |
* ADD - Uninstall method to clear database and files on plugin deletion (not deactivation). |
| 294 |
|
| 295 |
= 1.1.7 = |
| 296 |
|
| 297 |
* DEL - Remove unused custom curl methods for downloading attachments |
| 298 |
* FIX - escape output data globally |
| 299 |
* FIX - sanitize data globally |
| 300 |
* FIX - Add nounce's to all ajax requests |
| 301 |
|
| 302 |
= 1.1.6 = |
| 303 |
|
| 304 |
* FIX - Post Deletion Vulnerability in Import WP. |
| 305 |
* FIX - Add tool to reset Import WP database. |
| 306 |
* FIX - Display errors when processing file fails. |
| 307 |
|
| 308 |
= 1.1.5 = |
| 309 |
|
| 310 |
* ADD - Visual Permission editor to filter fields to be imported per insert/update |
| 311 |
* EDIT - Change csv column selector to show a vertical table with one record. |
| 312 |
|
| 313 |
= 1.1.4 - 11/07/2019 = |
| 314 |
|
| 315 |
* ADD - Fetch files via wp_remote_get instead of curl or file_get_contents |
| 316 |
* ADD - Display information about custom field imports / errors |
| 317 |
* FIX - post_parent field for page template displays correctly |
| 318 |
* FIX - default value not being loaded when enabling field |
| 319 |
* FIX - Fetch non cached row count when selecting xml base nodes |
| 320 |
|
| 321 |
= 1.1.3 - 08/04/2019 = |
| 322 |
|
| 323 |
* ADD - iwp/importer/file_uploaded action |
| 324 |
* ADD - set file encoding via filter iwp/importer/file_encoding |
| 325 |
* FIX - Change plugin support link |
| 326 |
* FIX - include delimiter into record size calculations |
| 327 |
|
| 328 |
= 1.1.2 - 16/03/2019 = |
| 329 |
|
| 330 |
* ADD - store hash of imported attachments to compare against versions |
| 331 |
* ADD - Add iwp/{FIELD_TYPE}_field, iwp/{FIELD_TYPE}/{FIELD_NAME} filters |
| 332 |
* ADD - post date now tries to convert to correct format |
| 333 |
|
| 334 |
= 1.1.1 - 22/01/2019 = |
| 335 |
|
| 336 |
* FIX - Remove whitespace before importing remote attachments. |
| 337 |
* FIX - Attachment Preview. |
| 338 |
* FIX - Preview Error when importer has been first created. |
| 339 |
|
| 340 |
= 1.1.0 - 16/01/2019 = |
| 341 |
|
| 342 |
* FIX - Import WP XMLFile reader, stop xml parsing CDATA |
| 343 |
* ADD - Introduce new methods to make building templates easier |
| 344 |
* EDIT - Re-Structure libs folder. |
| 345 |
|
| 346 |
= 1.0.5 - 23/10/2018 = |
| 347 |
|
| 348 |
* ADD - unique template field, set which field is used to identify a record |
| 349 |
* FIX - Multiple bugs fixed. |
| 350 |
* ADD - new filter 'iwp/import_mapper_permissions' to block fields from being modified |
| 351 |
* ADD - new filter 'iwp/template_unique_fields' to override the templates unique reference field |
| 352 |
|
| 353 |
= 1.0.4 - 16/10/2018 = |
| 354 |
|
| 355 |
* ADD - Add aria-label to inputs. |
| 356 |
* ADD - Add file index cache based on amount of rows chosen |
| 357 |
|
| 358 |
= 1.0.3 - 09/10/2018 = |
| 359 |
|
| 360 |
* FIX - Reduce memory load by streaming file indices. |
| 361 |
* FIX - Speed up Post importer for larger files. |
| 362 |
* FIX - Add Processing notification when file is added/updated. |
| 363 |
* FIX - Remove templates fetching dropdown option values to edit importer screen only. |
| 364 |
|
| 365 |
= 1.0.1 - 28/09/2018 = |
| 366 |
|
| 367 |
* FIX - multiple XML import issues |
| 368 |
* FIX - import display to show error total |
| 369 |
* FIX - Preview block to hide loading text if no value |
| 370 |
|
| 371 |
= 1.0 - 29/04/2018 = |
| 372 |
|
| 373 |
* Integrated new and improved XML and CSV importers |
| 374 |
|
| 375 |
= 0.7 - 04/02/2018 = |
| 376 |
|
| 377 |
* Add - tooltips ot xml base node fields, Slightly simplify XML process by hiding group base nodes. |
| 378 |
* Fix - Run link on importer archive screen would not start new csv import if one had completed previously. |
| 379 |
* Fix - Change links in about block |
| 380 |
|
| 381 |
= 0.6 - 22/08/2017 = |
| 382 |
|
| 383 |
* Optimise CSV Parser |
| 384 |
|
| 385 |
= 0.5 = |
| 386 |
|
| 387 |
* Add tooltips to title, slug, content and excerpt fields. |
| 388 |
* Add the ability to import attachments from a local folder. |
| 389 |
* Fix - Issue with php7.1.1 and saving of template data throwing warning for type missmatch string to array. |
| 390 |
|
| 391 |
= 0.4.1 - 08/06/2017 = |
| 392 |
|
| 393 |
* Fix admin redirect when uploading new file on edit screen |
| 394 |
* Add filter to change template name when importer is created: jci/importer/template_name |
| 395 |
|
| 396 |
= 0.4 - 20/05/2017 = |
| 397 |
|
| 398 |
* Add filter to alter field data: jci/parse_csv_field and jci/parse_xml_field |
| 399 |
* Add filter to alter specific field data: jci/parse_csv_field/{{field_name}} and jci/parse_xml_field/{{field_name}} |
| 400 |
* UI Improvements |
| 401 |
|
| 402 |
= 0.3.1 - 11/04/2017 = |
| 403 |
|
| 404 |
* Change Interfaces |
| 405 |
* Change upgrade notices |
| 406 |
|
| 407 |
= 0.3 - 26/03/2017 = |
| 408 |
|
| 409 |
* Rename plugin to Import WP |
| 410 |
* Fix Broken unit tests, make it work with WP 4.7.3 |
| 411 |
* Simplify Creation Process |
| 412 |
|
| 413 |
= 0.2 = |
| 414 |
|
| 415 |
* fix wrong user version importer tag when adding |
| 416 |
* allow addition of user meta values (add/edit) |
| 417 |
|
| 418 |
= 0.1.9 = |
| 419 |
|
| 420 |
* Improve create importer screen. |
| 421 |
* fix misspelled version variable causing warnings |
| 422 |
|
| 423 |
= 0.1.8 = |
| 424 |
|
| 425 |
* Fix get_groups() issue in mapper |
| 426 |
|
| 427 |
= 0.1.7 = |
| 428 |
|
| 429 |
* Update XML node selector modal window |
| 430 |
|
| 431 |
= 0.1.6 = |
| 432 |
|
| 433 |
* set default options to field dropdown list |
| 434 |
* skip empty attachments, and taxonomies |
| 435 |
* move preview record box next to fields |
| 436 |
|
| 437 |
= 0.1.5 = |
| 438 |
|
| 439 |
* Disable attachment check when switching importer file from list due to empty results |
| 440 |
* Add XMLReader library for creating xml node and element selectors |
| 441 |
|
| 442 |
= 0.1.4 = |
| 443 |
|
| 444 |
* Switch saving importer files as attachments to custom post type, stopping filling media library with files |
| 445 |
* Clear current import status on new file upload globally |
| 446 |
|
| 447 |
= 0.1.3 = |
| 448 |
|
| 449 |
* Add file session storage for CSV import |
| 450 |
* Save session between imports to keep track of file pointer position |
| 451 |
* Allow multiple records to be imported per ajax request |
| 452 |
|
| 453 |
= 0.1.2 = |
| 454 |
|
| 455 |
* Improved import speed |
| 456 |
* Fixed attachment import error message |
| 457 |
* Added importer permissions to add screen |
| 458 |
|
| 459 |
= 0.1.1 = |
| 460 |
|
| 461 |
* Allow page authors to use username, or ID |
| 462 |
* Fix post author and post name |
| 463 |
* Add Tax Template and Mapper |
| 464 |
|
| 465 |
= 0.1 = |
| 466 |
|
| 467 |
* JC Importer |
