🚀 What is wiscus ?
Wiscus is a bridge between WordPress and GitHub Discussions.
Instead of storing comments in your WordPress database, Wiscus lets you:
- Deliver a fast, modern commenting experience
- Store discussions in your GitHub repository
- Use GitHub’s moderation tools
- Enable developer-friendly workflows
⚙️How it Works ?
Wiscus uses Giscus under the hood to embed a comment interface powered by GitHub Discussions.
Here’s the flow:
- A visitor opens a page
- Wiscus loads Giscus
- Giscus looks for an existing discussion
- If none exists, it creates one automatically
- Comments are displayed and synced in real-time
Each page is mapped to a discussion using configurable rules such as URL, title, or a custom identifier.
Key Features
Shortcode Support
[wiscus]Admin Configuration
All settings are managed from the WordPress admin panel:
- Repository and IDs
- Discussion category
- Mapping strategy
- Theme selection
🎨 Theme Customization
Wiscus supports all official Giscus themes, including:
- GitHub Light & Dark
- High contrast variants
- Catppuccin themes
- Gruvbox themes
This ensures your comments match your site’s design perfectly.
đź”— Flexible Mapping System
Wiscus allows you to control how discussions are linked to pages:
pathname(recommended)urltitleog:titlespecific(custom ID)
The specific mapping option is especially powerful—it lets you use a stable identifier (like a post ID), preventing broken discussions if URLs change.
đź’ˇ Why Use GitHub Discussions for Comments?
Using GitHub Discussions offers several advantages:
- âś… No database bloat in WordPress
- âś… Built-in moderation tools
- âś… Spam protection via GitHub authentication
- âś… Developer-friendly ecosystem
- âś… Version-controlled conversations
It’s especially useful for:
- Technical communities
- Developer blogs
- Documentation sites
- Open-source projects