文章說明
本文源自 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> 標籤。
原內容 | 新內容 |
<install version="1.5"... | <extension version="2.5"... |
</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> 標籤及其中內容
原內容 | 新內容 |
<params> | <config> <fields name="params"> <fieldset name="advanced"> |
<param... | < field... |
</param> | </ field> |
</params> | </fieldset> </fields> </config> |
編輯「index.php」檔案
完成「templateDetails.xml」檔案變更後要再修改「index.php」檔案。
Step 01:增加 PHP 程式碼,載入 Mootools 函式庫:在如下圖所示位置加入「JHtml::_('behavior.framework', true);」程式碼。
Step 02:以 PHP 程式碼取代佈景主題名稱:在 Joomla! 2.5 可以自「templateDetails.xml」檔案取得佈景主題名稱,不需要在「index.php」檔案中寫佈景主題名字了。
原內容 | 新內容 |
rhuk_milkyway. | <?php echo $this->template ?> |
安裝、測試轉換後的佈景主題。
你已完成佈景主題修改工作,但是 Joomla! 2.5 還找不到她…別擔心,透過以下步驟就能完成。
Step 01:前往 Joomla! 2.5 後台,選擇「擴充套件管理」捷徑圖示,接著選擇「探索」分頁。
Step 02:選擇工具列上的「探索」圖示。
Step 03:畫面上會顯示「rhuk_milkyway25」項目,選擇該項目後選擇工具列「安裝」圖示。
Step 04:你可以到「佈景主題管理」畫面將轉換過後的佈景主題設為預設,看看呈現結果。