创建块主题

描述

此插件允许您:

  • 创建空白主题
  • 基于当前活动主题创建新主题
  • 创建活动父主题的子主题
  • 创建新的样式变体
  • 导出主题
  • 将用户更改的模板和样式保存到活动主题

所有新创建的主题或样式变体都将包括WordPress编辑器中所做的更改。

此插件还对主题的内容进行了一些更改,包括:

  • 将模板中使用的所有图像添加到主题的资产文件夹。
  • 确保模板和模式中使用的块标记可以导出。
  • 确保模板和模式中使用的大多数字符串都是可翻译的。

该插件仅用于开发,不用于制作网站,而是用作创建新主题的工具。

步骤1–设置

安装并激活创建块主题插件。

在WordPress编辑器中会有一个新的面板,你可以点击编辑器顶部“保存”按钮右侧的新图标来打开。

步骤2–样式自定义

使用编辑器更改网站样式、字体和模板。

步骤3–导出

仍然在WordPress编辑器中,导航到编辑器顶部的创建块主题菜单。

要将编辑器中最近所做的更改保存到当前活动主题,请执行以下操作:

  • 选择“保存更改”以保存对当前活动主题的任何最近更改。

要安装和卸载字体:

  • 使用WordPress字体库从任何来源安装并激活字体。
  • 选择“保存对主题的更改”,然后选择“保存字体”将所有活动字体保存到当前活动主题。然后,这些字体将在主题中激活,并在系统中停用(并且可以从系统中安全删除)。
  • 在主题中安装的任何字体,如果已被WordPress字体库停用,则将从主题中删除。

或导出主题:

  • 选择“Export Zip”将主题导出为Zip文件。

要编辑主题元数据,请执行以下操作:

  • 选择“编辑主题元数据”编辑主题的元数据。这些细节将在style.css文件中使用。

要检查活动主题的theme.json内容,请执行以下操作:

  • 选择“检查主题JSON”

创建新的空白主题:

  • 选择“创建空白主题”
  • 提供新主题的名称(以及可选的附加元数据)
  • 单击“创建空白主题”

要创建变体,请执行以下操作:

  • 选择“创建主题变体”
  • 提供新变体的名称
  • 单击“创建主题变体”

要创建当前主题的新克隆或为当前活动主题创建子主题:ons:

  • 单击“创建主题”
  • 单击“克隆主题”,根据活动主题创建一个新主题和您的更改
  • 单击“创建子主题”以创建一个新的子主题,将活动主题作为您所做更改的父主题

这些选项中的许多选项也可以在旧的、不推荐使用的“创建块主题”页面的“外观”>“创建块主题”下使用。

通用Troobleshooting

如果您有问题,请尝试以下操作:

  • 确保你安装了WordPress的最新版本。
  • 确保您安装了最新版本的插件。
  • 停用所有插件,看看这是否解决了问题。如果这有效,请逐个重新激活插件,直到找到有问题的插件。
  • 将主题切换为默认主题以排除任何与主题相关的问题。
  • 检查支持论坛针对类似问题。

导出主题时,我收到一个损坏的zip文件

  • 首先按照上述一般故障排除步骤进行操作。
  • 请确保您WP_DEBUG公司设置在您的wp-config.php文件设置为这样地:define('WP_DEBUG',false);.
  • 如果主题包含PHP文件,请确保这些文件包含使用PHP结束标记?>在文件末尾。如果有,请将其移除。

屏幕截图

  • WordPress编辑器中的“创建块主题”面板
  • WordPress编辑器中的创建块主题保存面板
  • WordPress编辑器中的主题元数据编辑面板
  • WordPress编辑器中的theme.json检查器
  • 在WordPress编辑器中创建主题面板1
  • 在WordPress编辑器中创建主题面板2
  • “外观”>“创建块主题”下的页面

常见问题解答

我如何获得支持?

如果遇到问题,应检查支持论坛第一。论坛是一个获得帮助的好地方。

如何报告问题?

如果您有要报告的错误,请将其提交给GitHub存储库作为一个问题。请在创建新错误之前进行搜索,以确认它不是重复的。

评论

2024年5月4日 1个回复
我并没有用它来定制任何东西。我只是用它来创建2024年的儿童主题。效果很好。我导出了主题,它自动下载到我的电脑上。我试图上传它来添加一个新主题,但它说它会覆盖我2024年的主题。因此,我必须解压缩并重新压缩才能重命名文件夹,这应该是导出选项的一部分(可能在未来的版本中?)。然而,在这样做之后。我只是上传了zip,我的孩子主题就在那里!
2024年2月25日
哇,两天的工作完全结束了!最后,我编辑了“主题信息”,点击“保存的更改”和“噗”,一切都消失了。
2024年2月14日
我需要改进的一件事是:当你打开TT3或TT4主题的assets/fonts文件夹时,它们提供了.woff2,但这个插件却没有这样做。因此,当你添加谷歌字体时,它只是添加了.ttf字体格式,这是一种非常古老的格式。
2024年1月12日
谢谢你。它工作得很好。令人兴奋的是,区块主题设计是低代码的。这个插件使它的代码更加低廉。
2023年6月10日 1个回复
与内置主题编辑器配合良好。遗憾的是,主题编辑器本身并没有更好。
阅读全部29条评论

贡献者和开发者

“创建区块主题”已被翻译成15个地区。谢谢翻译人员感谢他们的贡献。

将“创建区块主题”翻译成您的语言。

对开发感兴趣?

浏览代码,查看SVN存储库,或订阅开发日志通过RSS(RSS).

变更日志

2.1.4条

  • 修复模板文本本地化/转义(#641)
  • 在“Tested up to”字段(#635)中仅使用major.minor版本
  • 不要篡改元数据(#634)
  • 清理并完成变更日志(#636)
  • 为PHP全局命名空间中的名称添加前缀。(#628)
  • 改进标签UI(#630)
  • 重构Theme_Readme(Readme.txt)PHP类(#626)
  • 元数据屏幕截图(#621)
  • 在段塞中留出空间。更改逻辑以正确替换功能。更新测试。(#622)
  • 克隆和主题创建时重置更改日志和版本(#623)
  • 为wp-env使用非默认端口(#611)
  • 更新package-lock.json(#620)
  • 测试:对phpunit使用Tests-wordpress wp-env(#618)
  • 将Repository Management部分添加到贡献文档(#614)
  • 更新wp-env版本(#619)
  • 将节点版本更新为20(#617)
  • ESLint:添加新规则(#616)

2.1.3

  • 编辑器边栏:持久保存“保存更改”面板设置(#607)
  • 修复Windows上创建zip文件的问题(#606)
  • 修复自定义字体资源路径(#601)
  • 删除未使用的更新主题面板组件(#608)
  • 在zip导出之前检查ZipArchive类(#609)
  • 编辑器侧栏:使保存面板文本可翻译(#603)
  • 编辑器提要栏:改进屏幕标题UI(#605)
  • 移动文件(#598)

2.1.2

  • 记录发布过程(#594)
  • 确保代码仅在发布PR合并(#593)时部署到目录中
  • 删除字体管理(#595)

2.1.1

  • 保存主题时处理组背景图像(#586)
  • 删除了不必要的过滤器,拒绝不安全的URL(#588)
  • 固定/盖-块-内含-脱扣(#587)
  • 当没有要导出的字体时,会抛出错误(null ref)。此更改在尝试之前检查要复制到主题的字体。(#582)
  • 修复硬编码wp-admin URL(#576)
  • 代码质量:删除无终止eslint规则(#577)
  • 将屏幕截图参考移至屏幕截图部分(#580)

2.1.0条

  • 仅保存已更改的模板(#572)
  • I18n:使模态标题可翻译(#575)
  • 根据UI更改和更新的屏幕截图更新自述文件(#571)
  • 修复翻译字符串的串联(#554)
  • 在主题zip导出功能中包含激活的字体(#564)
  • 修复/取消转置模式(#567)
  • 尝试/重构编辑器UI(#563)
  • 使用编辑器特定的步骤和屏幕截图参考更新自述文件(#555)

2.0.2

  • 更新自述文件,从发布版本中删除测试文件(#548)

2.0.1

  • 添加缺少的构建步骤以部署工作流(#546)

2.0.0

  • 删除审阅者添加(#544)
  • 重构GitHub发布工作流(#542)
  • 修复更改日志创建脚本(#541)
  • 添加主题json检查器(#520)
  • 在主题导出管理屏幕中添加弃用通知(#540)
  • 将字体管理替换为指向本机字体库的屏幕(#539)
  • 将主题验证的创建添加到站点编辑器界面(#532)
  • 添加/子主题创建(#531)
  • 添加blueprint.json文件以启用插件预览(#511)
  • 从api类中提取任何可能需要测试的逻辑(#522)
  • 使用CORE进行字体管理(#518)
  • 添加集成测试(#393)
  • 从.distignore中删除CODE_OF_CONDUCT.md。(#515)
  • 删除回购特定CoC。(#514)
  • GitHub操作:添加JavaScript单元测试(#508)
  • 将发布不需要的文件和目录添加到.distignore(区分)(#512)
  • 将破折号图标替换为SVG图标(#506)
  • 修复单击重置按钮时出现的浏览器警告错误(#505)
  • 添加markdown和package.json lint命令(#504)
  • 修复字体上传页面上的反应警告错误(#502)
  • 修复动态属性弃用(#501)
  • 将文本域添加到翻译目标(#499)

1.13.8

  • 删除仅限开发的警告

1.13.7

  • docs:将最新的发行说明添加到更改日志

1.13.6

  • 修复管理字体页面

1.13.5

  • 使表单文件更特定于表单页面
  • 设置仅在CBT中设置的页面标题

1.13.4

  • 颠簸“测试高达”6.4
  • 从API更新Google Fonts JSON数据
  • 更新主题表单标记和样式
  • 修复/子导出
  • 更正格式错误的输入标记
  • 将引号添加到字体系列名称

1.13.3

  • 将“Tested up to”版本更新为6.3
  • 添加.wp-env.override.json文件.gitignore(.git忽略)
  • 将wp_add_inline_script用于createBlockTheme对象
  • 从API更新Google Fonts JSON数据
  • 更新要求PHP版本达到7.4
  • 修复因缺少页面标题而导致的PHP 8.1错误

1.13.2

  • 从API更新Google Fonts JSON数据
  • 将初始版本设置为1.0.0,而不是0.0.1
  • 修复:反应渲染警告
  • 介绍基本的wp-env环境

1.13.1

  • 为推荐插件部分添加默认值
  • 从API更新Google Fonts JSON数据

1.13.0

  • 保留新主题创作的版权信息
  • 从API更新Google Fonts JSON数据
  • 移动检查下载url更高的
  • 在字体资源路径上避免使用空格或其他奇怪的字符。
  • 将文件添加到名为主题slug的zip子文件夹
  • 从API更新Google Fonts JSON数据

1.12.1

  • 修复replace_namespace中的双重替换

1.12.0

  • 添加图像学分输入
  • 更新主题版本使用isset()的逻辑
  • 从API更新Google Fonts JSON数据

1.11.0

  • 从API更新Google Fonts JSON数据
  • 在自述文件中的连字符列表前添加换行符以修复插件存储库显示
  • 防止readme.txt中的字体署名中出现额外空白
  • 谷歌字体:将onClick处理程序更改为onChange
  • 转义特殊字符以避免语法错误
  • 更新所需的节点版本和更新依赖项

1.10.0

  • 从API更新Google Fonts JSON数据
  • 添加疑难解答常见问题
  • 更新生成主题的“至少需要”字段
  • 改进字体许可证错误的处理
  • 修复选项卡索引支柱
  • 自动添加本地字体的字体许可证信息

1.9.0

  • 处理谷歌字体署名
  • 从API更新Google字体JSON数据
  • 修复中的控制台错误准备主题名称验证功能
  • 将常见问题部分添加到readme.txt
  • 自动添加谷歌字体的字体许可证信息
  • 删除捐赠链接

1.8.2

  • 通气测试版本
  • 更新测试版本至:6.2 WordPress版本
  • 修复导出主题中的标记重复
  • 修复错误检查
  • 从API更新Google Fonts JSON数据
  • 通用重构react应用程序代码
  • 将构建目录添加到php排除列表
  • 在覆盖主题时不要调用replace_template_namespace
  • 修复在后期编辑器中切换到模板编辑模式时的错误
  • 将useRootPaddingAwareAlignments添加到空白主题
  • 从API更新Google Fonts JSON数据
  • 如果模板信息为空,请避免将其添加到style.css
  • 修复名称与系列不同时删除字体系列/字体的问题
  • 添加主题名称验证
  • 修复从站点编辑器导出主题
  • 打印样式表前去除转义字符
  • 未打印的文件

1.8.1

  • 将当前WordPress版本添加到style.css和readme.txt
  • 在Google字体系列复选框控件周围添加标签
  • 修复克隆主题、子主题和兄弟主题的主题slug、textdomain和模板。
  • 从模板中获取媒体URL后替换模板中的主题slug

1.8.0

  • 仅导出用户所做更改的样式变化
  • 修复在版本碰撞时未更新package-lock的问题
  • 向添加默认值以避免调用export_theme_data()时出错
  • 修复图像下载在某些情况下不起作用
  • 从API更新Google Fonts JSON数据
  • 将导出(克隆)添加到站点编辑器

1.7.1

  • 更新屏幕截图
  • 修复在theme.json中未定义设置时管理字体UI和后端的问题
  • 可变字体粗细范围

1.7.0

  • 管理字体小重构。从PHP中移动元素以进行反应
  • 允许上传otf字体文件
  • React中的本地字体部分实现
  • 字体大纲侧边栏
  • 从API更新Google Fonts JSON数据

1.6.3

  • (修复重构回归)从主题slug中删除空白

1.6.2

  • 重构字体管理类
  • 重构create-block-theme类
  • 修复管理主题字体菜单大小写
  • 添加phpcs异常以避免PHP8.0不兼容错误
  • 修复空白主题屏幕截图致命错误
  • 使用自动修复工具修复线头问题
  • 从API更新Google Fonts JSON数据
  • 修复CSS线头问题
  • 修复PHP lint问题
  • 修复JS线头问题
  • 将皮棉验证添加到PR工作流中
  • 修复包锁定同步问题

1.6.1

  • 添加:主题标签的输入
  • 占位符URL更改为TT3
  • 从主题蛞蝓中删除空白

1.6.0

  • 更新主自述文件并添加支持文档
  • 修复折旧警告
  • 清理管理主题字体UI
  • 将模板图像捆绑到主题资产中并使其URL相对
  • 克隆主题:将原始主题名称添加到readme.txt和style.css
  • 默认情况下折叠的字体系列
  • 修复:单击折叠V形图标时出现意外操作
  • Lint所有CSS文件
  • 修复:作曲家脚本在Windows上不起作用
  • 如果可用,请使用古腾堡主题JSON解析器
  • 从API更新Google Fonts JSON数据
  • 用WordPress wp_mkdir_p()函数替换mkdir()调用

1.5.1

  • 检查DISALLOW_FILE_EDIT并简化权限检查逻辑
  • 从url加载谷歌字体数据
  • 重置单独的样式和模板
  • 加载谷歌字体时添加微调器,而不是显示空白页面
  • 添加:代码linting脚本
  • 从API更新Google Fonts JSON数据
  • 避免对Github操作进行提交前验证,以防止由linting问题导致的操作错误

1.5.0

  • 修复:浏览器控制台错误
  • 修复:在某些Windows环境中添加或删除字体失败
  • 将占位符屏幕截图添加到样板主题
  • 重构:将googleFonts部分从vanilla JS添加到React应用程序
  • 添加演示文本设置

1.4.0

  • 指定节点和npm版本,添加nvmrc文件
  • 添加主题截图上传
  • 管理字体:演示文本可编辑
  • 从API更新Google Fonts JSON数据

1.3.10

  • 删除字体:避免不必要地删除fontfamily。
  • 将缺少的空格添加到选项标签

1.3.9

  • 更新测试到:6.1
  • I18N:一些新的UI字符串不可翻译
  • 将“当前主题”替换为“活动主题”(或“当前活动主题”)
  • 通过删除尾部空格改进翻译过程
  • 字体:如果字体外观/系列被删除,则从主题资产文件夹中删除字体文件。
  • 重构以读取原始的theme.json数据,而不是使用核心方法
  • 从API更新Google Fonts JSON数据

1.3.8

  • 修复定义的拼写
  • 修复自述贡献器
  • 将贡献者用户名添加到自述文件
  • 更新GitHub操作以避免弃用警告
  • 从API更新Google Fonts JSON数据
  • 从API更新Google Fonts JSON数据
  • 在运行需要文件写入权限的函数之前检查权限
  • 允许预览系统字体

1.3.7

  • 移动要由发布操作自动更新的资产文件

1.3.6

  • 使用github操作自动更新资产

1.3.5

  • 自动发布:使用新版本提交更新的php文件

1.3.4

  • php文件的自动更新版本

1.3.3

  • 自动发布改进

1.3.2

  • 自动发布改进

1.3.1

  • 更新.distignore

1.3.0

  • 更新谷歌字体数据
  • 强制https加载Google字体预览
  • 添加选择/取消选择所有谷歌字体变体的功能
  • 使用repo操作自动更新google字体JSON数据
  • 管理主题字体
  • 自动发布:build、version bump、changelog、deploy to wp.org
  • 自动发布

1.2.3

  • 添加翻译域(#121)
  • 检查nonce索引(#120)
  • 正在服务器端验证字体文件的mime类型(#119)

1.2.2

  • 添加功能和nonce检查(#118)

1.2.1

  • 正在更正版本号

1.2.0

  • 在主题中嵌入谷歌字体和本地字体文件(#113)
  • 更改按钮文本(#112)
  • 为模板和零件文件夹添加检查和目录创建。(#110)
  • 如果没有安装Gutenberg,请更改空白主题的theme.json模式。(#107)

1.1.3

  • 更新链接,新更改的屏幕截图(#97)
  • 添加$schema并使用Gutenberg类(#99)
  • 更新自述文件以包含最新功能(#100)
  • 以与核心相同的方式生成$schema URL。(#105)

1.1.2

  • 保存主题变体(#90)
  • 使UI字符串“创建块主题”可以翻译(#92)

1.0.1

  • 添加选项以创建空白主题。(#70)
  • 改进表单说明(#76)
  • 表单清理和主题名称检查(#77)
  • 获取正确的合并主题.json数据(#88)

1

  • 初始版本。