PluginProbe
Import WP – CSV & XML Import Export for WordPress / 2.7.6
Import WP – CSV & XML Import Export for WordPress v2.7.6
2.15.2 2.15.1 2.15.0 2.14.24 2.14.23 2.7.0 2.7.1 2.7.10 2.7.11 2.7.12 2.7.13 2.7.14 2.7.2 2.7.3 2.7.4 2.7.5 2.7.6 2.7.7 2.7.8 2.7.9 2.8.0 2.8.1 2.8.2 2.8.3 2.9.0 All 145 releases
jc-importer / readme.txt

readme.txt in Import WP – CSV & XML Import Export for WordPress 2.7.6, at readme.txt

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