Wiki source code of Imports for Extensions
Last modified by Eleni Cojocariu-testing account on 2026/08/21 21:47
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Installing an extension by importing its [[##XAR## file>>doc:documentation.xs.admin.exports.export-content-xar-format.format-specifications.WebHome]] is technically possible but is not the recommended method, because importing an extension's Pages does not bring in the dependencies the extension needs. Use the [[Extension Manager>>doc:extensions:Extension.Extension Manager Application||anchor="HInstall"]] instead, which resolves them. | ||
| 2 | |||
| 3 | Some extensions are nevertheless packaged as ##XAR## files. When [[importing XWiki Pages>>doc:documentation.xs.admin.imports.import-xwiki-pages.WebHome]], the import process reads the ##package.xml## file contained in the archive. If that file carries an ##extensionId## value, the Importer looks the Extension up in the XWiki Extension Repositories configured in ##xwiki.properties## under the ##extension.repositories## keys. | ||
| 4 | |||
| 5 | {{image reference="imported-extension.png" size="extra" alt="The Package Content panel of an extension's archive, showing the extension name and version read from package.xml"/}} | ||
| 6 | |||
| 7 | If the Extension is found in one of those repositories, the Importer registers it as installed on the instance, and it appears in the [[Extension Manager>>doc:extensions:Extension.Extension Manager Application]] under "Installed extensions". |