Wiki source code of Import XWiki Pages
Last modified by Eleni Cojocariu on 2026/03/19 08:46
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | To [[import>>documentation.xs.admin.imports.WebHome]] wiki Pages: | ||
| 2 | |||
| 3 | 1. [[Administer your wiki>>xwiki:documentation.xs.admin.base.content-organization.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 with the Import item highlighted"/}} | ||
| 6 | ))) | ||
| 7 | 1. Click on "Choose File" button to select the [[##XAR## package>>extensions:Extension.XAR Module Specifications]].((( | ||
| 8 | {{image reference="package-imported.png" size="medium" alt="The user interface of the Import feature with the button Choose File highlighted"/}} | ||
| 9 | ))) | ||
| 10 | 1. Click on the package uploaded under "Available Packages", and check the "Package Content".((( | ||
| 11 | {{image reference="package-content.png" size="medium" alt="The files uploaded that under the Available Packages and their content in the Package Content"/}} | ||
| 12 | ))) | ||
| 13 | 1. Unselect/select the Pages to import. By default, all Pages are selected. You can choose "None" or "All" to select/deselect, or use the box with the Tick icon.((( | ||
| 14 | {{image reference="selected-pages.png" size="medium" alt="The package content with the "/}} | ||
| 15 | ))) | ||
| 16 | 1. Choose what action to take "when a Page already exists in the wiki". This option refers to situations when a Page with the exact same [[Page reference>>documentation.xs.user.base.page.linking-references.WebHome||anchor="PageReferences"]] (i.e., in the same location within the wiki) already exists.((( | ||
| 17 | {{image reference="options-importing-package.png" size="medium" alt="The posible options to select when a page already exists in the wiki"/}} | ||
| 18 | |||
| 19 | * "Add a new version to the existing page (if different)". | ||
| 20 | ** Select this if you want to add a new version to the existing Page, but only if the content differs from the current version. This will maintain the Page's existing [[history>>documentation.xs.user.base.page.view-page.view-history.WebHome]] and create a new revision for the changes. | ||
| 21 | * "Replace the page history with the history from the package". | ||
| 22 | ** Select this if you want to replace the [[Page history>>documentation.xs.user.base.page.view-page.view-history.WebHome]] with the history from the imported package. If you don't select this, the newly imported Pages will have the [[version>>documentation.xs.user.base.page.view-page.view-history.major-minor-versions.WebHome]] "1.1" instead. | ||
| 23 | * "Reset history to version 1.1". | ||
| 24 | ** Choose this option if you want to reset the [[Page's history>>documentation.xs.user.base.page.view-page.view-history.WebHome]] and start from [[version>>documentation.xs.user.base.page.view-page.view-history.major-minor-versions.WebHome]] "1.1". This will discard any existing history and treat the imported Page as the first revision. | ||
| 25 | * If you want to keep the [[author>>documentation.xs.user.base.page.authors-page.WebHome]] of the imported Pages, make sure to check the "Import as backup package" option. Otherwise, the author of the Page will be set to the user performing the import. | ||
| 26 | ))) | ||
| 27 | 1. Click "Import" to import all the selected Pages. |