Link from content area to open search tab
Moderators: Alexander Halser, Tim Green
Link from content area to open search tab
Hello
We are using the skin "Responsive Webhelp Flat Blue Style".
Is it possible to open the search tab on the left side with a link in the content area?
Like "You can search the whole Guide by using the Keyword-Search on the left".
By clicking the link the tab on the left changes to the search tab.
This would be very helpful.
Thanks!
& best,
Thomas.
We are using the skin "Responsive Webhelp Flat Blue Style".
Is it possible to open the search tab on the left side with a link in the content area?
Like "You can search the whole Guide by using the Keyword-Search on the left".
By clicking the link the tab on the left changes to the search tab.
This would be very helpful.
Thanks!
& best,
Thomas.
- Tim Green
- Site Admin
- Posts: 23186
- Joined: Mon Jun 24, 2002 9:11 am
- Location: Bruehl, Germany
- Contact:
Re: Link from content area to open search tab
Hi Thomas,
This is easy to do, but you need to create the link as an HTML code object because it needs a special target. Click in the topic where you want to create the link, select the HTML Code Object tool in Write > Insert Object and then enter the following code in the editing box:
If you want to actually perform a search you can do it like this:
Note that any spaces in the search argument must be encoded as %20, as in the example. The same applies to accented characters, umlauts and other special characters. You can find a percent encoding reference for this here:
https://www.w3schools.com/tags/ref_urlencode.asp
(When you perform searches yourself in Help+Manual the internal scripts handle all the conversion and encoding.)
This is easy to do, but you need to create the link as an HTML code object because it needs a special target. Click in the topic where you want to create the link, select the HTML Code Object tool in Write > Insert Object and then enter the following code in the editing box:
Code: Select all
<a href="hmftsearch.html" target="hmnavigation">Open Search</a>
Code: Select all
<a href="hmftsearch.html?zoom_query=your%20search%20argument" target="hmnavigation">Open Search</a>
https://www.w3schools.com/tags/ref_urlencode.asp
(When you perform searches yourself in Help+Manual the internal scripts handle all the conversion and encoding.)
Regards,
Tim (EC Software Documentation & User Support)
Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
Tim (EC Software Documentation & User Support)
Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
Re: Link from content area to open search tab
Hi Tim
Thanks for the super fast reply.
This works... though with a quite big issue:
After clicking the link the search tab appears on the left (as it should).
But from the three grafics on top of the sidebar the "Table of contents" is still active.
And if i change between the three elements from now on in the "TOC" tab stays the search mask – no list of the topics.
This means, the TOC is gone and does not appear, until i refresh the site.
With this, this helpful possibility to show the users the search mask doesn't make sense...
For your info: we tested our webhelp project with a handfull of users and most of them had problems to find the search mask.
At least not in a short time...
So we thought, it would be helpful to have a notice/link about this feature and then open it right away (with this link).
Maybe we will now just use a grafic without a link.
Except the problem above can be solved.
Thanks!
Best regards,
Thomas.
Thanks for the super fast reply.
This works... though with a quite big issue:
After clicking the link the search tab appears on the left (as it should).
But from the three grafics on top of the sidebar the "Table of contents" is still active.
And if i change between the three elements from now on in the "TOC" tab stays the search mask – no list of the topics.
This means, the TOC is gone and does not appear, until i refresh the site.
With this, this helpful possibility to show the users the search mask doesn't make sense...
For your info: we tested our webhelp project with a handfull of users and most of them had problems to find the search mask.
At least not in a short time...
So we thought, it would be helpful to have a notice/link about this feature and then open it right away (with this link).
Maybe we will now just use a grafic without a link.
Except the problem above can be solved.
Thanks!
Best regards,
Thomas.
- Tim Green
- Site Admin
- Posts: 23186
- Joined: Mon Jun 24, 2002 9:11 am
- Location: Bruehl, Germany
- Contact:
Re: Link from content area to open search tab
Hi Thomas,
Sorry about that, I probably sent it too quickly. You also need to add this onclick handler to it:
Sorry about that, I probably sent it too quickly. You also need to add this onclick handler to it:
Code: Select all
<a href="hmftsearch.html" onclick="currentNav('search')" target="hmnavigation">Open Search</a>
Regards,
Tim (EC Software Documentation & User Support)
Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
Tim (EC Software Documentation & User Support)
Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
Re: Link from content area to open search tab
Hi Tim
Thanks – but unfortunately still the same problem/behavior...
Another idea?
Best,
Thomas.
Thanks – but unfortunately still the same problem/behavior...
Another idea?
Best,
Thomas.
- Tim Green
- Site Admin
- Posts: 23186
- Joined: Mon Jun 24, 2002 9:11 am
- Location: Bruehl, Germany
- Contact:
Re: Link from content area to open search tab
Hmm... It's working fine here. Make sure that you are really using the HTML Code Object tool and add parent. to the onclick reference like this to make absolutely sure:thschaer wrote:Thanks – but unfortunately still the same problem/behavior...
Code: Select all
<a href="hmftsearch.html" onclick="parent.currentNav('search')" target="hmnavigation">Open Search</a>
http://www.helpandmanual.com/downloads.html?upd
Just install on top of your current version to update.This will not change any of your settings etc.
Regards,
Tim (EC Software Documentation & User Support)
Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
Tim (EC Software Documentation & User Support)
Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
Re: Link from content area to open search tab
Hi Tim
Thanks for your effort.
And SORRY – I made a mistake.
We're using a customized skin with an own name.
And that's based on the skin "Minimalist Plain White", not on "Flat Blue".
My mistake, I just found out while testing with different original skins without adaptions.
"Flat Blue" > code works nice, "Minimalist Plain White" > same problem as mentioned before.
Do you have a solution for a search link for this skin?
Thanks a lot!
& best regards,
Thomas.
Thanks for your effort.
And SORRY – I made a mistake.
We're using a customized skin with an own name.
And that's based on the skin "Minimalist Plain White", not on "Flat Blue".
My mistake, I just found out while testing with different original skins without adaptions.
"Flat Blue" > code works nice, "Minimalist Plain White" > same problem as mentioned before.
Do you have a solution for a search link for this skin?
Thanks a lot!
& best regards,
Thomas.
- Tim Green
- Site Admin
- Posts: 23186
- Joined: Mon Jun 24, 2002 9:11 am
- Location: Bruehl, Germany
- Contact:
Re: Link from content area to open search tab
Hi Thomas,
"Minimalist Plain White" is a completely differnent V3 skin from the Premium Pack that uses a totally different kind of WebHelp called WebHelp 3.0. Absolutely nothing in it is in any way like the standard HM skins that I though you were referring to. Trying the methods from the standard skins there is like putting diesel in a petrol engine car...
For these skins you need to use this code in your HTML code object:
Just switch to the search pane
Switch to the search pane and perform a search
The only thing you should change here is the link text (Open Search) and the text to search for inside the single quotes in the fa: '' attribute. Leave everything else untouched.
"Minimalist Plain White" is a completely differnent V3 skin from the Premium Pack that uses a totally different kind of WebHelp called WebHelp 3.0. Absolutely nothing in it is in any way like the standard HM skins that I though you were referring to. Trying the methods from the standard skins there is like putting diesel in a petrol engine car...
For these skins you need to use this code in your HTML code object:
Just switch to the search pane
Code: Select all
<a href="javascript:void(0)" onclick="hmWebHelp.switchNavTab('search');">Open Search</a>
Code: Select all
<a href="javascript:void(0)" onclick="hmWebHelp.switchNavTab('search');setTimeout(function(){xMessage.sendObject('hmsearch',{action: 'callfunction', fn: 'hmDoFtSearch', fa: 'test'})},300);">Open Search</a>
Regards,
Tim (EC Software Documentation & User Support)
Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
Tim (EC Software Documentation & User Support)
Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
Re: Link from content area to open search tab
Hi Tim
Works like a charm!
Thank you – and sorry again for the detour...
Best,
Thomas.
Works like a charm!
Thank you – and sorry again for the detour...
Best,
Thomas.
-
- Posts: 274
- Joined: Mon Sep 13, 2004 12:44 pm
Re: Link from content area to open search tab
Hi Tim,
I like this link very much.
What I would like to have is:
- a link to activate the TOC itself;
- a link to activate the Index Tab including a search;
- a link to activate the Seach Tab including a search;
I have tried some things but did not really work, just partially.
I am using 2 different skins:
V3 responsive skin: Flat_Slate_Blue.hmskin
V3 responsive skin: Minimalist_Standard.hmskin
If you have some time, could you help me with this?
Thanks in advance.
Regards,
Paul
I like this link very much.
What I would like to have is:
- a link to activate the TOC itself;
- a link to activate the Index Tab including a search;
- a link to activate the Seach Tab including a search;
I have tried some things but did not really work, just partially.
I am using 2 different skins:
V3 responsive skin: Flat_Slate_Blue.hmskin
V3 responsive skin: Minimalist_Standard.hmskin
If you have some time, could you help me with this?
Thanks in advance.
Regards,
Paul
- Tim Green
- Site Admin
- Posts: 23186
- Joined: Mon Jun 24, 2002 9:11 am
- Location: Bruehl, Germany
- Contact:
Re: Link from content area to open search tab
Hi Paul,
First of all, I would not really recommend putting links like this in your help. It is much better to let the users navigate the help themselves, and it adds unnecessary complexity to your pages. But be my guest:
The link to activate the search tab with a search is explained above so I don't need to repeat that here. As explained above, you must enter these links as HTML code objects, NOT as normal links.
To activate the TOC:
To activate the index tab:
To activate the index tab and search in the index:
Replace the text in 'search term' with the keyword you want to search for. If you have any problems with the search not being performed because the tab is not open in time, which might happen on slower servers, try increasing the 300 to a higher value. This is the delay in milliseconds that the script waits for the tab to be displayed before performing the search.
First of all, I would not really recommend putting links like this in your help. It is much better to let the users navigate the help themselves, and it adds unnecessary complexity to your pages. But be my guest:
The link to activate the search tab with a search is explained above so I don't need to repeat that here. As explained above, you must enter these links as HTML code objects, NOT as normal links.
To activate the TOC:
Code: Select all
<a href="javascript:void(0)" onclick="hmWebHelp.switchNavTab('contents');">Open Contents</a>
Code: Select all
<a href="javascript:void(0)" onclick="hmWebHelp.switchNavTab('index');">Open Keyword Index</a>
Code: Select all
<a href="javascript:void(0)" onclick="hmWebHelp.switchNavTab('index');setTimeout(function(){xMessage.sendObject('hmindex',{action: 'callfunction', fn: 'hmDoKwSearch', fa: 'search term'})},300);">Open Index and Search</a>
Regards,
Tim (EC Software Documentation & User Support)
Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
Tim (EC Software Documentation & User Support)
Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
-
- Posts: 274
- Joined: Mon Sep 13, 2004 12:44 pm
Re: Link from content area to open search tab
Hi Tim,
First of all, thanks.
Point taken. and you are right, of course.
In some of the topics I have, it is just a "service" to the customer where the subject covers multiple topics depending on the detail you are looking for.
Maybe even this way the user is pointed to the Search and/or Index tabs.
Regards,
Paul
First of all, thanks.
Point taken. and you are right, of course.
In some of the topics I have, it is just a "service" to the customer where the subject covers multiple topics depending on the detail you are looking for.
Maybe even this way the user is pointed to the Search and/or Index tabs.
Regards,
Paul
- Tim Green
- Site Admin
- Posts: 23186
- Joined: Mon Jun 24, 2002 9:11 am
- Location: Bruehl, Germany
- Contact:
Re: Link from content area to open search tab
Hi Paul,
Look at it this way: If you put those pre-defined search links in the topics you are cooking a fish and serving it. If you explain how to search you are getting your users to learn how to fish and cook for themselves, and to be active instead of passive. In the long run they will be happier that way, because they are empowered to find things for themselves, and it will be better for you because you will have fewer support requests.Paul Elbertse wrote:In some of the topics I have, it is just a "service" to the customer where the subject covers multiple topics depending on the detail you are looking for.
Regards,
Tim (EC Software Documentation & User Support)
Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
Tim (EC Software Documentation & User Support)
Private support:
Please do not email or PM me with private support requests -- post to the forum directly.