老葛的Drupal培训班 Think in Drupal
下面的函数用于创建、修改、和删除词汇表。它们返回一个状态代码,代码为Drupal常量SAVED_UPDATED、SAVED_NEW、或SAVED_DELETED中的一个。
taxonomy_save_vocabulary(&$vocabulary)
这个函数用来创建一个新的词汇表或者更新一个已有的词汇表。参数$vocabulary是一个关联数组(注意它不是一个词汇表对象!),包含以下键:
• name: 词汇表的名字。
• description: 词汇表的描述。
• help: 一个帮助文本,在节点创建表单中,它显示在这个词汇表字段的下面。
• nodes: 一个数组,包含了这个词汇表适用的所有节点类型。
• hierarchy: 0表示没有层级,1表示单个层级,2表示多个层级。
• relations: 0表示禁用相关术语, 1表示允许相关术语。
• tags: 0表示禁用自由标签化, 1表示启用自由标签化。
• multiple: 0表示禁用术语的多选,1表示启用多选。
• required: 0表示节点被提交前术语是可选的(这将引入一个默认的“没有选择任何选项”术语), 1表示节点提交前术语是必选的。
• weight: 词汇表的重量;它影响它在节点提交表单的词汇表字段集里面的位置。
• module: 负责这个词汇表的模块的名字。如果没有传递这个键,那么它的值默认为taxonomy。
• vid: 词汇表ID。如果没有传递这个键,那么将创建一个新的词汇表。
taxonomy_save_vocabulary(&$vocabulary)函数返回SAVED_NEW 或者 SAVED_UPDATED。
taxonomy_del_vocabulary($vid)
这个函数的参数$vid是词汇表的ID。删除一个词汇表的同时,会删除词汇表中的所有术语,通过为每个术语调用taxonomy_del_term()来删除术语。taxonomy_del_vocabulary($vid)函数返回SAVED_DELETED。