Title: Wiscus Author: zakarialaoui10 Published: 2026 年 4 月 27 日 Last modified: 2026 年 4 月 27 日 --- 搜索插件 ![](https://ps.w.org/wiscus/assets/icon-256x256.png?rev=3516721) # Wiscus 作者：[zakarialaoui10](https://profiles.wordpress.org/zakarialaoui10/) [下载](https://downloads.wordpress.org/plugin/wiscus.1.1.3.zip) * [详情](https://cn.wordpress.org/plugins/wiscus/#description) * [评价](https://cn.wordpress.org/plugins/wiscus/#reviews) * [安装](https://cn.wordpress.org/plugins/wiscus/#installation) * [开发进展](https://cn.wordpress.org/plugins/wiscus/#developers) [支持](https://wordpress.org/support/plugin/wiscus/) ## 描述 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. ## 屏幕截图 [⌊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. ## 区块 该插件提供了 1 个区块. * Wiscus Example block scaffolded with Create Block tool. ## 安装 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] ## 常见问题 ### 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. ## 评价 此插件暂无评价。 ## 贡献者及开发者 「Wiscus」是开源软件。 以下人员对此插件做出了贡献。 贡献者 * [ zakarialaoui10 ](https://profiles.wordpress.org/zakarialaoui10/) [帮助将「Wiscus」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/wiscus) ### 对开发感兴趣吗? 您可以[浏览代码](https://plugins.trac.wordpress.org/browser/wiscus/)，查看[SVN仓库](https://plugins.svn.wordpress.org/wiscus/)， 或通过[RSS](https://plugins.trac.wordpress.org/log/wiscus/?limit=100&mode=stop_on_copy&format=rss) 订阅[开发日志](https://plugins.trac.wordpress.org/log/wiscus/)。 ## 更新日志 #### 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 ## 额外信息 * 版本 **1.1.3** * 最后更新：**1 月前** * 活跃安装数量 **不到10** * 已测试的最高版本为 **6.9.4** * 语言 * [English (US)](https://wordpress.org/plugins/wiscus/) * 标签 * [comments](https://cn.wordpress.org/plugins/tags/comments/)[discussions](https://cn.wordpress.org/plugins/tags/discussions/) [Github](https://cn.wordpress.org/plugins/tags/github/) * [高级视图](https://cn.wordpress.org/plugins/wiscus/advanced/) ## 评级 尚未提交反馈。 [Your review](https://wordpress.org/support/plugin/wiscus/reviews/#new-post) [查看全部评论](https://wordpress.org/support/plugin/wiscus/reviews/) ## 贡献者 * [ zakarialaoui10 ](https://profiles.wordpress.org/zakarialaoui10/) ## 支持 有话要说吗？是否需要帮助？ [查看支持论坛](https://wordpress.org/support/plugin/wiscus/) ## 捐助 您愿意支持这个插件的发展吗? [ 捐助此插件 ](https://ko-fi.com/zakariaelalaoui)