jverdeyen/archibald repository overview

⁠Archibald

Archibald is a self-hosted Slack integration written in PHP to post tag-selected GIF replies from replygif.net⁠ into your current Slack channel or Direct Messages.

⁠How to use

/archie tags Shows a list of all tags that can be used, together with the amount of gifs available in brackets

/archie [tag] Use a tag to let Archibald search for a gif with that tag and randomly select one for you.
E.g: /archie magic

/archie shaq You’ll love it, because he (you know who) loves you dearly!

⁠Configure Integrations

⁠Slash Command

Add a new Slash Command integration for your team.

For the Integration Settings, use the following values:

Setting	Value
Command	/archie
URL	http://yourOwnDomain.com/archibald/api.php⁠
Method	POST
Autocomplete help text
Descriptive Label	Archibald

Now copy the Token and paste it as a value for SLASHCOMMAND_TOKEN into config.php.

    define('SLASHCOMMAND_TOKEN', 'Your copied Token here');

⁠Incoming Webhook

Now add a new Incoming Webhook integration for your team.

It doesn’t matter which channel you choose for the messages to be posted to. All you need to do in the settings for the Incoming Webhook integration is to copy the Webhook URL and paste it as a value for WEBHOOK_URL into config.php. All other values are overwritten by Archibald.

    define('WEBHOOK_URL', 'The copied URL here');

⁠Config

Rename config.sample.php to config.php and set the Token for the Slash Command Integration as well as the Webhook URL from the Incoming Webhook Integration.

⁠Upload files to Webserver

You need to upload all files to a webserver running PHP version 5.4.x or higher.

Before you upload the files, be sure to use Composer⁠ to also include all vendor files.

composer install

⁠How to run within a Docker container

Build the image

docker build -t="jverdeyen/archibald" .

Run the image, and replace the token and webhook url

docker run -p 80:80 -e SLASHCOMMAND_TOKEN=token -e WEBHOOK_URL="http://webhookurl" -d --name=archibald jverdeyen/archibald