Drupal 7 模 .info 文件描述

2019-04-14 21:29发布

Drupal使用.info文件以节省话题(theme)和模块(modules)基本数据(metadata)。 编码:推荐使用UTF-8。这是一个没有BOM(Byte Order Mark)。 下面是一个.info的样例 name = Really Neat Widget description = Provides a really neat widget for your site's sidebar. core = 7.x package = Views dependencies[] = views dependencies[] = panels files[] = tests/example.test 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 name = Really Neat Widget
description (推荐)
最好写一下,用一行简单说明模块用途。最多255字符description = Provides a really neat widget for your site's sidebar.
说明里能够包含链接,这样能够非常方便让使用者链接到指定页面。了解很多其它模块的信息和使用。 description = Domain manager by Peter Moulding .com.
core (必须)
你模板适用的Drupal版本号。假设是Drupal 7就写 7.x。注意版本号不能指定子版本号。写7.12不对 core = 7.x
stylesheets (可选)
假设你每页都须要用到CSS文件。Drupal 7同意你在这里加入。格式能够參考主题(theme)里的 .info stylesheets[all][] = node.css
scripts (可选)
假设你每页都须要用到Javascript文件,你能在这里加入。 scripts[] = somescript.js 很多其它信息,能够參考 Drupal 7中Javascript的管理
files (可选)
Drupal 如今支持动态加载代码注冊表。为了支持这个功能。全部模块必须在.info文件里事先预读那些包括类(classes)和接口(interface)声明的代码文件。 files[] = tests/example.test
当一个模块激活(enabled)后。Drupal将会又一次扫描全部files里声明的文件,索引全部能找到的类(classes)和接口(interface)。当类第一次被訪问到,它就会自己主动被PHP加载。
dependencies (可选)
执行模块时所要求其它模块支持 dependencies[] = view dependencies[] = panels
注:这里尽管仅仅用到了模块 View 和 Panels,只是他们会用到模块Chaos tools,所以会自己主动增加。 假设你要指定须要某个版本号的模块,你能够用下面表达方法 dependencies[] = modulename (major.minor)
major是数字表达主版本。minor能够是数字或字母表示次版本。.x能够用来表示不论什么次版本。下面样例 dependencies[] = exampleapi (1.x) test_dependencies[] = autoload (>7.x-1.5)
以上样例中,模块安装Example API主板1,不论什么次版本模块(如1.0, 1.1, 1.2-beta4 etc.) .info文件中的dependencies[]属性还同意选择指定的版本号
  • = or == 等于 (可选择:默认是等号)
  • > 大于
  • < 小于
  • >= 大等于
  • <= 小等于
  • != 不等于
版本大于1.0 dependencies[] = exampleapi (>1.0)
版本要求7.x兼容,而且大于1.5 dependencies[] = exampleapi (>7.x-1.5)
另外还支持多版本号依赖,用逗号分开 dependencies[] = exampleapi (>1.0, <=3.2, !=3.0)
还能用系统(system)作为模块名。来指定最小Drupal核心版本号。本模块最少执行在Drupal 7.53。 dependencies[] = system (>=7.53)
package (可选)
为模块归类,方便查找。假设不写,就会在 Others。注意这里大写和小写敏感。Views和views是两类。这里不应该用标点符号。 package = Views

php (可选)
指定模板执行最低的PHP版本号 php = 5.3
譬如这里就表示模块不能执行在5.3曾经的版本号。假设不写,就是用和Drupal同样的版本号。有时用新版本号PHP的一些特性。当模块须要用比核心要求更新的版本号,这里才会凝视。
version (不鼓舞)
假设模块公布到drupal.org,他们会给你一个版本字符串。假设你仅仅是自己写的,能够写自己想要的版本,或者不写。 由于这里我是自己写的,没有给版本,所以是空的。
configure (可选)
显示模块配置页面的的路径。当模块激活后。“配置(Configurre)”和“权限(Permission)”链接就会显示出来。这个链接就连到模块配置的概述(Overview)页面 configure = admin/config/content/example
点 Confirgure,就会跳转到 admin/config/content/example,配置这个模块。
required (可选)
假设模块绝对须要并不能被关闭,就要写: required = TRUE这些模块在Drupal安装时候就被自己主动激活(enabled)。这一般用Drupal的核心模块(譬如:节点(Node)、用户(User)等)
hidden (可选)
假设模块或者主题不可看见就设置 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} ,这个样例里。 project status url = http://my.domain.com/projects
參考并做了改动: https://www.drupal.org/node/542202
 版权声明:本文博客原创文章,博客,未经同意,不得转载。