9 Enabling the widget

Bohdan Mart edited this page 2024-03-31 01:43:21 +02:00

1. Serve everything under web/ using your webserver of choice. Make sure not to serve the top-level data, as config.json and the Telethon session file contain sensitive data.

2. Type /devtools in chat. Other -> Explore account data in Element Web (not "room account data", must be the global one), edit the m.widgets account data event to have the following content:

   {
       "stickerpicker": {
           "content": {
               "type": "m.stickerpicker",
               "url": "https://your.sticker.picker.url/?theme=$theme",
               "name": "Stickerpicker",
               "creatorUserId": "@you:matrix.server.name",
               "data": {}
           },
           "sender": "@you:matrix.server.name",
           "state_key": "stickerpicker",
           "type": "m.widget",
           "id": "stickerpicker"
       }
   }
   

   If you do not yet have a m.widgets event, simply create it with that content. You can also use the client-server API directly instead of using Element Web.

   The theme=$theme query parameter will make the widget conform to Element's theme automatically. You can also use light, dark or black instead of $theme to always use a specific theme.

   You can use https://maunium.net/stickers-demo/ as the URL to try out the picker without hosting the files yourself.

3. Open the sticker picker and enjoy the fast sticker picking experience.