OSV3改版——消息改版（会话）

摘要: OSV3会话设计开发手册

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会话——消息模板开发手册

公共消息模板开发：

首先打开文件./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的格式

模块消息模板开发：（模块用[module]代替）

首先打开文件./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的格式