Skip to content

Commit

Permalink
Add tutorial section to README
Browse files Browse the repository at this point in the history
  • Loading branch information
okld committed May 24, 2021
1 parent 866cf56 commit 4d229e7
Showing 1 changed file with 34 additions and 0 deletions.
34 changes: 34 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,40 @@ topic_id = 8061
st_discourse(discourse_url, topic_id)
```

## Tutorial

### Embed Streamlit topics into your Streamlit Sharing apps

Let's say you made a topic on this forum showcasing one of your apps.
Now you want to integrate comments from your topic directly in it.

1. The first step is to get your **Topic ID**.
You can find it in the URL of your topic.
For instance with this URL: https://discuss.streamlit.io/t/discourse-integration/8061, the Topic ID is 8061, located at the end.

2. Now in your app, you just have to call `st_discourse("discuss.streamlit.io", 8061)`

> :warning: If your app is **not** run from share.streamlit.io, you won't be able to embed comments from discuss.streamlit.io.
> The same thing applies when you run your app locally, you'll get an `Embedding error`.
>
> If your app is not hosted on Streamlit Sharing, please refer to the two next parts below.
### Embed posts from another Discourse into your Streamlit apps

With this component, you can embed comments from other Discourse websites as well.
However, those other Discourse must be configured to allow embedding for your Streamlit app domain.

For example, if you have a discourse hosted on mydiscourse.example.com, and your streamlit app on myapp.herokuapp.com, you must allow the host myapp.herokuapp.com in your discourse configuration.

For more information, please follow steps 1 to 3 described [here](https://meta.discourse.org/t/embedding-discourse-comments-via-javascript/31963#configuring-discourse-for-embedding-simple-setup).

### Another way to embed comments into your Streamlit apps

Not everyone has its own Discourse, or has admin rights to change embedding settings.

If you're just looking for an easy way to embed comments into your apps **not** hosted on Streamlit Sharing, a great alternative would be to use [Disqus](https://disqus.com/).
You can easily embed comments using [this component](https://share.streamlit.io/okld/streamlit-gallery/main?p=disqus) ([github](https://github.com/okld/streamlit-disqus)).

## Demo

[![Open in Streamlit][share_badge]][share_link]
Expand Down

0 comments on commit 4d229e7

Please sign in to comment.