Piwigo：为一张照片添加多个可下载格式

目标

为图库中的一张照片提供额外格式，让访问者可从同一照片下载不同版本，而不是将多份文件当作不同照片分别展示。

适用环境与准备

适用于 Piwigo 16.4.0 Web 管理端。步骤依据官方滚动文档整理，未在指定版本实测。 开始前确认部署类型和权限：

• **自托管：**需要管理员或服务器维护者修改 Piwigo 配置；先备份原配置。
• **Piwigo Cloud：**官方文档说明 Multiple formats 仅适用于 Enterprise 或 VIP 方案，并需联系支持启用。
• 要在图库下载按钮展示多种格式，还需安装并启用 Download Formats Buttons 插件。 准备与原照片内容对应的替代文件；不要用不同内容、不同主体的图片冒充格式版本。

启用多格式

自托管部署

1. 先备份当前配置，并确认管理员允许修改。
2. 使用 LocalFile Editor 在配置文件中加入官方示例开关： $conf['enable_formats'] = true;
3. 如站点需要限制可接受格式，请由维护者按官方配置文档单独核对。不要直接复制未知扩展名或覆盖原有配置。
4. 保存后回到照片管理页，确认编辑照片页面出现 Formats 页签。若没有出现，先恢复备份或排查配置加载，不要重复上传文件。

Piwigo Cloud

联系支持确认套餐资格并请求启用；不要尝试编辑托管端服务器配置。

为照片添加替代格式

1. 在管理后台打开目标照片的编辑页，先核对照片身份。
2. 打开 Formats 页签，选择 Add formats。
3. 在上传表单中确认系统显示的是目标主照片，再选择要关联的格式文件并开始传输。
4. 上传后回到该照片的 Formats 页签，核对替代格式已经列出。
5. 如果从通用照片上传页选择 Upload formats，官方要求新格式文件名与原照片文件名相同；优先使用照片编辑页的 Formats 页签，避免名称不匹配。

让访问者选择下载格式

管理员需另行安装并启用 Download Formats Buttons 插件。启用后，照片下载按钮可显示可用格式与文件大小；访问者点击对应格式下载。没有插件时，不要假设图库已经展示全部格式。

预期结果

管理端同一照片记录关联多个格式；在展示插件启用后，图库的下载按钮列出格式及其文件大小。本文未实测上传或下载过程。

常见问题与恢复

• **管理端没有 Formats 页签：**确认自托管配置开关已正确加载，或云套餐与支持请求满足条件；先检查配置，不要重复导入照片。
• **格式已关联但访客看不到选择按钮：**核对 Download Formats Buttons 插件是否已安装、启用；后台 Formats 列表和前台下载入口是两处检查。
• **上传失败：**确认格式在该站点允许列表内，检查文件名/上传限制和服务器日志；保留源文件并避免删除原主照片。
• **配置改动导致问题：**使用事先备份恢复原配置，再由管理员检查配置语法与缓存。不要把本教程的开关配置直接用于未确认的多环境站点。
• **传错文件：**暂停开放下载，确认原图与替代文件，按当前版本管理界面移除错误关联；官方所引页面未详述误传的恢复交互，操作前保留独立副本。

FAQ

Piwigo 默认会显示多格式下载按钮吗？

不会只凭关联格式自动显示。官方文档要求安装 Download Formats Buttons 插件。

Cloud用户可以自行改配置吗？

不行。官方文档说明 Enterprise 或 VIP 客户需联系支持启用。

新格式文件名必须和原文件相同吗？

从通用上传页使用 Upload formats 时需同名；从照片编辑页 Formats 页签选择 Add formats 时应核对其提示的目标照片。

来源与核验

后台关联资源：Piwigo 16.4.0，ID 6d64ff79-2f28-4375-a7db-78757b6e0fe8，revision 2，published。官方滚动文档未逐项绑定此构建；未实测，无软件截图。核验日期：2026-10-16（Asia/Shanghai）。

• https://doc.piwigo.org/import-and-manage-photos/multiple-formats-piwigo/