Onlinehelp is a module for the Yii PHP framework that provides a web user interface to generate and maintain an online help system.
Onlinehelp was developed to provide a modern and responsive user interface for managing online help text in Yii projects. To achieve its goals it was built using the popular Twitter Bootstrap extension.
Onlinehelp is written according to Yii's conventions.
- Twitter Bootstrap extension for Yii version 2.0.0 or above
Download the latest release from Yii extensions.
Unzip the module under protected/modules/onlinehelp and add the following to your application config:
// protected/config/main.php: return array( ... 'modules' => array( 'onlinehelp', ), ... );
Please note that the module requires you to use a database, if you wish to use Onlinehelp you need it's schema (it can be found in the module directory under /data/...schema.sql).
Configure the module to suit your needs. Here's a list of the available configurations (with default values).
'modules'=>array( ... 'onlinehelp' => array( 'users' => array('admin'), // a list of users who has access to the module. 'userIdColumn' => 'id', // the name of the user id column. 'layout' => 'application.views.layouts.main', // the layout used by the module. ), ...
Showing the Online Help Widget ¶
Insert the following code in your views/layouts/column...php file, just after <?php $this->beginContent('//layouts/main'); ?>:
<?php // Get path info $pathInfo = array(); if(!is_null(Yii::app()->controller->module)) $pathInfo = Yii::app()->controller->module->id; $pathInfo = Yii::app()->controller->id; $pathInfo = Yii::app()->controller->action->id; $this->widget('application.modules.onlinehelp.components.OnlineHelpWidget',array('pathInfo'=>join('/',$pathInfo))); ?>
This will display a ? link before the main content, aligned to the right. If clicked, the online help area for the current request will be toggled.
Alternatively press the H key to toggle the online help area (the H key might not work on some browsers).
Adding Help Text ¶
If there is no online help yet for a single page, a link to create the new help text is shown inside the online help area.
Create and save the help text in the form. The module returns to the calling page, and by clicking on ?, the new help text is shown.
You may also manage help texts via the ...?r=onlinehelp/editor URL.
By default, Page Help text is shown as a popup dialog, when the page is opened.
You may also want to add guiders to some specific elements on your page, not just a general help text for the whole page.
To do so, create entries in the onlinehelp table, where Page Help is not checked and an Element ID is specified.
The element-specific help will be shown in consecutive popups after the page-help popup.
Use the Sequence No. field to define the sequence of popups.
For Element ID, you can use any valid jQuery selectors.
Do you wish to use a translation for Onlinehelp? If so, please copy onlinehelp/messages/* folders to protected/messages.
Translations should be placed in the messages folder under a folder named according to its locale (e.g. en_us).
If you like this extension and would like to buy me a coffee, please consider to donate.