Twitch Live Status

Display a live status indicator when you're streaming on Twitch with customizable appearance and automatic stream information.

Description

The Twitch Live Status block automatically detects when you're live on Twitch and displays a customizable status indicator that links directly to your stream. When you're not streaming, the block remains invisible, keeping your site clean.

Key Features:

• Automatic Live Detection - Checks your Twitch stream status in real-time
• Fully Customizable - Configure size, colors, alignment, title, and description
• Stream Information - Displays current game/category and viewer count
• Responsive Design - Adapts beautifully to any theme
• Performance Optimized - Uses WordPress transients for efficient API caching
• Easy Setup - Simple Twitch API configuration in WordPress admin

Customization Options:

• Multiple size presets (Small, Medium, Large, Custom)
• Flexible alignment (Left, Center, Right, Full Width)
• Custom colors for background, text, and accent elements
• Personalized title and description text
• Show/hide stream details like game and viewer count
• Adjustable refresh intervals

Requirements:

To use this block, you'll need to obtain a Twitch Client ID and optionally a Client Secret from the Twitch Developer Console. The block includes detailed setup instructions and handles all the technical implementation.

Perfect for streamers, content creators, and anyone who wants to showcase their live Twitch presence on their WordPress website.

Installation

1. Upload the plugin files to the /wp-content/plugins/twitch-live-status directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Create a Twitch application at https://dev.twitch.tv/console/apps
4. Configure your Twitch Client ID in Settings > Twitch Live Status
5. Add the block to any post or page using the block editor

Frequently Asked Questions

How do I get a Twitch Client ID?

1. Go to https://dev.twitch.tv/console/apps
2. Log in with your Twitch account
3. Click "Register Your Application"
4. Fill in the required fields (OAuth Redirect URLs can be your website URL)
5. Copy the Client ID to your WordPress settings

Will this slow down my website?

No! The block uses WordPress transients to cache API responses and only checks for updates at configurable intervals (default 2 minutes). The frontend display is also optimized for performance.

Can I customize the appearance?

Absolutely! The block offers extensive customization options including colors, sizes, alignment, and content. You can make it match your website's design perfectly.

What happens when I'm not streaming?

The block becomes invisible when you're offline, so your visitors won't see anything. This keeps your site looking clean when you're not broadcasting.

Screenshots

1. Live status block showing stream information with custom styling
2. Block settings panel with all customization options
3. Twitch API configuration in WordPress admin
4. Block in the editor showing live preview

Changelog

0.1.0

• Initial release
• Live stream detection with Twitch API integration
• Customizable appearance and content options
• Performance optimized with transient caching
• Responsive design for all devices

Setup Instructions

After installation, you'll need to configure your Twitch integration:

1. Get Twitch Credentials: Visit the Twitch Developer Console to create an application and get your Client ID
2. Configure Settings: Go to Settings > Twitch Live Status in your WordPress admin
3. Add Your Details: Enter your Twitch username and Client ID
4. Insert Block: Add the Twitch Live Status block to any post or page
5. Customize: Use the block settings to style it to match your brand

The block will automatically start checking your stream status and display when you go live!