允許您的用戶使用實體瀏覽器模塊選擇 Drupal 實體

在這篇博文中，我將向您展示如何讓 Drupal 用戶使用“實體瀏覽器”模塊來選擇實體。

本教程是由正在構建書評網站的 OSTraining 客戶請求的。 客戶想要使用實體瀏覽器，以便他們可以創建此功能：

• 該網站有兩種內容類型：書籍和書評。
• 當用戶創建新的書評時，他們可以使用視圖來搜索和選擇他們正在審閱的書。 例如，如果他們正在查看“戰爭與和平”，他們可以搜索現有的“戰爭與和平”節點。
• 當書評發佈時，所選節點將嵌入書評中。

這個客戶請求可以在實體瀏覽器模塊的幫助下實現。 該模塊提供了一個瀏覽器，Drupal 用戶可以使用該瀏覽器將節點嵌入到其站點的其他部分。

本教程將帶您完成站點構建練習，並向您展示如何使用實體瀏覽器模塊。

步驟1。 安裝所需的模塊

為了使用實體瀏覽器，您必須安裝以下模塊：實體瀏覽器和混沌工具。

使用您喜歡的方法下載並安裝這些模塊。 我正在使用作曲家：

 composer install drupal/entity_browser

 composer install drupal/ctools

這會將模塊放置在您的 Drupal 安裝中。 之後單擊Extend ，搜索這兩個模塊，啟用它們並單擊Install 。

第2步。 創建分類術語

在此示例中，書籍按其類型分類，因此我們需要一個名為“書籍類型”的詞彙表。

• 單擊結構 > 分類 > 添加詞彙表。
• 給詞彙一個合適的名稱和描述。
• 單擊保存。

• 在列表選項卡上，單擊添加術語。

添加以下術語：

• 冒險
• 食譜
• 戲劇
• 幻想
• 恐怖

步驟#3。 創建圖書內容類型

接下來，我們將為我們的書籍創建內容類型。 我們將使用在上一步中創建的 Book Genre 分類法。

• 單擊結構 > 內容類型 > 添加內容類型。
• 創建一個名為Book的內容類型，並使用它們的默認設置添加這些字段：

• 再次單擊添加字段。
• 在Reference下的下拉列表中，選擇 Taxonomy term 並給它一個適當的標籤。
• 單擊保存並繼續。

• 將Allowed number of values保留為 1，然後單擊Save field settings
• 向下滾動到“編輯”屏幕的底部，然後選擇要在內容類型中引用的詞彙。 在這種情況下：書籍類型
• 點擊保存設置

• 單擊管理表單顯示選項卡。
• 查找圖書類型字段並將其小部件更改為複選框/單選按鈕。
• 單擊保存。

步驟4。 創建圖書內容

現在是時候創建 5 到 10 本書，並將每一本書分配給特定的流派。

• 單擊內容 > 添加內容 > 書籍。

步驟#5。 創建視圖

創建一些示例內容後，您現在可以創建視圖了。 此視圖將顯示在實體瀏覽器上，因此您可以在創建書評時選擇一本書。

• 單擊結構 > 視圖 > 添加視圖。
• 創建一個標題為可用書籍的視圖。
• 顯示Book 類型的內容。
• 取消選中頁面和阻止設置。
• 單擊保存並編輯。

• 單擊“顯示”部分下的“添加”按鈕。
• 選擇實體瀏覽器。

• 單擊排序條件旁邊的重新排列並刪除內容：在 desc 條件下創作。
• 單擊應用。
• 單擊過濾條件旁邊的添加並選擇圖書類型字段。
• 單擊添加並配置過濾條件。

• 確保選擇了圖書流派詞彙。
• 將選擇類型更改為下拉。
• 單擊應用並繼續。

• 選中向訪問者公開此過濾器，以允許他們更改它。
• 確保將運算符選擇為Is one of。
• 單擊應用。

• 將Title字段添加到SORT條件。
• 保留默認配置升序排序，然後單擊應用。

這將按字母順序顯示視圖中的書籍。 您必須插入更多字段才能顯示在視圖上。 目前，只有節點標題可用。

• 單擊字段部分上的添加按鈕。
• 查找書籍封面字段，然後單擊添加並配置字段。

• 選擇圖像樣式（縮略圖 100x100）並單擊應用。
• 再次單擊添加以添加實體瀏覽器批量選擇表單字段。
• 單擊添加並配置字段。

• 單擊應用。

如果要使用實體瀏覽器，則必須使用此字段，因此要特別注意這一點。

• 更改視圖的格式，例如更改為網格。
• 單擊應用兩次。

Views UI 中的視圖配置應如下圖所示。 單擊保存以保存視圖。

步驟#6。 配置實體瀏覽器模塊

在這一步中，我們將選擇本教程中的設置關鍵模塊：實體瀏覽器。

• 單擊配置 > 實體瀏覽器

• 單擊添加實體瀏覽器。
• 給它一個適當的標籤，例如，圖書瀏覽器。
• 作為顯示插件選擇iFrame。
• 單擊下一步。

• 選中自動打開實體瀏覽器，然後單擊下一步。

• 再單擊兩次Next ，直到您進入Widgets配置頁面。
• 單擊下拉列表以選擇查看小部件插件。
• 更改小部件的標籤，例如：“選擇一本書”。
• 選擇您在步驟#5 中配置的視圖。
• 單擊完成。

步驟#7。 創建書評內容類型

我們的網站幾乎完成了。 在完成之前，我們確實需要創建書評人可以使用的內容類型：

• 單擊結構 > 內容類型 > 添加內容類型。
• 將此內容類型命名為書評。
• 添加一個新字段，從參考部分選擇內容。
• 給這個字段一個適當的標籤，例如，這本書。
• 單擊保存並繼續。
• 在要引用的項目類型選項中選擇內容。
• 單擊保存字段設置。

• 單擊保存設置。
• 單擊此內容類型的管理表單顯示選項卡。
• 找到引用字段並將其小部件更改為實體瀏覽器。
• 單擊右側的齒輪並選擇圖書瀏覽器（或任何您在步驟#6 中創建的瀏覽器。
• 單擊更新。
• 單擊保存。

請注意，您還可以選擇僅顯示實體標籤或完整呈現的實體。 您可以使用視圖模式（例如 Teaser）在這個新的書評內容類型上呈現實體。

步驟#8。 創建書評

現在我們的網站幾乎可以使用了。 讓我們創建一個書評，看看是否一切正常。

• 單擊內容 > 添加內容 > 書評。
• 給這個節點一個適當的標題和正文。
• 進一步向下滾動，您會發現一個名為 THE BOOK 的折疊部分（即該字段的名稱）。
• 單擊此字段，您將看到實體瀏覽器，您可以在其中選擇您在此書評中引用的書。
• 此外，頂部有一個暴露的過濾器，因此您可以選擇僅與一種類型有關的書籍。
• 選擇一個流派，然後單擊應用。

瀏覽器將只向您顯示該類型的書籍。

• 選擇一本書並單擊選擇實體。

• 嵌入實體後單擊保存，您將在Book review節點上看到引用的Book實體。

本教程展示了 Drupal 8 的“實體瀏覽器”模塊的強大功能。希望你喜歡它。 謝謝閱讀！