Table of Contents
Quality Check Plugin
Compatible with DokuWiki
- 2022-07-31 "Igor" unknown
- 2020-07-29 "Hogfather" no
- 2018-04-22 "Greebo" yes
- 2017-02-19 "Frusterick Manners" yes
Installation
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
After installation you need to put the quality check into your template's main.php
(should be somewhere above the page content):
<?php //Quality Control $qc = plugin_load('helper','qc'); if ($qc) $qc->tpl(); ?>
Configuration & Usage
Configuration
The plugin adds an option to the config manager where the look of the quality bar can be adjusted.
You can set the color of the generated text to match your template and choose from different icon sets.
Disabling Checks on a Page
You can disable the quality check on a page by putting a ~~NOQC~~ macro somewhere into the page.
Currently Implemented Checks
The following checks are currently used to determine the structural quality:
- Number of FIXMEs
- No Main Headline
- Too many Main Headlines
- Incorrectly Nested Sections
- Many Horizontal Rules
- Many Forced Line Breaks
- Deeply Nested Quotes
- Single Author Only
- Very Small Document
- Very Large Document
- Many Headlines
- Few Headlines
- No Wiki Links
- Many links to non-existing pages
- Too much Text Formatting
- Long Formatted Passages
- Overly Formatted Text
- No Backlinks
Admin page
Moderators and administrators find a quality report on the admin page. This report lists the worst 25 wiki pages known to the quality plugin with their current quality score and FIXME count.
Development
Change Log
- Version upped (2021-02-17 23:51)
- Merge pull request #48 from cosmocode/warnings (2021-02-17 13:34)
- Eliminate warnings in PHP 8 (2021-02-17 11:23)
- Merge pull request #46 from cosmocode/indexing (2020-06-30 16:17)
- Fix method visibility (2020-06-30 16:13)
- Merge pull request #44 from cosmocode/hogfarther (2020-06-03 17:54)
- Version upped (2020-06-03 17:51)
- More code style fixes (2020-06-03 17:44)
Known Bugs and Issues
Please report bugs and issues at: https://github.com/cosmocode/qc/issues
Discussion
The QC helper use a ondemande build'in image with gd.
HTML entities like é(é) won't be correctly encode.
To solve it, in the icon.php file, you can change the line 91 :
Previous :
list($x,$y) = textbox($img,0,2,$qc->getLang('i_qcscore'),$c_text);
Change :
list($x,$y) = textbox($img,0,2,html_entity_decode($qc->getLang('i_qcscore')),$c_text);