Configuration

Configuring the software

  1. Navigate to the administrator side of your Joomla-powered website.
  2. Click on System > Global Setting and click on SD Twitch Stream.

Basic settings

Setting Explanation Default
Bootstrap 4 Enable this option if your frontend template uses Bootstrap 4. If disabled, a polyfill will be loaded in. No

Cronjob settings

These steps and settings are not required if you only plan on using the stream embeds.

Setting Explanation Default
Allow Web Cron If you don't know how to setup cronjobs on your server or lack support, you can use the webcron. Enable this option to allow webcrons. No
Client ID The OAuth client ID.
Client Secret The OAuth client secret.
OAuth Redirect URL The OAuth redirect URL

To use SD Twitch Stream to its full potential, you should setup the API link between Twitch.tv and your website. Open the configuration of SD Twitch Stream on your website via Global Settings > SD Twitch Stream. Open the Cron tab and go to the Client ID, Client Secret and OAuth Redirect Url fields. You'll need those in a minute.

Acquiring authentication details
The authentication details can be directly retrieved from Twitch. You'll need a Twitch account to retrieve these.

  1. Open your app dashboard on Twitch.
  2. Press the Register Your Application button to create a new application.
  3. Fill the required fields;
    1. Name can be the name of your website.
    2. The OAuth Redirect URLs must contain a full URL to the root of your website.
  4. Press Create to create your application.
  5. Return to the SD Twitch Stream settings on your website and enter the Client ID and Client Secret into the correct fields. The OAuth Redirect Url must match the one set on Twitch. If the URL if different, the integration will not work.

Setting up the cronjob
SD Twitch Stream works with a cronjob. This assures fresh information every minute without slowing down navigation on your website. The cronjob retries all vital information which then gets cached on your website. Open the SD Twitch Stream component in the administrator side of your website and navigate to the System status page. You'll see two blocks containing instructions on how to setup the cronjob. The CLI cronjob is strongly recommended, but if required a HTTP cronjob is also available.