diff --git a/mod_post_log/COPYING b/mod_post_log/COPYING new file mode 100644 index 0000000..c8d3f9e --- /dev/null +++ b/mod_post_log/COPYING @@ -0,0 +1,20 @@ +Copyright (C) 2014 Mojo Lingo LLC + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/mod_post_log/README.md b/mod_post_log/README.md new file mode 100644 index 0000000..a50bde6 --- /dev/null +++ b/mod_post_log/README.md @@ -0,0 +1,34 @@ +# mod_post_log - Logs messages to an HTTP API + +*Homepage*: https://github.com/processone/ejabberd-contrib/tree/master/mod_post_log +*Author*: Tim Stewart, Mojo Lingo LLC +*Requirements*: ejabberd 14.07 or later + +This module implements logging of all messages sent (chat and groupchat) via an HTTP API. + + +## CONFIGURATION + +Add the module to your ejabberd.yml, in the modules section: + +```yaml +modules: + ... + mod_post_log: + url: http://foo.bar.com/messages + ... +``` + +## API example + +``` +POST /messages HTTP/1.0 +HTTP-X-MESSAGE-FROM: doo@dah.com +HTTP_X_MESSAGE_TO: foo@bar.com +Content-Type: application/xml +Content-Length: 122 + + + Hello there Foo! + +```