XML Import-Export

See also MediaWiki Importer

Introduced in Tiki3

(2022-08-14) The XML Import-Export feature is outdated, thereby broken and barely documented. It uses image galleries, which are no longer supported in Tiki. Both the import and export of images is broken.

It was possible to import/or export a list of pages or a structure in an xml format
Each page could be exported with:

• its history
• its comments
• its attached files
• its images

The export produced a zip file containing

• a wiki.xml page
• a directory for each page. And each of this directory
  • page.txt: that contains the data of a page
  • a directory attachments that contains all the attached files of the page
  • a directory images that contains all the images contained in the page (via the wiki plugin
     Plugin Image

    No image specified. One of the following parameters must be set: fileId, randomGalleryId, fgalId, attId or src.
    )
  • a directory history that contains all the data of each history

Example of a wiki.xml page

<pages>
  <page zip="noel/page.txt">
    <name>noel</name>
    <user>me</user>
    <comments>
      <comment>Joyeux Noel</comment>
    </comments>
    <images>
      <image zip="test1/images/fgal/2" where="fgal">
         <wiki>/test/tikiwikitrunk/tiki-download_file.php?fileId=2&amp;display</wiki>
      </image>
    </images>
     <attachments>
	<attachment filename="noel.jpg" attId="1" zip="test1/attachments/1">
		<filesize>89597</filesize>
		<filetype>image/jpeg</filetype>
	</attachment>
     </attachments>

     <history>
	<version version="1" zip="test1/history/1.txt">
		  <user><![CDATA[admin]]></user>
        </version>
      </history>
  </page>
</pages>

This example is very simplified. More fields are provided

For a structure we will have something like

<structure>
  <page><name>noel</name></page>
  <structure>
    <page>1 noel</page>
    <structure>
       <page>1.1 noel</page>
    </structure>
  <structure>
  <structure>
     <page>2 noel</page>
  </structure>
</structure>

The export could be done in wiki->List pages or in Structures-> List structures
The import could be done by calling tiki-import_xml_zip.php
You need to have tiki_p_admin to do the import and the export

Requirements

The ZipArchive class for php must be installed
(Example: for gentoo, emerge pecl-zip and restart the server)

Documentation

The documentation is incomplete. It consists only of the two examples above. The XML Import-Export feature uses the Smarty template engine to generate the xml.zip file. The most complete documentation is this template that is being used. It's located here in the Tiki source code: templates/tiki-export_page_xml.tpl.

Repairing XML Import-Export

For anyone who wants to repair it, here are the concerned source code files:

tiki-import_xml_zip.php

Entry point.

lib/core/Services/Wiki/Controller.php

Contains a small section which is used when exporting pages.

lib/wiki/xmllib.php

Main code. Defines a sort of library which does most of the work. This code is mostly commented now.

templates/tiki-import_xml_zip.tpl

Tempalte for the XML Zip Import page, used by tiki-import_xml_zip.php.

templates/tiki-export_page_xml.tpl

Template for the <page> element in the wiki.xml file. This means this is generating most of it.

templates/tiki-export_comment_xml.tpl

Template for comments attached to wiki pages.

Alias

• XML Import-Export
• XML Import/Export