编辑文件

编辑文件：企业介绍版块-运营指南.md

# 首页「企业介绍」版块 — 运营指南

首页（New Arrivals 下方、页脚上方）有一个「企业介绍」版块，包含**视频**和**文字描述**（标题 + 正文），内容全部可在后台维护，并自动适配全站 10 语言。本文说明"内容存在哪里"以及"如何改"。

> 翻译机制与术语统一见 [i18n-workflow.md](i18n-workflow.md)、[i18n-glossary.md](i18n-glossary.md)。本版块的文字走其中第 2 类（Polylang → Strings translations），视频走 Customizer。

## 1. 内容存在哪里

| 内容 | 存在哪 | 后台入口 | 是否按语言 |
|---|---|---|---|
| **视频**（本地上传 mp4 / YouTube / Vimeo） | Customizer（`theme_mod`，全局一份） | 外观 → 自定义 → 企业介绍 | 否（全语言共用） |
| **标题** `Company Introduction` | Polylang 注册串（数据库） | 语言 → 字符串翻译 | 是（10 语言） |
| **正文描述** | Polylang 注册串（数据库，多行） | 语言 → 字符串翻译 | 是（10 语言） |

> 视频按 Polylang `media_support=0` 配置，天然全语言共用一份；只有文字需要逐语言翻译。

## 2. 配视频（配一次，全语言生效）

后台 → **外观 → 自定义**（Appearance → Customize）→ 找到 **「企业介绍 / Company Introduction」** 区块。两种方式**二选一**，外链填了会覆盖本地视频：

- **本地视频**：「企业视频（本地 mp4/webm）」点「选择 / 更换」→ 媒体库弹窗 → 选已有视频或拖入上传 `.mp4` →「选择」。控件已限定视频类型。
- **外链**：「或外链地址」框填 YouTube / Vimeo / 直链 mp4，例如 `https://youtu.be/xxxxxxxxx`。

填完点左上角 **「发布」**（首次）或 **「更新」**。两者都不配 → 前台显示占位海报图（`assets/images/about-poster.svg`），不报错。

> 建议：mp4 用 H.264 编码、30–50MB 以内，网页加载快。文件太大或不想占自有带宽，优先用 YouTube/Vimeo 外链。

## 3. 配文字（按语言翻译）

后台 → **语言 → 字符串翻译**（Languages → Strings translations）：

1. 顶部「选择组」下拉选 **Polylang**（询盘表单的文字也在这一组）；或直接在搜索框输入 `Company` 过滤。
2. 认「字符串」列内容，找到这两行：
   - **`Company Introduction`** —— 标题。在各语言列填入（如中文列填「企业介绍」）。
   - **`Yinbo is a clothing manufacturer focused on … at scale.`** —— 正文（多行文本框）。在各语言列填入本地化正文。
3. 滚到页面底部 → **「保存更改」**（Save changes）。

英文是默认值（已自动填好），不用动；只补其他 9 个语言。某语言不填则前台回退显示英文默认值——所以最低限度可以先只配视频上线，文字逐步补。

**可直接粘贴的中文正文示例**（对应英文默认那段）：

> Yinbo 是一家专注于高性价比批发生产的服装制造商。凭借多年 B2B 经验，我们在多种版型与面料上稳定交付优质成衣，为需要可靠供应链的合作伙伴而准备。

术语对照见 [i18n-glossary.md](i18n-glossary.md) 第 4 节（"Company Introduction" 10 语言译法）。

## 4. 验证

打开首页，企业介绍版块应在 **New Arrivals 下方、页脚上方**：

- 视频能正常播放（本地 mp4 = 原生播放器；YouTube/Vimeo = 内嵌 iframe）；不配则显示占位海报。
- 地址栏切 `/zh/`、`/es/`、`/ar/`（阿拉伯语，版块左右镜像）等，标题/正文跟随语言切换。
- 手机宽度（≤768px）下版块纵向堆叠、标题居中。

## 5. 常见问题

- **视频传不上去 / 报 413 / 提示超大小限制**：调大 `php.ini` 的 `upload_max_filesize` 和 `post_max_size`（如各 `64M`），重启 Web 服务；或改用 YouTube 外链（不受此限）。
- **字符串翻译里找不到那两行**：先访问一次任意后台页或首页（触发 `init` 注册），再回「字符串翻译」刷新。
- **改了前台没变**：Customizer 要点「发布/更新」；字符串翻译要滚到底点「保存更改」；浏览器 `Ctrl+F5` 强刷清缓存。
- **想给某语言换不同视频（如配音版）**：当前设计视频全语言共用。如确需按语言区分，需扩展存储（Customizer 按语言配置不在 Polylang 免费版自动支持范围内），联系开发评估。

## 6. 本地 → 线上

本仓库是本地 phpstudy 副本。改完代码（PHP/CSS/SVG）部署到线上后，**视频和翻译存在各自数据库里，不会自动同步**，需在线上后台重做一遍第 2、3 步。部署流程见 [deployment-checklist.md](deployment-checklist.md)。

## 7. 相关代码位置（给维护者）

| 作用 | 文件 |
|---|---|
| 版块模板（视频/海报 + 标题 + 正文 + CTA） | [front-page.php](../front-page.php)（`<section class="cb-about">`） |
| 视频后台入口（Customizer 区块）+ 渲染器 `clothb2b_about_video_html()` | [functions.php](../functions.php)（section 7） |
| 注册标题/正文翻译串（`pll_register_string`） | [mu-plugins/clothb2b-catalog.php](../../mu-plugins/clothb2b-catalog.php) |
| 版块样式 `.cb-about*` / 按钮 `.cb-btn--solid` | [assets/css/theme.css](../assets/css/theme.css) |
| 占位海报 | [assets/images/about-poster.svg](../assets/images/about-poster.svg) |

新增/删除版块、改视频渲染逻辑后，若动了 `pll_register_string` 字面量串，记得按 [i18n-workflow.md](i18n-workflow.md) 第 2 节跑 `.make-pot.php` + `.build-all.php`（非必填项也靠它做 `.mo` 回退）。