Exchange_XH – User Manual

Exchange_XH facilitates exporting and importing the contents of a CMSimple_XH website to and from XML, respectively. This may be helpful for the migration to or from other CMSs, and also for migrating between CMSimple_XH versions.

Requirements

Exchange_XH is a plugin for CMSimple_XH ≥ 1.6. It requires PHP ≥ 5.3.0 with the DOM and SimpleXML extensions.

Installation

The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.

  1. Backup the data on your server.
  2. Unzip the distribution on your computer.
  3. Upload the whole directory exchange/ to your server into CMSimple_XH's plugins directory.
  4. Set write permissions for the subdirectories css/ and languages/.
  5. Switch to Plugins→Exchange in the back-end to check if all requirements are fulfilled.

Settings

The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select Plugins → Exchange.

Localization is done under Language. You can translate the character strings to your own language if there is no appropriate language file available, or customize them according to your needs.

The look of Exchange_XH can be customized under Stylesheet.

Usage

You can export and import the contents of the current language in the plugin's main administration (Plugins→Import/Export). After successful export you find the file content.xml in the content folder of the current language, right besides the content.htm from which it was exported. To import foreign contents, you have to place content.xml, which must have an appropriate format, right besides the content.htm that you want to be overridden (so make sure you make a backup before) by the import.

For multilingual websites, each language content has to be imported and exported separately.

To migrate between CMSimple_XH versions, at first the plugin has to be installed in the old version, and all language contents have to be exported. Then the plugin has to be installed in the new version, the language contents have to be copied to their appropriate places in the new version, and all language contents have to be imported.

Limitations

Additional markup of page headings will silently be stripped during export.

License

Exchange_XH is licensed under GPLv3.

Copyright © 2017 Christoph M. Becker

French translation © 2017 Patrick Varlet

Credits

The plugin logo is designed by Dellustrations. Many thanks for publishing this icon as freeware.

Many thanks to the community at the CMSimple_XH forum for tips, suggestions and testing.

And last but not least many thanks to Peter Harteg, the father of CMSimple, and all developers of CMSimple_XH without whom this amazing CMS wouldn't exist.