Drupal

Step-by-step instructions for installing Drupal 9 multisite in subdirectories.

站點安裝設置失誤導致在S3上缺失了 public://media-icons/ 下的所有文件，如今在media 中上傳任何 video、document、audio 都無法生成縮略圖，fallback 到本地path 提示 404 not found，檢視 Recent log messages 日誌，發現了相關錯誤信息：

在Drupal Views 中自帶了分頁功能 Pager，可以在界面上自定義每頁要顯示條目個數 Items to display，要跳過的個數 Offset (number of items to skip)，總頁數 Number of pages，分頁的標籤 Page Link Labels，指定分頁顯示的個數 Number of pager links visible。

在Drupal 8 和 Drupal 9 的 twig 模板開發中，常常會需要輸出指定的field，本文列出常見類型的field取值方法，以便查詢。 一般類型 General # Field type How to get value Note Boolean {{ content.field_name[0] }} 值為“On”或“Off”的label Boolean {{ content.field_name['#items'][0].value }} 值為1或0 Date {{ content.field_name[0] }} 值為套用time.html.twig模板的完整日期時間html片段 Date {{ content.field_name[0]['#text] }} 值為完整日期時間格式的純文本 Timestamp {{ content.field_name[0] }} 值為完整日期時間格式的純文本 Timestamp {{ content.field_name['#items'][0].value }} 值為時間戳數字 Email {{ content.field_name[0] }} 值為純文本格式 link {{ content.field_name[0]['#url'] }} 值為連結URL link {{ content.field_name[0]['#title'] }} 值為連結文字 數字類型 Number # Field type How to get value Note Number (float) {{ content.field_name[0] }} 顯示有前綴和後綴並number_decimal格式化 Number (float) {{ content.field_name['#items'][0].value }} 顯示未經格式化的浮點數 Number (integer) {{ content.field_name[0] }} 顯示有前綴和後綴 Number (integer) {{ content.field_name['#items'][0].value }} 顯示未經格式化的整數 Number (decimal) {{ content.field_name[0] }} 顯示有前綴和後綴 Number (decimal) {{ content.field_name['#items'][0].value }} 顯示未經格式化的小數 文字類型 Text # Field type How to get value Note Text (formatted) {{ content.field_name[0] }} 帶格式的文本 Text (formatted) {{ content.field_name[0]['#text'] }} 未經html轉化的文本 Text (formatted) {{ content.field_name['#items'][0].value|striptags }} 純文本 Text (formatted, long) {{ content.field_name[0] }} 帶格式的文本 Text (formatted, long) {{ content.field_name[0]['#text'] }} 未經html轉化的文本 Text (formatted, long) {{ content.field_name['#items'][0].value|striptags }} 純文本 Text (formatted, long with summary) {{ content.field_name[0] }} 帶格式的文本 Text (formatted, long with summary) {{ content.field_name[0]['#text'] }} 未經html轉化的文本 Text (formatted, long with summary) {{ content.field_name['#items'][0].value|striptags }} 純文本 Text (formatted, long with summary) {{ content.field_name['#items'][0].summary }} 摘要 Text (plain) {{content.field_name.0 }} 純文本 Text (plain, long) {{content.field_name.0 }} 純文本 列表類型 List # Field type How to get value Note List (float) {{ content.field_name[0] }} 在管理介面Manage Display中設置該欄位顯示值key或標籤label List (float) {{ content.field_name['#items'][0].value }} 顯示值的key List (integer) {{ content.field_name[0] }} 在管理介面Manage Display中設置該欄位顯示值key或標籤label List (integer) {{ content.field_name['#items'][0].value }} 顯示值的key List (text) {{ content.field_name[0] }} 在管理介面Manage Display中設置該欄位顯示值key或標籤label List (text) {{ content.field_name['#items'][0].value }} 顯示值的key 參照類型 Reference # Field type How to get value Note Fiel {{ content.field_name[0] }} 值為套用file-link.html.twig模板的html片段 File {{ file_url(content.field_name[0]['#file'].uri.value) }} 檔案連結 File {{ content.field_name[0]['#description'] }} 檔案描述 Image {{ file_url(content.field_name[0]['#item'].entity.uri.value) }} 圖片連結 Image {{ content.field_name[0]['#item'].value.alt }} 圖片alt文字 Image {{ content.field_name[0]['#item'].value.title }} 圖片title文字 Image {{ content.field_name[0]['#item'].value.height }} 圖片設置的高度 Image {{ content.field_name[0]['#item'].value.width }} 圖片設置的寬度 Taxonomy Term {{ content.field_taxonomy[0]['#options'].entity.id }} 在Manage display中將format設為Label時顯示term id Taxonomy Term {{ content.field_name[0]['#title'] }} 在Manage display中將format設為Label顯示term label Taxonomy Term {{ content.field_name[0]['#url'] }} 在Manage display中將format設為Label顯示term path 媒體類型 Media # 啟用Media模組後出的media field。

Drupal 9 多語言站點啟用 Paragraphs 模組，如果在 custom block 中使用了 paragraphs 類型的字段 ，會遇到字段內文字的翻譯無法顯示問題。該 paragraphs 字段的內容始終加載的是 default 的語言內容（通常是英文），需要在custom module 代碼中使用 hook_preprocess_block() 修改一下。

Drupal 9 Webform 表單提交後可以自定義 email 內容發送通知郵件到指定email地址，本地開發中使用 Mailhog 做測試。 💡關於Mailhog的安裝介紹參看Y Cheung之前的文章《本地開發測試郵件服務 Mailhog》

GIT CLONE 代碼 正常流程 stander 安裝drupal8 修改/sites/default/settings.php 指定 config 文件夾位置 1$config_directories['sync'] = 'sites/config/sync'; 執行drush命令導入config 1drush config-import 提示報錯：

標題有點拗口，YCHEUNG也想不出來更好的中文表達，沒懂的朋友直接看內文吧（或者看url的英文標題）。 這種功能的表格表單YCHEUNG已經嘗試了五六種方式來寫，但都不滿意。不然就是功能上多少有缺陷，比如無法使用drupal 7 form API的日期type，不然就是很繁瑣的一堆代碼和判斷，看着都頭暈……等，今天終於試出了一個令YCHEUNG較滿意的寫法！分享給大家，也是一種記錄，YCHEUNG有預感，之後還會寫很多個這樣的表單QAQ

系統環境需求 # PHP環境最好是 PHP 7，系統最好是紅帽系。 操作步驟 # 安裝Oracle Instant Client # 在Oracle官網頁面中找到系統對應的客戶端下載安裝，比如Y CHEUNG選擇的就是 Instant Client Downloads for Linux x86-64 ，Fedora可以下載RPM包直接安裝，非RedHat系統的可能需要先編譯,用make install的方式安裝。