HowTo:Create Application-Specific Help

From AgileApps Support Wiki
Revision as of 23:44, 10 August 2015 by imported>Aeric

The pages you are currently reading comprise the support wiki. The support wiki is intended primarily for application builders, admins, and installers. But end-users need information that is specific to the application they are using--and that is where application-specific help comes in.

WorkInProgress.gif

Work In Progress:
This page is under development.
This page should be completed shortly.

  • --Form Scripts#Add a Help Button to an Arbitrary Form
  • --Application Help Tab
   x-Make a self-contained Help tab (Sample Help Page)
    --TBD: How to add a reference to jQuery in an HTML page, if needed (Sherwin)
                 http://agileappslive.info/aadev/JSP_Pages#About_Header_Files 
  • --Make a multi-page help system
  • --make two JSP pages (NO HEADERS--so links work)
  • --make the main page into the help tab (as explained above)
  • --get the ID of the Web Tab, or inspect the tab element to get iFrame ID
  • for links TO the page (from a Help button on a form):
  • --Find the Help tab, use {element}.click to click the tab!
<script>
function goToHelpTab() {
   document.getElementById("...HELP TAB ID...").click();
}
</script>
  • --To go to the help tab and load a specific page:
<SCRIPT LANGUAGE="JavaScript">
function go(loc){
   document.getElementById('...HELP TAB ID...').src = loc;
}
</script>
THEN "click" the tab from the script
  • --To display link-target in a new window, use the standard HTML idiom:
<a href="source-URL" target="_blank">...text...</a>
  • --To display link-target in the Help tab:


function to search for the iFrame and change the src attribute:
onclick() in the anchor to invoke the function and pass target

--loc.href="pages/PAGE_NAME"
--works for pages hosted in the platform
--does not work for external pages (use the external site option, for that)
--add a learn-more link that goes to "Making Help Pages"