#summary Incidents Handling plugin
#labels Stage-Beta

= Introduction =

This module implements [http://xmpp.org/extensions/xep-0268.html XEP-268].

= Details =

It will let you manage reports, inquiries, requests and responses through an Adhoc interface.
The following new adhoc admin commands will be available:

 * List Incidents -- List all available incidents and let's you reply requests.
 * Send Incident Inquiry -- Inquiry a remote server about an incident.
 * Send Incident Report -- Send an incident report to a remote server.
 * Send Incident Request -- Send an incident request to a remote server.

Each Adhoc form provides syntax instructions through `<desc/>` elements (they may currently be stripped
by Prosody), although it's encouraged to read the [https://tools.ietf.org/html/rfc5070 IODEF specifications].

= Usage =

Copy the module folder into your prosody modules directory.
Place the module between your enabled modules either into the global or a vhost section.

Optional configuration directives:
<code language="lua">
incidents_expire_time = 86400 -- Expiral of "closed" incidents in seconds.
</code>

= Info =

 * to be 0.9, works.