Z-Blog Wiki Z-Blog Wiki

Z-Blog官方文库

用户工具

站点工具


zblogphp:development:functions:loadlanguage

LoadLanguage 语言包载入

Z-BlogPHP支持多语言,在较新版本(1.4+)中可以方便的为主题或者插件引入语言包为应用增加多语言支持。

第一步 编写语言包文件

请在你的应用目录下建立language目录,并根据语言版本命名文件,如en.phpzh-cn.phpzh-tw.php等,其内容格式如下:

<?php
return array(
	'closemenu'=>'收起菜单',
	'expandmenu'=>'展开菜单',
);
该数组键名推荐使用简洁明了的英文单词,以方便引用。

第二步 载入语言包

请在使用语言包之前,用如下代码载入:

global $zbp; //注意 $zbp->LoadLanguage 之前应先声明全局变量$zbp
$zbp->LoadLanguage('plugin', 'AdminColor');

LoadLanguage($type, $id, $default = ' ') 函数有三个参数:

  • $type 指应用类型:分别是system|theme|pluginsystem是系统保留类型,应用只可选theme|plugin
  • $id 指应用ID:当类型为theme或plugin时有效。
  • $default 为指定默认语言:如zh-cn,为空则跟随系统语言配置。

对于应用而言,一般推荐在激活应用时载入,如

#注册插件
RegisterPlugin("AdminColor", "ActivePlugin_AdminColor");
 
#激活插件执行
function ActivePlugin_AdminColor() {
	global $zbp;
	$zbp->LoadLanguage('plugin', 'AdminColor');
	...
}

第三步 使用

在代码中可用 $zbp->lang[APPID][KEY] 来引用,如上述第一步例子,引用如下(注意大小写):

$zbp->lang['AdminColor']['closemenu'] //收起菜单
同理在模板中可用如下代码
{$lang['AdminColor']['closemenu']}

Z-BlogPHP将根据系统配置或载入时指定的默认语言自动加载相应语言包。

zblogphp/development/functions/loadlanguage.txt · 最后更改: 2016/11/29 08:43 由 yszm