我们目标:创建一个带有区块(Block)的模块(Module)
我们建立一个简单模块,模块会用到内建的区块子系统(Block Sub-system)来添加一个自定义区块,这个区块显示当前Drupal中已经激活的模块列表。
我们将分成三个部分:
- 创建一个新模块的目录和文件
- 调用区块子系统(Block Sub-system)
- 利用Drupal 8内建的简单测试框架(SimpleTest testing framework),写一个自动测试功能。
建立一个新模块(Module)
创建Drupal模块是一件很简单的事,简单到不需要是 php 专家,这里我们只需要建立几个目录和3个小文件就可以
模块名字
我们需要给模块命名2个名字:
- 机器识别名(a machine-readable name):这名字在Drupal内部使用。它只能由大小写字母(a-zA-Z)和下划线(_)组成(大多数是还是只用小写和下划线)
- 人可识别名(a human-readable name):这个名字会显示在模块列表页面,一般会一个或几个简单单词组成。
为了方便,这2个名字尽量类似。一般机器识别名遵循规则:人可识别名里的空格用下划线代替,大写字母用小写字母替换
模块保存哪里?
Drupal 8的核心模块都在 /core 文件夹下,我们不要去触碰这个文件夹
我们把模块放在 /modules 文件夹下。虽然可以直接把模块放在modules下面,强烈建议,在 modules下建立 contrib 和 custom 二个子文件夹,用以区分模块来源,方便管理。在 contrib文件夹里的模块是来源于drupal.org网站上的非核心模块,custom文