AgileApps Support Wiki Pre Release

HowTo:Create Application-Specific Help

From AgileApps Support Wiki
Revision as of 23:52, 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.

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):
  • --To display link-target in a new window, use the standard HTML idiom:
<a href="source-URL" target="_blank">...text...</a>
  • --Find the Help tab, use {element}.click to click the tab!
<syntaxhighlight lang="javascript" enclose="div">

<script> function goToHelpTab() {

  document.getElementById("...HELP TAB ID...").click();

} </script> </syntaxhighlight>

  • --To go to the help tab and load a specific page:
<syntaxhighlight lang="javascript" enclose="div">

<SCRIPT LANGUAGE="JavaScript"> function go(loc){

  document.getElementById('...HELP TAB ID...').src = loc;

} </script> </syntaxhighlight>

THEN "click" the tab from the script
  • --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"