Extension:Streamer

The Streamer extension displays information about streamers from various streaming services. It can display information as simple as online/offline to as extensive as the current thumbnail.


 * Project Homepage: Documentation at Github
 * Mediawiki Extension Page: Extension:Streamer
 * Source Code: Source Code at Github
 * Bug Reports and Feature Requests: Issue Tracker at Github
 * Licensing: Streamer is released under The GNU Lesser General Public License, version 3.0.

=Installation=

Configuration
Streamer only requires configuration if the YouTube or Twitch service will be used.

=Usage=

#streamer - Parser Tag
The #streamer parser tag takes what service is being used, who the user is, and optionally how to display the information.

Basic Syntax:

Example
To display the default block template for TwitchPlaysPokemon from the Twitch streaming service:



Templates
There are seven built in templates that come with the extension; block, debug, link, live, minilive, thumbnail, and viewers. By default if no template is specified it uses the block template.

Custom
Which template is used to display streamer information can be customized through Mediawiki's templating system. Using the "template" parameter simply add the template page name into the parser call. Example: template=Template:BlockCustom

There are several replacement variables used in the templates that will be automatically filled in with the correct information.


 * %ONLINE% - Integer based boolean if the streamer is online. Use the  parser function to check against this.
 * %NAME% - Streamer's display name, as reported from the streaming service. Will fall back to the streamer's user name if one is not available.
 * %VIEWERS% - Number of current live viewers.
 * %DOING% - What the streamer is doing. This is typically the name of a video game they are playing.
 * %STATUS% - Custom status field set by the channel. This might be a custom stream title or social status depending on the service.
 * %LIFETIME_VIEWS% - Number of overall lifetime views on the channel. This count may include video on demand views depending on the service.
 * %FOLLOWERS% - Number of followers(subscriptions) that the channel has.
 * %LOGO% - Static logo image of the user or channel avatar.
 * %THUMBNAIL% - Periodically updated thumbnail image of a currently live stream.
 * %CHANNEL_URL% - Direct unmodified URL to the channel on the service.
 * %LINK% - URL to the streamer's page on the service. If a custom page link is specified in the Special:StreamerInfo interface it will be used instead.

Built In
The built in templates below are copied from the StreamerTemplate class file and are placed here for reference purposes. They can be used to assist in building custom templates.

block
  %NAME% 

debug
 ONLINE => %ONLINE% NAME => %NAME% VIEWERS => %VIEWERS% DOING => %DOING% STATUS => %STATUS% LIFETIME_VIEWS => %LIFETIME_VIEWS%</li> FOLLOWERS => %FOLLOWERS%</li> LOGO => %LOGO%</li> THUMBNAIL => %THUMBNAIL%</li> CHANNEL_URL => %CHANNEL_URL%</li> LINK => %LINK%</li> </ul>

link
<a href='%LINK%'>%NAME%</a>

live
<div class='stream_info'> <a href='%LINK%'>%NAME%</a> <div class='online '>

minilive
<div class='stream_info'> <a href='%LINK%'>%NAME%</a> <div class='online '>

viewers
<div class='stream_info'> <a href='%LINK%'>%NAME%</a> <div class='online '> %VIEWERS%

thumbnail
<img src=''/>

#streamerinfo - Parser Meta Tag
The #streamerinfo parser meta tag takes what service is being used and who the user is to tag an article as related to that person. It will cause any links automatically generated from the #streamer tag to use the article page as the destination and display name. Streamer information created from tagging or manually entered will be visible in the Special:StreamerInfo interface. Note: Articles tagged with the #streamerinfo tag will override any manually entered information.

Basic Syntax:

Example
To tag the article "Twitch Plays Pokemon" with the Twitch user "twitchplayspokemon":

This would cause all output from the #streamer tag to reference to the "Twitch Plays Pokemon" when generating links and display names.