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'); ?>:
// 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.
Thanks To ¶
- Raoul for equiders
- Christoffer Niska for yii-bootstrap
- Yii Framework
The demo says
The install directory still exists. Please remove this directory and re-open this page.
...and I'll definitely try it (now the Demo link returns a 404)
I hope you had no problem using eguiders ;)
Thanks for sharing
Thanks for pointing to the wrong demo link.
The link is http://www.diggin-data.de/demos/onlinehelp .
Fix the demo link
Hi, please fix the demo link because it's not working. I would like to "preview" this extension. Thank you and keep up the good work.
Re: Fix the demo link
I was about to complain about this too, when it occurred to me that I probably should log into the site first.
And after doing that, the demo worked.
It should probably be written down somewhere.. >)
Link working on the menu!
I tested again and after i logged in "admin/admin" using the link provided here for the demo
the "demo page" link provided in the main text does not work. What does work is the menu. Someone should post this info as well or fix the text link.
I have switched the default page in the demo to the blog posts and added a note in the first post where the online help can be seen.
Hope this is e clear now...
Guiders not fired up
I found that Guiders are not fired up when there is no help for entire page.
Is there possibility to change that behaviour to be able to se Guiders without general page help ?
File not found
The demo does not work :(
If you have any questions, please ask in the forum instead.
Signup or Login in order to comment.