选择图片来源,检查队列与额度;启用自动处理前,先验证一张图片的处理结果。 本译文为简要指南;完整的技术参考目前仅提供俄语版。
1. 模块功能
模块从所选的信息块、文件夹和单个文件中查找 JPEG、PNG、WebP 图片。符合条件的图片会发送至 ANK API;如果优化副本更小,就使用该副本。原文件仍保留原位,同一路径不会被并行重复发送。
2. 安装与连接
安装 ank.imagecompress 后,打开“概览”选项卡,输入 ANK API 密钥,检查连接和余额。启用自动化前,请确认 1C-Bitrix 主 cron 确实运行。
3. 选择来源与排除项
选择信息块、站点文件夹或单张图片。在多站点安装中,检查各站点的代码和域名。把不应优化的路径加入排除项,并在扫描前复核选择。
4. 统计文件并启动队列
在“队列与错误”中点击“统计文件”:本地扫描不会消耗额度。检查不同路径数量、已处理文件数和额度上限估计,然后启动压缩,或在“概览”中启用自动处理。即使关闭后台页面,队列仍在服务器上运行。
5. 自动处理与进度
启用自动处理后,每小时运行的代理任务会检查来源,并把新增或变更的图片加入共用队列。另一个代理任务持续处理队列。暂停会阻止新任务启动,但已发出的 API 请求仍可能完成。请在后台查看保存的进度和下次运行时间。
6. 结果与额度
按文件名搜索结果,打开原文件和优化副本并比较大小。通常只有结果更小时才会消耗额度,实际用量会记录在日志中。若自动处理仍开启,删除优化副本后可能重新生成并再次消耗额度。
7. 故障排查与支持
如果没有开始处理,请检查密钥、余额、所选来源、主 cron 和代理任务。单个文件失败时,查看错误和路径,修复权限或格式问题,再用一张图片重试。向 modules@ank-studio.ru 求助时,请提供模块版本和错误信息,不要发送 API 密钥。