主題解釋了 Drupal 網站的用戶界面 (UI)。雖然主題結構并沒有明顯的變化，但 Drupal 版本 7 配備了一個新的主題實現方法。本文演示了如何創建一個新的 Drupal 7 主題。

http://www.ibm.com/developerworks/cn/opensource/os-new-drupal-theme/index.html

Drupal 主題的目標是將框架的處理邏輯和設計元素分開。為了做到這一點，Drupal 采用了一個復雜的主題系統，其中包括主題、主題引擎和掛鉤。主題組件與 Drupal 核心系統和模塊設計元素配合，創建具有獨特外觀的用戶界面（單獨 Drupal 頁面和表單）。由于將 Drupal 的業務邏輯從它的表示邏輯中分離出來，使代碼更易于維護，并且您無需重寫代碼層就可以交換出主題層的實現，反之亦然。圖 1?說明了 Drupal 框架結構。

圖 1. Drupal 框架結構

主題顯示 Drupal 核心通過底層主題引擎從數據庫中提取的數據，主題引擎被用作 Drupal 核心和主題模板之間的接口。

主題引擎

主題引擎?是一種手段，主題通過此引擎與 Drupal 核心進行交互。有幾個主題引擎可以與 Drupal 配合使用。最流行的是：

• PHPTemplate
• XTemplate
• Plain PHP
• Smarty Engine

其他 Drupal 主題引擎

與 Drupal 配合的還有其他幾個常用主題引擎。它們包括PHPTAL、wgSmarty、Zengine、Awesomengine、ETS、Haml、XSLengine?和 Peroxide。不過，本文使用?PHPTemplate?引擎，因為它是默認的主題引擎，并且是與 Drupal 7 一起打包的惟一主題引擎。

如果您愿意，您也可以使用自己的自定義引擎。

PHPTemplate?主題引擎是默認的 Drupal 引擎，也是本文中所使用的主題引擎，它使用名稱類似于?filename.tpl.php?的單獨主題文件作為 Drupal 的?theme_filename()?函數的主題。這些文件每個均包含面向動態數據的 HTML 框架以及 PHP 語句。因此，憑借 PHP 的基本知識，利用?PHPTemplate?就能輕松創建高級主題，因為這只涉及極少量的代碼。

回頁首

規劃主題

主題是由若干個文件組件。文件的數量取決于主題的復雜性。一個主題可能只有三個文件，也可能會有幾十個文件，包括放置在主題目錄內若干個文件夾中的圖形元素和各種腳本。圖 2?顯示了在主題主文件夾中預期可以找到的典型文件描述（顏色、圖像、徽標、模板、樣式和 PHP 文件）。

圖 2. 主題文件夾的典型內容

并非所有這些文件都是一個主題所需要的，許多人認為級聯樣式表 (CSS) 文件是絕對必需的，但某些主題甚至連 CSS 也沒有。通過了解這些主題文件的用法，主題結構以及它的工作方式會變得更加清晰。讓我們再看看主題目錄中的一些文件，并探討它們在整體主題中的功能。

.info 文件

.info 文件是一個必需的文件：Drupal 必須包括它，才能看到主題。.info 文件告訴 Drupal 主題的內部名稱。例如，如果這個文件的名稱是ibmtheme.info，那么 Drupal 給這個主題的名稱將是?ibmtheme。如果您的主題使用 JavaScript、元數據、樣式表或塊區域等元素，您也必須在 .info 文件中定義它們。一切都是可選的。在?清單 1?中，Bartik 主題的 .info 文件內容解釋了這種行為。

清單 1. Bartik 主題的 .info 文件內容

; $Id: bartik.info,v 1.5 2010/11/07 00:27:20 dries Exp $name = Bartik description = A flexible, recolorable theme with many regions. package = Core version = VERSION core = 7.xstylesheets[all][] = css/layout.css stylesheets[all][] = css/style.css stylesheets[all][] = css/colors.css stylesheets[print][] = css/print.cssregions[header] = Header regions[help] = Help regions[page_top] = Page top regions[page_bottom] = Page bottom regions[highlighted] = Highlightedregions[featured] = Featured regions[content] = Content regions[sidebar_first] = Sidebar first regions[sidebar_second] = Sidebar secondregions[triptych_first] = Triptych first regions[triptych_middle] = Triptych middle regions[triptych_last] = Triptych lastregions[footer_firstcolumn] = Footer first column regions[footer_secondcolumn] = Footer second column regions[footer_thirdcolumn] = Footer third column regions[footer_fourthcolumn] = Footer fourth column regions[footer] = Footersettings[shortcut_module_link] = 0; Information added by drupal.org packaging script on 2011-01-05 version = "7.0" project = "drupal" datestamp = "1294208756"

.tpl.php 模板文件

主題目錄包含若干個模板文件，其文件名如?xxx.tpl.php。這些模板文件包含主題的 Extensible HTML (XHTML) 標記和 PHP 變量。在某些情況下，您可以編寫它們，以提供其他類型的數據輸出，如 RSS。一般來說，每個 Drupal 主題的 tpl.php 文件都進行編碼，以處理特定的數據輸出：在模板文件中嵌入復雜的邏輯有可能帶來混亂，并事與愿違，因為這樣做有可能使它們難以維護。理想的場景是讓它們只包含簡單的 XHTML 標記和 PHP 變量。

清單 2?顯示 node.tpl.php 文件的內容，該文件描述核心 Garland 主題的基本節點的輸出。

清單 2. Garland 主題 node.tpl.php 文件的內容

<?php // $Id: node.tpl.php,v 1.24 2010/12/01 00:18:15 webchick Exp $ ?> <div id="node-<?php print $node->nid; ?>" class="<?php print $classes; ?>"<?php print $attributes; ?>><?php print $user_picture; ?><?php print render($title_prefix); ?><?php if (!$page): ?><h2<?php print $title_attributes; ?>><a href="<?php print $node_url; ?>"><?php print $title; ?></a></h2><?php endif; ?><?php print render($title_suffix); ?><?php if ($display_submitted): ?><span class="submitted"><?php print $submitted ?></span><?php endif; ?><div class="content clearfix"<?php print $content_attributes; ?>><?php// Hide the comments and links now so you can render them later.hide($content['comments']);hide($content['links']);print render($content);?></div><div class="clearfix"><?php if (!empty($content['links'])): ?><div class="links"><?php print render($content['links']); ?></div><?php endif; ?><?php print render($content['comments']); ?></div></div>

template.php 文件

template.php 文件中通常包含主題輸出的所有條件邏輯和數據處理。您也可以使用 template.php 文件使主題的 .tpl.php 文件保持整潔。因為這是一個 PHP 文件，強制以 PHP 打開?<?php?標記作為內容的開始，但您可以省略結束標記。

其他文件

有幾個其他元素對于主題正常運作不是必需的，但它們可能會在許多主題中出現。這些元素包括徽標和屏幕截圖、theme-settings.php 文件和 color.inc 文件：

• 徽標和屏幕截圖。這些元素是建議使用的元素，但對于主題的正常運作并不是絕對必要的。然而，如果您想將主題貢獻到 Drupal 存儲庫，那么屏幕截圖就是一個強制要求的元素。圖 3?是 Garland 主題的屏幕截圖。

  圖 3. Garland 主題的屏幕截圖

• theme-settings.php。除了搜索或任務徽標等一般設置外，該文件還顯示 UI 管理設置或高級特性。請查看針對 Garland 主題的該文件內容，如?清單 3?所示，說明了最終顯示。

  清單 3. Garland theme-settings.php 文件的內容

  <?php // $Id: theme-settings.php,v 1.3 2010/09/04 15:21:09 dries Exp $/*** @file* Theme setting callbacks for the garland theme.*//*** Implements hook_form_FORM_ID_alter().** @param $form* The form.* @param $form_state* The form state.*/ function garland_form_system_theme_settings_alter(&$form, &$form_state) {$form['garland_width'] = array('#type' => 'radios','#title' => t('Content width'),'#options' => array('fluid' => t('Fluid width'),'fixed' => t('Fixed width'),),'#default_value' => theme_get_setting('garland_width'),'#description' => t('Specify whether the content will wrap to a fixed width or will fluidly expand to the width of the browser window.'),// Place this above the color scheme options.'#weight' => -2,); }

  最終顯示的將是一個類似于?圖 4?的表單。

  圖 4. 主題設置頁面

• color.inc。color. module 的功能是允許管理員徹底改變主題的配色方案，而無需手動修改樣式表。如果您的主題需要配色模塊支持，那么您必須包括一個?color?目錄，其中包含 color.inc 文件和各種支持文件。

回頁首

構建主題

構建主題有兩個基本方法：您可以從頭開始構建它，您也可以修改一個現有主題。在本文中，您將從頭開始構建一個新主題。話雖如此，您還是應該準備好現有主題的內容，以便了解結構。

創建目錄結構

首先，創建一個包含主題文件的目錄。放置該目錄的最佳位置是 sites/all/themes 目錄。將該目錄命名為一個惟一的名稱以描述您的主題：該名稱不應該包含空格。

雖然不是強制性的，但是這對于為樣式表（CSS 文件）、圖像和腳本（如果您的主題使用它們）創建子目錄是有幫助的。這樣做有助于保持結構整潔。

回頁首

構建 .info 文件

.info 文件只是一個包含數據的文本文件，通常是描述主題的結構、內容和配置所需要的參數。在該文本文件中，每一行都有一個鍵值對，值放在等號 (=) 的右邊，鍵放在等號的左邊。清單 4?提供了一個示例。

清單 4. 來自 Garland 主題的 .info 文件的示例內容

; $Id: garland.info,v 1.10 2010/11/07 00:27:20 dries Exp $ name = Garland description = A multi-column theme that can be configured to modify colors andswitch between fixed- and fluid-width layouts package = Core version = VERSION core = 7.x stylesheets[all][] = style.css stylesheets[print][] = print.css settings[garland_width] = fluid; Information added by drupal.org packaging script on 2011-01-05 version = "7.0" project = "drupal"

您可以在一行的開頭使用分號 (;)，以添加注釋。使用方括號 ([]) 時，是為了創建關聯值的數組。讓我們詳細介紹在 .info 文件中必須或有可能包含的元素。

名稱

name?值是必需的。它應該是一個人類可讀的名稱，必須以字母字符開始。名稱的限制與 PHP 中構成函數的限制相同，因為 Drupal 將它用作同樣的用途。因此，該名稱可以包含數字和下劃線 (_)，但沒有連字符 (-)、空格或標點符號。下面是語法：

name = Garland

描述

description?鍵是建議使用的，它應該只是主題的簡要說明。您在此處輸入的描述出現在主題的選擇或?Appearance?頁面。下面是其語法：

description = A multi-column theme that can be configured to modify colorsand switch between fixed- and fluid-width layouts

屏幕截圖

screenshot?鍵是可選的。它的功能是告訴 Drupal 在哪里能找到新主題的縮略圖。Appearance?頁面上也將顯示縮略圖。如果 .info 文件中沒有包含這個鍵，Drupal 將調用默認主題目錄中的 screenshot.png 文件。如果您決定調用的縮略圖文件名稱不是?screenshot.png，或者，如果您將該文件放置主題主目錄以外的目錄，您將需要包括這個鍵。下面是其語法：

screenshot = /images/screenshot.png

要創建一個屏幕截圖，只需在瀏覽器中捕獲完整的主題圖像。然后，裁剪圖像并將其尺寸調整為 294 x219 像素，將它保存為 screenshot.png。把這個文件和 .info 文件放在同一文件夾中。

版本

盡管許多流行的主題都包括?version?關鍵，但我們并不鼓勵使用它。如果你打算將主題托管在 Drupal 主題存儲庫，就沒有必要包括?version，因為當一個發布被打包用于下載時，drupal.org 會自動添加版本字符串。否則，您可以包括自己喜歡的任何版本字符串。下面是其語法：

version = 1.0

核

core?鍵是必需的值。在所有目前受支持的 Drupal 版本中，您必須說明您的模塊和主題所兼容的 Drupal 版本。在這里設置的值將與 Drupal Core Compatibility 常數（可以在 include/bootstrap.inc 文件中找到）兼容；如果沒有找到匹配，則 Drupal 將禁用主題。下面是該常數的語法：

<?php define('DRUPAL_CORE_COMPATIBILITY', '7.x') ?>

drupal.org 打包腳本會根據每一個發布節點上的 Drupal 核心兼容性設置來自動設置這個值（如果您貢獻您的主題）。

引擎

engine?鍵表示您的主題所使用的主題引擎種類。在大多數情況下它是必需的。如果您在 .info 文件中沒有提供?engine，Drupal 假定主題是一個通過 .theme 文件實現的獨立主題。在 Drupal.org 庫中找到的大多數主題使用默認的?PHPTemplate?引擎，該引擎與 Drupal 核心一起打包。下面是其語法：

engine = phptemplate

基礎主題

如果您的主題是另一個主題的子主題，那么就一定要聲明其?base theme，以啟用主題繼承。換句話說，子主題中將可以使用基礎主題 (base theme) 的文件資源。您需要輸入基礎主題的內部機器可讀名稱。下面是其語法：

base theme = garland

區域

創建新的主題區域

您希望能夠在?Blocks?管理頁面上編輯的頁面的任何部分，都需要成為一個區域。通常情況下，這個區域包括標題、右側欄、內容區和頁腳。您必須在 .info 文件中引入您的所有區域。否則它們對于 Drupal 而言并不存在。

regions?鍵定義主題可用的塊區域。您必須明確定義?regions?鍵，然后定義在方括號中的內部機器可讀名稱。之后，您必須將人類可讀名稱定義為適當的值。下面是其語法：

regions[highlighted] =Mission Statement

如果您選擇不定義區域，在 Drupal 7 主題中假定使用以下值：

regions[header] = Header regions[highlighted] = Highlighted regions[help] = Help regions[content] = Content regions[sidebar_first] = Left sidebar regions[sidebar_second] = Right sidebar regions[footer] = Footer

您可以根據自己的特定需求覆蓋這些值。如果要這樣做，您必須聲明該行。下面是語法：

regions[highlighted] =Mission Statement

Features

您可以在主題的配置頁面上切換各種頁面元素。在主題配置頁面上所顯示的復選框由?features?鍵控制（見?圖 5）。因此，對于主題沒有定義或使用的元素，您可以禁止顯示其復選框。省略一個條目，就會禁止顯示該特性的復選框；如果您沒有定義任何特性，那么所有復選框都將顯示為假定的默認值。

圖 5. 主題特性設置頁面

清單 5?顯示?features?鍵的所有可用元素。

清單 5. 在 .info 文件中的主題特性條目

features[ ] = logo features[ ] = name features[ ] = slogan features[ ] = node_user_picture features[ ] = comment_user_picture features[ ] = favicon features[ ] = main_menu features[ ] = secondary_menu

樣式表

Drupal 主題曾經默認使用 style.css。然而，在當前版本中，如果未在 .info 文件中指定 style.css，則主題不再默認為 style.css。此外，您可以通過 .info 文件添加新的樣式表。下面是其語法：

stylesheets[all][] = css/style.css stylesheets[print][] = css/print.css

腳本

在主題的 template.php 文件中，通過調用?drupal_add_js()?等函數來包括 JavaScript 文件，這曾經是常見的做法。然而，在 Drupal 7 中，只有當您在 .info 文件指定 script.js 時，才會包括該文件。下面是其語法：

scripts[] = scripts/myscript.js

PHP

您在這里定義的字符串將是主題所支持的最低 PHP 版本。默認值來自?DRUPAL MINIMUM PHP?常數（位于 includes/bootstrap.inc 文件）：

<?php define('DRUPAL_MINIMUM_PHP', '5.2.4') ?>

您可以更改此值，但不需要添加字符串。下面是其語法：

php = 5.2.4

默認的 .info 值

.info 文件中包含 Drupal 為每個已安裝主題假設的默認值。如果在 .info 文件中沒有定義這些值，Drupal 強制主題使用默認值。但是請注意，這些值應用為一個組。這意味著，如果重寫一行，如：

regions[sub_header] = Sub-header

您將需要重新定義默認區域的其余部分；否則，它們將被省略。這條規則也適用于樣式表。即使樣式表在技術上并不是在一個組中進行定義的，但如果在 .info 文件中定義了另一個樣式表，您必須再次重新定義 style.css；否則，它將不會被包括在內。

在?清單 6?中的鍵和值是 Drupal 7 主題的默認值。

清單 6. 默認的 .info 值

regions[sidebar_first] = Left sidebar regions[sidebar_second] = Right sidebar regions[content] = Content regions[header] = Header regions[footer] = Footer regions[highlighted] = Highlighted regions[help] = Help regions[page_top] = Page Top regions[page_bottom] = Page Bottomengine = phptemplatefeatures[ ] = logo features[ ] = name features[ ] = slogan features[ ] = node_user_picture features[ ] = comment_user_picture features[ ] = favicon features[ ] = main_menu features[ ] = secondary_menuscreenshot = screenshot.png

回頁首

構建 page.tpl.php 文件

現在，研究典型的 page.tpl.php 文件的內容。圖 6?中的圖像來自 Garland 主題，顯示了源代碼在瀏覽器中的樣子。

圖 6. 在瀏覽器中的 page.tpl.php 源代碼

若您更仔細地查看，page.tpl.php 模板只是一個簡單的 HTML 頁面，其中有大量 PHP 語句。很方便，已經為 Drupal 定義了大部分 PHP 元素，您需要做的就是按需要放置它們。

注：鏈接?http://drupal.org/node/190815 [Core Templates]?將為您提供 page.tpl.php 模板可用的變量列表。

對基本頁面元素添加變量

有若干個變量可用于構建 page.tpl.php。選擇包括哪些變量，取決于您想在主題中實現的功能。例如，如果您選擇在您的網頁上要有面包屑，請添加?$breadcrumbs?變量。

在 page.tpl.php 中最常見的變量是：

• $site_name
• $logo（通過主題設置標志上傳的徽標；僅在實現徽標主題特性時才有用）
• $title（頁面標題）
• $main_menu
• $secondary_menu
• $breadcrumbs（導航輔助，當用戶更深入網站時留下一串參考鏈接）

Drupal 管理也有相關的變量：

• $tabs（用于編輯或查看管理菜單等的菜單；經常由模塊使用）
• $messages
• $action_links

其他一些有用的變量是：

• $base_path（站點 root 的路徑）
• $front_page（站點首頁的路徑）
• $directory（您的主題的路徑）

使用 Render 應用程序編程接口 (API) 插入變量，如下：

<?php print render($tabs); ?>

如果您的 PHP 和 HTML 技能都較高，您顯然可以通過觀察示例的構建方式，然后使用允許的變量來明顯創建自己的卓越主題。

回頁首

構建其他模板文件

打印或渲染

有些變量需要使用?render()?函數顯示，而其他變量可以簡單地打印。如果數組中包含了在 page.tpl.php 參考頁（見?參考資料?中的鏈接）中列出的變量，那么您需要使用?render()?方法。否則，您可以打印該變量 (<?php print $variable; ?>)。

隨 Drupal 核心提供的還有其他可用的主題文件的默認模板。您可以在 Drupal 站點（見?參考資料?中的鏈接）找到它們的列表。對于 page.tpl.php 文件，要輕松構建屬于自己的文件，最佳方式是找到一個核心文件，觀察它是如何組成的，然后再構建您自己的。訪問 Drupal 站點將為您指出允許在任何主題文件中使用的變量。

回頁首

style.css 文件

在一個普通的靜態 HTML 頁面中，您必須在頁頭中包括一個指針，以說明用于頁面顯示的樣式表的位置。指針看起來像這樣：

<link rel="stylesheet" type="text/css" href="/model.css" />

如前所述，您可以將新的樣式表添加到一個主題，也可以覆蓋默認樣式。在這兩種情況下，你必須在 .info 文件中輸入主題樣式表。樣式表中有什么呢？您對 CSS 類所使用的模塊化方法，與 Drupal 核心對框架的標準頁面元素所使用的模塊化方法相同。即使主題開發人員可以創建自己的類，但在整個 Drupal 站點有許多類。如需要有關 Drupal 7 核心中的類的完整列表，請參閱?參考資料。

回頁首

結束語

本文為您概述了主題系統在 Drupal 7 中的運作方式，還介紹了 Drupal 主題的多個組件，以及如何使用默認的?PHPTemplate?主題引擎從頭開始構建一個新的主題。您已經觀看了每個組件主題文件的典型結構，現在應該了解了創建自定義主題所需要的技巧。開始做您喜歡的事情吧！

總結

以上是生活随笔為你收集整理的为 Drupal 7 构建一个新主题的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。