# 文派叶子
文派叶子🍃（WPCY.COM）优化内核加速，产品使用文档。
# 使用文档
# 参与生态建设、贡献翻译、bug 报告、赞助我们
我们的使命：打造更适合中国互联网的开源 CMS 建站系统
文派叶子 🍃（WP-China-Yes）本质上是一款基础服务性质插件，属于非盈利产品，存在的意义就是为了破除 WordPress 程序与中国用户之间的障碍。
> 插件和服务是免费的，但是「免费 ≠ 零成本」。
文派开源的基础软硬件设施成本十分高昂，我们将在未来通过平台化方式尝试各种盈利的可能性，同时接受商业赞助及合作。
参与项目开发及发现 Bug 问题回报，请访问文派开源（WenPai.org）主页，
> [https://github.com/WenPai-org/ ↗](https://github.com/WenPai-org/)
协助中文翻译贡献您的力量，请前往文派翻译平台，
> [https://translate.wenpai.org ↗](https://translate.wenpai.org)
如果您乐意为我们提供资金、资源以及其他相关支持，欢迎与我们取得联系。
目前官方捐赠渠道暂未开通，我们将会在未来一段时间上线新的渠道。所有的款项将用于文派（WordPress）生态建设以及相关成本支出。
期待您的参与，我们更期待文派生态成型的那一天。
---
# 自动获取 WordPress 中文翻译更新
首先您应该了解到，WordPress 平台上的所有中文翻译均为贡献者参与翻译和校对的，在过去的十几年间已经更换过多次管理团队及人员。
> 所有的 WordPress 中文翻译均为志愿者进行校对和翻译。
对于缺少的语言包是因为 WordPress 主题、插件开发者原本就没有提供中文支持，现在可以如此方便获得文派开源社区提供的语言包时，也不应认为理所应当。
### 一、更新翻译
1、自动获取中文翻译
安装文派叶子 🍃（WP-China-Yes）并正常启用后，请到后台设置页面选择更新源为【文派开源】，保存后刷新页面您将会看到有更新提示。
进入更新页面，点击【更新翻译】即可获得全部由文派开源社区提供的中文翻译文件更新。
> 此为独家功能，平台数据完全由中国服务器托管。
2、手动导入中文翻译
如果以上方式更新失败，或者无法通过自动更新获取到某个插件的语言包，那么请尝试使用[文派翻译导入器（wpfanyi import）↗](https://wenpai.org/plugins/wpfanyi-import)插件。
WordPress 应用市场无法获取到中文翻译、亦或是若自动翻译失效，请使用此插件手动导入。数据来源请访问 WPfanyi.com 搜索您需要的语言包文件即可。
如果某款主题、插件未能有可用语言包，也可以尝试进入[文派翻译平台↗](https://translate.wenpai.org/) 搜索，请求管理员进行 AI 翻译皆可。
### 二、发展历程
从 2015 年起，由薇晓朵（Weixiaoduo.com）创始团队成员逐步为 WordPress.org 提交贡献了大量精校优质的免费翻译词条以此改善了WordPress 翻译日渐混乱的现状。这其中不乏多款热门的免费插件如 bbPress 、BuddyPress、WooCommerce 等。
至 2019 年 [WordPress 翻译平台（wpfanyi.com）](https://wpfanyi.com/)平台上线后，开始实现大批量的 WordPress 主题、插件翻译的语言包更新下载，再到现在的 [translate.wenpai.org](https://translate.wenpai.org/) 文派翻译平台。
而文派翻译平台的前身是 LitePress 社区中文翻译系统，现在您可以完全免费且快速高效的获得需要使用的部分中文语言包。
虽然依旧少不了人工校对的工作，但已经极大程度上实现了自动化 AI 翻译，质量可以达到 85~90% 的准确度。欢迎更多人参与到文派开源社区建设和翻译更新中，这将会加速 WordPress 软件国产化进程。
---
# 如何安装和更新、卸载插件？
由于WordPress官方插件目录在 2020 年清退了全部用于解决 429 等问题的代理和切换更新源的插件，所以您无法通过后台插件目录搜索安装。
### 一、手动安装：
1、通过本站或者网络下载到 文派叶子 🍃（WPCY.COM）最新版本；
> 下载地址 [https://wpcy.com/download](https://wpcy.com/download)
2、进入WordPress网站后台找到【插件】=【安装新插件】=【上传插件】，之后选择以下载的插件点击【立即安装】即可。
3、安装完毕后，您可以通过访问插件设置页面进行个性化调整。
至此保存设置后，安装完毕。
### 二、更新插件；
当有新版本的插件时，您将会在后台接收到更新，此时只需要进行常规的更新操作即可。
稳定版与测试版
目前 文派叶子 🍃（WPCY.COM）提供稳定版和测试版功能，如果您是运营站点，那么推荐使用从本站直接下载得到的稳定版。
对于想要尝试新功能，并且有时间参与测试的用户可以加入官方 [QQ 群 1046115671](https://jq.qq.com/?_wv=1027&k=AizcubYC) 查看群文件即可获取到最新的测试版插件。
### 三、卸载插件；
如果您确信是由于此插件不兼容、导致您网站出现异常，可以在后台【插件列表】停用，或者直接删除卸载即可。
已经无法进入网站后台，可以通过FTP或者Web面板访问以下目录
> 网站目录/wp-content/plugins/wp-china-yes
执行手动删除或移动至其他文件夹即可。
卸载后如需重新安装，建议下载最新稳定版，如需帮助请入群。
---
# 网站后台错乱，停用插件就正常？
这可能是由于旧版本 WP-China-Yes 加速域名或服务中断导致。WordPress 网站后台错乱，停用掉此插件后就可以恢复正常，请通过以下排查方式如下：
### 1、旧版更新
如果您在网站后台使用的是旧版本 WP-China-Yes 插件，那么请在官网下载最新 WPCY.COM 版本手动上传更新后即可恢复正常。
原因：此问题是旧版内置服务的加速域名淘汰后，备案信息掉落，无法再进行国内加速服务，请使用最新版本文派叶子 🍃插件，功能设置更简约且实用。
由于上述不可抗力情况，内置服务的终端服务均已停止运行，并且我们已计划逐步淘汰部分加速域名。
> 不建议使用 3.6.5 之前的任何旧版本
详情公告可见[《WP-China-Yes 业务域名和中继域名切换通知》](https://wpcy.com/news/domain-name-switching)
### 2、停用后台加速
前往后台设置【 WPCY.COM 】=【加速设置】=【萌芽加速】，停用【后台加速】取消勾选保存后刷新页面即可。
偶尔可能会因为服务器宕机或者未知因素，这种情况可以选择性的去掉加速位置，待服务恢复后再勾选即可。
### 3、海外环境
如果你是在外网海外环境使用的文派叶子 🍃（WPCY.COM）那么这种情况需要自行排查，一般都是由于CDN服务商没有提供海外节点导致的加载速度过慢。也可以停用科学上网工具 VPN 等看看是否正常。
> 未来我们可能会专门提供一款 WordPress 外贸加速插件。
敬请关注。
---
# 文派叶子只能用于 WP 和 Woo 网站吗？
现阶段此功能仅支持 WordPress 程序和 WooCommerce 商店加速。
我们深知还有很多开源项目和软件都需要一个类似文派叶子 🍃的功能，但由于精力和资源有限，开发团队仅对WordPress进行了适配。
如果您是其他开源项目的爱好者，并且对开放网络（Open Web）感兴趣，希望可以对接文派叶子的各项内置服务功能，
比如下面列出或未列出的开源程序，内置文派开源相关开放服务 API 本质上均可集成使用。
- WordPress
- Joomla
- Drupal
- Magento
- TYPO3
- OpenCart
- PrestaShop
- Moodle
欢迎与联系洽谈。
---
# 新版本与旧版有什么区别？
二者皆为同一款插件。
新版本“文派叶子 🍃 WPCY.COM ”与“WP-China-Yes ”旧版最大的区别在于运营主体和服务商。
> 简言之这是 WordPress 网站加速器插件，绿色、开源且免费。
注意：如果您使用的是 3.6.5 版本之前的“WP-China-Yes ”请手动更新至最新版 WPCY.COM 版本，这样可以后续通过后台直接获取到更新推送。
以下是此项目的发展背景。
### 项目背景
WordPress是一款全球广受欢迎的网站建设平台，然而在中国市场中，它面临着一些特殊的问题。这些问题包括Gravatar无法访问、Google字体无法使用、API访问太慢等等。
这些问题使得中国用户在使用WordPress时感受到困难和不便，而这些问题背后也反映了中国互联网市场和语言文化的特殊性。
### 发展历史
2020年，在这个背景下，WP-China-Yes 应运而生，这款WordPress插件专门针对中国市场中的特殊问题进行优化，最初是因为WordPress官网出现 429 问题导致中国用户使用异常，随后逐渐发展成为一个WordPress中国发行版项目，并被广泛使用。
### 收购重启
经过几年的发展，项目遇到了瓶颈期和大多开源社区都会有的问题，为了能够可持续发展，在与创始团队协商后，现在，[此插件已被文派公司收购 ↗](https://wpcy.com/news/acquisition-announcement)，更名为**“文派叶子 🍃”，寓意生生不息**，旨在为中国用户提供更好的WordPress使用体验。
同时也附带的 LitePress 开源社区项目一并成为[文派开源（WenPai.org）↗](https://wenpai.org/)的子项目。
---
# 文派叶子 🍃（WPCY.COM）是免费的吗？
**文派叶子 🍃（WPCY®.COM）以前叫 **WP-China-Yes****，是一款免费的文派（WordPress）生态服务接入插件，做为文派开源项目的官方服务连接器存在。
文派（广州）科技有限公司承诺：
> 此插件永久免费，不限制商业用途，采用 GPL 协议开源。
若此插件功能不符合您的实际要求，也可以自行修改和分叉二次开发，源代码 100% 可读，无任何加密限制。
> **唯一要求**：在严格遵守 GPL 协议的前提下，尊重文派科技的各项合法权益，包括（不限于）版权、商标、专利、知识产权、商誉等…
---
# 导出/导入备份设置选项
**导出设置：**点击”导出”按钮将当前所有插件配置保存为JSON文件，文件会自动下载到您的电脑。
**导入设置：**选择之前导出的JSON备份文件，点击”导入”按钮恢复所有设置。
**注意事项：**
- 导出文件包含所有选项卡的设置内容，支持跨站点配置迁移
- 导入操作会覆盖当前所有配置，请谨慎操作
- 建议在重要配置更改前先导出备份
- 不同版本的插件备份文件可能不完全兼容
- 导入前请确认备份文件的来源和完整性
- 重要操作建议在测试环境先行验证
---
# 自选新闻源推送小工具
如果希望为自己的客户站点推送新的文章通知，可开启此选项。
> 目前此功能仍在开发阶段
后续将支持【文派茶馆】新闻小工具自定义名称和替换为您自己的 RSS 新闻源推送。
注意事项：此新闻源站点应当保障可用性达 99.9% 否则可能会因为源站异常影响客户端站点速度。
为避免此情况发生，当监测到您的新闻源加载异常，也将默认显示为文派茶馆 WPTEA.com 新闻。
1、内容条数默认为 5 条，分配规则为：默认显示 2 条文派茶馆的官方新闻信息，其余 3 条显示为您的自定义源。
2、根据更新频率进行新闻推送，您的新闻源长期不更新也将会默认显示为文派茶馆 WPTEA.com 新闻源，以便填补小工具数据栏位。
> 如需隐藏新闻小工具，请点击页面右上角的【显示选项】
其他设置请到文派叶子插件的【新闻推送】标签进行设置。
---
# 隐藏插件设置页面
如果您不希望让客户知道本站启用了文派叶子🍃（WP-China-Yes）插件及服务，可开启此选项。
开启后如果忘记地址，那么请复制下面的理解到浏览器，并修改域名进行访问。
```
https://您的网址/wp-admin/options-general.php?page=wp-china-yes
```
**自定义品牌名称**：这一功能为企业和代理商提供了更大的自主性。用户可以根据自身需求，将 WP-China-Yes 插件重新命名为自己的品牌名称。这不仅提高了品牌的一致性，也增强了用户体验。
**隐藏设置菜单**：为了让插件更加隐形，用户可以选择隐藏 WP-China-Yes 的设置菜单。这样，客户在使用网站时不会察觉到该插件的存在，从而保持了后台的整洁与专业性。
#### 使用场景
- **企业用户**：通过自定义品牌名称，企业可以将 WP-China-Yes 完全集成到自己的网站管理体系中，统一品牌形象，提升专业度。
- **建站代理商**：代理商可以为不同的客户提供量身定制的插件版本，增强客户满意度和品牌忠诚度。
WP-China-Yes 新版本的自定义品牌名称功能，为用户提供了更大的灵活性和控制权。无论是企业还是代理商，都能从中受益，使其 WordPress 网站更加个性化和专业化。
---
# 加速
# WordPress 前台加速
由于部分用户服务器本身资源限制，导致系统加载速度过慢，极大程度上影响了用户使用体验，为此我们专门部署了 adminCDN 官方 WordPress静态文件资源库来进行加速。
服务域名
> https://您的网址/
加速域名
> https://public.admincdn.com/https://您的网址
此为 WordPress 静态文件资源库在中国的加速源，您可以在文派叶子 🍃（WP-China-Yes）中的【萌芽加速】选项中，勾选【前台加速】设置保存后即完成加速配置。
或者将您的资源地址直接替换为如上加速域名。
---
# WordPress 后台加速
由于部分用户服务器本身资源限制，导致系统加载速度过慢，极大程度上影响了用户使用体验，为此我们专门部署了 adminCDN 官方 WordPress静态文件资源库来进行加速。
服务域名
> 您的网址/wp-admin
加速域名
> wpstatic.admincdn.com
此为 WordPress 静态文件资源库在中国的加速源，您可以在文派叶子 🍃（WP-China-Yes）中的【萌芽加速】选项中，勾选【后台加速】设置保存后即完成加速配置。
或者将您的资源地址直接替换为如上加速域名。
---
# WordPress 应用市场加速
由于众所周知的问题，WordPress 后台经常会遇到的很多未知问题，这其中有80%以上是由于API查询超时引起的。
为了解决此问题，文派科技 2024 年在中国内地采购了三十多台服务器，组件了自有的WordPress代码及托管平台。
应用下载市场加速有两种新的方式：
1、官方加速源（WPMirror.com）
直接从 WordPress.org 反代至大陆分发；这是传统的方向代理+内地 CDN加速的方式，不改变任何数据内容，与官方源信息保持一致。
2、文派开源（WenPai.org）
中国境内自建托管仓库，同时集成文派翻译平台；这是完全自建的新平台，速度和功能上针对国内用户做了特别优化，速度上相比官方源及反代加速更稳定。
3、不启用加速
如果您的服务器在海外，那么请勿启用此选项，开启后反而可能会影响到您的网站应用更新速度。
如果只是需要获取到文派翻译平台中的最新中文语言包，可以临时切换后获取到语言包更新通知，之后再关闭选项即可。
---
# jsDelivr 前端公共库加速
由于 jsDelivr 前端资源库服务在中国无法正常访问，而 WordPress 系统大部分主题插件都集成了此服务，极大程度上影响了中国用户的使用体验，为此我们专门部署了 adminCDN 官方镜像源来为此服务进行加速。
服务域名
> jsd.admincdn.com
加速域名
> jsd.admincdn.com
此为 jsDelivr 前端资源库在中国的加速镜像站，您可以在文派叶子 🍃（WP-China-Yes）中的【萌芽加速】选项中，勾选【jsDelivr 公共库】设置保存后即完成加速配置。
或者将您的资源地址直接替换为如上加速域名。
---
# CDNJS 前端公共库加速
由于 CDNJS 前端资源库服务在中国无法正常访问，而 WordPress 系统大部分主题插件都集成了此服务，极大程度上影响了中国用户的使用体验，为此我们专门部署了 adminCDN 官方镜像源来为此服务进行加速。
服务域名
> cdnjs.cloudflare.com
加速域名
> cdnjs.admincdn.com
此为 CDNJS 前端资源库在中国的加速镜像站，您可以在文派叶子 🍃（WP-China-Yes）中的【萌芽加速】选项中，勾选【CDNJS 前端公共库】设置保存后即完成加速配置。
或者将您的资源地址直接替换为如上加速域名。
---
# Google 前端公共库加速
由于 Google 前端公共库加速服务在中国无法正常访问，而 WordPress 大部分主题插件集成了此服务，极大程度上影响了中国用户的使用体验，为此我们专门部署了 adminCDN 官方镜像源来为此服务进行加速。
服务域名
> ajax.googleapi.com
加速域名
> googleajax.admincdn.com
此为Google 前端公共库在中国的加速镜像站，您可以在文派叶子 🍃（WP-China-Yes）中的【萌芽加速】选项中，勾选【Google前端公共库】设置保存后即完成加速配置。
或者将您的资源地址直接替换为如上加速域名。
---
# Google Fonts 字体加速
由于 Google fonts 服务在中国无法正常访问，而WordPress系统本身以及大部分主题插件都集成了此服务，极大程度上影响了中国用户的使用体验，为此我们专门部署了 adminCDN 官方镜像源来为此服务进行加速。
服务域名
> fonts.googleapi.com
加速域名
> googlefonts.admincdn.com
此为 Google fonts 在中国的字体加速镜像站，您可以在文派叶子 🍃（WP-China-Yes）中的【萌芽加速】选项中，勾选【Google字体】设置保存后即完成加速配置。
或者将您的资源地址直接替换为如上加速域名。
---
# Gravatar 头像加速
由于 Gravatar 头像服务在中国无法正常访问，而 WordPress 系统本身和大部分主题插件都已经默认集成了此服务，这极大程度上影响了中国用户的使用体验，为此我们专门开发了初认头像（Cravatar）服务中国本土化的头像托管服务来进行加速和替代。
[初认头像（Cravatar）](https://cravatar.com/)Gravatar 在中国的完美替代方案，您可以在 Cravatar.com 上传头像，更多选项请安装 WPAavatar 插件。
（任何开发者均可在自己的产品中集成该服务，不局限于 WordPress）
服务域名
> cn.gravatar.com
加速域名
> cn.cravatar.com
> cravatar.cn
同时我们提供了几个选项
- 默认线路
- 国际线路
- 备用源（WeAvatar.com）
- 不启用
其中，默认线路默认是通过 cravatar.cn 进行流量传达，国际线路是通过 cn.cravatar.com ，备用源是由耗子科技 @haozi 提供的 WeAvatar 服务。
这些服务源均开启了国内的政策合规的内容审核，可保障您网站上显示的头像图片正常使用而不用担心出现违规情况。
---
# 萌芽加速 adminCDN 的推荐设置
顾名思义，adminCDN 原本是为了解决 WordPress 后台访问慢，并且很多主题插件内置的如 Google fonts 、Ajax 文件等导致中国用户无法正常使用的异常情况而存在。
> adminCDN 现已发展为一项独立前端公共服务。
1、插件使用
正常安装文派叶子 🍃（WP-China-Yes）后，进入设置页面，可以看到如下界面，找到【萌芽加速】按需开启您的想要实现的加速选项即可。
- 后台加速：加速WordPress后台静态资源；
- 前台加速：加速WordPress前台静态资源；
- Google 字体：替换为“文派开源”提供国内加速镜像；
- Google 前端公共库：替换为“文派开源”提供国内加速镜像；
- CDNJS 前端公共库：替换为“文派开源”提供国内加速镜像；
- jsDelivr 公共库：替换为“文派开源”提供国内加速镜像；
[萌芽加速（adminCDN）](https://admincdn.com/)将 WordPress 依赖的静态文件切换为公共资源，加快网站访问速度。您可按需启用需要加速的项目，更多细节控制和功能，请关注 adminCDN 项目。
2、手动加入
如果希望在自己项目中应用，而不安装插件，那么可以访问 admincdn.com 搜索您需要的前端库资源链接，替换为萌芽加速的源地址即可。
这是由文派可以提供的自建前端库，并且服务器完全托管于中国境内的前端公共资源库加速源。
3、异常排查
当您的网站发生异常情况，如前后台界面资源加载不完整，错版等情况，请尝试关闭【后台加速】、【前台加速】选项，然后F5刷新页面重试。
在访问已开启使用萌芽加速的网站时，如果有使用特殊的科学上网工具如果 VPN 等出现异常，也可以停用或将自己站网址加入到白名单里，这样可避免出现越加速越慢的情况。
---
# 切换至 WPMirror 备用线路
WPMirror.com 即文派镜像服务，是2022年起由汉中菲比斯网络技术有限公司提供的一个长期 WordPress 中国加速的备用方案，也是国内最初由商业公司介入专门提供的免费加速服务。
这是完全反代的WordPress.org资源并且进行了个性化定制，可以无障碍使用和搜索、下载WordPress资源。
加速源主要还是做的**站点全局、头像、图片资源**的访问加速。
> **请合理使用此站点，整个 WPMirror.com 的反向代理加速 CDN 和下载带宽都是在按时长计费**，也就是通常说的，经费在燃烧，而且还是 24 小时连轴计费。
目前此项目整合至文派叶子 🍃（WPCY.COM）内部，可供用户选择是否通过官方代理渠道获取资源。
---
# 可信公共前端资源库
这里列出由文派科技提供的公共前端资源库服务。
如果您在使用WordPress的主题插件后发现很慢，那么有可能是因为这些软件本身使用了外部的资源库，而这些资源库又因为网络环境原因无法再中国正常使用。
比如 cdnjs.cloudflare.com 、 googleajax.com 、googlefonts.com 、cdn.jsdelivr.com 等等均已被墙。
以下是在中国的前端公共资源库加速源，您也可以在其他的前端和开源项目中进行使用，但我们建议是优先应用于WordPress。
### 主加速源
- [googlefonts.admincdn.com ↗](http://googlefonts.admincdn.com/)
- [googleajax.admincdn.com ↗](https://googleajax.admincdn.com/)
- [cdnjs.admincdn.com ↗](https://cdnjs.admincdn.com/)
- [gstatic.admincdn.com ↗](https://gstatic.admincdn.com/)
- [jsd.admincdn.com ↗](https://jsd.admincdn.com/)
- [wpstatic.admincdn.com ↗](https://wpstatic.admincdn.com/)
已备案，由文派开源官方维护的前端资源库加速源站。
### 备加速源
已备案，由菲比斯公司维护的前端资源库加速源站。
### 第三方加速源
cdn.bytedance.com ↗ 资源库较老，自选使用。 已下线不可使用。
已备案，由字节跳动维护的前端资源库加速源站。
由于最近一两年发生的供应链攻击事件，在此处我们只做已认证且无不良记录的服务商推荐，如果您能提供稳定的服务器及带宽资源，可加入自定义源。
---
# 广告拦截
# 智能广告拦截
这是一个待开发功能，目前暂未发布，我们将会在未来的版本中完善想法和用户需求，以便提供最合适的智能拦截方式。
当前可用方式为手动拦截模式。
---
# 手动广告拦截模式
文派叶子🍃（WP-China-Yes）独家特色功能，让您拥有清爽整洁的 WordPress 后台，清除各类常用插件侵入式后台广告、通知及无用信息。
如果你已经厌倦了 WordPress 后台一大堆的垃圾无用的促销广告和烦人的反复通知信息？那么这就是解决方案。
```
广告拦截可还您一个清爽快速的 WordPress 后台。
```
1、插件使用
正常安装[文派叶子 🍃（WP-China-Yes）](https://wpcy.com/download)后，进入设置页面，可以看到如下界面，找到【广告拦截】开启后将会加载默认的广告屏蔽规则。
这里的默认规则可以屏蔽掉大部分 WordPress 热门主题、插件的广告信息，只需要保存即可。注意：此项仅包含免费主题插件的广告屏蔽功能。
默认规则说明
- 规则名称：自定义规则名称，方便识别
- 应用元素：设置规则应用的广告元素（CSS 选择器）
- 启用规则：支持添加多条广告屏蔽规则
默认屏蔽规则跟随插件更新，插件更新后可删除规则重新添加以获取最新屏蔽规则。
我们以 WordPress 最流行的 Yoast SEO 插件为例：
> 以下为去除广告后的实际效果，界面非常的干净舒适。
注意：此去广告功能，仅为免费版插件的界面修饰，**并不会解锁其本身缺失、限制以及隐藏功能**。如果遇到某些元素、内容无法正常显示和点击的情况，请查看[《启用广告拦截后故障排查》](https://wpcy.com/document/troubleshooting-ad-blocking)
2、自定义规则
如果默认的规则不能满足实际情况，那么也可以新建规则，这需要稍微懂一些CSS知识，也可以用 Firefox、Google 浏览器等工具的 F12 开发工具进行查看。
添加完成后保存刷新页面广告信息就会消失。
### 添加拦截目标
提交需要拦截的广告插件，审核通过后我们将会更新屏蔽规则。
> [wp-china-yes.com/add ↗](https://wpcy.com/add)
### 提交新规则
如果您已经编写了自定义广告拦截规则，可加入自定义源。
---
# 拦截规则
此默认规则将会不定期更新，如果你发现有部分插件更新后广告拦截规则失效，那么可能的原因在于开发者更新了对应的广告、通知css标签。
> 请通过本站公开的方式联系我们进行处理。
### 拦截规则源
提交需要拦截的广告插件，审核通过后我们将会更新屏蔽规则。
```
.wpseo_content_wrapper #sidebar-container, .yoast_premium_upsell, #wpseo-local-seo-upsell, .yoast-settings-section-upsell, #rank_math_review_plugin_notice, #bwp-get-social, .bwp-button-paypal, #bwp-sidebar-right, .tjcc-custom-css #postbox-container-1, .settings_page_wpcustomtaxfilterinadmin #postbox-container-1, #duplicate-post-notice #newsletter-subscribe-form, div[id^="dnh-wrm"], .notice-info.dst-notice, #googleanalytics_terms_notice, .fw-brz-dismiss, div.elementor-message[data-notice_id="elementor_dev_promote"], .notice-success.wpcf7r-notice, .dc-text__block.disable__comment__alert, #ws_sidebar_pro_ad, .pa-new-feature-notice, #redux-connect-message, .frash-notice-email, .frash-notice-rate, #smush-box-pro-features, #wp-smush-bulk-smush-upsell-row, #easy-updates-manager-dashnotice, #metaslider-optin-notice, #extendifysdk_announcement, .ml-discount-ad, .mo-admin-notice, .post-smtp-donation, div[data-dismissible="notice-owa-sale-forever"], .neve-notice-upsell, #pagelayer_promo, #simple-custom-post-order-epsilon-review-notice, .sfsi_new_prmium_follw, div.fs-slug-the-events-calendar[data-id="connect_account"], .tribe-notice-event-tickets-install, div.notice[data-notice="webp-converter-for-media"], .webpLoader__popup.webpPopup, .put-dismiss-notice, .wp-mail-smtp-review-notice, #wp-mail-smtp-pro-banner, body div.promotion.fs-notice, .analytify-review-thumbnail, .analytify-review-notice, .jitm-banner.is-upgrade-premium, div[data-name*="wbcr_factory_notice_adverts"], .sui-subscription-notice, #sui-cross-sell-footer, .sui-cross-sell-modules, .forminator-rating-notice, .sui-dashboard-upsell-upsell, .anwp-post-grid__rate, .cff-settings-cta, .cff-header-upgrade-notice, .cff_notice.cff_review_notice_step_1, .cff_get_pro_highlight, .aal-install-elementor, #ws_sidebar_pro_ad, .bold-timeline-lite-feedback-notice-wrapper, #elementskit-lite-go-pro-noti2ce, #elementskit-lite-_plugin_rating_msg_used_in_day, .yarpp-review-notice, #prli_review_notice, #webdados_invoicexpress_nag, #vc_license-activation-notice, .villatheme-dashboard.updated, #njt-FileBird-review, .notice[data-dismissible="pro_release_notice"], #thwvsf_review_request_notice, .wpdeveloper-review-notice, div[data-notice_type="tinvwl-user-review"], div[data-notice_type="tinvwl-user-premium"], #sg-backup-review-wrapper, .notice-wpmet-jhanda-getgenie-cross-promo, .notice-getgenie-go-pro-noti2ce, .notice-wpmet-jhanda-Summer2023, .thwcfd-review-wrapper, .woo-permalink-manager-banner, div.notice.bundle-notice, div.notice[data-dismissible="notice-owa-upgrade-forever"], .wpsm-acc-r-review-notice, .wpsm_ac_h_i, .edac-review-notice, .notice-iworks-rate, #monterinsights-admin-menu-tooltip, .monsterinsights-floating-bar, #monterinsights-admin-menu-tooltip, .exactmetrics-floating-bar, #metform-unsupported-metform-pro-version, .lwptocRate, .wpsm-tabs-b-review-notice, .quadlayers_woocommerce-direct-checkout_notice_delay, .iworks-rate-notice, #metform-_plugin_rating_msg_used_in_day, [id^="wpmet-jhanda-"], #wpmet-stories, #ti-optml-notice-helper, .menu-icon-dashboard-notice, .catch-bells-admin-notice, .wpdt-bundles-notice, .td-admin-web-services, .cf-plugin-popup, .wpzinc-review-media-library-organizer, .oxi-image-notice
```
### 提交新规则
申请添加 ↗
如果您已经编写了自定义广告拦截规则，可加入自定义源。
---
# 飞行模式的 URL 屏蔽规则
此飞行模式的默认规则将会不定期更新，此功能对于追求极致速度体验的WordPress用户很有效，我们已在多个站点测试运行半年以上，无任何风险故障产生。
如果你发现有部分插件更新后 UR L屏蔽规则失效，那么可能的原因在于开发者更新了对应更新、发送、收集信息的域名导致。
> 请通过本站公开的方式联系我们进行处理。
### URL 屏蔽规则源
提交需要屏蔽的URL链接，审核通过后我们将会更新屏蔽规则。
```
public-api.wordpress.com/wpcom/v2/wcpay/incentives
woocommerce.com/wp-json
my.yoast.com
api.ipify.org
tnedi.me
packages.translationspress.com
```
### 提交新规则
申请添加 ↗
如果您已经编写了自定义URL拦截规则，可加入自定义源。
---
# 商业产品广告规则
在全球 WordPress 生态中，不完全统计大概有 5 万款商业产品，所以要能实现全部产品都屏蔽掉广告是不可能的事情。
实际上不管是免费的还是付费产品，只需要处理销量最好的前100~1000款产品就完全可以满足大部分用途。
> 如何清除 themeforest、codecanyon 等付费产品的广告？
对于 WordPress 商业产品的屏蔽规则无法免费提供。但并不限制您自行编写规则分享。
每一款 WordPress 高级主题、插件产品都需要有专人进行针对性的编写 CSS 和广告拦截规则。而且每款高级产品的结构都非常复杂，热门产品更新维护更加频繁。
文派叶子🍃会主要提供 WordPress.org 公共目录产品的广告规则屏蔽。未来我们可能会提供一个专门的高级产品广告屏蔽规则市场供下载。
---
# 提交和查找新广告屏蔽规则
请注意，任何人都可以编写自己的 WordPress 广告屏蔽规则，无需特别专业的技能，只需要一点点php和css基础知识。
### 如何提交？
对于有专业前端开发经验的人就更是如鱼得水，如果你愿意分享自己的规则，可以在本站提交，或者对应的产品信息下留言粘贴。
找到每篇规则下方底部【点击提交规则，分享您的代码。】
展开后可以看到评论框，在此输入您的规则或者更新即可。最好是提交做为补充的代码，除非是有大版本改进，不用发布完全内容。
内容审核后会自动显示到页面底部。您的头像也会在此规则下方的贡献者列表中展示。
### 如何查找？
目前已知的站点仅文派叶子 🍃（WP-China-Yes）有提供广告屏蔽规则，在本站可以输入对应的主题、插件名称来进行规则搜索，完全免费。
---
# 启用广告拦截后故障排查
开启了广告屏蔽规则后发现对应插件的很多功能和按钮点不动？
> 发生这种情况不用想，肯定被净化的插件本身就有功能限制。
通常情况下，如果发生了版式错乱、原始免费功能缺失、输入框点不动等，极有可能是因为广告规则编写的不正确导致。但首先您需要确认停用广告规则后可以正常使用。
如果有这种情况出现，请到对应的产品信息列表里提交新规则请求，我们将会更新对应的广告规则。另一种小概率事件，可能是由于新版本升级后原始产品的开发者修改幅度过大导致旧规则失效，具体情况需要具体判断。
---
# 广告屏蔽对于开发者会有影响吗？
放眼全球 WordPress 市场，如果是中国用户那么这些促销广告横幅通知除了是打扰外没有任何意义，所以屏蔽后才是最原本的功能形态。
> 文派叶子 🍃（WP-China-Yes）并不会主动屏蔽任何中国开发者的应用内广告，如果您有担忧，欢迎分叉此插件。
### 回归存粹
开发此功能的目的在于净化 WordPress 程序本身，确实免费插件有很多是通过广告引流、促销通知和高级版本来实现盈利以及长期维护。
但实际情况是很多 WordPress 开发者滥用了所谓的通知方式和促销手段，这极大程度上阻碍了用户使用及体验。
把普通用户的 WordPress 后台变成了促销广告垃圾场，花花绿绿的没有任何美感可言，另外，不能用的功能为什么要显示出来？
> 如果真想要获得更多销售，为什么不好好完善产品本身。
### 用户自选
如果将文派开源（WenPai.org）项目看做是WordPress开源程序的一个分支，那么每个被屏蔽掉无用信息的主题、插件也可以理解为一个新的分支。
这是完全符合 GPL 协议的方式。并且选择权完全交给用户，可以自行决定是否启用。
最好的证明来自于浏览器中最流行的 Adblock 工具，仔细想想，如果不是因为有那么多令人厌烦的广告信息，又怎么会有这些工具？
---
# 中文字体
# 如何使用中文字体 Windfonts ？
文风字体（Windfonts）是文派开源的 WordPress 中国生态基础项目之一，目前已在文派叶子 🍃（WP-China-Yes）中集成，可以直接使用。
一、安装插件
通过本站或者网络下载到 [文派叶子 🍃（WP-China-Yes）](https://wpcy.com/download)最新版本；启用后可以看到文风字体设置选项。
[文风字体（Windfonts）](https://windfonts.com/)为您的网站增添无限活力。专为中文网页设计，旨在提升用户阅读体验和视觉享受
开启文风字体定制选项后，可以选择使用范围和实现效果。
- 全局启用
- 前台启用
- 本机字体
- 不启用
【全局启用】就是在前后台均可显示文风字体，如果使用的是个性字体那么建议是采用【前台启用】就可以满足大部分使用场景。
【本机字体】是使用的统一中文字体 fonts.css 文件实现，无需加载外部的字体文件，而是完全调用用户电脑中的字体。
二、获取字体
不同的字体文件需要通过 [Windfonts 在线字体平台 ↗](https://app.windfonts.com/)获取。
进入到文风字体平台后，选择需要的字体效果，然后点击【获取嵌入代码】，找到对应的免费字体嵌入代码：
- 字体家族名称：填入从文风字体获取的字体家族名称
- 字体链接：填入从文风字体获取的字体 CSS 链接
- 字体字重：设置字体权重大小（字体粗细）
- 字体样式：设置字体样式（正常、斜体、倾斜）
- 字体应用：设置字体应用的元素（CSS 选择器）
- 启用字体：是否启用该字体
三、设置字体 CSS
这里我们以Google版的思源黑体为例，将代码放入你的 <head> 标签内即可使用。
完整代码如下：
```
```
- 字体家族名称：wenfeng-syhtcjk
- 字体链接：[https://cn.windfonts.com/wenfeng/fonts/syhtcjk/regular/web/index.css](https://cn.windfonts.com/wenfeng/fonts/syhtcjk/regular/web/index.css)
- 字体字重：保持默认
- 字体样式：保持默认
- 字体应用：自行填入，常用的标题标签为 h1,h2,h3,h4,h5,h6
- 启用字体：默认启用
当使用文派叶子插件时，只需要复制字体链接即可如：
```
https://cn.windfonts.com/wenfeng/fonts/syhtcjk/regular/web/index.css
```
插件内已经添加了字体授权标注，无需重复添加。
保存刷新前台页面后，就可以看到字体的应用效果。此为文风字体 Windfonts 的自建中文网络字体源站，您可以免费使用。
---
# 免费可商用字体仓库
WordPress 6.5 版本开始加入了一个新的字体库功能，默认已经集成了Google fonts 并且支持下载至自己的网站来使用，并且也支持手动上传字体。
上传的字体会出现在您的资料库中，并可在主题中使用。支持的格式：.ttf 、.otf 、.woff 和 .woff2。
### 字体区别
因为此功能和英文字体（26个字母加标点符号，小而简单）的特性，并不是时候中文字体（常用字库3500多个，大且全面），每一个中文字体文件大概在4~50MB不等，所以要直接上传到网站使用并不现实。
这里就需要用到文风字体的字体切片技术：将一个大的中文字体库文件切割为多个小文件，然后通过CSS来加载，这样可以按需请求和获取到字体文件包，实现快速、轻便的特性，完全不影响到网站的加载速度。
对应的一些免费可商用字体及免费开源字体（Open Fonts）资源站点可以参考以下链接。
### 文风字体
文风字体整理的了大部分的免费可商用及网页引用的中文字体库您可以按需启用。
- 免费可商用中文字体站[ windfonts.com ↗](https://windfonts.com)
- 开源可商用中文字体站 [wenfeng.org ↗](https://wenfeng.org/)
### 方块字库
方块字库 FontSquare 是一个整理的可商用及免费下载的英文字体库，您可以下载到对应的字体文件并转换为 Web 字体格式，上传到网站使用。
> 免费可商用英文字体站 [fontsquare.com ↗](https://fontsquare.com/)
另请注意，方块字库绝大部分英文字体采用 OFL 开源协议授权，您可以根据实际情况使用。
---
# 提交新的中文字体
如果您确认字体的授权没有问题，Windfonts.com 乐意收录该中文字体提供服务，请通过支持论坛或联系我们发送相关的文件下载及授权信息地址。
审核无误后将会上传至字库系统进行切片处理。
### 特别注意：
> 所有的思源字体及衍生版字体均为开源授权。
也就是说，如果您发现自己想要用的字体本身就是思源字体的分支变体，那么请直接联系我们添加，无任何问题。
---
# 添加自定义 HTML 标签
文风字体默认规则设置里添加了部分 HTML 标签来实现网页中文字体的显示效果，如果不能满足您实际的要求，可以自行进行调整。
示例如下：
标题应用：
```
h1,h2,h3,h4,h5,h6
```
全局应用：
```
a,p,h1,h2,h3,h4,h5,h6,ul,ol,li,button,blockquote,pre,code,table,th,td,div:not([class*="star"]),label,b,i:not([class]),em,small,strong,sub,sup,ins,del,mark,abbr,dfn,span:not([class*="icon"])
```
全局应用（不含标题）：
```
a,p,ul,ol,li,button,blockquote,pre,code,table,th,td,div:not([class="star"]),label,b,i:not([class]),em,small,strong,sub,sup,ins,del,mark,abbr,dfn,span:not([class="icon"])
```
问题排查
如果出现使用文风字体后，不能正常显示内容，可以参考以下方式：
---
# 缺字、少字、显示不全，没有简、繁字？
首先需要明白每个字体库的文件大小都是不一样，这也就意味着包含的数据信息不会一样，很多中文字体库都只是制作了常用的2500字，这其中很多还是简体和繁体的区别，也就是习惯繁体的字体设计师不会专门做简体字版本，反之亦然。
比如文风字体的“风”与“風”的简繁区别，很多字体库都显示不出来，那么这种情况下就需要自行取舍，或者使用别的字体。
### 特别注意：
> 所有的思源字体及衍生版字体均为开源授权。
也就是说，如果您发现自己想要用的字体本身缺少某些字，而且有一定的动手能力，可以尝试自行补全需要的字体，这些工具我们将会在 Wenfeng.org 文风开源字体平台提供。
---
# 如何避免字体侵权投诉?
使用 Windfonts 在线字体服务，如果担心会有侵权风险，请务必仔细阅读以下内容。
1、保留版权标注，也就是下面这段文字；
> <!– 此中文网页字体由文风字体（Windfonts）免费提供，您可以自由引用，请务必保留此授权许可标注 https://wenfeng.org/license –>
您在网站源代码中保留了此注释信息，那么可以放心使用文风字体，有任何问题均由文派（广州）科技有限公司提供法律主体支持。
2、网站关于页面或者页脚链接直接标注；
对于想要明示网站使用的 Webfonts 为【文风字体】服务，请在网站页脚添加一条链接至 Windfonts.com 的链接，如下：
```
文风字体
```
使用的是下载后的 Web fonts 字体切片也可使用：
```
文风字体
```
或者在您的关于页面写明是使用了文风字体服务，贴上对应链接即可。
3、更多说明可以按需要自行进行授权标注，这么做的目的仅一个：让所有人可以正常使用中文网页字体而无需担忧。
字体授权查询： [https://wenfeng.org/license ](https://wenfeng.org/license)
> 您合规使用，我们省心服务。
如果您是使用的 WordPress 程序，并且已经安装了 [文派叶子 🍃（WP-China-Yes）](https://wpcy.com/download)那么启用文风字体后，会自动标注此授权信息，无需再次填入。
---