Difference between revisions of "Documentation/DevGuide/Extensions/Checklist for Writing Extensions"

Revision as of 12:16, 30 June 2008

This page gives a brief overview about what is important when developing an extension.

Use the .oxt file extension and provide description.xml. Look here why you should use .oxt.
Provide an extension identifier. [go to XML description]
Provide a version. [go to XML description]
Provide a display name. [go to XML description]
Provide an icon. [go to XML description]
Provide a short description. [go to XML description]
Specify the target platforms. [go to XML description]
You may provide dependencies. [go to XML description]. For example, if your extension requires a 'minimal version' of OOo then use the OpenOffice.org-minimal-version dependency.
You may provide a license. [go to XML description]
You may customize the 'online update' of your extension unless the update facility of the OOo extension repository does not fit your needs. [go to XML description].
You may provide options pages in case the extension needs to be configured. [go to XML description].
Provide publisher information. [go to XML description].
Provide links to release notes (TODO: more documentation) in the description.xml. Currently only used within the 'update dialog'. When using the OOo extension repository, then the link to the release notes is automatically generated from the information entered on the web site. That is, when using the repository one does not need to provide this information in the description.xml.
Provide content for help system if necessary.

Content on this page is licensed under the Public Documentation License (PDL).

@@ Line 12: / Line 12: @@
 # Provide a [[Documentation/DevGuide/Extensions/Display_Name|'''display name''']]. [[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/display-name| [go to XML description]]]
 # Provide an [[Documentation/DevGuide/Extensions/Icon|'''icon''']]. [[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/icon|[go to XML description]]]
+# Provide a [[Documentation/DevGuide/Extensions/Short Description | '''short description''']]. [[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/icon|[go to XML description]]]
 # Specify the [[Documentation/DevGuide/Extensions/Target Platform|'''target platforms''']]. [[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/platform|[go to XML description]]]
 # You may provide [[Documentation/DevGuide/Extensions/Dependencies|'''dependencies''']]. [[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/dependencies|[go to XML description]]]. For example, if your extension requires a 'minimal version' of OOo then use the [[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/dependencies/OpenOffice.org-minimal-version|OpenOffice.org-minimal-version]] dependency.