函数hook_uc_message()位于uc_store.module模块中:
<?php
hook_uc_message()
?>
描述:
有很多例子中,Ubercart模块都会用到可配置的区块文本。这通常是一些默认消息,比如新订单的电子邮件模板。如果使用普通的默认值设置方式的话,你可能需要在模块中的不同位置,(当你希望使用变量,或者使用默认值来显示设置表单时),多次拷贝和粘贴大段的文本。为了降低这种混乱,我们引入了这个钩子。使用这个钩子,你就可以把你的消息放到一个位置,而在其它需要的地方(或者其它模块)使用函数uc_get_message()来调用相应的文本就可以了。
这个函数非常简单,它没有参数,返回值为一个基本的关联数组,其中键为消息的IDs,而值为默认的消息。当你使用uc_get_message()时,使用你这里设置的消息ID来引用你想要的消息
注意:当使用t()时,你不能向里面传递一个串联的字符串!所以我们的例子中,没有使用换行符,尽管它的宽度超过了80个字符。使用串联就会影响字符串的翻译。
返回值:
一个关于消息的数组。
示例:
<?php
function uc_cart_uc_message() {
$messages['configurable_message_example'] = t('This block of text represents a configurable message such as a set of instructions or an e-mail template. Using hook_uc_message to handle the default values for these is so easy even your grandma can do it!');
return $messages;
}
?>