TablePress 扩展:修改 DataTables 字符串

TablePress 是 WordPress 的一个管理和发布表格的插件,它使用 DataTables JavaScript 库来提供诸如表格排序、过滤、分页等特色功能。启用这些功能后,在表格周围会显示像“搜索”等字符串。但是有时候可能会希望能够将“搜索”改为“过滤”之类的更贴切网站使用环境的说法。

DataTables 的字符串并没有包含在 TablePress 的语言包中,而是有它自己的翻译文件。TablePress 在发布的时候就已经包含了 DataTables 的所有文件,包括其支持的各国语言文件。这些语言文件看起来如下所示(这是其中的简体中文语言文件 lang-zh_CN.js):

{
	"sProcessing": "处理中...",
	"sLengthMenu": "显示 _MENU_ 项结果",
	"sZeroRecords": "没有匹配结果",
	"sInfo": "显示第 _START_ 至 _END_ 项结果,共 _TOTAL_ 项",
	"sInfoEmpty": "显示第 0 至 0 项结果,共 0 项",
	"sInfoFiltered": "(由 _MAX_ 项结果过滤)",
	"sInfoPostFix": "",
	"sSearch": "搜索:",
	"oPaginate": {
		"sFirst": "首页",
		"sPrevious": "上页",
		"sNext": "下页",
		"sLast": "末页"
	}
}

而其英文(美国)语言文件内容如下(稍稍有点不同哈):

{
	"sEmptyTable":	   "No data available in table",
	"sInfo":	   "Showing _START_ to _END_ of _TOTAL_ entries",
	"sInfoEmpty":	   "Showing 0 to 0 of 0 entries",
	"sInfoFiltered":   "(filtered from _MAX_ total entries)",
	"sInfoPostFix":	   "",
	"sInfoThousands":  ",",
	"sLengthMenu":	   "Show _MENU_ entries",
	"sLoadingRecords": "Loading...",
	"sProcessing":	   "Processing...",
	"sSearch":		   "Search:",
	"sZeroRecords":	   "No matching records found",
	"oPaginate": {
		"sFirst":	 "First",
		"sLast":	 "Last",
		"sNext":	 "Next",
		"sPrevious": "Previous"
	},
	"oAria": {
		"sSortAscending":  ": activate to sort column ascending",
		"sSortDescending": ": activate to sort column descending"
	}
}

这些语言文件可以从 TablePress 安装目录(/wp-content/plugins/tablepress/)里找到。在其中 “i18n/datatables” 文件夹下面有一些以各国语言缩写命名的文件就是了。比如上面的英文(美国)语言文件名为 lang-en_US.js

虽然直接修改这些文件的内容就可以达到更改显示字串的目的,但是不推荐这么做。因为这些文件会在每次 TablePress 升级的时候被新的、默认的文件覆盖,从而导致自己修改的内容丢失。显然每次升级 TablePress 都要小心记着不要覆盖自己修改过的文件是一件非常痛苦的事情。所以,使用这里介绍的“修改 DataTables 字符串”(Change DataTables strings)扩展就会省事得多。

目录 Contents

下载

TablePress 扩展:修改 DataTables 字符串(点击下载该扩展

安装后,此扩展在 WordPress 后台“插件”页面显示为,

TablePress 扩展:修改 DataTables 字符串

该文件由水景一页根据 TablePress 官方网站发布的扩展 Change DataTables strings 1.0 版汉化打包重新发布。如果您发现官方更新了版本,请在文后留言告知,谢谢!

使用说明

要使用该 TablePress 扩展,直接从本页下载,然后象对待一般的 WordPress 插件那样安装、激活。详细说明请看 TablePress 扩展页面上的使用说明

然后,还需要将 “tablepress/i18n/datatables” 文件夹中的,您正在使用的语言(也就是您想要修改的语言)的文件,文件名为 “lang-xy_XY.js”,复制到插件目录里 “tablepress-change-datatables-strings” 文件夹下面。(作为示例,其中 en_US 和 zh_CN 已经复制到位了。)

再然后,直接在复制过来的文件里,也就是直接修改,比如 lang-zh_CN.js 文件(该文件里的内容如本文前面的代码所示)。但是要注意的是,这里面有些内容是不能修改的

  • 只能修改每一行中 : 号右边的、英文半角双引号内部的内容;
  • 并且其中使用下划线 _ 包围住的内容,如 _START_ 是不能修改的,但是你可以改变它们的位置;
  • 修改后的内容中不能包含英文半角的双引号(”),否则会破坏原来的双引号的范围。

当该扩展激活后,TablePress 就会使用你修改过的这个文件做为 DataTables 的语言文件,原来的就不用了。所以升级 TablePress 的话您的修改也不会丢失。

在 TablePress 扩展页面还有更多扩展可供使用。如果您觉得 TablePress 或者扩展对您有帮助,请考虑捐助原作者以支持其开发。水景一页仅仅是提供 TablePress 中文支持,也知道大家生活都不容易,目前不接受捐助。如果你愿意,请给小站做个友情链接,或者通过这里的网购通道给自己或家人买些小礼品(小站可以顺便赚点佣金)。谢谢!©

本文发表于水景一页。永久链接:<https://cnzhx.net/blog/tablepress-ext_change-datatables-strings/>。转载请保留此信息及相应链接。

时间过去太久,评论已关闭。
如果您有话要说,请到讨论区留言并给出此文章链接。
谢谢您的理解 :-)