发布于 2014-09-28 03:13:28 | 201 次阅读 | 评论: 0 | 来源: 网友投递

这里有新鲜出炉的精品教程,程序狗速度看过来!

Drupal开源内容管理框架

Drupal是使用PHP语言编写的开源内容管理框架(CMF),它由内容管理系统(CMS)和PHP开发框架(Framework)共同构成。连续多年荣获全球最佳CMS大奖,是基于PHP语言最著名的WEB应用程序。


本文为大家讲解的是Drupal的主题/模块配置文件(.info)相用方法,Drupal使用.info文件来保存关于主题(theme)和模块(modules)的基本数据(metadata)。感兴趣的同学参考下。

Drupal是使用PHP语言编写的开源内容管理框架(CMF),它由内容管理系统(CMS)和PHP开发框架(Framework)共同构成。连续多年荣获全球最佳CMS大奖,是基于PHP语言最著名的WEB应用程序。

编码:推荐使用UTF-8,就是不带BOM(Byte Order Mark)。

以下是一个.info的例子

 
  1. name = Really Neat Widget  
  2. description = Provides a really neat widget for your site's sidebar.  
  3. core = 7.x  
  4. package = Views  
  5. dependencies[] = views  
  6. dependencies[] = panels  
  7. files[] = tests/example.test  
  8. configure = admin/config/content/example  

他包括的属性有:

  • name 必须
  • description 推荐
  • core 必须
  • stylesheets
  • scripts
  • files
  • dependencies
  • package
  • php
  • version 不鼓励
  • configure
  • required
  • hidden
  • project 不鼓励,仅适合封装时使用
  • project status url 仅用在不提交到drupal.org上的订制模块。

解释一下:

name (必须)

这个将显示模块的名称,写成可读性强的,这里不要写成 really_neat_widget

 
  1. name = Really Neat Widget  

description (推荐)

最好写一下,用一行简单说明模块用途。最多255字符

 
  1. description = Provides a really neat widget for your site's sidebar.  

说明里可以包括链接,这样可以很方便让使用者链接到指定页面,了解更多模块的信息和使用。

 
  1. description = Domain manager by <a href="http://petermoulding.com">Peter Moulding .com</a>.  

core (必须)

你模板适用的Drupal版本。如果是Drupal 7就写 7.x。注意版本不能指定子版本。写7.12不正确

 
  1. core = 7.x  

stylesheets (可选)

如果你每页都需要用到CSS文件,Drupal 7允许你在这里添加。格式可以参考主题(theme)里的 .info

 
  1. stylesheets[all][] = node.css  

scripts (可选)

如果你每页都需要用到Javascript文件,你能在这里添加。

 
  1. scripts[] = somescript.js  

更多信息,可以参考 Drupal 7中Javascript的管理

files (可选)

Drupal 现在支持动态载入代码注册表。为了支持这个功能,所有模块必须在.info文件中事先预读那些包含类(classes)和接口(interface)声明的代码文件。

 
  1. files[] = tests/example.test  
当一个模块打开(enabled)后,Drupal将会重新扫描所有files里声明的文件,索引所有能找到的类(classes)和接口(interface)。当类第一次被访问到,它就会自动被PHP载入。

dependencies (可选)

运行模块时所要求其他模块支持

 
  1. dependencies[] = view  
  2. dependencies[] = panels  

 

注:这里虽然只用到了模块 View 和 Panels,不过他们会用到模块Chaos tools,所以会自动加入。

如果你要指定需要某个版本的模块,你可以用以下表达方法

 
  1. dependencies[] = modulename (major.minor)  

major是数字表达主版本号,minor可以是数字或字母表示次版本号。.x可以用来表示任何次版本号。以下例子

 
  1. dependencies[] = exampleapi (1.x)  
  2. test_dependencies[] = autoload (>7.x-1.5)  

以上例子中,模块安装Example API主板1,任何次版本号模块(如1.0, 1.1, 1.2-beta4 etc.)

.info文件里的dependencies[]属性还允许选择指定的版本

  • = or == 等于 (可选择:默认是等号)
  • > 大于
  • < 小于
  • >= 大等于
  • <= 小等于
  • != 不等于

版本号大于1.0

 
  1. dependencies[] = exampleapi (>1.0)  

版本号要求7.x兼容,并且大于1.5

 
  1. dependencies[] = exampleapi (>7.x-1.5)  

另外还支持多版本依赖,用逗号分开

 
  1. dependencies[] = exampleapi (>1.0, <=3.2, !=3.0)  

还能用系统(system)作为模块名,来指定最小Drupal核心版本。本模块最少运行在Drupal 7.53。

 
  1. dependencies[] = system (>=7.53)  

package (可选)

为模块归类,方便查找。如果不写,就会在 Others。注意这里大小写敏感,Views和views是两类。这里不应该用标点符号。

 
  1. package = Views  

php (可选)

指定模板运行最低的PHP版本

 
  1. php = 5.3  

譬如这里就表示模块不能运行在5.3以前的版本。如果不写,就是用和Drupal相同的版本。有时用新版本PHP的一些特性,当模块需要用比核心要求更新的版本,这里才会注释。

version (不鼓励)

如果模块发布到drupal.org,他们会给你一个版本号字符串。如果你只是自己写的,可以写自己想要的版本号,或者不写。

因为这里我是自己写的,没有给版本号,所以是空的。

configure (可选)

显示模块配置页面的的路径。当模块打开后,“配置(Configurre)”和“权限(Permission)”链接就会显示出来。这个链接就连到模块配置的概述(Overview)页面

 
  1. configure = admin/config/content/example  

点 Confirgure,就会跳转到 admin/config/content/example,配置这个模块。

required (可选)

如果模块绝对需要并不能被关闭,就要写:

 
  1. required = TRUE  
这些模块在Drupal安装时候就被自动打开(enabled)。这一般用Drupal的核心模块(譬如:节点(Node)、用户(User)等)

hidden (可选)

如果模块或者主题不可看见就设置

 
  1. hidden = TRUE  

一般这是用在测试模块

project (不鼓励,仅适合封装时使用)

模块维护人员不能使用这个属性。当代码上传drupal.org,他们会自动在这里分配字符串。这设置主要为了配合升级状态(Update status)模块,以致于能监控版本升级,提醒管理员有新版本可以使用。

project status url (仅用在不提交到drupal.org上的订制模块)

允许模块维护人员定义一个URL,让升级状态(Update status)模块来检查他们模块是否需要升级。如果模块没有在drupal.org上发布,应该在这里定义参数。URL应该指向一个XML格式,这个 XML要放在 http://my.domain.com/projects/{project}/{core} ,这个例子里,

 
  1. project status url = http://my.domain.com/projects  

 



最新网友评论  共有(0)条评论 发布评论 返回顶部

Copyright © 2007-2017 PHPERZ.COM All Rights Reserved   冀ICP备14009818号  版权声明  广告服务