Vssue (/'vɪʃuː/, combined by "V" and "Issue") is a Vue component / plugin, which can enable comments for your static pages.
As your pages are "static", you don't have database nor backend APIs, but you still want users to login and post comments. With the help of OAuth API of the code hosting platforms (e.g. Github, Gitlab, Bitbucket, Coding, etc.), Vssue can help users to login with account of those platforms, store the comments in their Issue System, and display the comments on current page.
This is how Vssue get its name : Vue-powered and Issue-based.
How Vssue works
Following the OAuth 2 spec, platforms provide OAuth API. With the help of them, users can login to Vssue with accounts of the platform and access comments.
Here is the brief process about how Vssue works:
Vssue Platform ┌──────────────────────┐ ┌────────────────────┐ │ Click Login ├───────── redirect ────────>│ Authorization Page │ └──────────────────────┘ └──────────┬─────────┘ ┌──────────────────────┐ │ │ │<─── redirect with token / code ───────┘ │ Handle Authorization │ ┌────────────────────┐ │ │<─── (may) request token ──>│ │ └──────────────────────┘ │ │ ┌──────────────────────┐ │ │ │ Get Comments │<─── request with token ───>│ Platform API │ └──────────────────────┘ │ │ ┌──────────────────────┐ │ │ │ Post Comments │<─── request with token ───>│ │ └──────────────────────┘ └────────────────────┘ ......
After Vssue is authorized by users for the platform in the Authorization Page, the platform will redirect back to Vssue with
Vssue will request the platform for users'
code, and store
token in localstorage, which means that users have "logined" to Vssue with the account of the platform.
Then Vssue could get the user's info and get the comments of this page. And users could post comments, too.
Comparison with similar projects
- Vssue supports Github, Gitlab and Bitbucket, and can be extended to other platform easily. Gitment and Gitalk only support Github.
- Vssue can post, edit and delete comments. Gitment and Gitalk can only post comments.