Extension:Send2StatusNet

MediaWiki extensions manual

Send2StatusNet Release status: beta
Implementation	Data extraction
Description	Sends updates to any StatusNet / GNU social site of your choice for new articles or edits
Author(s)	Erkan Yilmaz, Singlespeedfahrer, Rohit Keshwani, Sage Ross
Latest version	2.0.0 (MW 1.19+) 1.3.3 (MW 1.16-1.18) (2014-08-01)
MediaWiki	1.16-1.23
License	GPL
Download	This page
Hooks used ArticleSaveComplete GetPreferences ArticleInsertComplete
Translate the Send2StatusNet extension if it is available at translatewiki.net
Check usage and version matrix; code metrics

What can this extension do?

This extension lets users push updates to any StatusNet / GNU social site of their choice whenever they make an edit (v1.3.3) or create a new page (v1.3.3 + v2.0.0) on the wiki. The messages are customizable and urls are shortened with either is.gd or ur1.ca.

Users input their username and password in the "Misc" section of "My preferences" (see picture below) and set some configuration parameters.

what else?

• if you want to help: here are some tasks
• give feedback, report bugs, ... at:
  • Extension talk:Send2StatusNet or
  • in the bug tracker

Usage

• 

  preferences (v2.0.0)

• 

  preferences (v1.3.2)

In the "Misc" tab of "My preferences", a user may input the username and password of their StatusNet (SN) / GNU social (GS) account and choose whether to send updates about new articles and/or edits to existing articles, plus selecting the service to shorten the URLs with.

wiki root url: if your wiki works in this URL format (http://YOURSERVER/wiki/index.php?title=) use it, and NOT this (http://YOURSERVER/wiki/)

Other configuration parameters are:

• Karma - only notify when you are lucky today
  • depending on the dice there will be no dent with the page name, but a general link to the wiki instead + the tags #wiki and #karma will be added
• remove text from article titles
  • (e.g. in my Mediawiki blog all my page names start with: Blog:Observations/ + since dents have a limit on text, this is useful)

API to use

use for the API: http://YOURSERVER/api/statuses/update.xml

please consider: send each edit or only wiki articles ?

If you select "Notify StatusNet site below every time you edit" you should be aware that in some cases this can "backfire" (e.g. spam, new users trying out something) + who knows you may get banned somewhere because of this :-(

I'd recommend to use first "Notify StatusNet when you start a new article".

how to enable other micro-blogging services

Some of those SN/GS instances also offer a twitterbridge, so you can cross-post to twitter.

The API of SN/GS is very similar to that of friendica, so that should be addable with few efforts

changes to old version

This extension has following changes to Extension:SendToIdentica:

• one can post now to any StatusNet / GNU social site
• post only when the extension is activated, can be useful in cases of spam or test edits by new users
• remove text from article names (e.g. in my Mediawiki blog all my page names start with: Blog:Observations/ + since dents have a limit on text, this is useful)
• configuration of the extension is easier (it's now in your wiki preferences) + also can be done without shell access
• karma factor
  • why did I implement this? software should also be fun :-)
• make URL shorteners also customizable in options (2 services offered)

tested versions so far

version 2.0.0 was tested with (2014-08-01):

• MediaWiki 1.23.2
• StatusNet 1.0.1

version 1.3.2 was tested with (2011-10-14):

• MediaWiki 1.17.0
• StatusNet 1.0.1

The extension is set up in this wiki if you want to see it in action.

change log

2014-08-01: version 2.0.0

• works in Mediawiki 1.23.2
  • should probably also work in 1.19+, to be tested
• deactivated "Notify StatusNet site every time you edit"
  • until I fix: "Fatal error: Call to a member function estimateRevisionCount() on a non-object in ..."
• new: add text at end
  • e.g. I wanted my msgs only delivered to a certain SN/GS group (in my case in screenshot, it's the !testing group, so I added " !testing")

2014-08-01: version 1.3.3

• some minor changes

2011-10-14: version 1.3.2

• see here: add a 2nd URL shortener since the existing one does not work anymore
• start with refactoring code

Download instructions

Please download/clone these files and place them in:

$IP/extensions/Send2StatusNet/Send2StatusNet.php and

$IP/extensions/Send2StatusNet/Send2StatusNet.i18n.php, respectively.

(Note: $IP stands for the root directory of your MediaWiki installation, the same directory that holds LocalSettings.php.)

Installation

To install this extension, add the following to LocalSettings.php:

require_once("$IP/extensions/Send2StatusNet/Send2StatusNet.php");

Send2StatusNet uses the GetPreferences hook and so requires MediaWiki 1.16 or later.

Note: This extension needs php-curl to work.

Code

You can find:

• Send2StatusNet.php
• Send2StatusNet.i18n.php

for Mediawiki 1.19+: at v2.x branch

for Mediawiki 1.16-1.18: at v1.x branch

• Download the archive (over the download-button in the respective branches) or
• clone them:
  • v2.x: git clone https://git.gitorious.org/send2statusnet/send2statusnet.git
  • v1.x: git clone https://git.gitorious.org/send2statusnet/send2statusnet_v1_branch.git