Social tools

Social tools is a term which refers to the and various other related extensions, most of which depend on the SocialProfile extension.

Many of the social tools were developed by Aaron Wright, Ashish Datta, David Pean, Jeffrey Tierney and Robert Lefkowitz for ArmchairGM. Currently the SocialProfile extension and other related social tools are maintained by (the lead maintainer) in collaboration with a few other people,  and. is also another contributor who mainly focuses on, , and.

For a complete list of social tools, see Category:Social tools.

General disclaimer
A message from the developers:

We are are all volunteers that work on this in our own time to help make the social tools be of use for MediaWiki wiki communities. As such, none are being paid to help write code to improve the MediaWiki extensions that are encompassed under the umbrella.

While we value bug reports and feedback given to us, we are under no obligation to provide bug fixes, updates, etc.

The best way to ensure that your bug gets fixed or your feature request gets implemented is to join in for the products are free and open-source software, which means you can help! You can learn more about how to contribute by reading our process on submitting a patch below, as well as learning how to become a MediaWiki hacker.

MediaWiki compatibility

 * MediaWiki version: Extensions under the social tools umbrella are only supported on the latest, stable version of MediaWiki core software (currently MediaWiki ). We do not provide support for any earlier releases (including LTS releases) or alpha releases of MediaWiki, and thus any task for social tools reported against these unsupported releases will be closed as invalid. Learn more about MediaWiki's development model for versioning.
 * Branches: For any social tool software you want to install, you must install from the master branch. We don't develop for any other git branch since we lack the resources for such support.

Differences between wikis and social networks
Wikis have many pros and cons compared to social networks. While wikis are designed to help people monitor their adversaries (e.g. vandals) through the Recent Changes page, social media is designed to help people monitor their friends. Wikis generally lack befriending features that update them on what their friends are doing; it would be necessary to check the contributions of individual users one by one, except on small wikis where Recent Changes is easy to monitor.

Userboxes are a prime example of a social networking tool that wikis have but sites such as Facebook don't. Userboxes can be collaboratively customized by editing the wiki code and they can be put into categories whose hierarchy is organized collaboratively as well.

Contributing
Notice that your language isn't translated at all or that the translation is incomplete? patches are always welcome. See to learn more. Once you've finished your patch, please submit it to gerrit to have it reviewed and merged.

For other patches, add and  as reviewers for your patch. Once the patch is done, it'll usually need to be deployed to the dedicated testing environment for further testing on general user experience (e.g user interaction and UI design) and checking to see if there's anything that was missed. After the design review has been done and the patch has been amended accordingly and correctly, one of the reviewers will +2 the change to have it merged into the source code.

Testing environment
The extensions under the social tools umbrella have a dedicated testing environment which is hosted on Wikimedia Cloud VPS, which will almost always be running the most recent commit from the master branch of each social tool extensions. Documentation of the Cloud VPS instance is available on Wikitech.

Reporting bugs and feature requests
Bugs, feedback, and feature requests should be reported on Wikimedia Phabricator, a dedicated application to ticketing and software collaboration. If you don't already have an account yet, you can read a tutorial on how to. Please note that any that are reported on the talk page of any of the social tool extensions will either:
 * Fly under the radar of the maintainers as we might likely not notice it.
 * Be closed as declined if the bug isn't reproducible or doesn't have enough information.
 * Be migrated upstream if determined that such a report is valid. It's recommended that you migrate your report upstream yourself if you know how to.

Support for notifications
Social tools are in development for supporting Echo notifications currently; see the above link for more information.

Licensing
By default, almost every social tools extension is licensed under the GNU General Public License, version 2 (GNU GPL v2) unless otherwise specified. The only current exception is the TopLists extension.