This is an old revision of the document!
Table of Contents
HtmlOKay Plugin
Compatible with DokuWiki
2006-11-06, 2007-06-26b,binky,ponder stibbons,hrun,detritus,"Elenor Of Tsort","Frusterick Manners",Greebo
Controls HTML access, so that only designated users and groups may use HTML at one of four access levels
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
Similar to htmlok
Installation
Search and install the plugin using the Extension Manager. Or download from gitHub: https://github.com/turnermm/htmlOKay/archive/master.tar.gz and install manually.
Note: When installing from the extension manager, you might get a message that the extension has not been installed. This is probably not true; reload the extension manager and check to see if the extension is listed. Then if it is not, you can install it by using the manual install tab of the extension manager and the above github url.
If you install from the command line, you must make the plugin's conf/access
directory writable by the web server.
Instructions
For instructions on use, you can go to the plugin's htmlOKay web site or consult either the pdf file or the ebook which comes bundled with the htmlOKay plugin in the docs
directory.
A backup of the web site is at: web.archive.org.
Briefly
To begin with, to use this plugin, the htmlok configuration option must be set to true. The documentation for the htmlok
option warns of the security risk in setting this option to true. The htmlOKay plugin is designed to address those risks by enabling HTML access only to restricted users and pages and at different levels.
These restriction are set in the plugin's access manager, where the different levels of HTML access can be set on files and namespaces for different users.
Note on performance
Access can be restricted by page and by namespace. That is, you can set HTML access permissions on one or more files in a namespace, or you can choose the ALL
option which sets the permissions for all of the pages in a selected namespace. Whichever method you choose, you cannot set different permissions for the pages of a namespace: all of the pages in a namespace will have the same permissions whether or not you choose the ALL
option.
You should try to use the ALL
option only for those namespaces where all of the pages are going to be using HTML. The reason for this is that the plugin advises the browser not to cache pages with htmlok
markup, forcing the browser to re-fetch these pages each time they are accessed. This is necessary to assure that Dokuwiki retains htmlOKay's access settings between page loads.
It might be good policy to designate selected namespaces for HTML usage for selected users. Then it is not necessary to reset the permissions each time a new page is created.
Refresh Button
More than one access level
can be applied to the same namespace. For visitors to such a namespace, htmlOKay uses the the display_level
to determine the access level at which to display the pages in that namespace.
Because DokuWiki caches its pages, sometimes the HTML displayed to a visitor may be that of the last cached version of a page, instead of the version assigned to the display level. Because DokuWiki caches its pages, the HTML displayed to a visitor may be that of the last cached version of a page, instead of the version assigned to the display level. To get around this problem if you see it as a problem, you can create a refresh button, to re-parse the page after the developer has logged out:
- button.php
<form class="button" method="get" action=<?php echo DOKU_BASE ."/doku.php"?>> <div class="no"> <input type="hidden" name="do" value="show" /> <input type="hidden" name="refresh" value="yes" /> <input type="hidden" name="id" value="<?php echo $ID; ?>" /> <input type="submit" value="Refresh" class="button" /> </div> </form>
Change Log
- Merge pull request #9 from dokuwiki-translate/lang_update_137_1600878931 (2020-09-23 18:43)
- translation update (2020-09-23 18:40)
- Merge pull request #8 from turnermm/dokuinc (2019-11-07 18:48)
- doku_inc test for Ubntu (2019-11-07 18:38)
- Merge pull request #6 from dokuwiki-translate/lang_update_907_1530794314 (2018-07-05 15:09)
- translation update (2018-07-05 14:40)
- fixed version in plugin.info.txt (2017-12-07 15:11)
- update info (2017-03-15 21:50)
- inserted two missing semi-colons in script.js (2016-12-22 00:30)
- fixed javascript errors output in action.php and php notice in helper… (2016-12-11 18:30)
- updated manuals (2016-12-09 21:10)
- fixed javascript type error (2016-12-08 15:58)
- merge with refactor_1 (2016-12-08 14:51)
- refactored directory_scan-3.php (2016-12-08 14:03)
- fixed script url using DOKU_BASE instead of JSON (2016-12-07 18:27)