1、消息需求:
- 消息以会话的形式展现;
- (类型)会话类型包括标题、类型标识、logo;
- (类型)有一个公共的会话类型“系统消息”;
- (类型)开发者可以自己定义会话类型;
- (类型)每个模块都有默认会话类型。标识用模块标识,标题用模块名,logo用模块logo;
- (类型)类型列表展示的时候有先后顺序,并且,当前类型有会话时排在前面;
- (类型)开发者可以专门为某种会话类型设置列表模板;
- (消息)开发者可以专门为某种消息类型设置消息模板;
- (类型、消息)模板有默认,未设置时使用;
2、全部会话类型设计:
- 会话类型存放到文件中;
- 公共会话类型放到./Application/Common/Conf/message_type.php;
- 模块会话类型放到./Application/[ModelName]/Conf/message_type.php;
- 没有message_type.php文件的,生成一个模块类型的会话;
- 全部会话类型获取方式:get_all_message_session(),其返回结果是会话类型列表。每种类型含有name、title、logo、sort(选填,用于排序,可选值为0~1000;对于有消息的类型,sort值会增加1000从而将其排在前面)、block_tpl(选填,用于设置会话列表样式模板)。
- block_tpl填写的模板文件位置为./Application/[ModelName]/View/default/MessageTpl/block/
- block_tpl的模板文件为./Application/Common/View/default/MessageTpl/tpl/_message_block.html
- 公共会话类型logo存放文件夹为./Public/images/message_logo/
- 模块会话类型logo存放文件夹为./Application/[ModelName]/Static/images/message_logo/
- 模块lago存放到文件夹./Application/[ModelName]/Static/images/中,名字为module-logo.png
3、会话消息模板设计
- 消息模板类型存放到文件中;
- 公共模板类型放到./Application/Common/Conf/message_type.php
- 模块模板类型放到./Application/[ModelName]/Conf/message_type.php
- 全部消息模板获取方式:get_message_tpl(),其返回结果是消息模板列表。每个模板含有name、title、module、tpl_name(模板文件除后缀部分)、example_content(消息内容模板)。
- tpl_name 公共消息模板放到./Application/Common/View/default/MessageTpl/tpl/
- tpl_name 模块消息模板放到./Application/[ModelName]/View/default/MessageTpl/tpl/
- tpl_name 默认消息模板文件为./Application/Common/View/default/MessageTpl/tpl/_message_li.html
4、会话类型开发手册
公共会话类型开发:
- 首先打开文件./Application/Common/Conf/message_config.php
- 可以看到如下所示内容:其中session中的即为当前系统中的会话类型
- 在上图红框部分添加会话类型的数组信息(name、title、logo、[sort]、[block_tpl])name为''表示模块会话,用于覆盖自动生成的模块会话
- 将会话类型的logo放到文件夹./Public/images/message_logo/下
- 如果会话类型需要单独的列表模板,将列表模板文件放到文件夹./Application/Common/View/default/MessageTpl/block/下
- 经过上面的步骤后,就可以发送这种类型的会话了。
- 这时候去后台重置会话类型列表,就能看到新添加的会话类型了。
- 使用方法为,send_message()和send_message_without_check_self()的参数$type写为"Common_[新加类型的name]",若name为空,则为"Common"
模块会话类型开发:(模块用[module]代替)
- 首先打开文件./Application/[module]/Conf/message_config.php
- 可以看到如下所示内容:其中session中的即为当前系统中的会话类型
- 在上图红框部分添加会话类型的数组信息(name、title、logo、[sort]、[block_tpl])name为''表示模块会话,用于覆盖自动生成的模块会话
- 将会话类型的logo放到文件夹./Application/[module]/Static/images/message_logo/下
- 如果会话类型需要单独的列表模板,将列表模板文件放到文件夹./Application/[module]/View/default/MessageTpl/block/下
- 经过上面的步骤后,就可以发送这种类型的会话了。
- 这时候去后台重置会话类型列表,就能看到新添加的会话类型了。
- 使用方法为,send_message()和send_message_without_check_self()的参数$type写为"[module]_[新加类型的name]",若name为空,则为"[module]"
5、OSV3会话——消息模板开发手册
公共消息模板开发:
模块消息模板开发:(模块用[module]代替)
- 首先打开文件./Application/Common/Conf/message_config.php
- 可以看到如下所示内容:其中tpl中的即为当前系统中的消息模板
- 在上图红框部分添加消息模板的数组信息(name、title、module、tpl_name、example_content)
- 将模板文件放到文件夹./Application/Common/View/default/MessageTpl/tpl/下
- 经过上面的步骤后,就可以发送需要使用这种消息模板渲染的消息了。
- 这时候去后台重置消息模板列表,就能看到新添加的消息模板了。
- 使用方法为,send_message()和send_message_without_check_self()的参数$tpl写为"Common_[新加模板的name]",$content为example_content的格式
- 首先打开文件./Application/[module]/Conf/message_config.php
- 可以看到如下所示内容:其中tpl中的即为当前系统中的消息模板
- 在上图红框部分添加消息模板的数组信息(name、title、module、tpl_name、example_content)
- 将模板文件放到文件夹./Application/[module]/View/default/MessageTpl/tpl/下
- 经过上面的步骤后,就可以发送需要使用这种消息模板渲染的消息了。
- 这时候去后台重置消息模板列表,就能看到新添加的消息模板了。
- 使用方法为,send_message()和send_message_without_check_self()的参数$tpl写为"Common_[新加模板的name]",$content为example_content的格式