4 Replies Latest reply on Dec 22, 2010 1:02 PM by Peter Grainge

    RoboHelp and ZoomSearch in Toolbar Main

    heavywriter Level 1

      I produce KB's for my company that seem to be the rave.  User base is expanding to the entire company and I need to honestly address the failing of RH8's flawed (though better than RH7) Search. I am looking at ZoomSearch.   My customers want search input from any topic.  Not search linked from any topic. But, of course, focus groups (yes... ugh!) liked having the search input field on the toolbar even when I suggested that we can put the search input on each topic or master page header.


      I've read the original postings on this (http://forums.adobe.com/message/737933) I'm not really satisfied with the answer - that one cannot place the search field for ZoomSearch in a WebHelp toolbar without developer help. I profusely apologize for being such an upstart for even suggesting that Peter and others might have overestimated the core issue.


      As I stated above, you can add the search form to any page.  Why can you not add it to the toolbar in the skin?  I realize the skin editor is too GUI-based to be much help here, but is there some what to get right to the code for the toolbar main and just permanently into the toolbar .htm file within the top frame?


      <form method="get" action="<path>search.html"> Would need to modify with frame or target ="main"
      <input type="text" name="zoom_query" size="10" style="width: 300px;" />

      <input type="submit" value="Search" />



      I realize one drawback to this would be that whatever topics are placed in the project must have the same relative path to the search files.  Peter's tutorial solves one end of that with the suggested "search_files" folder.  You could also have all files in the project top folder (may work for some, not for me).


      Any help or suggestions would be appreciated.



        • 1. Re: RoboHelp and ZoomSearch in Toolbar Main
          MergeThis Level 4

          "overestimated the core issue"? Yikes, what the heck does that mean?


          To do what you want will require the efforts of a developer, period. As would embedding the help in your software app, as would setting permissions for viewing only portions of the help by user role, as would...well, are you getting the picture?


          To configure Zoom for our help, we disabled the default RH Search button and added a custom Search button that links to the Zoom search.html file (the separate page that contains input and results). In addition, we run the Zoom JavaScript mode so as not to have to rely on any developers' efforts.



          Good luck,


          1 person found this helpful
          • 2. Re: RoboHelp and ZoomSearch in Toolbar Main
            Peter Grainge Adobe Community Professional (Moderator)

            I'll join with Leon in wishing you luck.


            Am I right in understanding that you have got the search input field into every topic and have the search working? Presumably the topic is replaced by the search results.


            You now want that search field in the toolbar plus a button to invoke the search when the search term has been entered. Quite simply I don't know of any way to get the search field into the skin, then you have the issue of the button picking up the search term and returning the results in a different frame.


            I'm not going to say it cannot be done but I do believe it will take a developer or someone with some developments skills. If you look at ZoomSearch's own help, the closest they have come is having the Search link invoke a similar panel to RoboHelp's own search. They use a different HAT.


            If you do achieve this, please post back and hopefully share the solution.


            See www.grainge.org for RoboHelp and Authoring tips



            • 3. Re: RoboHelp and ZoomSearch in Toolbar Main
              heavywriter Level 1

              Thank you both for your answers.


              Peter - yes, I have been able to post the search input field (with the code above) as a snippet in each master page - once criteria is input, it is replaced with the search results page in the main frame.  However, the primary consideration when doing such a thing is to ensure the relative path back to the search form remains the same for every topic in the project.  That "could" be troublesome at some future time if someone places a new topic improperly (unless you have multiple search snippets for different relative paths (i.e., down one to search scripts, up and down, up 2 and down one).


              "overestimated the core issue": I think the core issue is just moving the form to the top frame.  If one could access that top frame file and prevent it from being overwritten during generation, one could do it outside the skin editor (similar to how one would customize the About box to replace the "WebHelp" graphic).  I really think it's that simple.  Then again, maybe I'm grossly understimating it... I tend to not accept a "no" answer when I can articulate the problem.


              For now, I think I can sell it as within each topic as the snippet mentioned above.  Bringing a developer would add weeks to the job in which hours matter.


              Again, thank you both for your help.  If breaking down the problem as I have gave you more ideas, I'd love to hear it.



              • 4. Re: RoboHelp and ZoomSearch in Toolbar Main
                Peter Grainge Adobe Community Professional (Moderator)

                I can articulate that I cannot fly under my own power so perhaps you would let me have the instructions for doing so.


                My answer was clear enough that I wasn't saying it could not be done but that I don't know how.


                Working in the same frame as you do either with a page as in my article or in a snippet as you have done is one thing. You want to work across frames and that is quite different. If it can be done, it needs technical skills not in my scope.


                It is going to require hacking the skin.


                See www.grainge.org for RoboHelp and Authoring tips