====== bugzillaHTTP Plugin ======

---- plugin ----
description: plugin to embed bugs from bugzilla as a table in DokuWiki querying xml-view via HTTP
author     : Andreas Parschalk
email      : dprskavec@gmail.com
type       : syntax
lastupdate : 2012-12-07
compatible : 
depends    : 
conflicts  : 
similar    : bugzillaxmlrpc
tags       : bugzilla, bugtracker

downloadurl: https://github.com/downloads/d-prskavec/dokuwiki-bugzillaHTTP/bugzillaHTTP.zip
bugtracker : https://github.com/d-prskavec/dokuwiki-bugzillaHTTP/issues
sourcerepo : https://github.com/d-prskavec/dokuwiki-bugzillaHTTP
donationurl: 
----

===== Installation =====

This plugin is known to work with dokuwiki "Hrun" and bugzilla 3.4. I would expect it to work with the latest versions of dokuwiki and bugzilla as well. If not, you can open a ticket at https://github.com/d-prskavec/dokuwiki-bugzillaHTTP/issues

:!: **External requirements:** If not already installed on your system you might need to install: 
  * php-curl

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

On pages where you embed buglists you need to disable caching by placing ''%%~~NOCACHE~~%%'' on top of the page. Otherwise the bug-states will not be updated on load of the page.

This of course makes pages with lots and lots of buglists a bit slow to load.

This is how it looks:

{{http://bitstindl.com/dokuwiki-bugzillaHTTP/buglist_screenshot.jpg|screenshot}}

===== Syntax =====

Syntax is simple:
  [buglist | <bug_id>,<bug_id>,<bug_id>,...]
e.g.
  [buglist | 1,3,6,77]

===== Configuration and Settings =====

After installing the plugin go to the dokuwiki configuration page. There you have to
set the hostname/URLs of your bugzilla instance.

If you want to change/fix the colors of the bugtables you can manually edit the style.css file in the plugins directory of your dokuwiki installation (usually <dokuwiki_base>/lib/plugins/bugzillaHTTP/).

===== Development =====

=== Change Log ===

{{rss>https://github.com/d-prskavec/dokuwiki-bugzillaHTTP/commits/master.atom date}}

=== ToDo/Wish List ===

  * test for current dokuwiki version + current/other bugzilla versions

===== Discussion =====

This is a works-for-me implementation inspired by the [[plugin:bugzillaxmlrpc|bugzillaxmlrpc plugin]].
If you have feature requests/bug reports please use the issue tracker provided above. You are of course also cordially invited to expand/enhance or simply fork it yourself :)