Title: Wiscus Author: zakarialaoui10 Published: April 27, 2026 Last modified: April 27, 2026 --- Search plugins ![](https://ps.w.org/wiscus/assets/icon-256x256.png?rev=3516721) # Wiscus By [zakarialaoui10](https://profiles.wordpress.org/zakarialaoui10/) [Download](https://downloads.wordpress.org/plugin/wiscus.1.1.3.zip) * [Details](https://srd.wordpress.org/plugins/wiscus/#description) * [Reviews](https://srd.wordpress.org/plugins/wiscus/#reviews) * [Installation](https://srd.wordpress.org/plugins/wiscus/#installation) * [Development](https://srd.wordpress.org/plugins/wiscus/#developers) [Support](https://wordpress.org/support/plugin/wiscus/) ## 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](https://github.com/zakarialaoui10/wiscus) ### Project structure * [/src](https://github.com/zakarialaoui10/wiscus/tree/main/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: 1. Fork the repository on GitHub. 2. Clone your fork (replace `` with your GitHub handle): git clone https://github.com//wiscus.git 3. Create a new branch: git checkout -b feature/your-feature-name 4. Commit your changes and push: git push origin feature/your-feature-name 5. 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 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 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 ](https://ps.w.org/wiscus/assets/screenshot-2.png?rev=3516713) 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.⌉⌊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 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.⌉⌊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.⌉[ 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. ## Blocks This plugin provides 1 block. * Wiscus Example block scaffolded with Create Block tool. ## Installation To install the plugin, please follow the following steps: 1. Create a GitHub Repository 2. * 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. 3. Enable Discussions 4. * Open your repository. * Go to Settings Features. * Check Discussions to enable it. * Save changes. 5. Install the Giscus App 6. * Visit Giscus : https://github.com/apps/giscus. * Click Install. * Choose your GitHub account or organization. * Select the repository you created. * Complete the installation. 7. Get Your Giscus Configuration 8. * 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). 9. Install the Wiscus Plugin in WordPress 10. * 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. 11. Configure Wiscus 12. * Go to Settings Wiscus. * Paste your Giscus configuration. * Save changes. 13. Add Wiscus to Your Site 14. * 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] ## FAQ ### A question that someone might have ### What is Wiscus ? Wiscus is a WordPress plugin that integrates the Giscus comment system, allowing you to use GitHub Discussions as a modern commenting platform on your website. ### Do I need a GitHub account to use Wiscus ? Yes. Wiscus requires a GitHub account and a public repository with Discussions enabled to store and manage comments. ### How do I connect Wiscus to my site ? After installing the plugin, go to Settings > Wiscus and paste your Giscus configuration generated from the Giscus website. ### Why are comments not showing ? Make sure your repository is public, Discussions are enabled, the Giscus app is installed, and your configuration settings are correct. ### Can I use Wiscus without widgets ? Yes. You can display Wiscus on any page or post using the shortcode [wiscus]. ### Can I customize the appearance ? Yes. You can customize themes (light/dark), language, and other options through your Giscus configuration. ### Is Wiscus free to use ? Yes. Wiscus and Giscus are free to use, but they rely on GitHub’s infrastructure. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Wiscus” is open source software. The following people have contributed to this plugin. Contributors * [ zakarialaoui10 ](https://profiles.wordpress.org/zakarialaoui10/) [Translate “Wiscus” into your language.](https://translate.wordpress.org/projects/wp-plugins/wiscus) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/wiscus/), check out the [SVN repository](https://plugins.svn.wordpress.org/wiscus/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wiscus/) by [RSS](https://plugins.trac.wordpress.org/log/wiscus/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.1.3 * Improve Forking & Contributing instructions with clearer guidance for contributors. #### 1.1.2 * Replace inline JavaScript in admin.php with proper WordPress script enqueue system using wp_enqueue_script * Fix WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound warnings by prefixing global variables with “wiscus” keyword. #### 1.1.1 * Improved security by escaping all output properly (esc_attr, esc_html) * Replaced json_encode with wp_json_encode for WordPress compatibility * Fixed PHPCS warnings (OutputNotEscaped, MissingVersion, DirectQuery, NoCaching) #### 1.1.0 * Fix editor attributes * Add Hot page reloading #### 1.0.0 * Initial release ## Meta * Version **1.1.3** * Last updated **2 months ago** * Active installations **Fewer than 10** * Tested up to **6.9.4** * Language * [English (US)](https://wordpress.org/plugins/wiscus/) * Tags * [comments](https://srd.wordpress.org/plugins/tags/comments/)[discussions](https://srd.wordpress.org/plugins/tags/discussions/) [Github](https://srd.wordpress.org/plugins/tags/github/) * [Advanced View](https://srd.wordpress.org/plugins/wiscus/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/wiscus/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/wiscus/reviews/) ## Contributors * [ zakarialaoui10 ](https://profiles.wordpress.org/zakarialaoui10/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/wiscus/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://ko-fi.com/zakariaelalaoui)