There seems to be no way to add a local help for the configuration of a component. I do not see any external component who provides something like that. Did try JCE and Kunena. All with the same result. Choosing a component from the component menu in backend and clicking on Options and there the help button shows a screen like in the attached picture. Is that only possible with the standard Joomla components?
Showing a help screen for component options from a local help file
a default window with the message, that there is no text in this page.
Joomla 3.4.1
Labels |
Removed:
?
|
Labels |
Added:
?
|
You should be able to point to a custom location by passing the right params. Take a look at JToolbarHelper::help()
Thanks for answering. Michael, I will try it with your provided link. I do not know that such an option exists.
This is probably the page you most need to read: https://docs.joomla.org/Help_system/Adding_a_help_button_to_the_toolbar
The help system was actually designed to be very flexible. The intention was that it should support third-party extensions using a wide variety of potential methods of hosting help files, both local and remote. The way the Joomla core extensions do it is by no means the only way possible.
Thanks chris I missed that page.
Can this be closed now as asked and answered?
Yes, I think so.
Status | New | ⇒ | Closed |
Closed_Date | 0000-00-00 00:00:00 | ⇒ | 2015-04-02 00:08:00 |
Chris, I think you misunderstood the original request: The issue is not how third-party components can implement a help button in general (which I agree is nicely described in the links you posted).
The issue is that in J3 third-party components have their configuration page shown in the com_config component, and this component does not provide any way to offer help pages from servers different from the default help server. So if you go to the configuration page of e.g. Kunena or VirtueMart, then the help button in the com_config component will try to use the JHELP_COMPONENTS_com_kunena_OPTIONS or JHELP_COMPONENTS_com_virtuemart_OPTIONS help keys on the Joomla server.
The corresponding code is in administrator/components/com_config/view/component/html.php, function ConfigViewComponentHtml::addToolbar:
protected function addToolbar()
{
[...]
JToolbarHelper::divider();
JToolbarHelper::help('JHELP_COMPONENTS_' . $this->currentComponent . '_OPTIONS');
}
This will always try to load the help page from the default Joomla help server, even for third-party applications (which do not have any help pages on the joomla servers, of course). Those third-party components thus do not have any way to provide help pages for the configuration page on their own servers.
For third-party components, the com_config component needs to be made more flexible to allow help pages on other servers, too... That is the real issue here.
Reopening based on the explanation of @kainhofer
Status | Closed | ⇒ | New |
Ahh, okay. In that case it's definitely a bug (in com_config).
At a quick glance I'd say that instead of inserting the component name into the key reference it should be passed as the 4th argument to JToolbarHelper::help(). Maybe something like
JToolbarHelper::help('JHELP_COMPONENTS_OPTIONS', true, null, $this->currentComponent);
Extension developers should then store the help URL (actually a URL template) in the "helpURL" parameter in component parameters. The help URL can contain substitution codes and if the above code were to be used, {keyref} would be replaced by "JHELP_COMPONENTS_OPTIONS".
@chrisdavenport @kainhofer @franzpeter this: #6639 try to fix the issue based on @chrisdavenport 's idea. I hope you can test it. Thanks
Did test with the provided code from chrisdavenport and it works as expected. Exchanging in administrator/components/com_config/view/component/html.php the old code at line 90 with that: JToolbarHelper::help('JHELP_COMPONENTS_' . strtoupper($this->currentComponent) . '_OPTIONS', true, null, $this->currentComponent);
did solve the issue.
I think we can close that issue as solved with the solution provided here: issue 6639
Status | New | ⇒ | Closed |
Closed_Date | 2015-04-02 00:08:00 | ⇒ | 2015-04-18 21:23:35 |
Closed_By | ⇒ | Bakual | |
Labels |
Removed:
?
|
No it is only for the core of Joomla. For an explanation on how it works see
https://docs.joomla.org/Help_system/How_the_help_system_works
On 1 April 2015 at 11:30, franzpeter notifications@github.com wrote:
Brian Teeman
Co-founder Joomla! and OpenSourceMatters Inc.
http://brian.teeman.net/