DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:autotweet2

AutoTweet 2 Plugin

Compatible with DokuWiki

  • 2018-04-22 "Greebo" yes
  • 2017-02-19 "Frusterick Manners" unknown
  • 2016-06-26 "Elenor Of Tsort" unknown
  • 2015-08-10 "Detritus" unknown

plugin Post the information of changes to Twitter.

Last updated on
2018-10-30
Provides
Action
Repository
Source

Similar to autotweet

Tagged with api, notifications, twitter

:!: このページは日本語でご覧頂けます(This page is also available in Japanese)
:!: I’m not a native English speaker, so this page may contain some mistakes in English sentences.

Summary

When pages are changed, this plugin will post tweets through Twitter API.

It seems that Autotweet (1) Plugin is no longer be supported, so I newly made it.

:!: When I made this plugin, this page (in Japanese) was really helpful for me.

Installation

:!: JUST adding this plugin to your wiki won't activate the auto-tweet. You should read this section through the end.

Add this plugin to your wiki

Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.

Additional Operations

You'll have to sign up to Twitter Developer Platform to use Twitter API.

Sorry but I'm not motivated to introduce you about signing up to the platform and creating Twitter API. Google about them.

Be careful, it takes several days to be accepted by Twitter.

After you get the Twitter API

You'll enter your Consumer Key, Consumer Secret, Access Token, and Access Token Secret to the config of this plugin. Use Configuration Manager, scroll to Autotweet2, and fill in the blanks (also, you can change other settings of the plugin).

:!: The picture is the screen of https://apps.twitter.com, which became unable to create Twitter API.
:!: Consumer Secret and Access Token Secret shouldn't be seen by others. Please be sure that your conf directory is secured (see web_access_security).

OK, the plugin is ready!

Examples/Usage

When pages in your wiki are changed, the Twitter app will notice with URLs of the pages.

Configuration and Settings

You can change the following setting by using the Configuration Manager.

OptionDescriptionValue TypeDefault Value
apiKey, apiSecret, accessToken, and accessTokenSecretSee the instruction above.string1)
subjectOfTweetSubjects of the auto-tweet (choose from when edited, reverted, created, deleted, and edited [minor changes])multiple choice from edit, revert, create, delete, and minoredit,revert,create,delete
templateTemplate of the message
REPLACEMENT:
###WIKITITLE###→The title of this wiki
###PAGETITLE###→The title of the edited page
###TYPE###→The type of editing (“edited”, “reverted”, “created”, “deleted”, or “edited (minor change)” will be shown)
###SUMMARY###→The summary of editing
###EDITOR###→Who changed the wiki (Follows the config “showuseras”)
###PAGEURL###→The URL leading to the edited page (if there is not ###PAGEURL###, the URL will be automatically added to the last of the template)
textarea[###WIKITITLE### - ###TYPE### by ###EDITOR###] ###PAGETITLE###: ###SUMMARY### ###PAGEURL###
guestIPWhat to replace ###EDITOR### of the template with if the editor was not logging inpull-down choice from 0 (Don\'t show the IP address, replace with the null text), alt (Replace with the alternative text (Hidingip plugin required.)), or show (Show the IP address)0
blacklistPages that will not be subjects of auto-tweet (separate by vertical bars “|”)
e.g.:“playground:playground|start|wiki:syntax“
string2)
debugIf the editor is a manager, show the debug information (a body (JSON) and a response header) when the plugin is run (Use this option to investigate causes when the plugin doesn't work well.)boolean0

Development

Change Log

  • 2018-07-02
    • Initial release
  • 2018-08-29
    • From this version, a space will be inserted after an at-mark @ not to violent the Twitter rule that prohibits “automated @ tweets”
    • Added an option “debug”
  • 2018-10-30
    • Added a option to tweet who changes the wiki

Known Bugs and Issues

Currently none

ToDo/Wish List

I'll do my best if you think this leaves something to be desired

Contact Me

If you find some problems in this plugin, you can make issue topics on the GitHub page, or if you wanna contact me for other things, you can contact me by:

Discussion

1) , 2)
empty
plugin/autotweet2.txt · Last modified: 2018-10-31 15:43 by hokkaidoperson