如何開發一個區塊佈景主題 (Block Theme) – 01 – 檔案結構

WordPress 5.9 即將在 1/25 發佈,這次將會導入全站編輯,除了對於使用者來說是一個全新的體驗,對於開發者來說開發的方式也相當的不同。這一系列的文章將會介紹如何開發一個 Block theme。

Block theme 檔案目錄結構

上圖是一個基本的區塊佈景主題的檔案目錄結構,其中有兩個檔案是每個佈景主題一定要有的:index.php and style.css.

如果一個佈景主題要被辨識為區塊佈景主題那麼就必需要在 templates 資料夾中新增一個 index.html 範本檔案。

functions.php 不是必要的。如果你需要新增客製化的程式才會需要新增這個檔案。同時 theme.json 也是非必要的,除非你要管理全域樣式 (global style)。

區塊範本 (Block Templates)

區塊範本是你的佈景主題的基礎檔案,他們是一些包含 HTML 語法的檔案,且必須要放在 templates 資料夾中。區塊範本檔案是遵循 WordPress 檔案目錄結構的,所以 /templates/index.html 會對應到傳統佈景主題下的 index.php,/templates/404.html 會對應到傳統佈景主題下的 404.php,以此類推。

如果 WordPress 無法在 templates 目錄中找到對應的 html 檔案,那麼就會尋找佈景主題根目錄下的 .php 檔。

區塊範本組件(Block Templates Parts)

範本組件不是必須的,如果要新增範本檔案則要新增在 parts 資料夾中。它是用來幫助佈景主題開發者有效地重複利用一些可重複使用的程式。一個範本組件基本上就是一個區塊,它是用來包含其他區塊的容器。範本組件檔案會放在 parts 資料夾中,同時跟範本檔案一樣,它們也是一些 html 檔案,同時遵循 WordPress 的檔案目錄結構。所以 parts/header.html 就會對應到傳統佈景主題下的 header.php。

發佈留言