Flare is great for general Help and for context-sensitive Help. But you may not know that you can build general Help, page-level CSH, AND field-level CSH.
There are a few steps (some optional) that are involved with creating field-level Help. Once completed, your developers can easily connect the forms to the Help system.
You can create an entire Help system just for form-based Help or you can have topics in your existing Help system that are defined for just the Help calls from your form. This example will assume that the field-level topics are going to live in an existing Help system.
For the Existing Site:
- You’ll need to identify the fields that you will be tagging with Help. A good rule would be to only add tags to fields that are not self-explanatory.
- Once you’ve identified the fields, you’ll need to define a way to suggest to the users that there is Help for the field. Usually an image will do.
Tip: It may be good to have a few different sized images to match with different sized elements.
For the Flare Project:
- Create topics to be used for the field-level Help. It may be useful to keep these separate from existing topics or other field-level topics by storing them in a separate folder. You can style them differently than the rest of your content, exclude them from the search database so they do not appear in search results, etc.
- If you are using master pages, you may not want the field-level topics to have breadcrumbs, headers, footers, topics toolbars, etc. It is a good idea to create a new master page and apply it to just these topics.
- Now you can apply the FieldLevelTopics class to field-level topics. At this point you can also remove them from the search database too.
- Open the File List: View > File List
- Select all of the topics that are in the Field-Level Topics folder, right-click and select Properties.
- In the Properties dialog set the Topic Style Class to the html style that you created FieldLevelTopic. You can also remove the topics from the search database. Press OK once you set the desired options.
- Now you will want to change how these topics are displayed. You will do this by creating a skin for these specific CSH calls.
- Create a skin for the the field-level Help calls: Project > Add Skin… Name it “FieldLevelTopics“.
- General tab: Only check the “TOC” option in the Features section. All of the other settings in this dialgo should be un-checked.
- Size tab: Set the Width to be 300 px and the Height to be 200 px. Everything else should be “0” or un-checked.
- About tab: Un-check this option.
- WebHelp Setup tab: Check the options “Hide Navigation Pane on Startup” and “Exclude Accordion Title”. Un-check any of the browser settings that you don not want, most likely all of them.
- WebHelp Toolbar tab: Make sure that there are no items listed in the “Selected” column. This shouldn’t affect the project, but it is good to be sure.
- Topic toolbar tab: Again, make sure that there is nothing in the “Selected” column
- Styles tab: If you want to remove or change the header with the company logo, you would do it here. Under the “Frame” style select the “Toolbar” class. You will see options under a “General” node to the right. If you want to remove the pane, set the Height to “0 px”. In this example, we will leave it as is “28px”.
- Save All
- Now just build and test the output with a WebHelp Target: Build > Test CSH API Calls.
If prompted to build the target, click OK. If you have to build, when it’s done, go back to Build > Test CSH API Calls and click. This window will open:
Find one of your field-level CSH calls and click Test.
My new field-level CSH call looks like this:
For the Developers:
- You will need to provide them with a list of the identifiers so they know which ones to use and for which fields. This is done by suppying them with the header file: Build > Export Header Files…
<a href=”#” onclick=”return pop(‘MyWebHelp/Default_CSH.htm#TL_Name’)”> <img src=”Help.jpg” border=”0″></a>
When you click on the “?” image, a popup with the field-level Help topic will appear.
Thanks to Laura Johnson for assistance with this blog post.
The following link is a sample project that contains the files and settings outlined in this blog post: FieldLevelHelp