主题尺寸声明 Theme Settings
inc/..setting.php 用于向后台声明本主题要求的图片尺寸提示与裁剪比例(不影响前台渲染)。后台初始化时由 ThemeSettingsReader 读取当前启用主题的该文件,注入后台模板变量 $setting.theme。
一、作用
{$setting.theme.<key>_img_size}:提示文案,输出在各模块编辑页的图片上传框下方;{$setting.theme.<key>_img_crop}:由_img_size自动派生,从文案中解析「宽/高」,作为图片裁剪比例传给上传组件(如inc/file_input.tpl的crop_ratio)。
二、文件格式
每行一条 键:值,其余行(文件首尾的引号行、空行)会被忽略;解析时取每行第一个冒号分割,因此:
- 冒号两侧不要加空格;
- 值里不要再出现英文冒号。
实际文件长这样(示例):
<?php
'
logo_img_size:宽度55~200、高度55
banner_img_size:宽度>=1920、高度400
product_img_size:上传图片尺寸推荐为1000*1000,不建议上传过大图片
product_thumb_size:300*300
article_img_size:上传图片尺寸推荐为750*500
'
?>
三、支持键与后台出现位置
| 键 | 后台出现位置 |
|---|---|
article_img_size |
文章、课程、图库、下载编辑页(共用文章尺寸) |
doc_img_size |
文档编辑页 |
professional_img_size |
专业人士编辑页 |
product_img_size |
产品编辑页 |
cases_img_size |
案例编辑页(兼容旧键 case_img_size,缺 cases_ 时自动取 case_) |
banner_img_size |
幻灯片编辑页 |
logo_img_size |
站点 Logo 尺寸说明(主题声明惯例) |
product_thumb_size |
产品缩略图尺寸(如 300*300);启用主题时若已配置,会同步到缩略图宽高配置 |
四、裁剪比例派生
*_img_size 的文案建议写成可解析出宽高的形式,裁剪比例才生效:
宽度>=1920、高度400→ 裁剪比例1920/400;1000*1000、750x500→1000/1000、750/500。
五、注意事项
- 未声明的键后台会补空串占位,不会报错;多声明无对应页面的键也没有副作用;
- 该文件只影响后台的尺寸提示与裁剪比例,不影响前台渲染;
- 文件内容同样受主题脚本的安全约束(参见「主题数据装配 Portal」篇的 SQL 关键字白名单)。