You are here

Drupal专业开发指南 第14章 添加、修改、和删除词汇表

g089h515r806 的头像
Submitted by g089h515r806 on 星期五, 2009-08-21 15:54

老葛的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。

Drupal版本: