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>[email protected]</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(); ?>

页脚