Welcome to the Crate tutorial!
This tutorial assumes you have already completed the Getting Started with WidgetBot tutorial. If you have not, please read it and invite the bot.
If you need any assistance adding WidgetBot, please ask in the server. However, please make sure you mention what the issue is, send your code in a codeblock (
```), include your server and channel IDs, and optionally include a link to your site.
To get started with Crate, use
/crate in your server. You should run it in the channel you want to show as default on your website. (Note that users can switch between the public channels in the sidebar). WidgetBot should send code that looks like this:
<script src="https://cdn.jsdelivr.net/npm/@widgetbot/crate@3" async defer>
The code sent by the bot goes in your site's HTML source at the end of your website's
body, right before the closing
</body> tag. This might be in your theme or layout's code.
If you run your site with this code, you should see the little crate button in the bottom right corner. If you click it, it should show your server, with the correct default channel.
(If there's an issue, please go to the WidgetBot server, and make sure you mention what the issue is, send your code in a codeblock (
```), include your server and channel IDs, and optionally include a link to your site.)
You have successfully set up WidgetBot. However you can further customize WidgetBot to your needs. Read below for more info.
This tutorial showed you the
channel options. However, there are many other options you can set, letting you do things such as change the location, the color and icon, toggling message notifications, and more. For a full list of options, click here.
You can see tons of Crate examples here.