Issue 94891 - Extensions : contextual help does not work anymore
Summary: Extensions : contextual help does not work anymore
Alias: None
Product: General
Classification: Code
Component: code (show other issues)
Version: OOO300m9
Hardware: Unknown All
: P3 Trivial with 2 votes (vote)
Target Milestone: OOo 3.0.1
Assignee: joerg.skottke
QA Contact: issues@framework
Depends on:
Reported: 2008-10-12 07:48 UTC by bmarcelly
Modified: 2008-12-08 12:25 UTC (History)
1 user (show)

See Also:
Issue Type: DEFECT
Latest Confirmation in: ---
Developer Difficulty: ---

Extension created to test help system in 3.0 (31.05 KB, application/vnd.openofficeorg.extension)
2008-10-12 07:50 UTC, bmarcelly
no flags Details

Note You need to log in before you can comment on or make changes to this issue.
Description bmarcelly 2008-10-12 07:48:39 UTC
I updated from 2.4.1 to OOO300m9.
In 2.4.1 there was an extension with contextual help.
In OOO300m9 the extension still works, the help may be displayed from the index pane, 
but the contextual help does not work.

In OOO300m9 I installed another extension, same problem.
Comment 1 bmarcelly 2008-10-12 07:50:24 UTC
Created attachment 57130 [details]
Extension created to test help system in 3.0
Comment 2 bmarcelly 2008-10-12 08:01:08 UTC
The above attachment creates a simple extension. Use it with english UI.
After OOo restart you can see a new node in the help tree : "How to write a help".

On a new Writer document you see a new toolbar "Test of the help".
Click on the "heart" button, it starts a dialog from Basic library basTest4. The 
contextual help is defined in this dialog but when you hit F1 the help page is not 
Comment 3 poxi1023 2008-10-13 08:51:13 UTC
Confirmed with OOo3 RC4, on Kubuntu 8.04: contextual help, working in OOo 2.4.1,
does not work anymore! Showstopper?

The only workaround I found is assigning to the dialogs or buttons HelpURL:
(from the compiled help page), instead of a defined one, like:
"org.Rup.Xamqon.odt2pml.O1". But that works only for help pages that are
directly linked to some subroutine. Others have no more contextual help...
Comment 4 Olaf Felka 2008-10-13 08:58:03 UTC
@ jsk: Please have a look.
Comment 5 joerg.skottke 2008-10-13 10:58:54 UTC
Confirmed, but this is no stopper for 3.0.
Assigning to AB who made the extensible help framework.
Setting target 3.0.1 (is a regression).
Comment 6 ab 2008-10-20 09:44:38 UTC
After having a closer look, I found that this is no bug. The extension is
wrong, it does not meet the corresponding specification. As described in
in paragraph "Context sensitive help and extended tool tips" a Command URL
has to be used to bind Toolbar items or controls to their corresponding
help pages.

The problem is that "org.Rup.Xamqon.odt2pml.O1" is no URL at all as it
does not meet the scheme "<protocol>:<anything>". Unfortunately in 2.4
this wasn't tested and so also non URLs were accepted. But this was a
bug corrupting other functionality, especially the context sensitive
help inside the Basic IDE (pressing F1 while the cursor is placed on a
keyword/command opens the corresponding help).

To fix this (see
only Help URLs really meeting the URL scheme are considered to be links
to help pages while everything else is used to perform a search. The
workaround works because there a valid URL is used.

So, to solve this problem the extension has to be fixed.

Comment 7 ab 2008-10-31 13:21:22 UTC

As this problem doesn't seem to be exotic (other extension seem to
have similar problems) I had another look and now prefer to accept
at least strings containing . as help URL although they are not
really URLs. The fix of i90162 still works.
Comment 8 ab 2008-10-31 13:34:03 UTC
FIXED, -> cws ab64
Comment 9 bmarcelly 2008-10-31 14:45:10 UTC
I think it is more a problem of ambiguous documentation.
"It's important to choose a unique Command URL, e.g. by following a similar scheme 
like for the extension identifier or to refer to a service implementing the 

The scheme for the extension identifier does not request the use of colon character.
Comment 10 ab 2008-10-31 15:01:22 UTC
ab->bmarcelly: Similar, not the same as a URL is required...
But you are right, this isn't very clear. But it's fixed now anyway... :-)
Comment 11 ab 2008-10-31 16:34:16 UTC
ab->jsk: Please verify
Comment 12 joerg.skottke 2008-11-04 12:31:05 UTC
The test extension now brings me to a page called "Writing a help page,
Comment 13 joerg.skottke 2008-12-08 12:25:54 UTC
Looks good in m12. Closing