Create Block Theme

外掛說明

這個外掛能讓使用者完成以下目的:

  • 建立全新佈景主題、空白佈景主題、子佈景主題或樣式變化。
  • 列出及預覽字型系列,並將字型內嵌至佈景主題中。
  • 在佈景主題中內嵌 Google Fonts 網頁字型。
  • 在佈景主題中內嵌網站主機字型資源。

這個外掛僅供開發使用,它不適用於正式環境網站,而是用於建立新的區塊佈景主題的工具。

步驟 1:設定

安裝並啟用 Create Block Theme 外掛。

登入 WordPress 管理後台後,在 [外觀] 中會出現 2 個新頁面:

  • Create Block Theme
  • 管理字型

步驟 2:自訂樣式

使用網站編輯器變更網站樣式及範本。網站管理員可以使用外掛功能將新字型加入區塊佈景主題。

步驟 3:匯出

在 WordPress 控制台中,前往 [外觀]→[建立區塊佈景主題] 區段,選取其中一項可用功能,並依需求為佈景主題加入詳細資料,style.css 會使用這些詳細資料。點擊 [產生] 按鈕,便能儲存佈景主題。

一般疑難排解

如果使用時遇到問題,請檢查以下項目:

  • 確保網站安裝了最新版本的 WordPress 核心程式。
  • 確保網站安裝了最新版本的外掛。
  • 停用全部外掛並查看這項操作是否解決了問題。如果停用全部外掛可以解決問題,請逐一啟用外掛,直至找到造成問題的外掛。
  • 將佈景主題切換至核心程式預設佈景主題,藉以排除任何與佈景主題相關的問題。
  • 查看技術支援論壇是否有類似的問題。

匯出佈景主題後得到損毀的 ZIP 檔案

  • 請先依照上述一般疑難排解步驟檢查。
  • 請確認網站的 wp-config.php 檔案中的 WP_DEBUG 常數設定為 false,例如 define( 'WP_DEBUG', false );
  • 如果佈景主題中包含 PHP 檔案,請確認 PHP 檔案的檔案結尾處沒有使用 PHP 結束標籤 ?>。如果有使用,請移除。

螢幕擷圖

常見問題集

如何取得技術支援?

如果使用上發生問題,請前往外掛的技術支援論壇,技術支援論壇是取得協助的正確位置。

如何回報問題?

如果要回報程式碼錯誤,請在外掛的 GitHub 存放庫提交。提交前請先搜尋是否已有類似問題,避免重複提交相同問題。

使用者評論

2024 年 2 月 25 日
Wow, 2 days of work completely gone! In the end I edited the "theme info", hit "saved changes" and *poof*, all gone.
2024 年 2 月 14 日
One thing that I would improve:When you open the assets/fonts folder of TT3 or TT4 themes, they offer .woff2 but the same doesn't happen with this plugin. So when you add a Google font it is only adding the .ttf font format, which is a very old format.
2024 年 1 月 12 日
Thanks for this. It works well. It's exciting that block theme design is low code. This plugin makes it even more low code.
2023 年 6 月 10 日 1 則留言
Works well with the built-in theme editor. Its a shame the theme editor itself is not better.
2023 年 6 月 2 日
This is essential for theme devs. Or anyone working with child themes.
2023 年 5 月 20 日
I love this. In just about a blink of the eye, I can create my own custom version of an already-built theme. Sweet!
閱讀全部 27 則使用者評論

參與者及開發者

〈Create Block Theme〉外掛目前已有 15 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈Create Block Theme〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

1.13.8

1.13.7

1.13.6

1.13.5

  • Make form files more specific to form page
  • Set page titles that set only within CBT

1.13.4

  • Bump “tested up to” to 6.4
  • Update Google Fonts JSON data from API
  • Update theme form markup and styles
  • Fix/child export
  • Corrects malformed input tag
  • Add quotes to font family names

1.13.3

  • Update “Tested up to” version to 6.3
  • Add .wp-env.override.json to .gitignore
  • Use wp_add_inline_script for createBlockTheme object
  • Update Google Fonts JSON data from API
  • Updated Requires PHP version to 7.4
  • Fix PHP 8.1 errors caused by missing page titles

1.13.2

  • Update Google Fonts JSON data from API
  • Set the initial version to 1.0.0 instead of 0.0.1
  • Fix: react render warning
  • Introduce basic wp-env environment

1.13.1

  • Add default value for recommended plugins section
  • Update Google Fonts JSON data from API

1.13.0

  • # Conflicts:

admin/create-theme/theme-readme.php

admin/create-theme/theme-zip.php

  • Merge branch ‘trunk’ into fix/resources-credits-on-save
  • Merge branch ‘trunk’ into add/subfolder-to-zip
  • Persist copyright info on new theme creation
  • Update Google Fonts JSON data from API
  • Move check for download_url higher up
  • Avoid white spaces or other weird characters on font asset paths.
  • Merge branch ‘trunk’ into add/subfolder-to-zip
  • Adding files to zip subfolder called as theme slug
  • Update Google Fonts JSON data from API

1.12.1

  • Fix double replacement in replace_namespace

1.12.0

  • # Conflicts:

src/plugin-sidebar.js

  • Add image credits input
  • Update theme version logic to use isset()
  • Update Google Fonts JSON data from API

1.11.0

  • Update Google Fonts JSON data from API
  • Add linebreaks before hyphen lists in readme to fix plugin repository display
  • Prevent additional white space in font credits in readme.txt
  • Google fonts: Change onClick handlers to onChange
  • Merge pull request #374 from WordPress/fix/escape-template-text
  • Update required node version and update dependencies

1.10.0

  • Update Google Fonts JSON data from API
  • Adding troubleshooting FAQs
  • Updating “Requires at least” field of generated themes
  • Improve handling of font license errors
  • Fix tabIndex prop
  • Automatically add font license info for local fonts

1.9.0

  • Merge branch ‘trunk’ into add/handle-google-font-credits
  • Update Google Fonts JSON data from API
  • Fix console error in prepareThemeNameValidation function
  • Add FAQ section to readme.txt
  • Automatically add font license info for Google fonts
  • Removing donate link

1.8.2

  • Merge branch ‘trunk’ into update/tested-up-wp-version-62
  • Updating Tested up to: 6.2 WordPress version
  • fix tag duplication in exported theme
  • Fixing error checking
  • Update Google Fonts JSON data from API
  • Refactor react app code for general purpose
  • add build directory to php exclude list
  • Do not call replace_template_namespace when overwrting theme
  • Merge branch ‘trunk’ into fix/314
  • Fix error when switching to template edit mode in the post editor
  • Add useRootPaddingAwareAlignments to blank theme
  • Update Google Fonts JSON data from API
  • Merge branch ‘trunk’ into fix/314
  • Avoid adding Template info to style.css if it’s empty
  • Fix delete font family/face when name is different from family
  • Add theme name validation
  • Fix export theme from Site Editor
  • Strip escaping characters before printing stylesheet
  • Linting unlinted file

1.8.1

  • Add current WordPress version to style.css and readme.txt
  • Add labels around Google font family checkbox controls
  • Fix theme slug, textdomain, and template for cloned, child and sibling themes.
  • Replace theme slug in templates after getting media urls from them

1.8.0

  • Export style variations just with the changes made by the user
  • fix issue where package-lock is not updated on version bump
  • Adding default value to an to avoid error when calling export_theme_data()
  • Fixing image downloading not working in some cases
  • Update Google Fonts JSON data from API
  • Add Export (Clone) to site editor

1.7.1

  • Update screenshots
  • Fix manage fonts UI and backend when no settings are defined in theme.json
  • Variable font weight range

1.7.0

  • Manage fonts minor refactor. Move elements from PHP to react
  • Allow otf font file upload
  • Local fonts section implementation in React
  • Fonts outline sidebar
  • Update Google Fonts JSON data from API

1.6.3

  • (Fix refactor regression) Remove white spaces from theme slug

1.6.2

  • Refactor font-management class
  • Refactor create-block-theme class
  • fix manage theme font menu casing
  • Add phpcs exception to avoid PHP8.0 incompatibility errors
  • Fix blank theme screenshot fatal error
  • Fix lint issues using auto fixer tool
  • Update Google Fonts JSON data from API
  • Fix CSS lint issues
  • Fix PHP lint issues
  • Fix JS lint issues
  • Add lint validation to PR workflows
  • fix package lock sync issue

1.6.1

  • Add: input for theme tags
  • Placeholder URL change to TT3
  • Remove white spaces from theme slugs

1.6.0

  • Update main readme and add supporting docs
  • Fix Depreciation Warning
  • Cleanup Manage Theme Fonts UI
  • Bundle template images into theme assets and make their urls relative
  • Cloned themes: Add original theme name to readme.txt and style.css
  • Font families collapsed by default
  • Fix: Unexpected action when clicking Collapse chevron
  • Lint all CSS files
  • Fix: composer scripts doesn’t work on Windows
  • Use Gutenberg Theme JSON resolver if its available
  • Update Google Fonts JSON data from API
  • Replacing mkdir() calls with WordPress wp_mkdir_p() function

1.5.1

  • check for DISALLOW_FILE_EDIT and simplify permission check logic
  • Load google fonts data from url
  • Separate styles and templates reset
  • Add spinner while google fonts load instead of showing a blank page
  • Add: code linting scripts
  • Update Google Fonts JSON data from API
  • Avoid pre commit verifications on Github actions to prevent action errors caused by linting problems

1.5.0

  • Fix: browser console errors
  • Fix: Adding or removing fonts fails in some Windows environments
  • Add placeholder screenshot to boilerplate theme
  • Refactor: Add Google Fonts section from vanilla JS to React app
  • Adding demo text settings

1.4.0

  • Specify node and npm versions, add nvmrc file
  • Add theme screenshot uploading
  • Manage fonts: Demo text editable
  • Update Google Fonts JSON data from API

1.3.10

  • Remove font face: avoid unwanted removal of fontfamily.
  • Add missing spaces to option labels

1.3.9

  • Updating Tested up to: 6.1
  • I18N: Some new UI strings are not translatable
  • Replace “current theme” with “active theme” (or “currently active theme”)
  • Improve translation process by removing trailing spaces
  • Fonts: remove font files from theme assets folder if the font face/family is removed.
  • Refactor to read raw theme.json data instead of using core methods
  • Update Google Fonts JSON data from API

1.3.8

  • Fixes the spelling of definition
  • Fixing readme contributors
  • Add contributor username to readme
  • Update GitHub action to avoid deprecation warning
  • Update Google Fonts JSON data from API
  • Update Google Fonts JSON data from API
  • Check permission before running functions that need file write permissions
  • Allow previewing system font

1.3.7

  • Moving assets files to be auto updated by the release action

1.3.6

  • Auto update assets using a github action

1.3.5

  • Auto release: commit updated php file with the new version

1.3.4

  • auto update version of php file

1.3.3

  • Automatic release improvements

1.3.2

  • Automatic release improvements

1.3.1

  • Update .distignore

1.3.0

  • Updating google fonts data
  • Force https to load Google fonts preview
  • Add the ability to select/unselect all google font variants
  • Merge branch ‘trunk’ into try/manage-fonts
  • Update google fonts JSON data automatically using a repo action
  • Merge branch ‘trunk’ into release-action
  • Merge branch ‘trunk’ into try/manage-fonts
  • Merge branch ‘try/manage-fonts’ into release-action
  • Manage theme fonts
  • Automate release: build, version bump, changelog, deploy to wp.org
  • Automate release

1.2.3

  • Add translation domain (#121)
  • Check for nonce index (#120)
  • Validating mime type of font file on server side (#119)

1.2.2

  • Add capabilities and nonce checks (#118)

1.2.1

  • Correcting version number

1.2.0

  • Embed Google fonts and local font files in theme (#113)
  • Change button text (#112)
  • Add check and directory creation for template and parts folders. (#110)
  • Change theme.json schema of blank theme if Gutenberg isn’t installed. (#107)

1.1.3

  • update links, screenshots of the new changes (#97)
  • Add $schema and use Gutenberg classes (#99)
  • Update readme to include latest features (#100)
  • Generate $schema URL in the same way as core. (#105)

1.1.2

  • Save a theme variation (#90)
  • Make UI string ‘Create Block Theme’ can be translatable (#92)

1.0.1

  • Add option to create blank theme. (#70)
  • Improve form instructions (#76)
  • Form cleanup and Theme name check (#77)
  • Get the correct merged theme.json data (#88)

1.0

  • Initial version.