Mambo 開源/建立自己的模板
| 目錄 |
|---|
| 章節 |
| 首頁 |
| 配置 |
| 設計 |
| 內容 |
| 開發 |
| 雜項 |
本文件是一個關於如何從頭開始建立模板的教程。
模板 位於目錄 /mambo_dir/templates 中。以下是一個
模板目錄的典型結構
/templates /basic_template /css template_css.css /images index.php template_thumbnail.png templateDetails.xml
其中每個檔案都是
- index.php
- 模板佈局檔案。
- template_css.css
- 模板的 CSS 樣式表。
- templateDetails.xml
- XML 格式的元資料檔案。
- template_thumbnail.png
- 模板的縮圖截圖(140px 寬 x 90px 高)
要製作模板,這是所需的最小檔案集。MOS 的核心指令碼 期待這些檔名。請注意,雖然 /images 目錄中沒有顯示任何影像,但通常您會將模板的任何支援影像(如背景、橫幅等)放在這裡。
Mambo 模板正常執行需要一些基本檔案。
首先,在您站點的 templates 目錄中為您的模板建立一個資料夾。給它一個合適的名稱,例如“myfirst”或“corporate_yellow”(任何名稱都可以),然後開啟它。這是您的模板的根資料夾。
然後建立一個名為“templateDetails.xml”的檔案。此檔案包含有關您模板的所有技術資訊,現在應該看起來像這樣(它將在後面擴充套件)
<?xml version="1.0" encoding="iso-8859-1"?>
<mosinstall type="template">
<name>Myfirst</name>
<creationDate>16/04/2005</creationDate>
<author>Your name</author>
<copyright>GPL</copyright>
<authorEmail>mail@something.com</authorEmail>
<authorUrl>www.yourhomepage.com</authorUrl>
<version>1.0</version>
<description>A little description.</description>
<files>
<filename>index.php</filename>
<filename>template_thumbnail.png</filename>
</files>
<images>
<filename>images/image.gif</filename>
</images>
<css>
<filename>css/template_css.css</filename>
</css>
</mosinstall>
此檔案是 Mambo 的參考,顯示了模板的名稱以及所有其他檔案的名稱。如您所見,它引用了一個 php 檔案、一些影像和一個 CSS 檔案。
並非所有欄位都是必需的,但請儘可能多地使用它們。
現在,您可以開始使用 index.php 檔案。您將在其中放置所有 HTML 程式碼,並且它將成為模板的主要輸出源。建立名為 index.php 的檔案並開啟它。這是 Mambo 操作所需的該檔案的基本內容
<?php
defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' );
$iso = split( '=', _ISO );
echo '<?xml version="1.0" encoding="'. $iso[1] .'"?' .'>';
?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<?php if ( $my->id ) initEditor(); ?>
<meta http-equiv="Content-Type" content="text/html; <?php echo _ISO; ?>" />
<?php mosShowHead(); ?>
<link rel="stylesheet" type="text/css" href="<?php echo $GLOBALS['mosConfig_live_site']; ?>/templates/yourtemplatesname/css/template_css.css" />
</head>
<body>
</body>
</html>
假設您瞭解基本的 HTML,您應該知道內容和模板本身應該放在模板的 <body> 標記中。在這裡,您可以使用任何您喜歡的用於內容組織的方法,例如 div 標記或表格。在本例中,我將使用表格。
這是我的計劃佈局
| 站點名稱 | ||
| 路徑/麵包屑 | ||
| 左側模組 |
主要內容 更多主要內容
|
右側模組 |
| 帶有版權資訊的頁尾 | ||
這是此佈局的 HTML 程式碼,要放在 body 標記中
<table width="700" border="0" cellpadding="0" cellspacing="0">
<tr align="center">
<td height="50" colspan="3">SITE NAME </td>
</tr>
<tr align="center">
<td colspan="3">Pathway/breadcrumb</td>
</tr>
<tr>
<td width="150" valign="top">Left modules</td>
<td width="400" valign="top"><p>Main content</p>
<p>More main content</p></td>
<td width="150" valign="top">Right modules </td>
</tr>
<tr align="center">
<td colspan="3">Some footer text. </td>
</tr>
</table>
您可以看到此佈局中包含一些簡單的靜態文字,例如“左側模組”和“一些頁尾文字”。現在我將使用動態 Mambo 變數替換這些文字。
Mambo 有一個用於站點名稱的變數,該變數主要用於頁面標題以及使用 Mambo 傳送電子郵件等。此變數也可以在模板中回顯,這就是這裡要做的。當然,您也可以直接在模板中寫入站點名稱,但這最好使用此變數,因為它使模板更具動態性。
這是變數的樣子
$GLOBALS[mosConfig_sitename]
現在,在將 php 程式碼插入模板時,需要使用 php 標記,這樣 PHP 才能將變數渲染成它的樣子。然後它會看起來像這樣
<?php echo $GLOBALS[mosConfig_sitename] ?>
將此行放在模板中,代替現在那裡的 SITE NAME 文字。
路徑使用類似的 dsg
<?php dsf?>
在佈局中,您可以看到一個名為左側和右側模組的內容。這是 Mambo 的核心功能,用於放置小的“框”或模組,例如主選單、使用者登入、新聞快訊、最受歡迎的專案等等。術語左側和右側僅僅是不同的模組位置,可以在 Mambo 中選擇。
無論如何,這是程式碼
用此替換“左側模組”文字
<?php mosLoadModules ( 'left' ); ?>
右側模組非常相似
<?php mosLoadModules ( 'right' ); ?>
我在這裡不會過多解釋,只是說明這樣做的方式與上述內容相同;將它插入您想要顯示主要內容的地方
<?php mosMainBody(); ?>