Wiscus is a lightweight WordPress plugin that integrates the Giscus comment system, allowing you to use GitHub Discussions as a modern comment platform for your website.
Instead of storing comments in your WordPress database, Wiscus connects your site to a GitHub repository and uses Discussions to manage conversations. Each post or page can automatically create and link to a corresponding discussion thread.
Key features:
- GitHub-powered comments using Giscus
- Automatic discussion thread creation
- Lightweight and privacy-friendly (no ads, no tracking)
- Easy integration via widget or shortcode
- Customizable themes and mapping options
- Hot page reloading
To install the plugin, please follow the following steps:
- Create a GitHub Repository
- Go to GitHub and log in.
- Click New Repository.
- Give your repository a name (e.g., my-comments).
- Set it to Public (required for Giscus).
- Click Create Repository.
- Enable Discussions
- Open your repository.
- Go to Settings → Features.
- Check Discussions to enable it.
- Save changes.
- Install the Giscus App
- Visit Giscus : https://github.com/apps/giscus.
- Click Install.
- Choose your GitHub account or organization.
- Select the repository you created.
- Complete the installation.
- Get Your Giscus Configuration
- Go to the Giscus website.
- Fill in:
- Your repository name
- Discussion category (e.g., General)
- Customize options (theme, mapping, etc.).
- Copy the generated configuration (you’ll use it in Wiscus).
- Install the Wiscus Plugin in WordPress
- Log in to your WordPress dashboard.
- Go to Plugins → Add New:
- Search for Wiscus, or
- Upload it manually to /wp-content/plugins/.
- Click Install Now and then Activate.
- Configure Wiscus
- Go to Settings → Wiscus.
- Paste your Giscus configuration.
- Save changes.
- Add Wiscus to Your Site
- Option A: Widget
- Go to Appearance → Widgets.
- Add the Wiscus widget to a sidebar or footer.
- Adjust settings as needed.
- Option B: Shortcode
- Add this to any page or post : [wiscus]