Difference between revisions of "The ARK Help System"

From ARK
Jump to: navigation, search
(Created page with "As of version 1.2 - a field-level help system has been introduced to ARK. The help system works by using the Markup system to attach chunks of Markup to specific fields. The...")
 
Line 2: Line 2:
  
 
The help system works by using the [[Markup]] system to attach chunks of Markup to specific fields. There is very little configuration needed to enable the help system.
 
The help system works by using the [[Markup]] system to attach chunks of Markup to specific fields. There is very little configuration needed to enable the help system.
 +
 +
==Configuring the subform==
  
 
A new subform conf will need to be entered in the settings.php file:
 
A new subform conf will need to be entered in the settings.php file:
Line 28: Line 30:
  
 
If this op is specified, then the help will be printed using the Textile tool - which means it can be used to print complex formatted HTML (along with images, etc.). For more information on Textile see this link: http://txstyle.org/
 
If this op is specified, then the help will be printed using the Textile tool - which means it can be used to print complex formatted HTML (along with images, etc.). For more information on Textile see this link: http://txstyle.org/
 +
 +
==Configuring the navigation==
 +
 +
The help is currently launched using an icon in the title bar of the subform that contains the fields you want help for. This is setup in the sf_conf 'sf_nav_type' configuration option. Currently the help icon will appear when sf_nav_type is set to 'full' or 'help'.
 +
 +
==Other things to bear in mind==
 +
 +
The help uses the Markup system to attach the help to the fields. Therefore, the contents of the help can either be edited directly from the help subform - or using the Markup Admin tools. By default the system assumes the nickname of the markup is 'help_' concatenated onto whatever the field_id is. For instance, the help for a field with id 'conf_field_description' would be 'help_conf_field_description'. It is possible to specify a different nickname, by including the option 'op_help_nname' in the field and setting a new nickname.
 +
 +
As the names for the nicknames of the markup are usually help_ prefixed on the name of the field -  the length of the nname field in cor_tbl_markup maybe too short. If you get an Error when updating or adding help related to the size of the field in the database then run this SQL command to fix it:
 +
<pre>
 +
ALTER TABLE `cor_tbl_markup` CHANGE `nname` `nname` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL DEFAULT
 +
</pre>

Revision as of 14:46, 9 June 2014

As of version 1.2 - a field-level help system has been introduced to ARK.

The help system works by using the Markup system to attach chunks of Markup to specific fields. There is very little configuration needed to enable the help system.

Configuring the subform

A new subform conf will need to be entered in the settings.php file:


$conf_mcd_help =
    array(
        'view_state' => 'max',
        'edit_state' => 'view',
        'sf_nav_type' => 'nmedit',
        'sf_title' => 'help', 
        'sf_html_id' => 'help', // Must be unique
        'script' => 'php/subforms/sf_help.php',
        'op_modtype' => FALSE, //if each modtype uses same fields (see below)
        'fields' =>
            array(
        )
);

This needs to be named $conf_mcd_help, otherwise the help system will not be able to find it. The subform has one 'op' value that can be applied:

'op_textile' => TRUE

If this op is specified, then the help will be printed using the Textile tool - which means it can be used to print complex formatted HTML (along with images, etc.). For more information on Textile see this link: http://txstyle.org/

Configuring the navigation

The help is currently launched using an icon in the title bar of the subform that contains the fields you want help for. This is setup in the sf_conf 'sf_nav_type' configuration option. Currently the help icon will appear when sf_nav_type is set to 'full' or 'help'.

Other things to bear in mind

The help uses the Markup system to attach the help to the fields. Therefore, the contents of the help can either be edited directly from the help subform - or using the Markup Admin tools. By default the system assumes the nickname of the markup is 'help_' concatenated onto whatever the field_id is. For instance, the help for a field with id 'conf_field_description' would be 'help_conf_field_description'. It is possible to specify a different nickname, by including the option 'op_help_nname' in the field and setting a new nickname.

As the names for the nicknames of the markup are usually help_ prefixed on the name of the field - the length of the nname field in cor_tbl_markup maybe too short. If you get an Error when updating or adding help related to the size of the field in the database then run this SQL command to fix it:

ALTER TABLE `cor_tbl_markup` CHANGE `nname` `nname` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL DEFAULT