Wiki source code of Import XWiki Pages
Last modified by Eleni Cojocariu on 2026/10/21 15:16
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | To [[import>>doc:documentation.xs.admin.imports.WebHome]] wiki Pages from a [[##XAR## package>>doc:documentation.xs.admin.exports.export-content-xar-format.format-specifications.WebHome]], with the [[options>>doc:documentation.xs.admin.imports.import-xwiki-pages.options.WebHome]] that decide what happens to Pages the wiki already has: | ||
| 2 | |||
| 3 | 1. [[Administer your wiki>>doc:documentation.xs.admin.base.administer-wiki.WebHome]]. | ||
| 4 | 1. Select "Content", and then select "Import" from the dropdown.((( | ||
| 5 | {{image reference="import-menu-item.png" size="medium" alt="The Content menu of the Administration with the Import entry highlighted"/}} | ||
| 6 | ))) | ||
| 7 | 1. Click the "Choose File" button and select the ##XAR## package.((( | ||
| 8 | {{image reference="package-imported.png" size="medium" alt="The Upload a new package area with the Choose File button highlighted"/}} | ||
| 9 | ))) | ||
| 10 | 1. Click the package listed under "Available packages" to display its "Package Content".((( | ||
| 11 | {{image reference="package-content.png" size="extra" alt="The uploaded archive under Available packages and the Package Content panel it opens"/}} | ||
| 12 | ))) | ||
| 13 | 1. Select the Pages to import. Every Page is selected by default: use "none" and "all", or the box with the Tick icon in front of a Page.((( | ||
| 14 | {{image reference="selected-pages.png" size="large" alt="The Package Content tree with the none and all links and a Page tick box highlighted"/}} | ||
| 15 | ))) | ||
| 16 | 1. Choose what action to take "when a Page already exists in the wiki".((( | ||
| 17 | {{image reference="options-importing-package.png" size="medium" alt="The three options offered when a Page already exists in the wiki, highlighted"/}} | ||
| 18 | ))) | ||
| 19 | 1. Check "Import as backup package" if the imported Pages have to keep their [[authors>>doc:documentation.xs.user.base.page.authors.WebHome]].((( | ||
| 20 | {{image reference="backup-package.png" size="medium" alt="The Import as backup package checkbox highlighted"/}} | ||
| 21 | ))) | ||
| 22 | 1. Click "Import". | ||
| 23 | 1. Check the import report, which counts the Pages installed, skipped and in error, and lists every installed Page as a link to it in the wiki.((( | ||
| 24 | {{image reference="import-result.png" size="large" alt="The import report, with the counts of installed, skipped and failed Pages and the list of installed Pages"/}} | ||
| 25 | ))) |