老葛的Drupal培训班 Think in Drupal
下面的函数用于创建、修改、和删除术语。它们返回一个状态代码,代码为Drupal常量SAVED_UPDATED、SAVED_NEW、或SAVED_DELETED中的一个。
taxonomy_save_term(&$term)
这个函数创建一个新的术语或者更新一个已有的术语。参数$term是一个关联数组(注意它不是一个术语对象!),包含以下键:
• name: 术语的名字。
• description: 术语的描述。Drupal的默认用户界面中用不到该值,但是可能在你的模块中或者其它的第3方模块中用到它。
• vid: 术语所在词汇表的ID。
• weight: 术语的重量。它影响术语下拉选择框中各个术语的相对位置。
• relations: 一个可选的数组,包含了相关术语的ID。
• parent: 既可以是一个字符串,用来代表父术语的术语ID;也可以是一个数组,其元素既可以是字符串,也可以是子数组,其中字符串为用来代表父术语的术语ID,子数组则是包含这样字符串的数组。
• synonyms: 一个可选的字符串,包含了以换行字符(\n)分隔的同义词。
• tid: 术语的ID。如果没有传递这个键,那么将创建一个新的术语。
这个函数返回SAVED_NEW 或者 SAVED_UPDATED。
taxonomy_del_term($tid)
taxonomy_del_term($tid)函数用来删除一个术语;参数$tid是术语ID。如果一个术语是在一个分层级的词汇表中,并且具有子术语,那么子术语也将被删除,除非子术语拥有多个父术语。