Editing SocialMediaTool

The Social Media Tool (aka SMT) is a tool for enabling non-[[SocialMediaWG]] members to contribute to Noisebridge's social media presence by creating and sharing content, replying to messages, and other common functions.

Lots of great stuff happens at Noisebridge that ought to be shared with the world, but the [[SocialMediaWG]] team can't handle all of that, and Noisebridge is a do-ocracy, so the solution is simple: let people Do-ocratically run our social media!


== How to use the SMT ==

Currently there is only a Slack interface, but in the future we'll hopefully have more ways of doing this.

Be excellent when doing social media stuff on Noisebridge's behalf! Don't post or share unexcellent things.

=== Using the Slack interface ===

==== Example ====

You've gotta upload the photo here: https://imgur.com/

After its done uploading, right-click on it and hit Save Image Address to get the image URL

Then in the #smt-accountability channel in Slack, all in one line write:

/smt-make-attachments twitter: <IMGUR URL HERE> ; <TEXT OF TWEET HERE>

==== Slack Commands Documentation ====

[[File:SMT Slack Commands.png|thumb|right]]

SMT integrates with Slack via a collection of slash commands, all of which are prefixed with <code>smt</code>. So for example, to make a new post, you would type <code>/smt-make</code>. Each command also has some arguments that you'll need to provide, which are documented in the popup info that Slack displays. They are as follows:

{| class="wikitable"
! Action
! Arguments
! Format

|-
| Make a post (without attachments)
| service, content
| <code>/smt-make [service]: [content]</code>

|-
| Make a post (with attachments)
| service, one or more attachment urls, content
| <code>/smt-make-attachments [service]: [attachment], ...; [content]</code>

|-
| Reply to a post (without attachments)
| service, url of the post to reply to, content
| <code>/smt-reply [service]: [post url]; [content]</code>

|-
| Reply to a post (with attachments)
| service, url of the post to reply to, one or more attachment urls, content
| <code>/smt-reply-attachments [service]: [post url]; [attachment], ...; [content]</code>

|-
| Delete a post or reply
| service, url of post to delete
| <code>/smt-delete [service]: [post url]</code>

|-
| Share someone else's post
| service, url of post to share
| <code>/smt-share [service]: [post url]</code>

|-
| Unshare someone else's post
| service, url of post to unshare (your share post URL from Slack, not the shared post's URL)
| <code>/smt-unshare [service]: [post url]</code>

|}

== How do we prevent vandalism? ==

The current interface for SMT is through Slack, which means we know who's performing any given action using the SMT. Whenever someone does something, the action is logged to the channel <code>#smt-accountability</code> in a message that alerts people in the channel using the <code>@here</code> username. Any abuse of the SMT will therefore be detectable and the abusers can be held accountable.


== Hacking on SMT ==

If you'd like to hack on the Social Media Tool, get in touch with the [[SocialMediaWG]].

== Where's the source code? ==

You can find [https://github.com/NoisebridgeSocialMediaWG/noisebridge-social-media-tool the source code] for SMT on the [[SocialMediaWG]]'s Github page.