mojoPortal Tips: Adding a Custom Help Section

If you are doing custom development within mojoPortal, your users will find it extremely beneficial (and you’ll have a much more peaceful deployment) if you leverage mojoPortal’s built-in help system.

There are two ways to include “help” references in a custom module or page: the first way, which is specific to module settings, is to add a “helpKey” attribute to a “FeatureSetting” element within the feature’s Feature Definition config file. To see an example, open up one of the config files under mojoPortal.Web/Setup/applications/KDMediaPlayer/FeatureDefinitions. You’ll notice the “helpKey” attributes reference a file name – these files are located under the /Data/HelpFiles section.

The second method of including a “help” reference in the custom page or feature is to leverage the portal:mojoHelpLink tag. An example you’ll find in the EditTrack.aspx file is as follows:

<portal:mojoHelpLink ID="TrackNameHelpLink" runat="server" HelpKey="MediaPlayerTrackName-help" />

By default, you’ll notice that the “Help” window that pops up leverages the same background as your main site; in the instance of strong patterns or low-contrast colors, this can make the “help” section less than helpful.

Here’s an addition to your CSS that will ensure that your help sections are clearly visible to your users:

body.help-page
{
	color:black;
	background-color: white;
	background-image: none;

}

This is included in the latest versions of mojoPortal skins, but may need to be retrofitted into older skins that have been updated to a current version of mojoPortal.

Looking for quality mojoPortal Hosting? Look no further than Arvixe Web Hosting!

Tags: , , , , , , | Posted under MojoPortal | RSS 2.0

Author Spotlight

Carole Bennett

Carole Bennett is the founder and principal of IndigoTea. As a professional IT consultant, Carole has provided solutions for companies as diverse as Verizon, Frito-Lay, Capital One Auto Finance, and Zales Jewelers, parlaying a unique talent for acting as a translator between the worlds of business challenges and technology solutions. She considers multi-tasking skills gained from simultaneously 1) managing a fire performance troupe, 2) raising a family, and 3) working as a full-time IT consultant excellent preparation for her current career incarnation as the driving force behind IndigoTea. "Fire-breathing redhead on a mission" is not just a metaphorical description!

Leave a Reply

Your email address will not be published. Required fields are marked *


7 + = 10

You may use these HTML tags and attributes: <a href="" title="" rel=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>