Difference between revisions of "Documentation/DevGuide/Extensions/Extension Description"
m (allow tooltip and extension-description) |
|||
| Line 7: | Line 7: | ||
The Extension Manager can display a small text for each extension in the dialog. The full text will become visible when the extension is being selected. Originally, this text was displayed in a 'tool tip' in versions of OOo previous v3.0. | The Extension Manager can display a small text for each extension in the dialog. The full text will become visible when the extension is being selected. Originally, this text was displayed in a 'tool tip' in versions of OOo previous v3.0. | ||
| − | Versions of OOo earlier than 3.1 use the [[Documentation/DevGuide/Extensions/File Format#Extension Tooltip Description|"Tooltip Description"]] of an extension which is kept in the [[Documentation/DevGuide/Extensions/File Format#Extension Tooltip Description| manifest.xml]]. Using the "Tooltip Description" is '''deprecated''' as of OOo 3.1 and that functionality will not be maintained. Since then the description is specified in the [[Documentation/DevGuide/Extensions/Description of XML Elements|description.xml]]. | + | Versions of OOo earlier than 3.1 use the [[Documentation/DevGuide/Extensions/File Format#Extension Tooltip Description|"Tooltip Description"]] of an extension which is kept in the [[Documentation/DevGuide/Extensions/File Format#Extension Tooltip Description| manifest.xml]]. Using the "Tooltip Description" is '''deprecated''' as of OOo 3.1 and that functionality will not be maintained. Since then the description is specified in the [[Documentation/DevGuide/Extensions/Description of XML Elements|description.xml]]. OOo 3.1 and later will first try to get the description from the description.xml. If there is none then it will try to get the tooltip description. That is, extensions can start to use this feature and need not necessarily require OOo 3.1. However, developers should be aware that the tooltip description may be removed in the future. |
Using a description is similar to the use of a [[Documentation/DevGuide/Extensions/Simple License|license]]. One can put a couple of localized description files into the extension and reference them in the description.xml. The description using a locale which matches that of the office will be displayed. See [[Documentation/DevGuide/Extensions/Localized XML Elements]] for how the localization works. | Using a description is similar to the use of a [[Documentation/DevGuide/Extensions/Simple License|license]]. One can put a couple of localized description files into the extension and reference them in the description.xml. The description using a locale which matches that of the office will be displayed. See [[Documentation/DevGuide/Extensions/Localized XML Elements]] for how the localization works. | ||
Revision as of 07:36, 6 August 2008
The Extension Manager can display a small text for each extension in the dialog. The full text will become visible when the extension is being selected. Originally, this text was displayed in a 'tool tip' in versions of OOo previous v3.0.
Versions of OOo earlier than 3.1 use the "Tooltip Description" of an extension which is kept in the manifest.xml. Using the "Tooltip Description" is deprecated as of OOo 3.1 and that functionality will not be maintained. Since then the description is specified in the description.xml. OOo 3.1 and later will first try to get the description from the description.xml. If there is none then it will try to get the tooltip description. That is, extensions can start to use this feature and need not necessarily require OOo 3.1. However, developers should be aware that the tooltip description may be removed in the future.
Using a description is similar to the use of a license. One can put a couple of localized description files into the extension and reference them in the description.xml. The description using a locale which matches that of the office will be displayed. See Documentation/DevGuide/Extensions/Localized XML Elements for how the localization works. The description files must contain UTF-8 encoded text.
See also
| Content on this page is licensed under the Public Documentation License (PDL). |
