WPML

WPML 提供了一组常量,您可以在主题或插件的 PHP 文件和模板中使用它们。

除了 WPML 核心插件定义的常量外,您还可以使用我们的附加组件插件提供的常量。

WPML Multilingual CMS 常量

ICL_DISABLE_CACHE

使用此常量可禁用 WPML 对象缓存。默认值为 false。

ICL_DONT_LOAD_LANGUAGES_JS

将此常量设置为 true 会移除语言切换器 JavaScript 文件(例如
\sitepress-multilingual-cms\templates\language-switchers\legacy-dropdown\script.js)。

ICL_DONT_LOAD_LANGUAGE_SELECTOR_CSS

将此常量设置为 true 会移除语言切换器 CSS(例如
\sitepress-multilingual-cms\templates\language-switchers\legacy-dropdown\style.css)。

WPML_TRANSLATOR_CAN_USE_LS_SHORTCODE

将此常量设置为 true 可允许译者用户在翻译时使用语言切换器简码 wpml_language_selector_widget

WPML_TRANSLATION_AUTO_UPDATE_ENABLED

对于页面构建器,WPML 提供了一项自动更新内容的功能。

要禁用此功能,请将此常量的值设置为 false

WPML_TAXONOMY_TRANSLATION_MAX_TERMS_RESULTS_SET

使用此常量可设置在 WPML分类翻译页面上显示的术语数量。

默认值为 1000。

WPML_SAVE_XLIFF_PATH

使用此常量可定义从 WPML翻译页面下载任务时保存 XLIFF 文件的服务器路径。例如:

define('WPML_SAVE_XLIFF_PATH', '/home/test-user/Desktop');

下载翻译任务后,将在定义的文件夹中创建该文件的副本。

WPML_DO_NOT_RESIZE_UPLOADED_FLAGS

默认情况下,为了保持一致,WPML 的语言切换器旗帜会自动调整为 18×12 像素。

有时,您可能不想调整旗帜的大小。例如,它们可能由自定义 CSS 或 JavaScript 处理,或者您想要显示自定义的动画 GIF。在这种情况下,您可以通过将此常量的值设置为 true 来关闭自动调整大小功能。

有关更多信息,请查看我们关于自定义语言切换器旗帜的页面。

WPML_INSTALLER_LOGGING

将此常量设置为 true 将启用与 WPML 安装程序相关的所有内容的日志记录。这将在您网站的 ..\wp-content\plugins\sitepress-multilingual-cms\vendor\otgs\installer\ 文件夹中创建一个名为 installer.log 的日志文件。

此常量仅供开发者使用。对于常规的安装程序日志,请前往您网站管理后台中的 WPML支持,然后进入安装程序支持页面。

OTGS_DISABLE_AUTO_UPDATES

如果您将此常量的值设置为 true,WPML 和 Toolset 将停止自动检查更新。您将需要手动检查更新。

WPML_EXPORT_ALL_TO_XLIFF_LIMIT

您可以使用此常量来设置可从 WPML翻译页面导出为 XLIFF 的最大任务数量。

默认值为 1700。这是所有服务器应该能够在合理时间内处理的任务数量。如果您的网站在快速的服务器上运行,您可以根据需要增加此限制。

WPML 字符串翻译常量

WPML_ST_SYNC_TRANSLATION_FILES

将此常量设置为 true 可在多台服务器之间同步 WPML 翻译文件(MO 文件)。

有关更多信息,请查看我们关于为在多台服务器上运行的网站同步翻译文件的页面。

WPML_ST_MO_SCANNING_LIMIT

WPML 字符串翻译会扫描并导入 MO 文件,以使其可供翻译。您可以使用此常量来定义在一次请求中可导入的 MO 文件的数量。

默认值为 20000。

WPML CMS Nav 常量

WPML_CMS_NAV_DISABLE_CACHE

将此常量设置为 true 会禁用 WPML CMS Navigation 缓存。

有关更多信息,请查看我们关于 WPML CMS Navigation 插件的页面。

ICL_DONT_LOAD_NAVIGATION_CSS

将此常量设置为 true 会禁用 cms-navigation-base.csscms-navigation.css 文件的加载。

WPML Multilingual & Multicurrency for WooCommerce 常量

WCML_GEOLOCATED_COUNTRY

使用此常量可强制 WPML Multilingual & Multicurrency for WooCommerce 在查询地理定位的国家/地区时使用特定的国家/地区。

该常量值应包含两位数的国家/地区代码(例如 GH 代表加纳)。

define( 'WCML_GEOLOCATED_COUNTRY', 'GH' );

此常量在测试时可能很有用。对于自定义模块,请使用专用的 API 钩子

Advanced Custom Fields Multilingual 常量

要了解您可以在 ACFML 中使用哪些常量,请查看我们的 ACF Multilingual 钩子和常量指南

作者:Amir · 最后更新时间:2025年7月2日