====== swarmwebhook Plugin ======

---- plugin ----
description: A webhook endpoint for foursquare swarm checkins forwarded IFTTT into a struct table
author     : Michael Große
email      : mic.grosse+dokuwiki@googlemail.com 
type       : action
lastupdate : 2019-05-29
compatible : Greebo
depends    : struct, sqlite
conflicts  : 
similar    : 
tags       : webhook, swarm, journal, IFTTT, Zapier

downloadurl: https://github.com/micgro42/dokuwiki-plugin-swarmwebhook/zipball/master
bugtracker : https://github.com/micgro42/dokuwiki-plugin-swarmwebhook/issues
sourcerepo : https://github.com/micgro42/dokuwiki-plugin-swarmwebhook/
donationurl: https://paypal.me/GrosseM

screenshot_img :
----



===== Installation =====

:!: This Plugin depends on the following other plugins:
  * [[struct]]
  * [[sqlite]]

Install the plugin using the [[plugin:extension|Extension Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.

Further, please import the ''swarm.struct.json'' from the plugin directory into struct to initialize the schema. **Warning**: this will overwrite any preexisting struct swarm schema that you may have.

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

Please see the the plugin's admin menu for instructions for how to create an appropriate IFTTT-Swarm webhook.

The data is stored in the struct schema ''swarm''. Therefore you need a struct aggregation to display the data.

For example:
<code>
---- struct table ----
schema: swarm
cols: date, time, locname, shout
order: ^date
----
</code>

Please see the extensive documentation of the [[struct]] plugin for more options.


In principle this also supports Zapier. However, there is a bug with Zapier that makes it impossible to verify the incoming webhooks, so  its usage is not recommended. 

===== Development =====

  * Travis: [[https://travis-ci.com/micgro42/dokuwiki-plugin-swarmwebhook|{{https://travis-ci.com/micgro42/dokuwiki-plugin-swarmwebhook.png?branch=master&nocache}}]]
  * Scrutinizer: [[https://scrutinizer-ci.com/g/micgro42/dokuwiki-plugin-swarmwebhook/|{{https://scrutinizer-ci.com/g/micgro42/dokuwiki-plugin-swarmwebhook/badges/quality-score.png?b=master&nocache}}]]
    *  code coverage: {{https://scrutinizer-ci.com/g/micgro42/dokuwiki-plugin-swarmwebhook/badges/coverage.png?b=master&nocache}}
==== Commit-Ticker ====

{{rss>https://github.com/micgro42/dokuwiki-plugin-swarmwebhook/commits/master.atom date}}

**Releases:**
{{rss>https://github.com/micgro42/dokuwiki-plugin-swarmwebhook/releases.atom description author}}