A simple Swarm module that monitors the Project's Activity feed for changes. Changes are sent to the Slack channel specified in the Project's configuration page.
The hyperlinks will take you directly to the Change or user specs in Swarm.
For the Swarm project to talk to Slack you need to add an Incoming Webhook
. Open Slack and access the options menu for the channel you want to add the integration. Then select 'Add a service integration ...'
Scroll down to the bottom of the list to 'DIY Integrations and Customizations' and select 'Incoming Webhook'.
Find the channel from the list...
then click to add..
Copy the Webhook URL
and add the Webhook URL to the 'Slack Webhook' box on your Swarm Project's configuration page.
'Save' and you are done.
The configuration of the module is located in: module/Slack/config/module.config.php
you can see the default here.
'slack' => array(
'user' => 'Swarm',
'icon' => 'https://pbs.twimg.com/profile_images/572920496824406016/Io8m39jD.jpeg',
'max_length' => 80
)
The fields are user
the name of the Swarm Slack BOT shown in the chat feed. An external URL for icon
used for the Slack BOT icon and max_length
the number of characters to show from the Change description (default 80 characters).
#Slack Swarm module A simple Swarm module that monitors the Project's Activity feed for changes. Changes are sent to the Slack channel specified in the Project's configuration page. ![Add Integration](images/PerforceSlack.png) The hyperlinks will take you directly to the Change or user specs in Swarm. ##Setup For the Swarm project to talk to Slack you need to add an `Incoming Webhook`. Open Slack and access the options menu for the channel you want to add the integration. Then select 'Add a service integration ...' ![Add Integration](images/AddIntegration.png) Scroll down to the bottom of the list to 'DIY Integrations and Customizations' and select 'Incoming Webhook'. ![Add Incoming Webhook](images/Incoming.png) Find the channel from the list... ![Find Channel](images/FindChannel.png) then click to add.. ![Add Add Hook](images/AddHook.png) Copy the Webhook URL ![Add Add Hook](images/Webhook.png) and add the Webhook URL to the 'Slack Webhook' box on your Swarm Project's configuration page. ![Add Add Hook](images/SwarmConfig.png) 'Save' and you are done. ##Configuration The configuration of the module is located in: `module/Slack/config/module.config.php` you can see the default [here](https://swarm.workshop.perforce.com/projects/paul_allen-slack/files/main/module/Slack/config/module.config.php). 'slack' => array( 'user' => 'Swarm', 'icon' => 'https://pbs.twimg.com/profile_images/572920496824406016/Io8m39jD.jpeg', 'max_length' => 80 ) The fields are `user` the name of the Swarm Slack BOT shown in the chat feed. An external URL for `icon` used for the Slack BOT icon and `max_length` the number of characters to show from the Change description (default 80 characters).
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#4 | 18278 | Paul Allen | Updated setup notes to relect changes to Slack's install pages. | ||
#3 | 16618 | Paul Allen | Install notes for Slack integration | ||
#2 | 16470 | Paul Allen | Configuration updates to UserGuide. | ||
#1 | 16468 | Paul Allen | MarkDown user guide. |