Soulanma boards can be embedded in other apps to improve efficiency and enhance communication.
If you're a user of Soulanma looking to embed a board in another app you use, check out this article: Embedding Soulanma files
If you're a developer looking to support Soulanma embeds in your own app, read on. 😉
If you want to give your users a way to embed Soulanma in your product, supporting the oEmbed protocol makes things simple. Soulanma is a provider in the oEmbed directory as well as in tools like iFramely and Embedly.
In this scenario, your users paste a Soulanma board URL into your app. Your app requests embed information from Soulanma, and we return the relevant code.
An added benefit to this approach: by supporting oEmbed, you can embed links from many other tools – not just Soulanma!
If you don’t want to use oEmbed, you can detect and transform links on your own. First, you’ll need to detect valid Soulanma file URLs. This regex may be helpful:
Next, you’ll want to grab the unique id from the URL. It’s the string of characters at the end.
You'll then insert that id into an iframe element, like so.
That's it. You’re welcome to adjust the style, width, and height parameters to match the context and styling of your app.
Yes, though they can only be previewed if you are currently logged into Soulanma in the same browser. If you’d like anyone to view the board, you will need to set it to public.