如何在 WP Multilang 插件中通过 PHP 为多语言文章设置语言-php教程-PHP中文网

如何在 WP Multilang 插件中通过 PHP 为多语言文章设置语言

WP Multilang 不支持直接在 wp_insert_post() 参数中指定语言；需借助其专用函数（如 wpm_ml_array_to_string() 和 wpm_translate_string()）构建多语言内容字符串并写入 post 字段。

wp multilang 不支持直接在 `wp_insert_post()` 参数中指定语言；需借助其专用函数（如 `wpm_ml_array_to_string()` 和 `wpm_translate_string()`）构建多语言内容字符串并写入 post 字段。

WP Multilang 是一个较早期的 WordPress 多语言插件（最后更新距今已逾四年），虽已停止积极维护，但仍在约 10,000+ 网站中运行。它不采用传统“语言字段”或自定义元数据方式存储翻译，而是将多语言内容序列化为特殊格式字符串，统一存入标准的 post_title、post_content 或 post_excerpt 字段中。因此，不能像其他现代插件（如 WPML 或 Polylang）那样通过 'lang' => 'de' 这类参数控制语言，而必须使用其内置函数生成兼容格式的内容。

✅ 正确做法：用 `wpm_ml_array_to_string()` 构建多语言内容

该函数接收一个以语言代码为键、对应翻译文本为值的关联数组，并返回 WP Multilang 可识别的结构化字符串（如 HelloHallo）。此字符串可安全赋值给 $post_data 的任意文本字段：

$localize_array = [
    'en' => 'Welcome to our site!',
    'de' => 'Willkommen auf unserer Website!',
    'fr' => 'Bienvenue sur notre site !'
];

$post_data = [
    'post_title'    => wpm_ml_array_to_string($localize_array),
    'post_name'     => 'welcome-page',
    'post_content'  => wpm_ml_array_to_string([
        'en' => '<p>Our services include web design and SEO.</p>',
        'de' => '<p>Unsere Leistungen umfassen Webdesign und Suchmaschinenoptimierung.</p>',
        'fr' => '<p>Nos services incluent la conception web et le référencement.</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站"><img
														src="https://img.php.cn/upload/skill/000/000/081/179040786932301.jpg" alt="btpanel phpsite 宝塔面板PHP网站" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="overflowclass">btpanel phpsite 宝塔面板PHP网站</a>
													<p class="overflowclass">宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>'
    ]),
    'post_status'   => 'publish',
    'post_author'   => 1,
    'comment_status'=> 'closed'
];

$post_id = wp_insert_post($post_data);

⚠️ 注意：wp_insert_post() 本身不会触发 WP Multilang 的钩子逻辑（如 save_post 中的语言处理），因此绝不可依赖修改用户 meta（如 edit_lang）来“临时切换语言”——该方式仅影响后台编辑界面，对程序化插入完全无效。

? 更新已有文章的多语言内容

若需为已存在文章添加或更新某语言版本，推荐结合 wpm_translate_string() 提取当前语言内容，再构造新数组：

$post = get_post($existing_post_id);
// 获取原文（默认语言）内容作为基础
$original_content = $post->post_content;

// 提取现有英文翻译（若存在），否则留空；手动提供德文新译文
$localize_array = [
    'en' => wpm_translate_string($original_content, 'en'),
    'de' => 'Dies ist die aktualisierte deutsche Übersetzung.',
    'fr' => wpm_translate_string($original_content, 'fr') // 保留原法文
];

$updated_content = wpm_ml_array_to_string($localize_array);

// 安全更新：仅覆盖 content，不改动其他字段
wp_update_post([
    'ID'           => $existing_post_id,
    'post_content' => $updated_content
]);

? 关键注意事项

函数可用性检查：确保 wpm_ml_array_to_string() 和 wpm_translate_string() 已加载（通常插件激活后即生效），生产环境建议加 function_exists() 判断：
```
if (!function_exists('wpm_ml_array_to_string')) {
    error_log('WP Multilang functions not available. Plugin may be inactive.');
    return;
}
```
语言代码规范：严格使用小写 ISO 639-1 标准（如 'en', 'de', 'fr'），不支持 'EN' 或 'ger'。
性能提示：频繁调用 wpm_translate_string() 可能触发数据库查询，批量操作时建议缓存原始字符串。
替代建议：对于新项目，强烈推荐迁移到更活跃、API 更完善的插件（如 Polylang + Polylang REST API 或 WPML），以获得更好的可维护性与扩展性。