Shortcodes, Widgets & Sidebars

Widgets » Tlk.io Widget

The Tlk.io widget allows you to embed a web chat in your site.

Table of Contents


Adding the Tlk.io Widget

To add the Tlk.io Widget to your site, you’ll first need to visit http://tlk.io to start a channel. All channels are public, including the random channels.

tlkio_createchannel

To add the widget to your site:

  1. In your dashboard, click on Appearance → Customize → Widgets.
  2. Choose the location where you’d like to place the widget on your site. Common options here include the Footer and Sidebar, but this may be different depending on your theme.
  3. Click either of the + block inserter buttons (see right) to see a list of all the available blocks and widgets.
  4. Scroll down to the Widgets section and click on the widget once to add it to your site.

For general information on working with widgets, see this guide.

The two + icon block inserter buttons are marked with arrows.
Block inserter buttons

↑ Table of Contents ↑

Settings

Once you add the widget to your sidebar or other widget area, you’ll see the following widget settings:

Screen Shot on 2021-09-07 at 08-27-22.png

Title: Sets the title for the widget on your site. You can choose any title for the widget, or omit it.

Channel: Sets the channel for the widget. The Channel setting must match your channel on tlk.io.

Height (in pixel): Sets the widget’s display height on your site.

After adding or changing the widget settings, click Save Changes.


↑ Table of Contents ↑

Starting Chats

Once you’ve added the widget, chats can be started from your sidebar:

tlkio_chatsidebar

They can also be started from the tlk.io website:

tlkio_chatthere

↑ Table of Contents ↑

Adding Chat to Pages and Posts

There is also a shortcode to add chat to pages and posts. You can add a shortcode to any page or post using a shortcode block.

Copy the shortcode below and paste it on its own line in the body of a page or post. Change your channel name and choose a height that works well for your site’s design.

[tlkio channel=lobby height=800]

Not quite what you're looking for?

Get Help