Taku SDK API Reference

The Taku SDK API is basically a set of instructions that helps you customize and control the Taku widget on your webpage. Let me break down how to use it:

Taku('news:boot', takuSettings)

1
window.Taku('news:boot', {
2
  api_public_key: '<Project Key>',
3
  user_id: "USER_ID",
4
  ...
5
});

You can start or "boot" Taku by calling Taku('news:boot', takuSettings). This is useful if your website only loads certain elements when a user logs in.

Here are the settings you can tweak:

Config name	Description	Type	Default value
`api_public_key`	The public key to access your project data. The one specified in code snippets is your public key for this project.	`string`	`undefined`
`user_id`	This links user's actions like voting, liking, or viewing posts to a specific user. If not given, Taku will make up a random ID per device. It's recommended to use a hash ID that might already be in use for other tracking services.	`string`	`undefined`
`user_groups`	This is an array of user groups that the user belongs to. This is useful for targeting specific groups of users.	`array<string>`	`undefined`
`disable_tracking`	If set to true, Taku will remove any user related data from the tracking.	`boolean`	`false`

Taku('news:shutdown')

1
window.Taku('news:shutdown');

This method will remove the widget and local user data. It's particularly useful when you want to logout a user from your application.

Taku('news:destroy')

1
window.Taku('news:destroy');

Compared to news:shutdown, this method will only remove the widget from the page. It will not remove the user's data. It's usefull when you want to hide the widget but still keep the user logged in.

Taku('news:show')

1
window.Taku('news:show');

If you have a special button to make the widget appear, use this method to show it.

Taku('news:hide')

1
window.Taku('news:hide');

If you want to hide the widget, use this method.

Taku('news:on', eventName, callback)

1
window.Taku('news:on', 'badge:show', function() {
2
  console.log('badge is shown');
3
});

Taku can trigger events that your website can react to. For example, in the code above, we're listening to the "badge:show" event to know when there are unseen messages for a user to check.

The different events you can listen for are:

Event name	Description
`show`	Triggered when the widget appears.
`hide`	Triggered when the widget disappears.
`badge:show`	Triggered when there are new, unseen messages for a user.
`badge:hide`	Triggered when there are no new messages for a user.

Taku('news:off', eventName, callback)

1
window.Taku('news:off', 'badge:show', onBadgeShow);

To stop receiving notifications from a certain event, you can use this method. It needs the name of the action and the function you used to handle it. This helps prevent overloading your computer's memory.