Fumiki Takahashi

Hametuha INC.

<p>This plugin integrates <a href="https://slack.com" rel="nofollow ugc">Slack</a> and WordPress.</p>
<h4>Core Conception</h4>
<p>By default, this plugin does nothing. It’s true.<br />
Slack has many API integration, but <strong>hameslack</strong> uses 2 of them.</p>
<ul>
<li><a href="https://api.slack.com/incoming-webhooks" rel="nofollow ugc">Incoming Webhook</a> to post to slack.</li>
<li><a href="https://api.slack.com/apps" rel="nofollow ugc">Slack App</a> to interact with slack.</li>
</ul>
<p>Upper is easier. This plugin helps the connection between Slack and WordPress and you can concentrate on what you should do with slack.</p>
<h4>Use Cases</h4>
<p>Here is a list of use case of us on WordPress with many editors.</p>
<ul>
<li><strong>Easy</strong> Post notification to slack if some post is awaiting review.</li>
<li><strong>Difficult</strong> Post access summary to slack once a week, because my colleague doesn’t open Google Analytics.</li>
<li><strong>Very Difficult</strong> Convert slack conversation to single post and make interview post.</li>
</ul>
<p>For more details, please read the <a href="https://github.com/hametuha/hameslack/blob/master/addons/README.md" rel="nofollow ugc">Addons documentation</a>.</p>
<h4>How to Integrate</h4>
<p>The simplest usage is <em>post to slack</em>. You can do like below:</p>
<pre>
do_action( 'hameslack', $text_to_post, $attachments, $channel );
</pre>
<p>Function <code>hameslack_post( $content, $attachment, $channel )</code> is also available, but I prefer to use <code>do_action</code> to avoid annoying <code>if ( function_exists('func_name'))</code>.</p>
<p>Everything works fine if you set properly.</p>
<h4>Deprecated API</h4>
<ul>
<li><strong>Sending Invitation</strong> <code>deprecated at 2.0</code>:  this endpoint was unofficial and official one is only for Enterprise grid. Users now can send invitation reqeust from their profile page.</li>
<li><strong>Outgoind Webhook</strong> <code>deprecated at 2.0</code>: Slack recommends Events API instead.</li>
</ul>
<h3>Install</h3>
<h4>From Plugin Repository</h4>
<p>Click install and activate it.</p>
<h4>From GitHub</h4>
<p>Download from <a href="https://github.com/hametuha/hameslack/releases" rel="nofollow ugc">Releases</a> and you can use it. Any pull requests are welcomed.</p>
<h4>Enter Credentials</h4>
<p>To post a message to slack, you need Payload URL. <a href="https://api.slack.com/apps/" rel="nofollow ugc">Create an app</a> and activate “Incoming Webhooks”.<br />
Now you can get payload URL.</p>
<p>To get Bot Token, go to “OAuth & Permissions”. By installing your app to your workspace, Bot token will be generated.</p>
<h4>Do something</h4>
<p>As mentioned above, this plugin does nothing by default. Enable built-in addons from the settings page, or read the <a href="https://github.com/hametuha/hameslack/blob/master/addons/README.md" rel="nofollow ugc">Addons documentation</a> to write your own.</p>
<p>If you have any request, please make issue on <a href="https://github.com/hametuha/hameslack" rel="nofollow ugc">github</a>.</p>
<h3>Development</h3>
<p>This plugin requires custom code to work with your Slack workspace. Here’s how to set up a local development environment.</p>
<h4>Prerequisites</h4>
<ul>
<li>Node.js >= 22 (managed via <a href="https://volta.sh/" rel="nofollow ugc">Volta</a>)</li>
<li>Docker Desktop (for <a href="https://developer.wordpress.org/block-editor/reference-guides/packages/packages-env/" rel="nofollow ugc">wp-env</a>)</li>
<li><a href="https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/get-started/" rel="nofollow ugc">cloudflared</a> (for Slack Webhook testing)</li>
</ul>
<h4>Getting Started</h4>
<pre><h3>Install dependencies</h3>npm install
composer install<h3>Start WordPress local environment</h3>npm start<h3>Build assets</h3>npm run package<h3>Watch for changes during development</h3>npm run watch
</pre>
<h4>Receiving Slack Webhooks Locally</h4>
<p>Slack requires a public HTTPS URL for Event Subscriptions and Interactive Components. Use Cloudflare Tunnel to expose your local environment:</p>
<pre><h3>In a separate terminal, start the tunnel</h3>npm run tunnel
</pre>
<p>This gives you a temporary public URL like <code>https://random-name.trycloudflare.com</code>. Then:</p>
<ol>
<li>Go to your <a href="https://api.slack.com/apps" rel="nofollow ugc">Slack App settings</a></li>
<li>Update <strong>Event Subscriptions</strong> Request URL to <code>https://random-name.trycloudflare.com/wp-json/hameslack/v1/...</code></li>
<li>Update <strong>Interactivity & Shortcuts</strong> Request URL similarly</li>
<li>The URL changes each time you restart the tunnel</li>
</ol>
<p><strong>Note:</strong> Make sure WordPress permalink settings are not set to “Plain” — pretty permalinks are required for <code>/wp-json/</code> to work through the tunnel.</p>
<h4>NPM Scripts</h4>
<p>  Command<br />
  Description</p>
<p>  <code>npm start</code><br />
  Start wp-env</p>
<p>  <code>npm run package</code><br />
  Build all assets (CSS + JS)</p>
<p>  <code>npm run watch</code><br />
  Watch for file changes</p>
<p>  <code>npm run tunnel</code><br />
  Open Cloudflare Tunnel to localhost:8888</p>
<p>  <code>npm run lint</code><br />
  Run ESLint + Stylelint</p>
<p>  <code>npm run fix</code><br />
  Auto-fix lint errors</p>
<p>  <code>npm test</code><br />
  Run PHPUnit tests</p>


HameSlack

SMILE

Nathan Monk

<p><a href="https://wordpress.org/plugins/stream/" rel="ugc">Stream</a> records activity on your WordPress site in your WordPress database. This plugin allows you to also send those records to <a href="https://slack.com/" rel="nofollow ugc">Slack</a>.</p>
<p><em>Based on the excellent Stream to Papertrail by <a href="https://github.com/japh" rel="nofollow ugc">@Japh</a></em></p>


Stream to Slack

... and so well executed.
It makes so much sense to see website changes in my #dev channel, alongside my Github integrations. Especially working with a team which has multiple contributors on our site. Loving seeing the potential of Stream unlocked like this.
Brilliant work. 👍



HameSlack vs Stream to Slack