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 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 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)