自訂外觀

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件
資訊

您可以依照公司主題自訂開發人員服務入口網站的外觀、為入口網站新增內容區域,或是變更入口網站上任何頁面的版面配置。大多數的這項設定都需要 Drupal 的工作知識。不過,您可能會想執行部分基本工作來自訂入口網站。

自訂網站標題和標語

您可以設定網站標題及其標語。標題和標語會顯示於首頁上:

「標題 | 標語」

標題是必填項目,且預設為「新增 Apigee 網站」。標語預設為空白。

如何設定標題和標語:

  1. 以具備管理員或內容建立權限的使用者登入入口網站。
  2. 在 Drupal 管理選單中,依序選取「Configuration」>「System」>「Site Information」
  3. 在「Site info」(網站資訊) 頁面中設定「Site Name」(網站名稱) ,並視需要設定 [Slogan] (Slogan)
  4. 儲存設定。
    請注意,資訊方塊和標語經過快取後,可能不會立即顯示變更。您可以選擇清除快取,使系統顯示這些變更。如要清除快取,請選取 Drupal 管理選單最左側的 Drupal 圖示,然後選取「Flush」(清除所有快取)。

自訂首頁的版面配置

下圖顯示首頁的版面配置:

Drupal 提供一套控制這個頁面顯示方式的機制。本節將說明預設主頁面的版面配置元素,以及如何修改這些元素。如要執行完整的頁面重新設計,請參閱 Drupal 說明文件。

首頁分為以下幾個部分:

  • 主選單:包含 Apigee 標誌,以及網誌和論壇選單項目。以下章節將說明如何設定主選單。
  • 歡迎訊息:主選單下方字串,開頭為「Welcome to the ...」。自訂主題說明如何設定歡迎訊息。
  • 頂部區域:主選單下方顯示歡迎訊息的區域、兩個方塊含有說明文件連結,以及含有存取金鑰的建構項目,以及大型圖示。這個區域由 Drupal Block 定義。區塊是 Drupal 網頁上的矩形內容區域。如要設定頂端區域,請編輯用於定義該區域內容的 Drupal Block,如下所述。
  • 底部區域:包含「近期網誌文章」、「論壇討論」和「熱門主題」等區域。這三個區域都是以 Drupal View 的形式導入。請參閱這篇文章,瞭解如何編輯這些檢視模式。
  • 頁尾:包含「隱私權政策」、「條款與使用條款」及「聯絡」連結。 請參閱「編輯頁尾頁面」。

自訂用來定義首頁頂端區域的區塊

  1. 以具備管理員權限的使用者的身分登入入口網站。
  2. 在 Drupal 管理選單中,依序選取「結構」>「區塊」
  3. 在「Blocks」頁面中,選取「封鎖首頁標頭」的「設定」configure連結。
    首頁標頭區塊的內文是 HTML 程式碼,定義該區塊的外觀
  4. 視需要編輯區塊。
  5. 選取「Save bloc」
  6. 前往首頁查看變更內容。

自訂主選單

主選單會顯示在開發人員入口網站的每一頁頂端。根據預設,系統會顯示 Apigee 標誌和兩個選單項目:網誌和論壇。您可以編輯主選單,藉此變更為標誌或自訂選單項目。

如何變更標誌:

  1. 以具備管理員或內容建立權限的使用者登入入口網站。
  2. 如果預設主題為 Apigee 回應式主題:
    1. 依序選取「外觀」>「設定」
  3. 如果預設主題為 Apigee DevConnect 主題:
    1. 依序選取「Appearance」>「Settings」>「Apigee DevConnect Theme」。
  4. 在標誌圖片設定下方,取消選取「使用預設標誌」
    頁面會有所異動,方便您瀏覽並上傳圖片檔。
  5. 在「上傳標誌圖片」下方,選取「選擇檔案」按鈕,然後前往您的圖片檔。
  6. 選取「開啟」上傳檔案。
  7. 按一下「Save Configuration」

如何編輯菜單項目:

  1. 以具備管理員或內容建立權限的使用者登入入口網站。
  2. 在 Drupal 管理選單中,依序選取「Structure」>「Menus」>「Main」選單
    您可以使用這個頁面新增、移除及重新排序選單項目。
  3. 按一下「新增連結」,新增選單項目。
  4. 新增必要資訊,然後選取「儲存」
  5. 在「主選單」頁面中按一下「儲存設定」

將「我的應用程式」頁面重新命名為「我的 API」

根據預設,每個入口網站開發人員都有一個名稱為「我的應用程式」的頁面,可用來新增、修改及刪除應用程式和這些應用程式相關聯的 API 金鑰。舉例來說,開發人員可以擁有多個應用程式、修改應用程式以新增或移除 API 產品,以及透過「我的應用程式」頁面查看應用程式使用情況的分析資訊。

不過,部分 API 供應商想要簡化入口網站上的資訊顯示,並簡化開發人員與入口網站的互動。舉例來說,您可以設定入口網站,在開發人員在入口網站註冊時建立預設的應用程式和 API 金鑰。該應用程式可能是開發人員唯一能存取的應用程式,且網站不允許使用者修改應用程式。如要瞭解如何建立預設應用程式,請參閱「新增及管理使用者帳戶」一文。

有些網站完全不想要使用「應用程式」一詞。這些網站改為參照 API 和 API 金鑰。在這種情況下,您會設定入口網站,將「應用程式」一詞替換為「API」,這樣開發人員現在就會有名為「My API」的頁面。不過,頁面顯示的資訊與頁面名為「我的應用程式」時的資訊相同,如下所示:

這項變更不只會影響「My API」頁面的標題,以及其他區域。舉例來說,在上圖中,請注意,右側的按鈕現在顯示為「Add a new API」,且下方文字是指 API,而非應用程式。

如何設定入口網站以顯示 My API:

  1. 以具備管理員或內容建立權限的使用者登入入口網站。
  2. 在 Drupal 管理選單中,依序選取「Configuration」>「Dev Portal」>「Application Settings」
  3. 展開頁面上的「Application UI Settings」區域。
  4. 找出要查看的文字,然後選取對應的圓形按鈕。
  5. 按一下「Save Changes」(儲存變更)
  6. 在 Drupal 管理選單中,依序選取「結構」>「選單」>「主選單」
  7. 按一下「My Apps」項目的 [Edit] 連結。
  8. 編輯「Menu link title」,改成「My APIs」
  9. 點按「儲存」
  10. 在「主選單」頁面中按一下「儲存設定」

啟用行動裝置的 Drupal 管理選單

預設的 Drupal 管理員選單與行動裝置的小螢幕尺寸不相容。 如要透過行動裝置管理入口網站,您可以啟用新的管理員選單,以便支援螢幕寬度為 767 像素以上的行動裝置。

如何啟用行動裝置相容管理員選單:

  1. 以具備管理員或內容建立權限的使用者登入入口網站。
  2. 在 Drupal 管理選單中選取「Modules」。系統會顯示所有已安裝的 Drupal 模組清單。
  3. 下載並安裝 Navbar 模組
  4. 啟用後,請停用「管理選單工具列樣式」模組。
  5. 按一下「儲存設定」
  6. 停用「管理選單」模組。
  7. 啟用「Navbar」模組
  8. 按一下「儲存設定」

您現在可以看到與行動裝置相容的 Drupal 管理選單。