Wiki source code of Imports for Extensions
Last modified by Eleni Cojocariu on 2026/06/18 15:09
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | While it's technically possible to install extensions by importing [[XAR files>>documentation.xs.admin.exports.export-content-xar-format.format-specifications.WebHome]], this is not the recommended method. Importing extension Pages is not enough to have the extensions working because extensions need their dependencies. It is always better to use the [[Extension Manager>>extensions:Extension.Extension Manager Application||anchor="HInstall"]] for installing extensions, as this ensures all dependencies are properly handled. | ||
| 2 | |||
| 3 | Some extensions can be packaged as [[##XAR## files>>documentation.xs.admin.exports.export-content-xar-format.format-specifications.WebHome]]. When [[importing XWiki Pages (a ##XAR##)>>documentation.xs.admin.imports.import-xwiki-pages.WebHome]], the import process analyzes the information defined in the ##package.xml## file contained in the ##XAR## archive. If the ##package.xml## file contains an ##extensionId## value (which represents an Extension ID), the Importer will check whether this Extension exists in the configured XWiki Extension Repositories. The configuration of these repositories is defined in: ##xwiki.properties##, using the keys: ##extension.repositories##. | ||
| 4 | |||
| 5 | {{image reference="imported-extension.png" size="large" alt="The user interface of the import feature showing example of an extension uploaded as a XAR package"/}} | ||
| 6 | |||
| 7 | If the Extension is found in one of the configured repositories, the Importer will register the Extension as installed in the current XWiki instance. The Extension will be visible in the [[Extension Manager>>extensions:Extension.Extension Manager Application]], under "Installed extensions". |
