Difference between revisions of "Documentation/DevGuide/Extensions/Description of XML Elements"
m (→Element <code>/description/update-information</code>) |
m (→Element /description/dependencies/OpenOffice.org-maximal-version) |
||
(34 intermediate revisions by 8 users not shown) | |||
Line 5: | Line 5: | ||
|NextPage=Documentation/DevGuide/Extensions/Localized XML Elements | |NextPage=Documentation/DevGuide/Extensions/Localized XML Elements | ||
}} | }} | ||
+ | {{Documentation/DevGuideLanguages|Documentation/DevGuide/Extensions/{{SUBPAGENAME}}}} | ||
{{DISPLAYTITLE:Description of XML Elements}} | {{DISPLAYTITLE:Description of XML Elements}} | ||
__NOTOC__ | __NOTOC__ | ||
Line 12: | Line 13: | ||
** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/identifier|<identifier>]]</code> | ** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/identifier|<identifier>]]</code> | ||
** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/version|<version>]]</code> | ** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/version|<version>]]</code> | ||
+ | ** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/platform|<platform>]]</code> | ||
** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/registration|<registration>]]</code> | ** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/registration|<registration>]]</code> | ||
** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/dependencies|<dependencies>]]</code> | ** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/dependencies|<dependencies>]]</code> | ||
Line 18: | Line 20: | ||
** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/release-notes|<release-notes>]]</code> | ** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/release-notes|<release-notes>]]</code> | ||
** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/display-name|<display-name>]]</code> | ** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/display-name|<display-name>]]</code> | ||
+ | ** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/icon|<icon>]]</code> | ||
+ | ** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/extension-description|<extension-description>]]</code> | ||
*Since: OOo 2.0.4 | *Since: OOo 2.0.4 | ||
Line 62: | Line 66: | ||
|} | |} | ||
− | + | ||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Extension Identifiers |Extension Identifiers]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
Line 81: | Line 88: | ||
|} | |} | ||
− | + | ||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Extension Versions|Extension Versions]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
+ | |||
+ | |||
+ | ==== Element <code>/description/platform</code> ==== | ||
+ | *Parent: <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description|<description>]]</code> | ||
+ | *Children: none | ||
+ | *Since: OOo 3.0 | ||
+ | |||
+ | |||
+ | {|border="1" cellpadding=4 style="border-collapse:collapse;" | ||
+ | |-bgcolor=#EDEDED | ||
+ | |+ Attributes of <code><platform></code> | ||
+ | !Attribute | ||
+ | !Description | ||
+ | |- | ||
+ | |<code>value</code> | ||
+ | |Required. A token representing a particular platform. See [[Documentation/DevGuide/Extensions/Target Platform|Target Platform]] for details. | ||
+ | |} | ||
+ | |||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Target Platform|Target Platform]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
Line 90: | Line 122: | ||
* Since: OOo 2.0.4 | * Since: OOo 2.0.4 | ||
The registration element currently only contains the <code><simple-license></code> element. If the <code><registration></code> element exists, then it must have a child element. | The registration element currently only contains the <code><simple-license></code> element. If the <code><registration></code> element exists, then it must have a child element. | ||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Simple License|Simple License]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
+ | |||
Line 97: | Line 134: | ||
** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/registration/simple-license/license-text|<license-text>]]</code> | ** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/registration/simple-license/license-text|<license-text>]]</code> | ||
* Since: OOo 2.0.4 | * Since: OOo 2.0.4 | ||
− | The element contains the <code><license-text></code> elements, determines if all user must agree to the license, or just the person who installs it, and determines a default <code><license-text></code> element. The mechanism for determining a "default" has changed in OOo 2.4. See [[Documentation/DevGuide/Extensions/Localized XML Elements]] for details. | + | The element contains the <code><license-text></code> elements, determines if all user must agree to the license, or just the person who installs it, and determines a default <code><license-text></code> element. The mechanism for determining a "default" has changed in OOo 2.4. See [[Documentation/DevGuide/Extensions/Localized XML Elements]] for details. This element is disregarded for bundled extensions. |
If the <code><simple-license></code> element exists, then it must have at least one child element. | If the <code><simple-license></code> element exists, then it must have at least one child element. | ||
Line 109: | Line 146: | ||
|- | |- | ||
|<code>accept-by</code> | |<code>accept-by</code> | ||
− | |<code>Required.Value</code> is either “user” or “admin”. “user” means that every user has to agree to the license. That is, the extension can only be installed as user extension but not as shared extension. If it has the value “admin” then it can be deployed as shared extension as well. In that case only the person who installs it has to agree to the license. Individual users will not be asked to accept the license. They can use the extension right away. In case the value is “user” and the extension is being installed as user extension then the user must always agree to the license. | + | |<code>Required.Value</code> is either “user” or “admin”. “user” means that every user has to agree to the license. That is, the extension can only be installed as user extension but not as shared extension. If it has the value “admin” then it can be deployed as shared extension as well. In that case only the person who installs it has to agree to the license. Individual users will not be asked to accept the license. They can use the extension right away. In case the value is “user” and the extension is being installed as user extension then the user must always agree to the license. By using <code>suppress-if-required=“true“</code> it is, however, possible to install an extension for all users, that is, as shared extension, even if <code>accept-by=“user“</code>. |
|- | |- | ||
|<code>default-license-id</code> | |<code>default-license-id</code> | ||
− | |Required. Since OOo 2.4 this attribute is obsolete. | + | |Required. Since OOo 2.4 this attribute is '''obsolete'''. If the extension should work properly (regarding showing the proper license during installation) on versions prior 2.4 one must use this attribute. If one does not use this attribute then one should use the [[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/dependencies/OpenOffice.org-minimal-version|OpenOffice.org-minimal-version]] dependency with a value of '2.4'. |
+ | The attribute determines what <license-text> is used if no <license-text> element has a lang attribute whose value matches the locals of {{PRODUCTNAME}}. There must always be exactly one <code><license-text></code> element with a license-id attribute whose value matches that of the default-license-id. The type is <code>xsd:IDREF</code>. | ||
|- | |- | ||
|<code>suppress-on-update</code> | |<code>suppress-on-update</code> | ||
|Optional. When the attribute is not provided then the value “false” is assumed. The value true indicates that the license for this extension will not be displayed during installation when the same extension (same id but probably different version) is already installed. This applies for the automatic update as well as for manually installing an extension. The version of the already installed extension does not matter. Suppressing the license can be useful during the online update, because otherwise the update operation could be interrupted by many license dialogs. | |Optional. When the attribute is not provided then the value “false” is assumed. The value true indicates that the license for this extension will not be displayed during installation when the same extension (same id but probably different version) is already installed. This applies for the automatic update as well as for manually installing an extension. The version of the already installed extension does not matter. Suppressing the license can be useful during the online update, because otherwise the update operation could be interrupted by many license dialogs. | ||
+ | |- | ||
+ | |<code>suppress-if-required</code> | ||
+ | |Optional. Since 3.3. When the attribute is not provided then the value “false” is assumed. The value “true“ indicates that the license will not be displayed during installation if this is desired, which can be expressed by the unopkg switch <code>--suppress-license</code> and is implicitely assumed for bundled extensions. | ||
|} | |} | ||
− | + | ||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Simple License|Simple License]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
Line 132: | Line 176: | ||
|-bgcolor=#EDEDED | |-bgcolor=#EDEDED | ||
|+ Attributes of <code><license-text></code> | |+ Attributes of <code><license-text></code> | ||
− | + | !Attribute | |
− | + | !Description | |
|- | |- | ||
|<code>xlink:href</code> | |<code>xlink:href</code> | ||
− | |Required. The value is a relative URL to the file | + | |Required. The value is a relative URL to the license file within the extension. |
|- | |- | ||
|<code>lang</code> | |<code>lang</code> | ||
Line 142: | Line 186: | ||
|- | |- | ||
|<code>license-id</code> | |<code>license-id</code> | ||
− | |Optional. Since OOo 2.4 this attribute is obsolete. One license-text element must have this attribute and the value must match the value of the default-license-id attribute of the <code><simple-license></code> element. The type is <code>xsd:ID</code>. | + | |Optional. Since OOo 2.4 this attribute is '''obsolete'''. If the extension should work properly (regarding showing the proper license during installation) on versions prior 2.4 one must use this attribute. If one does not use this attribute then one should use the [[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/dependencies/OpenOffice.org-minimal-version|OpenOffice.org-minimal-version]] dependency with a value of '2.4'. |
+ | One license-text element must have this attribute and the value must match the value of the default-license-id attribute of the <code><simple-license></code> element. The type is <code>xsd:ID</code>. | ||
|} | |} | ||
+ | |||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Simple License|Simple License]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
+ | |||
Line 150: | Line 201: | ||
* Children: | * Children: | ||
** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/dependencies/OpenOffice.org-minimal-version|<OpenOffice.org-minimal-version>]]</code> | ** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/dependencies/OpenOffice.org-minimal-version|<OpenOffice.org-minimal-version>]]</code> | ||
+ | ** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/dependencies/OpenOffice.org-maximal-version|<OpenOffice.org-maximal-version>]]</code> | ||
** others | ** others | ||
* Since: OOo 2.0.4 | * Since: OOo 2.0.4 | ||
− | + | ||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Dependencies|Dependencies]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
Line 174: | Line 229: | ||
|- | |- | ||
|<code>dep:name</code> | |<code>dep:name</code> | ||
− | |Required. | + | |Required. Descriptive string that will be displayed. Example : “OpenOffice.org value” (where value is the value of the attribute value). |
|- | |- | ||
|<code>dep:OpenOffice.org-minimal-version</code> | |<code>dep:OpenOffice.org-minimal-version</code> | ||
Line 180: | Line 235: | ||
|- | |- | ||
|<code>value</code> | |<code>value</code> | ||
− | |Required. The required underlying OpenOffice.org version (“2.1”, “2.2”, etc.), starting with OpenOffice.org 2.1. | + | |Required. String. The required underlying OpenOffice.org version (“2.1”, “2.2”, etc.), starting with OpenOffice.org 2.1. You should not specify a particular micro version, e.g. “2.2.1”, use “2.2” instead. |
|} | |} | ||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Dependencies|Dependencies]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
+ | |||
+ | ==== Element <code>/description/dependencies/OpenOffice.org-maximal-version</code> ==== | ||
+ | * Parent: <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/dependencies|<dependencies>]]</code> | ||
+ | * Children: none | ||
+ | * Since: OOo 3.1 | ||
+ | |||
+ | |||
+ | {|border="1" cellpadding=4 style="border-collapse:collapse;" | ||
+ | |-bgcolor=#EDEDED | ||
+ | |+ Attributes of <code><OpenOffice.org-maximal-version></code> | ||
+ | !Attribute | ||
+ | !Description | ||
+ | |- | ||
+ | |<code>xmlns:dep</code> | ||
+ | |The namespace for dependency information (inherited from <code><description></code>) must be defined as | ||
+ | http://openoffice.org/extensions/description/2006 | ||
+ | |- | ||
+ | |<code>dep:name</code> | ||
+ | |Required. Descriptive string that will be displayed. Example : “OpenOffice.org value or older” (where value is the value of the attribute value). | ||
+ | |- | ||
+ | |<code>dep:OpenOffice.org-maximal-version</code> | ||
+ | |Optional. This attribute should always be defined as “2.3” for this element. | ||
+ | |- | ||
+ | |<code>value</code> | ||
+ | |Required. The required maximal underlying OpenOffice.org version (“3.0”, “3.1”, etc.). You must not specify a particular micro version, e.g. “3.1.1”, use “3.1” instead. | ||
+ | |} | ||
+ | |||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Dependencies|Dependencies]] | ||
==== Element <code>/description/update-information</code> ==== | ==== Element <code>/description/update-information</code> ==== | ||
Line 192: | Line 281: | ||
<code><update-information></code> must have at least one <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/update-information/src|<src>]]</code> child element. The second, third, etc. element are regarded as fallback, that is, the elements provide URLs to mirrors. The Extension Manager will try to get update information by using a URL and only use a different URL if an error occurred. That is, if for example the first URL references an atom feed that does not contain any references at all, but is a valid feed, then the Extension Manager assumes that there are no update information available. Then URLs from other <code><src></code> elements are not examined. Therefore the update information referenced by every URL must be identical. | <code><update-information></code> must have at least one <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/update-information/src|<src>]]</code> child element. The second, third, etc. element are regarded as fallback, that is, the elements provide URLs to mirrors. The Extension Manager will try to get update information by using a URL and only use a different URL if an error occurred. That is, if for example the first URL references an atom feed that does not contain any references at all, but is a valid feed, then the Extension Manager assumes that there are no update information available. Then URLs from other <code><src></code> elements are not examined. Therefore the update information referenced by every URL must be identical. | ||
− | + | '''See also''' | |
+ | *[[Documentation/DevGuide/Extensions/Online Update of Extensions|Online Update of Extensions]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
+ | |||
==== Element <code>/description/update-information/src</code> ==== | ==== Element <code>/description/update-information/src</code> ==== | ||
Line 209: | Line 301: | ||
|Required. The value is a URL which provides the update information directly or an atom feed which in turn references the update information. The URL can point directly to a file or it may invoke code, such as a servlet, cgi, etc, that returns the atom feed or the update information. | |Required. The value is a URL which provides the update information directly or an atom feed which in turn references the update information. The URL can point directly to a file or it may invoke code, such as a servlet, cgi, etc, that returns the atom feed or the update information. | ||
|} | |} | ||
+ | |||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Online Update of Extensions|Online Update of Extensions]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
Line 217: | Line 314: | ||
* Since: OOo 2.4 | * Since: OOo 2.4 | ||
− | The children of this element provide a [[Documentation/DevGuide/Extensions/Localized XML Elements|localized publisher name]] together with a URL | + | <code><publisher></code> must have at least one <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/publisher/name|<name>]]</code> child element. The children of this element provide a [[Documentation/DevGuide/Extensions/Localized XML Elements|localized publisher name]] together with a URL. |
− | + | ||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Publisher Information|Publisher Information]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
Line 233: | Line 333: | ||
|-bgcolor=#EDEDED | |-bgcolor=#EDEDED | ||
|+ Attributes of <code><name></code> | |+ Attributes of <code><name></code> | ||
− | + | !Attribute | |
− | + | !Description | |
|- | |- | ||
|<code>xlink:href</code> | |<code>xlink:href</code> | ||
Line 242: | Line 342: | ||
|Required. A language identifier according to RFC 3066. See also [[Documentation/DevGuide/Extensions/Localized XML Elements]]. | |Required. A language identifier according to RFC 3066. See also [[Documentation/DevGuide/Extensions/Localized XML Elements]]. | ||
|} | |} | ||
+ | |||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Publisher Information|Publisher Information]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
+ | |||
==== Element <code>/description/release-notes</code> ==== | ==== Element <code>/description/release-notes</code> ==== | ||
Line 249: | Line 355: | ||
* Since: OOo 2.4 | * Since: OOo 2.4 | ||
− | + | <code><release-notes></code> must have at least one <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/release-notes/src|<src>]]</code> child element. The children provide URLs to [[Documentation/DevGuide/Extensions/Localized XML Elements|localized release-notes]]. | |
Currently this element and its children are not used by the Extension Manager. | Currently this element and its children are not used by the Extension Manager. | ||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
Line 259: | Line 368: | ||
* Since: OOo 2.4 | * Since: OOo 2.4 | ||
− | The element contains a | + | The element contains a URL to the ''release notes''. |
Line 265: | Line 374: | ||
|-bgcolor=#EDEDED | |-bgcolor=#EDEDED | ||
|+ Attributes of <code><src></code> | |+ Attributes of <code><src></code> | ||
− | + | !Attribute | |
− | + | !Description | |
|- | |- | ||
|<code>xlink:href</code> | |<code>xlink:href</code> | ||
Line 274: | Line 383: | ||
|Required. A language identifier according to RFC 3066. See also [[Documentation/DevGuide/Extensions/Localized XML Elements]]. | |Required. A language identifier according to RFC 3066. See also [[Documentation/DevGuide/Extensions/Localized XML Elements]]. | ||
|} | |} | ||
+ | |||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
+ | |||
==== Element <code>/description/display-name</code> ==== | ==== Element <code>/description/display-name</code> ==== | ||
Line 281: | Line 395: | ||
* Since: OOo 2.4 | * Since: OOo 2.4 | ||
− | The children of this element provide a [[Documentation/DevGuide/Extensions/Localized XML Elements|localized display name]] | + | <code><display-name></code> must have at least one <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/display-name/name|<name>]]</code> child element. The children of this element provide a [[Documentation/DevGuide/Extensions/Localized XML Elements|localized display name]]. The name will be used in the GUI instead of the file name. |
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Display Name|Display Name]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
Line 294: | Line 412: | ||
{|border="1" cellpadding=4 style="border-collapse:collapse;" | {|border="1" cellpadding=4 style="border-collapse:collapse;" | ||
|-bgcolor=#EDEDED | |-bgcolor=#EDEDED | ||
− | |+ Attributes of <code><name></code> | + | |+ Attributes of <code><name></code> || |
− | |Attribute | + | !Attribute |
− | + | !Description | |
|- | |- | ||
|<code>lang</code> | |<code>lang</code> | ||
Line 302: | Line 420: | ||
|} | |} | ||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Display Name|Display Name]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
+ | |||
+ | |||
+ | ==== Element <code>/description/icon</code> ==== | ||
+ | * Parent: <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description|<description>]]</code> | ||
+ | * Children: | ||
+ | **<code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/icon/default|<default>]]</code> | ||
+ | **<code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/icon/high-contrast|<high-contrast>]]</code> | ||
+ | * Since: OOo 3.0 | ||
+ | |||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Icon|Icon]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
+ | |||
+ | ==== Element <code>/description/icon/default</code> ==== | ||
+ | * Parent: <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/icon|<icon>]]</code> | ||
+ | * Children: none | ||
+ | * Since: OOo 3.0 | ||
+ | |||
+ | |||
+ | {|border="1" cellpadding=4 style="border-collapse:collapse;" | ||
+ | |-bgcolor=#EDEDED | ||
+ | |+ Attributes of <code><default></code> || | ||
+ | !Attribute | ||
+ | !Description | ||
+ | |- | ||
+ | |<code>xlink:href</code> | ||
+ | |The value is a relative URL to the icon file within the extension. | ||
+ | |} | ||
+ | |||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
+ | |||
+ | |||
+ | ==== Element <code>/description/icon/high-contrast</code> ==== | ||
+ | * Parent: <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/icon|<icon>]]</code> | ||
+ | * Children: none | ||
+ | * Since: OOo 3.0 | ||
+ | |||
+ | |||
+ | {|border="1" cellpadding=4 style="border-collapse:collapse;" | ||
+ | |-bgcolor=#EDEDED | ||
+ | |+ Attributes of <code><high-contrast></code> || | ||
+ | !Attribute | ||
+ | !Description | ||
+ | |- | ||
+ | |<code>xlink:href</code> | ||
+ | |The value is a relative URL to the icon file within the extension. | ||
+ | |} | ||
+ | |||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
+ | |||
+ | |||
+ | ==== Element <code>/description/extension-description</code> ==== | ||
+ | Parent: <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description|<description>]]</code> | ||
+ | * Children: | ||
+ | ** <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/extension-description/src|<src>]]</code> | ||
+ | * Since: OOo 3.1 | ||
+ | <extension-description> must have at least on [[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/extension-description/src|<src>]] child element. Every child references a localized description. See [[Documentation/DevGuide/Extensions/Localized XML Elements]] for details. | ||
+ | |||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Extension Description|Extension Description]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
+ | |||
+ | |||
+ | ==== Element <code>/description/extension-description/src</code> ==== | ||
+ | * Parent: <code>[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/extension-description|<extension-description>]]</code> | ||
+ | * Child elements: none | ||
+ | * Since: OOo 3.1 | ||
+ | |||
+ | The element contains information about where to find the file containing the description text and which language it uses. | ||
+ | |||
+ | |||
+ | {|border="1" cellpadding=4 style="border-collapse:collapse;" | ||
+ | |-bgcolor=#EDEDED | ||
+ | |+ Attributes of <code><src></code> | ||
+ | !Attribute | ||
+ | !Description | ||
+ | |- | ||
+ | |<code>xlink:href</code> | ||
+ | |Required. The value is a relative URL to the description file within the extension. | ||
+ | |- | ||
+ | |<code>lang</code> | ||
+ | |Required. A language identifier according to RFC 3066. See also [[Documentation/DevGuide/Extensions/Localized XML Elements]]. | ||
+ | |} | ||
+ | |||
+ | |||
+ | '''See also''' | ||
+ | *[[Documentation/DevGuide/Extensions/Extension Description|Extension Description]] | ||
+ | *[[Documentation/DevGuide/Extensions/Example|Example of description.xml]] | ||
{{PDL1}} | {{PDL1}} | ||
− | [[Category: Extensions]] | + | |
+ | [[Category:Documentation/Developer's Guide/Extensions]] |
Revision as of 12:40, 18 February 2013
Element /description
- Parent element: document root
- Children:
- Since: OOo 2.0.4
<description>
is the root element of the description.xml.
Attribute | Description |
---|---|
xmlns
|
The default namespace of element description and all children must be defined as |
xmlns:dep
|
The namespace for dependency information must also be defined as |
xmlns:xlink
|
The xlink namespace must be defined as |
other namespace definitions | Other namespaces can be added as necessary |
Element /description/identifier
- Parent:
<description>
- Children: none
- Since: OOo 2.2
Attribute | Description |
---|---|
value
|
Required. The extension identifier. |
See also
Element /description/version
- Parent:
<description>
- Children: none
- Since: OOo 2.1
Attribute | Description |
---|---|
value
|
Required. A textual representation of the extension version. |
See also
Element /description/platform
- Parent:
<description>
- Children: none
- Since: OOo 3.0
Attribute | Description |
---|---|
value
|
Required. A token representing a particular platform. See Target Platform for details. |
See also
Element /description/registration
- Parent:
<description>
- Children:
- Since: OOo 2.0.4
The registration element currently only contains the <simple-license>
element. If the <registration>
element exists, then it must have a child element.
See also
Element /description/registration/simple-license
Parent: <registration>
- Children:
- Since: OOo 2.0.4
The element contains the <license-text>
elements, determines if all user must agree to the license, or just the person who installs it, and determines a default <license-text>
element. The mechanism for determining a "default" has changed in OOo 2.4. See Documentation/DevGuide/Extensions/Localized XML Elements for details. This element is disregarded for bundled extensions.
If the <simple-license>
element exists, then it must have at least one child element.
Attribute | Description |
---|---|
accept-by
|
Required.Value is either “user” or “admin”. “user” means that every user has to agree to the license. That is, the extension can only be installed as user extension but not as shared extension. If it has the value “admin” then it can be deployed as shared extension as well. In that case only the person who installs it has to agree to the license. Individual users will not be asked to accept the license. They can use the extension right away. In case the value is “user” and the extension is being installed as user extension then the user must always agree to the license. By using suppress-if-required=“true“ it is, however, possible to install an extension for all users, that is, as shared extension, even if accept-by=“user“ .
|
default-license-id
|
Required. Since OOo 2.4 this attribute is obsolete. If the extension should work properly (regarding showing the proper license during installation) on versions prior 2.4 one must use this attribute. If one does not use this attribute then one should use the OpenOffice.org-minimal-version dependency with a value of '2.4'.
The attribute determines what <license-text> is used if no <license-text> element has a lang attribute whose value matches the locals of OpenOffice.org. There must always be exactly one |
suppress-on-update
|
Optional. When the attribute is not provided then the value “false” is assumed. The value true indicates that the license for this extension will not be displayed during installation when the same extension (same id but probably different version) is already installed. This applies for the automatic update as well as for manually installing an extension. The version of the already installed extension does not matter. Suppressing the license can be useful during the online update, because otherwise the update operation could be interrupted by many license dialogs. |
suppress-if-required
|
Optional. Since 3.3. When the attribute is not provided then the value “false” is assumed. The value “true“ indicates that the license will not be displayed during installation if this is desired, which can be expressed by the unopkg switch --suppress-license and is implicitely assumed for bundled extensions.
|
See also
Element /description/registration/simple-license/license-text
- Parent:
<simple-license>
- Child elements: none
- Since: OOo 2.0.4
The element contains information about where to find the file containing the license text, which language it uses, and if this element is the “default” <license-text>
. The mechanism for determining a "default" has changed in OOo 2.4. See Documentation/DevGuide/Extensions/Localized XML Elements for details.
Attribute | Description |
---|---|
xlink:href
|
Required. The value is a relative URL to the license file within the extension. |
lang
|
Required. A language identifier according to RFC 3066. See also Documentation/DevGuide/Extensions/Localized XML Elements. |
license-id
|
Optional. Since OOo 2.4 this attribute is obsolete. If the extension should work properly (regarding showing the proper license during installation) on versions prior 2.4 one must use this attribute. If one does not use this attribute then one should use the OpenOffice.org-minimal-version dependency with a value of '2.4'.
One license-text element must have this attribute and the value must match the value of the default-license-id attribute of the |
See also
Element /description/dependencies
- Parent:
<description>
- Children:
- Since: OOo 2.0.4
See also
Element /description/dependencies/OpenOffice.org-minimal-version
- Parent:
<dependencies>
- Children: none
- Since: OOo 2.1
Attribute | Description |
---|---|
xmlns:dep
|
The namespace for dependency information (inherited from <description> ) must be defined as
|
dep:name
|
Required. Descriptive string that will be displayed. Example : “OpenOffice.org value” (where value is the value of the attribute value). |
dep:OpenOffice.org-minimal-version
|
Optional. This attribute should never be used with this element. |
value
|
Required. String. The required underlying OpenOffice.org version (“2.1”, “2.2”, etc.), starting with OpenOffice.org 2.1. You should not specify a particular micro version, e.g. “2.2.1”, use “2.2” instead. |
See also
Element /description/dependencies/OpenOffice.org-maximal-version
- Parent:
<dependencies>
- Children: none
- Since: OOo 3.1
Attribute | Description |
---|---|
xmlns:dep
|
The namespace for dependency information (inherited from <description> ) must be defined as
|
dep:name
|
Required. Descriptive string that will be displayed. Example : “OpenOffice.org value or older” (where value is the value of the attribute value). |
dep:OpenOffice.org-maximal-version
|
Optional. This attribute should always be defined as “2.3” for this element. |
value
|
Required. The required maximal underlying OpenOffice.org version (“3.0”, “3.1”, etc.). You must not specify a particular micro version, e.g. “3.1.1”, use “3.1” instead. |
See also
Element /description/update-information
- Parent:
<description>
- Children:
- Since: OOo 2.2
<update-information>
must have at least one <src>
child element. The second, third, etc. element are regarded as fallback, that is, the elements provide URLs to mirrors. The Extension Manager will try to get update information by using a URL and only use a different URL if an error occurred. That is, if for example the first URL references an atom feed that does not contain any references at all, but is a valid feed, then the Extension Manager assumes that there are no update information available. Then URLs from other <src>
elements are not examined. Therefore the update information referenced by every URL must be identical.
See also
Element /description/update-information/src
- Parent:
<update-information>
- Children: none
- Since: OOo 2.2
Attribute | Description |
---|---|
xlink:href
|
Required. The value is a URL which provides the update information directly or an atom feed which in turn references the update information. The URL can point directly to a file or it may invoke code, such as a servlet, cgi, etc, that returns the atom feed or the update information. |
See also
Element /description/publisher
- Parent:
<description>
- Children:
- Since: OOo 2.4
<publisher>
must have at least one <name>
child element. The children of this element provide a localized publisher name together with a URL.
See also
Element /description/publisher/name
- Parent:
<publisher>
- Children: Text
- Since: OOo 2.4
The text value of this element is the publisher name.
Attribute | Description |
---|---|
xlink:href
|
Required. The value is a URL to the web site of the publisher of the extension. |
lang
|
Required. A language identifier according to RFC 3066. See also Documentation/DevGuide/Extensions/Localized XML Elements. |
See also
Element /description/release-notes
- Parent:
<description>
- Children:
- Since: OOo 2.4
<release-notes>
must have at least one <src>
child element. The children provide URLs to localized release-notes.
Currently this element and its children are not used by the Extension Manager.
See also
Element /description/release-notes/src
- Parent:
<release-notes>
- Children: none
- Since: OOo 2.4
The element contains a URL to the release notes.
Attribute | Description |
---|---|
xlink:href
|
Required. The value is a URL to the release notes of the extension. |
lang
|
Required. A language identifier according to RFC 3066. See also Documentation/DevGuide/Extensions/Localized XML Elements. |
See also
Element /description/display-name
- Parent:
<description>
- Children:
- Since: OOo 2.4
<display-name>
must have at least one <name>
child element. The children of this element provide a localized display name. The name will be used in the GUI instead of the file name.
See also
Element /description/display-name/name
- Parent:
<display-name>
- Children: Text
- Since: OOo 2.4
The text value of this element is the display name of the extension. The string length must be greater then null and must not only contain white space characters.
Attribute | Description |
---|---|
lang
|
Required. A language identifier according to RFC 3066. See also Documentation/DevGuide/Extensions/Localized XML Elements. |
See also
Element /description/icon
- Parent:
<description>
- Children:
- Since: OOo 3.0
See also
Element /description/icon/default
- Parent:
<icon>
- Children: none
- Since: OOo 3.0
Attribute | Description |
---|---|
xlink:href
|
The value is a relative URL to the icon file within the extension. |
See also
Element /description/icon/high-contrast
- Parent:
<icon>
- Children: none
- Since: OOo 3.0
Attribute | Description |
---|---|
xlink:href
|
The value is a relative URL to the icon file within the extension. |
See also
Element /description/extension-description
Parent: <description>
- Children:
- Since: OOo 3.1
<extension-description> must have at least on <src> child element. Every child references a localized description. See Documentation/DevGuide/Extensions/Localized XML Elements for details.
See also
Element /description/extension-description/src
- Parent:
<extension-description>
- Child elements: none
- Since: OOo 3.1
The element contains information about where to find the file containing the description text and which language it uses.
Attribute | Description |
---|---|
xlink:href
|
Required. The value is a relative URL to the description file within the extension. |
lang
|
Required. A language identifier according to RFC 3066. See also Documentation/DevGuide/Extensions/Localized XML Elements. |
See also
Content on this page is licensed under the Public Documentation License (PDL). |