zoukankan      html  css  js  c++  java
  • Drupal 7 模 .info 文件描述

    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 <a href="http://petermoulding.com">Peter Moulding .com</a>.
    

    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

    

    版权声明:本文博客原创文章,博客,未经同意,不得转载。

  • 相关阅读:
    nodeJS + webStrome
    js获取浏览器窗口属性
    理解JavaScript中的arguments,callee,caller,apply
    Java对象及对象引用变量
    Transform-style和Perspective属性
    线程同步的几种方式
    SQL高级查询——50句查询(含答案)
    接口、抽象类的区别与共同点
    JAVA异常架构图及常见面试题
    【转】JVM介绍
  • 原文地址:https://www.cnblogs.com/lcchuguo/p/4676593.html
Copyright © 2011-2022 走看看