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.css 和 cms-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 钩子和常量指南。