Technical

要建立自定義的 token 會需要用到 hook_token_info() 及 hook_token()，前者是定義 token 的分類及可以使用的 tokens、後者則是撰寫 token 要置換成什麼內容的程式。

準備 Token

以下是 Drupal Token - Generic placeholder substitution 的範例：

過往在 Drupal 7 以前，「日期」欄位存的是 UNIX timestamp 的格式，所以取出欄位值後，通常會需要用 date¹ 函式來轉換日期的呈現格式。

DrupalDateTime² 是擴充 PHP DateTime³ 的類別，自 Drupal 8 開始，核心提供的「日期」欄位預設都是 DrupalDateTime 類別實作的，這意味著，在取用 Entity 時可以直接使用 DrupalDateTime 提供的方法（method）來轉變日期的格式，而不需要再透過 date 來處理。

例如：

Drupal 8/9 要使用 TextFormat¹ 類型的欄位

平時甚少會需要在客製表單中加入檔案/圖像上傳的檔案，所以一時之間也不知道該怎麼寫，為了避免下次又忘記，來補篇筆記

Drupal 8 開始是定義在 ManagedFile Class¹ 內：

在 Drupal 8/9 可以用 OpenDialogCommand Class 來實作 Dialog 或 Modal Dialog。

但要怎麼讓 Dialog 可以因應載具尺寸自動調整呢？例如電腦版下最多 700px 的大小、而在手機版底下則變成滿版。在網路上搜尋到的範例，大多是

Drupal 8/9 改用 Configuration API 儲存模組的設定值及相關資料，此舉讓網站的設定資料搬遷變得更容易，但如果你遇到 Drupal 8 早期開發的模組（如 Commerce Inventory），因為模組的反安裝機制沒有寫好，以致於模組沒有成功反安裝而留下部分設定資料未能順利刪除時，這時就可以手動來裝這些資料刪掉。例如本文範例遇到的錯誤訊息如下：

如果你看到內文圖像無法顯示，並且圖像標題顯示

This image has been removed. For security reasons, only images from the local domain are allowed.

那應該就是文字格式裡不小心啟用了 Restrict images to this site 的選項，所以把外部圖像過濾掉了，關閉此過濾器就好了。

Ref: How do I override the "This image has been removed" message?

如題，主要就是在分類編輯頁，沒有出現「上層次分類」(parent) 欄位，而當次分類詞太多的時候，又無法用拖拉的方式調整分類詞的階層關係（例如出現在第二頁的分類詞，就無法拉到第一頁的父分類詞下）。這個問題滿奇特，一開始用關鍵字（例如 taxonomy parent disappear）搜尋都找不到真正的答案。

後來直接看程式碼

Ref:

• Cloning a Drupal Git repository
• Applying a patch in a feature branch

Ref:

• ConfigFormBase with Simple Configuration API
• Working with Configuration Forms