=== cm4all-wp-impex ===
Contributors:      cm4all
Plugin Name:       cm4all-wp-impex
Plugin URI:        https://github.com/IONOS-WordPress/cm4all-wp-impex
Tags:              import, export, migration
Requires at least: 5.7
Tested up to:      6.0.2
Stable tag:        1.4.2
Version:           1.4.2
Requires PHP: 7.4
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html
Author:            Lars Gersmann, CM4all
Author URI:        https://cm4all.com

ImpEx contributes extendable Import / Export functionality to WordPress

== Description ==

ImpEx is a WordPress plugin that allows you to import and export data from and to your WordPress installation.

The primary goal for ImpEx is to provide a **true Open Source WordPress Plugin** for importing/exporting your WordPress data (including data from third-party plugins/themes).

**This plugin is in an early (but working) stage.**

Impex provides : 

* WordPress hooks for third-party plugins to expose their own data to ImpEx Import / Export without being dependent on Impex.

* a (semi) streaming architecture for large data exports/imports.

* Definition of configurable import/export profiles defining data providers to use and configuration of these data providers

  * A user interface for importing / exporting data via ImpEx WP admin screen

* the ImpEx API is designed to support resumable/cancelable imports and exports.

* ImpEx provides a REST API integrated into WordPress

* ImpEx is explicitly designed for use in managed WordPress instances

* ImpEx development relies heavily on PHP unit testing its feature set to be stable and consistent.

* a [CLI](https://ionos-wordpress.github.io/cm4all-wp-impex/impex-cli.html) for importing/exporting data via ImpEx REST interface.
  The ImpEx CLI can be used as an alternative to the ImpEx WP admin screen. 

* related NPM package [@cm4all-wp-impex/generator](https://www.npmjs.com/package/@cm4all-wp-impex/generator) enabling transformation of any content to Impex Export format.
  
  Using this package you're able to convert any content to WordPress and import it using the ImpEx plugin. See the [Tutorial](https://ionos-wordpress.github.io/cm4all-wp-impex/cm4all-wp-impex-generator/static-website-tutorial.html) 
  or [watch the walk-trough at YouTube](https://www.youtube.com/watch?v=pjG69RmULYo).

**Your help is welcome !!**

== Frequently Asked Questions ==

= Where can I find the ImpEx documentation ? =

Documentation is in a very early stage and is not yet complete.

It's available at the [Impex plugin GitHub pages](https://ionos-wordpress.github.io/cm4all-wp-impex/)

Please file bugs and feature requests at the [Impex plugin GitHub issues](https://github.com/IONOS-WordPress/cm4all-wp-impex/issues)

= Why ImpE written in PHP 8 ? =

Because PHP 8 

* is much faster than any previous PHP Version

* allows a much cleaner PHP code

The plugin version available here (at WordPress plugin directory) is transpiled down to PHP 7.4

If you prefer to use the PHP 8 version, you can download it from the [ImpEx WordPress plugin GitHub repository](https://github.com/IONOS-WordPress/cm4all-wp-impex)

= What's the current feature set ? =

* ImpEx provides right now generic providers for 

  * import/export WordPress posts/pages **including attachments/uploads** and custom post types

  * import/export configurable database tables (can be used export data from third party plugins/themes)

  * import/export configurable wp_options (can be used export data from third party plugins/themes)

* ImpEx imports and exports data as plain files directly to your local filesystem so that you can operate on the exported data (and attachments) without hassle.

* ImpEx supports snapshots to allow you to rollback to a previous state of your data without downloading the whole data to your local machine

= What's planned for the future ? =

* developer documentation integrating your plugin / theme into ImpEx 

* an intuitive user interface allowing to configure import/export profiles and configuration of the used data providers based on React and JSON Schema

* user documentation 

* monthly releases

== Changelog ==

*[1.4.2](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.4.1...1.4.2) (2022-09-15)*


*Bug Fixes*

* fixed getFiles() in @cm4all-wp-impex/generator ([570f5e4](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/570f5e485f38b64c12b44a7502cfaebc8ab8ee5e))
* image attachments without extension can be handlet by impex ([f8d157f](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/f8d157fecfa4c726c105a031bef66e01dbd7afe3))
* typos fixed ([599e950](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/599e9503cb3c886a86c46bac841b421c89eb79ea))

*[1.4.1](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.4.0...1.4.1) (2022-08-31)*


*Bug Fixes*

* updated dev environment to wordpress 6.0.2 ([271b33d](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/271b33d97078fa4e584d82575fea7cecf00fe10d))

= [1.4.0](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.3.8...1.4.0) (2022-08-30) =


*Features*

* added cleanup option to "advanced import" ui ([74ffc47](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/74ffc479b0992580ada6ea5a3b89471062f83626))
* added import option to cleanup wordpress before import ([98cb602](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/98cb6021c8e2f44e21f34bf9c1afe61605755c3d))
* impex cli import now supports providing options to the import process ([9064a77](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/9064a7725e75a714d53e9f050f2beb63125fdce7))
* impex cli supports import options like "impex-import-option-cleanup_contents" ([b218221](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/b218221d1ba23b7756d23212018a0def9094e792))
* import/export filters can now be filtered using wp filters ([f94ae55](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/f94ae55c3203a93ff1bb017ab52e026b493f2345))
* simple import roughly implemented ([2836697](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/28366974ff2d8c23a65656d73af64876c013a0d6))


*Bug Fixes*

* browser filesystem-api will use consistent snaopshot directory handle ([3960b98](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/3960b985f73b386fd3b6dd7680f7647cc859c368))
* consumeImport will gracefully handle not set option impex-import-option-cleanup_contents ([4ac7660](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/4ac7660f02e41d4dafd580e4f5ce53fe695f4042))
* ensuring that the window.crypto api is available before using it ([4b818b4](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/4b818b438cca375b73bf4eb6506d6ccc4cec224e))
* fixed crypto api detection ([893ff0d](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/893ff0d2435037ebeb5d4b816e7e8190bf407c3e))
* fixed error message if browser crypto api is missing ([9544a00](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/9544a0080decfacb9d6a6643cce03deac5aa50a0))
* fixed some typos ([a79decb](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/a79decb01d37308b2068f9caaa47b0ca0f93d01a))
* getProfile() should return an ArrayIterator ([ad6ace4](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/ad6ace41ae50aa0ad3c5227196bdc199a66e2cde))
* i18n translations fixed ([8a7f392](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/8a7f3923f12c57ae50c047b42889b9a56d03b7b2))
* impex error popup can handle multiline messages ([f6b51e1](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/f6b51e168183dd4feeee005f337637120249dcbf))
* import will no more fail on unknown post type import ([5e25505](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/5e255058c199de968a9c4a68a1d498f3419dc532))
* import will not fail on unknown taxonomy references ([eff2c2e](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/eff2c2ea5d23d7167356f2a450d5abdb087d4d24))
* made snapshot import more sensitive about files/directories ([f6120d4](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/f6120d40bf4ddecd79165ecc550804f3b6a4213f))
* relax import of users with illegal login ([fea4c5a](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/fea4c5a0e93f529d7d07481481f92360f28afe3b))
* simple ui labels fixed ([be850cf](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/be850cf4f2a1aa740dd30d438f9c890a3379073a))
* test environment runs only with disabled wp cron ([ff24148](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/ff241480518107ff4c8a8d2d88e2d0eef70a3aaa))
* upgraded rector command to latest rector cli ([bcfc886](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/bcfc88630e863dc6edc6587ba44680e644dc5a77))

*[1.3.8](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.3.7...1.3.8) (2022-07-20)*


*Bug Fixes*

* import will no more fail on unknown post type import ([df37c18](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/df37c18c3a01b09edb20ed683b257f64712f456b))

*[1.3.7](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.3.6...1.3.7) (2022-07-06)*


*Bug Fixes*

* made snapshot import more sensitive about files/directories ([e38ed41](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/e38ed41c5f40bef8ce191462e158789142dd722c))

*[1.3.6](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.3.5...1.3.6) (2022-07-05)*


*Bug Fixes*

* import will not fail on unknown taxonomy references ([c2016b5](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/c2016b59b18ad2a841acb76c5f0e1f3515ea6f2a))
* upgraded rector command to latest rector cli ([0976dcf](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/0976dcf68fdefc080331686a742dc833a209168c))

*[1.3.5](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.3.4...1.3.5) (2022-05-31)*


*Bug Fixes*

* **@cm4all-wp-impex/generator:** package.json repository property fixed ([b140ffe](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/b140ffe032cf1d349ac43a7ac995ca4ad2093869))
* **impex-cli:** made import option "profile" optional. default value is "all" ([82517e2](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/82517e2e11388c8e143a30a8e9c7bfc4c967e83e))
* rector upgrade ([fae99b8](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/fae99b8df3e64f34fcaa56cb7f3104b445df90c4))
* updated recommended vscode extensions ([facf38e](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/facf38e192295a1b39fd1e381d5dff43c501be17))
* updated supported wordpress version to 6.0 ([be2a62d](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/be2a62d44026eec73de3e6a5584d9fc424c7e03c))

*[1.3.4](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.3.3...1.3.4) (2022-05-10)*


*Bug Fixes*

* typo fixed in plugin descriptor ([419625f](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/419625f0240cff3941a58340ecbb520b4bc2effc))
* typo fixed in wordpress descriptor ([ba440bd](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/ba440bd78bcb5d153c05929f244eedd849c6d946))

*[1.3.3](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.3.2...1.3.3) (2022-05-10)*


*Bug Fixes*

* added missing youtube links to npm package and wp plugin ([62e225b](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/62e225bc9ede710eef7e5c1b12450ec9c76763fe))

*[1.3.2](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.3.1...1.3.2) (2022-05-10)*


*Bug Fixes*

* Documentation polished ([1ae7828](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/1ae7828e962c770dea474d9fae52abcea5b65dab))

*[1.3.1](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.3.0...1.3.1) (2022-05-03)*


*Bug Fixes*

* removed obsolete files ([0bc19e6](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/0bc19e61e2e0ce815fe14fc156ab2fd4f02b55ad))

= [1.3.0](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.2.1...1.3.0) (2022-05-03) =


*Features*

* added npm package [@cm4all-wp-impex](https://github.com/cm4all-wp-impex) publish informations ([c0c659a](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/c0c659a53c49004b5887bab031a98acb17a2c833))
* **attachment:** added slice property 'impex:post-references' ([fca0be4](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/fca0be4ac978faa3bf8b1aeae2319429ed5e4fe3))


*Bug Fixes*

* **impex-transform:** add testcase core/image injecting <figure>...<figcaption> using onLoad hook ([278a0d9](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/278a0d95df5b9060d2feef6011a05ce1336af8d3))
* **impex-transform:** final attempt to fix resetting block transforms for tape tests ([8c793f7](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/8c793f720598ea4a2acadb9d4544781f091816af))
* provide NPM_TOKEN to semantic-release ([5f2fed5](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/5f2fed59a76cfb1b321f1b4d2b4bc05e8c7daac3))

*[1.2.1](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.2.0...1.2.1) (2022-03-24)*


*Bug Fixes*

* assert that WP_Filesystem() is already declared ([5ff641f](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/5ff641fe6b7bf2a9defbd9d6e6e0d84b216b3aff))
* fixed impexcli docker image build ([ce435ee](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/ce435eef11bab073d8bd8e5656688a9831ff285c))
* fixed variable naming typo ([e408ade](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/e408ade71ca093675bd55bea5b366f7ca8980577))
* **impex-cli-test:** fixed paths to impex-cli ([170af21](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/170af2149611847171fd2d63b36fef49c48c3ec7))
* import php namespace issue fixed ([342e5bd](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/342e5bd643b56fa4f383b11093a7faa933bd2f76))
* **wp-env:** htaccess gets also deployed to test-Wordpress ([993b275](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/993b2758d4c343e015a9fd2fb16ecbe2fa2b7e90))

= [1.2.0](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.1.7...1.2.0) (2022-03-02) =


*Features*

* impex-cli import and export finally works ([482c87e](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/482c87e3025bfcfe0168c966594d360d547d0906))


*Bug Fixes*

* added additional links to impex plugin entry in plugins.php ([4bd2a8a](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/4bd2a8a53ac2afc86b0ac5db1ea2980d37be6cf3))
* fixed mdbook image generation ([2f613fa](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/2f613fa01bdb869474295961b6ae99452db9c551))
* fixed typo in .wp-env.override.json ([8b9227d](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/8b9227d69b9f7a7337cb321e68a7e72192bdf0c5))
* impex plugin readme template updated ([56344dd](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/56344ddab6e3d15ab96b37de8664a4fc1a5d000d))
* **impex-cli:** improved impex-cli logging ([8476260](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/84762600997a825d2aed9045d4990b42e8b5f630))

*[1.1.7](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.1.6...1.1.7) (2022-02-08)*


*Bug Fixes*

* fixed wordpress.org subversion commit command in Makefile ([3d7baa5](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/3d7baa5e4d141a4dccc5a10839a26c801ed5d6c7))
* improved Makefile ([8272a02](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/8272a02ff8335561e4e9d89495c6a32970f3b80a))
* Makefile target "deploy-to-wordpress" - fixed SVN_* variable provisioning ([d639f59](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/d639f594f49313d5ad21e7d50bf3b41bc4239972))
* Makefile target "deploy-to-wordpress" - fixed typo in svn commit message ([baedfde](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/baedfde7018598b55e7158ce12754a8555699792))
* Makefile target "deploy-to-wordpress" - SNV_* parameter provisioning ([636ec30](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/636ec30623b8f5d4b01e2917fca33c49c6f5604e))

*[1.1.6](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.1.5...1.1.6) (2022-02-08)*


*Bug Fixes*

* fixed wordpress.org subversion commit command in Makefile ([c098eb9](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/c098eb9bd4c4241b091842e183e585c1e90ee8c0))

*[1.1.5](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.1.4...1.1.5) (2022-02-08)*


*Bug Fixes*

* improved Makefile ([0bafa03](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/0bafa033bcdbbc51d3c612b34caa4b9ba9030d0f))

*[1.1.4](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.1.3...1.1.4) (2022-02-08)*


*Bug Fixes*

* Makefile target "deploy-to-wordpress" - SNV_* parameter provisioning ([0a9db88](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/0a9db88865d3ee85989711f7eca6e6ab8986b94c))

*[1.1.3](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.1.2...1.1.3) (2022-02-08)*


*Bug Fixes*

* Makefile target "deploy-to-wordpress" - fixed SVN_* variable provisioning ([4c7d229](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/4c7d2293656759e95d136454cb4ff009421e80b7))

*[1.1.2](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.1.1...1.1.2) (2022-02-08)*


*Bug Fixes*

* Makefile target "deploy-to-wordpress" - fixed typo in svn commit message ([e5edf8b](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/e5edf8b8dd51ea5de40fef6a05d9702b66662d5c))

*[1.1.1](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.1.0...1.1.1) (2022-02-08)*


*Bug Fixes*

* fixed installation of convert in github action dependencies ([52e319c](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/52e319cc9122f7c27acb39e8dabda78a12a6a840))
* fixed installation of github action dependencies ([b4a7072](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/b4a70727946905a2a2367faa9fd863ed31abd33c))

= [1.1.0](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.0.4...1.1.0) (2022-02-02) =


*Features*

* impex for php 7.4 infrastructure added ([60d9ee5](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/60d9ee548cbcf3eadf4e9a80dbf9bfc712fce3d9))
* implex plugin for php 7.4 will be generated ([af7a393](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/af7a39316d062643ee8386be280587aac492cc4c))

*[1.0.4](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.0.3...1.0.4) (2022-01-26)*


*Bug Fixes*

* improved github action semantic-release ([feeeb53](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/feeeb5315898c058af8c59015c662e069a127ccc))

*[1.0.3](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.0.2...1.0.3) (2022-01-26)*


*Bug Fixes*

* added missing "Tested up to" metdata to plugin.php and readme.txt template ([270355e](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/270355e71c1c89cb3b29958116b2b43ca5b80f18))

*[1.0.2](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.0.1...1.0.2) (2022-01-25)*


*Bug Fixes*

* "Merge main back into develop" task of github release action fixed ([e2e4632](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/e2e463239bbbdc14c414ad1b8354b5e4693634a5))
* github release action fixed ([f26da00](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/f26da00011498e24ee816c20cdb11ca4b7559674))

*[1.0.1](https://github.com/IONOS-WordPress/cm4all-wp-impex/compare/1.0.0...1.0.1) (2022-01-25)*


*Bug Fixes*

* fixed typo for impex plugin field "Description" ([4e674f3](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/4e674f3105fa6f22fdf808eddad55f12caf22afe))

= 1.0.0 (2022-01-25) =


*Features*

* initial release ([69a74a7](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/69a74a70792304daff22d5bef721382f820e90d4))


*Bug Fixes*

* added missing package-lock.json ([bf5b9d5](https://github.com/IONOS-WordPress/cm4all-wp-impex/commit/bf5b9d5541e732046edd466ef5b07784f92dcd3c))

== Upgrade Notice ==

There is currently no upgrade needed.