欢迎莅临阿Q的项目

专业WP商业设计开发销售中心

[手册]Drupal 7 主题模板制作指南

Drupal是一个开源的内容管理系统(CMS) 平台,它是用PHP写成的。主要用于构造提供多种功能和服务的动态网站,这些功能包括用户管理(UserAdministration)、发布工作流 (Publishing Workflow)、讨论、新闻聚合(NewsAggregation)、元数据(Metadata)操作和用于内容共享的XML发布。Drupal有一个优秀的模块化结构,提供了许多模块,包括短消息、个性化书签、网站管理、Blog、日记、电子商务、电子出版、留言簿、Job、网上电影院、论坛、投票 等模块。并且Drupal模块的下载、安装、定制非常方便。

drupal核心的模板和建议

原文:http://drupal.org/node/190815

译者:葛红儒, Think in Drupal,

drupal默认模板:

这些为drupal内核提供的默认模板(.tpl.php)文件.drupal模板文件内部包含了相应变量和模板用途的文档.这有对于所有模板都可用的默认变量集.

由PHPTemplate在5.x中处理的模板,也被删除了. PHPTemplate不再处理模板文件.

为了覆写这些模板,你只需要将其拷贝到你的主体目录下,并清空drupal主题注册表.

drupal Aggregator(聚合器)

"modules/aggregator/..."

drupal Block (区块)

"modules/system/..."

"modules/block/..."

Book (书)

"modules/book/..."

Comment (评论)

"modules/comment/..."

drupal Forum (论坛)

"modules/forum/..."

drupal Node (节点)

"modules/node/..."

drupal Poll (投票)

"modules/poll/..."

drupal Profile (外形)

"modules/profile/..."

drupal Search (搜索)

"modules/search/..."

User (drupal用户)

"modules/user/..."

System (drupal系统模块)

"modules/system/..."

drupal模板建议

建议只有和基模板放在同一个目录下面时,才能工作.换句话说,为了让comment-blog.tpl.php正常工作,你需要把comment.tpl.php也放到同一个目录下.

下面列出的为默认建议.如果你想定制的话,可参看使用模板建议一页.

block-[region|[module|-delta]].tpl.php

基模板: block.tpl.php

默认建议及顺序:

  1. block-module-delta.tpl.php
  2. block-module.tpl.php
  3. block-region.tpl.php

"module"为模块名称,而"delta"为模块分配给该区块的内部id.例如, "block-user-1.tpl.php"将用于默认用户导航区块,因为该区块由user模块创建,且内部id为1. "region"将对特定区域产生作用.

comment-[type].tpl.php

基模板: comment.tpl.php

默认建议为comment-type.tpl.php,它用于特定节点类型的评论格式,以区别站内的其它评论.与node-[type].tpl.php类似,但是它用于评论.

comment-wrapper-[type].tpl.php

基模板: comment-wrapper.tpl.php

与前者类似,但是用于包装器(wrapper)模板.

forums-[[container|topic]-forumID].tpl.php

基模板: forums.tpl.php

默认模板建议及顺序。

对于论坛容器

  1. forums-containers-forumID.tpl.php
  2. forums-forumID.tpl.php
  3. forums-containers.tpl.php

对于论坛话题:

  1. forums-topics-forumID.tpl.php
  2. forums-forumID.tpl.php
  3. forums-topics.tpl.php

maintenance-page-[offline].tpl.php

基模板: maintenance-page.tpl.php

当数据库不可用时,应用该模板建议.用来为用户展示一个不带错误信息的页面.首先需要设置维护页面的主题化.

node-[type].tpl.php

基模板: node.tpl.php

节点类型,例如"node-story.tpl.php", "node-blog.tpl.php",等等.

page-[front|internal/path].tpl.php

基模板: page.tpl.php

可以有无数个建议.具有优先级的为首页(front page).剩下的都是基于当前页面的内部路径。不要将内部路径和路径别名混淆了,这里不能使用路径别名。记住,通常使用pathauto.module来设置路径别名。

可通过"Administrator > Site configuration > Site information"来设置首页。对于设置好的首页,将会为其使用"page-front.tpl.php"模板。

下面为drupal模板建议文件,根据内部路径,越特殊的次序越靠前。如果系统为当前页面找到了一个模板建议的话,就不会再调用位于它后面的模板建议了。例如,对于http://www.example.com/node/1/edit,将会有下面的建议可用:

  1. page-node-edit.tpl.php
  2. page-node-1.tpl.php
  3. page-node.tpl.php
  4. page.tpl.php

poll-results-[block].tpl.php

基模板: poll-results.tpl.php

生成投票结果的主体函数,可供节点和区块共同使用。默认是用于节点的,但是drupal模板建议使得可以用在区块区域中。这个建议是默认的,它位于"modules/poll/poll-results-block.tpl.php"。

poll-vote-[block].tpl.php

基模板: poll-vote.tpl.php

与poll-results-[block].tpl.php类似,但用来生成投票表单。你必须自己为其提供drupal模板,以让其生效。

poll-bar-[block].tpl.php

基模板: poll-bar.tpl.php

与poll-vote-[block].tpl.php一样,但是用来生成单个的bars(细长条纹)。

profile-wrapper-[field].tpl.php

基模板: profile-wrapper.tpl.php

这个profile包装器模板,是在浏览会员列表页面时使用的。当浏览特定的字段时,在模板建议中需要使用字段名称。例如http://drupal.org/profile/country/Belgium使用的模板为"suggest profile-wrapper-country.tpl.php"。

search-results-[searchType].tpl.php

基模板: search-results.tpl.php

search-results.tpl.php是搜索结果的默认包装器。根据搜索类型的不同,使用不同的建议。例如,对于"example.com/search/node/Search+Term",将使用"search-results-node.tpl.php"。而对于"example.com/search/user/bob",则使用"search-results-user.tpl.php"。模块可以扩展搜索类型,并为其添加更多的建议。

search-result-[searchType].tpl.php

基模板: search-result.tpl.php

与前者相同,但是用于单个的搜索结果。

原文:http://drupal.org/node/190815

译者:葛红儒, Think in Drupal

如果喜欢本文,请分享给朋友们