Wiscus Wordpress Plugin - Rating, Reviews, Demo & Download
Plugin Description
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
Development
This plugin uses a build process (webpack) to generate production files located in /build.
The full, human-readable source code is available here:
https://github.com/zakarialaoui10/wiscus
Project structure
- /src : original source code
- /build : compiled/minified production files (used in production)
Dependencies
This plugin relies on the following external libraries:
- giscus : https://giscus.app, used for embedding GitHub Discussions-based comments system.
- ziko : https://github.com/zikojs/ziko, a Custom UI/library used for frontend rendering and components.
Getting started
Clone the repository:
git clone https://github.com/zakarialaoui10/wiscus.git
cd wiscus
Install dependencies:
npm install
Run development mode:
npm run dev
Build for production:
npm run build
Forking & Contributing
You are welcome to fork and contribute:
- Fork the repository on GitHub.
- Clone your fork (replace
<your-username>with your GitHub handle):
git clone https://github.com//wiscus.git - Create a new branch:
git checkout -b feature/your-feature-name - Commit your changes and push:
git push origin feature/your-feature-name - Open a Pull Request.
Note: Ensure you are cloning your personal fork and not the main repository if you intend to submit a Pull Request
Notes
- Do not edit files inside /build directly.
- Always make changes in /src and rebuild.
Screenshots
The screenshot highlights the WordPress Settings menu with the Wiscus option visible at the bottom. It indicates where users can access the Wiscus plugin settings.
The screenshot shows the Wiscus settings page in the WordPress dashboard under Settings → Wiscus.
It includes fields for GitHub repository details, mapping, category, and theme configuration.![The screenshot shows the WordPress editor with the [wiscus] shortcode added to a page. On the right, the live preview displays the Giscus-powered comment section working with a sample comment.](https://ps.w.org/wiscus/assets/screenshot-3.png?rev=3516713)
The screenshot shows the WordPress editor with the [wiscus] shortcode added to a page. On the right, the live preview displays the Giscus-powered comment section working with a sample comment.
The screenshot shows a GitHub Discussions thread automatically generated by Wiscus for a WordPress page. It includes the post title, linked URL, and a synced comment from the site.
