華燈初上

文章說明

　　本文源自 Joomla! 社群雜誌 2012 年 5 月號〈How to convert Joomla 1.5 template to Joomla 2.5 template〉一文，本文章內圖片皆來自原始文章，在此僅作內文說明之用。

轉換前提及流程簡介

　　本文假設你擁有有 Joomla! 1.5 與 2.5 建置的網站，以 Joomla! 1.5 前台佈景主題「rhuk_milkyway」作為轉換示範。轉換流程分為 5 個階段：
Phase 1：複製 Joomla! 1.5 佈景主題所有檔案。
Phase 2：編輯檔案結構。
Phase 3：編輯「templateDetails.xml」檔案
Phase 4：編輯「index.php」檔案
Phase 5：安裝、測試轉換後的佈景主題。

複製 Joomla! 1.5 佈景主題所有檔案。

　　請先在 Joomla! 2.5 前台佈景主題資料夾中建立新資料夾（例如「rhuk_milkyway25」），接著把要轉換的 Joomla! 1.5 佈景主題中的所有檔案╱資料夾複製過去。

編輯檔案結構。

　　因應 Joomla! 2.5 在佈景主題格式上的變更，在檔案結構做新增與刪減動作。

Step 01：刪掉「params.ini」檔案：Joomla! 2.5 的參數設定值改寫在資料庫中，不需要該檔案了。

Step 02：自「atomic」佈景主題複製「error.php」：「error.php」 是 Joomla! 2.5 佈景主題中用來規劃錯誤訊息頁面呈現的檔案，你可從「atomic」這個精簡的佈景主題中複製過來使用。

Step 03：建立新檔案「template_preview.png」：「template_preview.png」是作為較大張佈景主題預覽圖片，請準備尺寸為 640 x 480 圖素的 PNG 格式圖片並命名為「template_preview.png」。

編輯「templateDetails.xml」檔案

　　編輯「templateDetails.xml」檔案已符合 Joomla! 2.5 在佈景主題上的要求。

Step 01：變更 <install> 標籤及參數為 <extension> 標籤。

Step 02：變更 <name> 標籤內容，例如變更為「rhuk_milkyway25」。

Step 03：將多個 <filename> 標籤更改為單一 <folder> 標籤：如果有多個檔案位於同資料夾中，在 Joomla! 2.5 不用一一敘述，用一個 <folder> 標籤就搞定。

Step 04：刪除「params.ini」檔案敘述，新增「error.php」與「template_preview.png」檔案敘述。

Setp 05：更改 <params> 標籤及其中內容

編輯「index.php」檔案

　　完成「templateDetails.xml」檔案變更後要再修改「index.php」檔案。

Step 01：增加 PHP 程式碼，載入 Mootools 函式庫：在如下圖所示位置加入「JHtml::_('behavior.framework', true);」程式碼。

Step 02：以 PHP 程式碼取代佈景主題名稱：在 Joomla! 2.5 可以自「templateDetails.xml」檔案取得佈景主題名稱，不需要在「index.php」檔案中寫佈景主題名字了。

安裝、測試轉換後的佈景主題。

　　你已完成佈景主題修改工作，但是 Joomla! 2.5 還找不到她…別擔心，透過以下步驟就能完成。

Step 01：前往 Joomla! 2.5 後台，選擇「擴充套件管理」捷徑圖示，接著選擇「探索」分頁。

Step 02：選擇工具列上的「探索」圖示。

Step 03：畫面上會顯示「rhuk_milkyway25」項目，選擇該項目後選擇工具列「安裝」圖示。

Step 04：你可以到「佈景主題管理」畫面將轉換過後的佈景主題設為預設，看看呈現結果。