Inserts Twitch.tv stream status tags in your blog. The tags just indicates if the stream is live with a blinking red cirle or offline.
Supports multiple channels.
Also implements a simple widget showing the stream status (including the thumbnail, title, game name and number of viewers) + CSS classes to show and hide some elements of the markup accordingly to the channel status.
The tags and the widget are updated every 30 seconds.
Install the plugin
- Download and unzip twitch-status archive contents to the
/wp-content/plugins/twitch-statusdirectory or add it using WordPress’ plugin manager.
- Activate the plugin through the ‘Plugins’ menu in WordPress.
Configure your channels
- Go to Settings / Twitch status
- Enter the name of all the channels you want to use with the plugin, including in widgets.
- (optional) Set the jQuery selector(s) for each channel matching the places you want to insert a status tag. Check the F.A.Q. for more information about how to use them (it’s easy). Leave this blank if you just want to use the plugin.
- Go to Appearance / Widgets
- Drag and drop the Twitch status widget wherever you want to use it.
- Choose the Twitch channel you want to show up among the ones you have previously entered in the settings.
Insert Twitch video player in a post
To insert a video player without the chatbox, use shortcode
[twitch-player channel="CHANNEL_NAME"]. With the chatbox, use shortcode
[twitch-player channel="CHANNEL_NAME" chat="true"].
Replace CHANNEL_NAME with the name of a channel you have previously configured in the settings.
Insert Twitch chatbox in a post
[twitch-chat channel="CHANNEL_NAME"] where CHANNEL_NAME is the name of a channel you have previously configured in the settings.
Insert “Live” tag when my channel is online in a post
[twitch-status channel="CHANNEL_NAME"] where CHANNEL_NAME is the name of a channel you have previously configured in the settings.
I want to add a widget for my channel but there is no way to set my channel name
You must first add your channel in the plugin’s settings page. Then, you will be able to select your channel in the widget’s settings.
I want to add a stream status tag on my “Twitch” tab. How do I find the matching jQuery selector?
You can find the jQuery selector by using the browser developers tools (right click / inspect on element) to get the id and/or classes of the element. If you have an id, just prepend the # symbol to it and you have it. For example, if your element has ID
menu-item-582, the jQuery selector would be
#menu-item-582. If the menu element has a link inside it (
aelement), add the a element in the selector
If your element doesn’t have an id but a class, use the class instead. The matching selector would have a
.instead of a
Fore more information about jQuery selectors, check out http://api.jquery.com/category/selectors/
I added the right shortcode to embed my channel’s player but all I see is a grey block
Check if you have correctly added your channel name in the settings page before.
Can I show and hide some parts of my page accordingly to my channel status?
Yes! There are 3 CSS classes
twitch-is-loadingto be used in conjunction with the
data-twitch-channelHTML attribute with your channel name
CHANNEL_NAMEis the name of your channel) to achieve this.
Please be aware that the channel must be added on the settings page.
For example, if your channel name is “nolife”:
Nolife is <span data-twitch-channel="nolife"><span class="twitch-is-online">online to kick ass and chew bubble gum!</span><span class="twitch-is-offline">offline. Eighters gonna 8.</span><span class="twitch-is-loading">...</span></span>
Contributors & Developers
“Twitch Status” is open source software. The following people have contributed to this plugin.Contributors
- Fixed metadata
- Updated for the new Twitch Helix API
- Minor bugfixes and improvements
- Chat now fits screen size when viewing embedded player + chat combo on a mobile screen.
- Fixed options page bugs
- Now using HTML5 data to update elements (CSS classes are still supported for backward compatibility)
- Added shortcode [twitch-status] for status tag
- Added shortcode [twitch-player] for embedded player
- Added shortcode [twitch-chat] for embedded chatbox
- Properly rewrote some parts of code
- Optimized loading time of the tags and the widgets.
- Widget links are now active all the time, even when the channel is offline.
- Fixed widget links to Twitch channels.
- Improved documentation.
- Fixed calls to Twitch.tv API.
- Added CSS classes
twitch-is-loadingto be used in conjunction with
twitch-status-channel-CHANNEL_NAMEto enable/disable some elements of the page accordingly to the channel status.
- Fixed widget size issues
- Added multiple channel support
- Added stream status widget
- First release