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.<\/p>\n\n
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.<\/p>\n\n
Key features:<\/p>\n\n
- GitHub-powered comments using Giscus\n- Automatic discussion thread creation\n- Lightweight and privacy-friendly (no ads, no tracking)\n- Easy integration via widget or shortcode\n- Customizable themes and mapping options\n- Hot page reloading\n<\/code><\/pre>\n\nDevelopment<\/h3>\n\n
This plugin uses a build process (webpack) to generate production files located in \/build.<\/p>\n\n
The full, human-readable source code is available here:\nhttps:\/\/github.com\/zakarialaoui10\/wiscus<\/a><\/p>\n\nProject structure<\/h3>\n\n\n- \/src<\/a> : original source code<\/li>\n
\/build<\/code> : compiled\/minified production files (used in production)<\/li>\n<\/ul>\n\nDependencies<\/h3>\n\n
This plugin relies on the following external libraries:<\/p>\n\n
\n- giscus<\/a> used for embedding GitHub Discussions-based comments system.<\/li>\n
- ziko<\/a> a custom UI\/library used for frontend rendering and components.<\/li>\n<\/ul>\n\n
Getting started<\/h3>\n\n
Clone the repository:\ngit clone https:\/\/github.com\/zakarialaoui10\/wiscus.git\ncd wiscus<\/p>\n\n
Install dependencies:\n npm install<\/p>\n\n
Run development mode:\n npm run dev<\/p>\n\n
Build for production:\n npm run build<\/p>\n\n
Forking & Contributing<\/h3>\n\n
You are welcome to fork and contribute:<\/p>\n\n
\n- Fork the repository on GitHub.<\/li>\n
- Clone your fork (replace
<your-username><\/code> with your GitHub handle):\ngit clone https:\/\/github.com\/\/wiscus.git<\/li>\n- Create a new branch:\ngit checkout -b feature\/your-feature-name<\/li>\n
- Commit your changes and push:\ngit push origin feature\/your-feature-name<\/li>\n
- Open a Pull Request.<\/li>\n<\/ol>\n\n
Note: Ensure you are cloning your personal fork and not the main repository if you intend to submit a Pull Request<\/p>\n\n
Notes<\/h3>\n\n\n- Do not edit files inside \/build directly.<\/li>\n
- Always make changes in \/src and rebuild.<\/li>\n<\/ul>\n\n\n
To install the plugin, please follow the following steps:<\/p>\n\n
\nCreate a GitHub Repository<\/p>\n\n
\n- Go to GitHub and log in.<\/li>\n
- Click New Repository.<\/li>\n
- Give your repository a name (e.g., my-comments).<\/li>\n
- Set it to Public (required for Giscus).<\/li>\n
- Click Create Repository.<\/li>\n<\/ul><\/li>\n
Enable Discussions<\/p>\n\n
\n- Open your repository.<\/li>\n
- Go to Settings \u2192 Features.<\/li>\n
- Check Discussions to enable it.<\/li>\n
- Save changes.<\/li>\n<\/ul><\/li>\n
Install the Giscus App<\/p>\n\n
\n- Visit Giscus : https:\/\/github.com\/apps\/giscus.<\/li>\n
- Click Install.<\/li>\n
- Choose your GitHub account or organization.<\/li>\n
- Select the repository you created.<\/li>\n
- Complete the installation.<\/li>\n<\/ul><\/li>\n
Get Your Giscus Configuration<\/p>\n\n
\n- Go to the Giscus website.<\/li>\n
- Fill in:\n\n
\n- Your repository name<\/li>\n
- Discussion category (e.g., General)<\/li>\n
- Customize options (theme, mapping, etc.).<\/li>\n<\/ul><\/li>\n
- Copy the generated configuration (you\u2019ll use it in Wiscus).<\/li>\n<\/ul><\/li>\n
Install the Wiscus Plugin in WordPress<\/p>\n\n
\n- Log in to your WordPress dashboard.<\/li>\n
- Go to Plugins \u2192 Add New:<\/li>\n
- Search for Wiscus, or<\/li>\n
- Upload it manually to \/wp-content\/plugins\/.<\/li>\n
- Click Install Now and then Activate.<\/li>\n<\/ul><\/li>\n
Configure Wiscus<\/p>\n\n
\n- Go to Settings \u2192 Wiscus.<\/li>\n
- Paste your Giscus configuration.<\/li>\n
- Save changes.<\/li>\n<\/ul><\/li>\n
Add Wiscus to Your Site<\/p>\n\n
\n- Option A: Widget\n\n
\n- Go to Appearance \u2192 Widgets.<\/li>\n
- Add the Wiscus widget to a sidebar or footer.<\/li>\n
- Adjust settings as needed.<\/li>\n<\/ul><\/li>\n
- Option B: Shortcode\n\n
\n- Add this to any page or post : [wiscus]<\/li>\n<\/ul><\/li>\n<\/ul><\/li>\n<\/ol>\n\n\n
\nA question that someone might have<\/h3><\/dt>\n- <\/dd>\n
What is Wiscus ?<\/h3><\/dt>\nWiscus is a WordPress plugin that integrates the Giscus comment system, allowing you to use GitHub Discussions as a modern commenting platform on your website.<\/p><\/dd>\n
Do I need a GitHub account to use Wiscus ?<\/h3><\/dt>\nYes. Wiscus requires a GitHub account and a public repository with Discussions enabled to store and manage comments.<\/p><\/dd>\n
How do I connect Wiscus to my site ?<\/h3><\/dt>\nAfter installing the plugin, go to Settings > Wiscus and paste your Giscus configuration generated from the Giscus website.<\/p><\/dd>\n
Why are comments not showing ?<\/h3><\/dt>\nMake sure your repository is public, Discussions are enabled, the Giscus app is installed, and your configuration settings are correct.<\/p><\/dd>\n
Can I use Wiscus without widgets ?<\/h3><\/dt>\nYes. You can display Wiscus on any page or post using the shortcode [wiscus].<\/p><\/dd>\n
Can I customize the appearance ?<\/h3><\/dt>\nYes. You can customize themes (light\/dark), language, and other options through your Giscus configuration.<\/p><\/dd>\n
Is Wiscus free to use ?<\/h3><\/dt>\nYes. Wiscus and Giscus are free to use, but they rely on GitHub\u2019s infrastructure.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.1.3<\/h4>\n\n\n- Improve Forking & Contributing instructions with clearer guidance for contributors.<\/li>\n<\/ul>\n\n
1.1.2<\/h4>\n\n\n- Replace inline JavaScript in admin.php with proper WordPress script enqueue system using wp_enqueue_script<\/li>\n
- Fix WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound warnings by prefixing global variables with \"wiscus\" keyword.<\/li>\n<\/ul>\n\n
1.1.1<\/h4>\n\n\n- Improved security by escaping all output properly (esc_attr, esc_html)<\/li>\n
- Replaced json_encode with wp_json_encode for WordPress compatibility<\/li>\n
- Fixed PHPCS warnings (OutputNotEscaped, MissingVersion, DirectQuery, NoCaching)<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n\n- Fix editor attributes<\/li>\n
- Add Hot page reloading<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Initial release<\/li>\n<\/ul>","raw_excerpt":"Bring GitHub Discussions to WordPress using Giscus.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/301037","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=301037"}],"author":[{"embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/zakarialaoui10"}],"wp:attachment":[{"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=301037"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=301037"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=301037"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=301037"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=301037"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=301037"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}