跳轉到內容

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

[編輯 | 編輯原始碼]

然後建立一個名為“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

[編輯 | 編輯原始碼]

現在,您可以開始使用 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(); ?>
華夏公益教科書