.jpg)
Snapic Page使用文档
- 使用方法
A 部署文件
将压缩包里的文件夹 Snapic 及其内部的所有文件，和文件 Snapic-Page.php 上传至目录 usr/themes 中的你的主题文件夹里。
重要：如果之前有使用 Snapic Page 模板，直接覆盖原文件即可。
B 配置页面
一、创建相册（必选项）
后台》管理》独立页面》新增，新建独立页面，除以下提到的事项外，其余正常操作即可。
1.此编辑页面左侧的“内容文本框”里，选择性输入你对相册的介绍，支持使用纯文本、插入链接等。
2.此编辑页面右侧的“自定义模板”里，请选择“Snapic Page”。
3.此编辑页面右侧的“附件”里，请上传你需要展示的图片，不需要插入“内容文本框”中。
4.此编辑页面右侧的“高级选项”，在“公开度”选择“隐藏”后，可将此相册（独立页面）的标题不展示在某些主题的分类菜单里。
二、添加描述（可选项）
1.方法一：在以上提到的编辑页面右侧的“附件”里，上传你需要展示的图片后，依次点击每个图片附件的“编辑”（铅笔状图标），进入图片信息的编辑页面，在右侧的“描述”里，输入你对这张图片的介绍，提交修改即可。
2.方法二：后台》管理》文件，也可以从这里进入图片信息的编辑页面，给每张图片添加描述。
三、新增图片（可选项）
后台》管理》独立页面，打开你需要新增图片的相册（独立页面），继续在“附件”里上传图片即可。最新上传的图片将展示在前台的最前面。
四、图片外链（说明项）
模板 Snapic Page 2022
需要将图片以附件的形式上传。如果使用图床，需要自己通过插件并修改模板代码实现，请自行研究（如果成功，欢迎分享，你的教程链接将出现在这里）。
C 使用技巧
1.除了模板默认的窄栏（四栏）和宽栏（三栏）外，如何新增自定义的栏数（如：五栏）？在模板文件 Snapic-Page.php 的<head>和</head>之间的适当位置，新增如下代码：
<?php if (strpos($this->fields->snapic, '自定义字段值') !== false): ?>
<style>
.grid .grid__item,
.grid .grid__sizer {
width: calc((100% / 3) - 10px);
margin: 5px;
}
@media screen and (max-width: 960px) {
.grid .grid__item,
.grid .grid__sizer {
width: calc((100% / 2) - 10px);
margin: 5px;
}
}
@media screen and (max-width: 480px) {
.grid .grid__item,
.grid .grid__sizer {
width: calc((100% / 1) - 10px);
margin: 5px;
}
}
</style>
<?php endif; ?>① 以上代码的作用是，使用自定义字段值设置图片瀑布流，在指定显示宽度（默认、480px~960px、0px~480px）的格子大小。
②请将以上代码中的（自定义字段值）替换为随意英文字母（如：sex），避免和模板的自定义字段值（wide,radius,overlay,padding,gallery,autoplay）重复。
③ 请将以上代码中的 (100% / 3) 修改为 (100% / 5) 即：在默认显示宽度下，五栏显示。其他显示宽度的设置类似。
④使用时，在自定义字段名称 snapic 里，填入以上自己新增的自定义字段值（如：sex）即可。
⑤注意：这个自己新增的自定义字段值（如：sex），请勿与模板已有的宽栏字段值（wide）同时使用。
D 配置模板
一、创建字段（可选项）
通过使用对应的自定义字段值，可以改变模板的布局和功能。打开你创建的相册（独立页面），按以下介绍依喜好设置即可。
1.添加自定义字段，字段名称填入 snapic，乱填无效！
2.字段值填入以下表格（字段值）栏中的任意一个，如果填入多个字段值时，使用半角逗号或空格分开，没有顺序要求。
3.字段值示例：radius,padding 或 overlay autoplay gallery
I字段列表
| 作用 | 字段值 | 说明 |
|---|---|---|
| 宽栏模式 | wide | 作用于每个格子。使用后，每个格子的宽度相对更宽。 |
| 格子圆角 | radius | 作用于每个格子。使用后，每个格子的圆角比较明显 |
| 灯箱透感 | overlay | 作用于图片灯箱。使用后，灯箱的遮罩层具有透明感。 |
| 灯箱线框 | padding | 作用于图片灯箱。使用后，可以隐藏灯箱的图片线框。 |
| 灯箱翻图 | gallery | 作用于图片灯箱。使用后，开启灯箱的图片翻图功能。 |
| 自动播放 | autoplay | 作用于图片灯箱。使用后，开启灯箱的自动播放功能。 |
- 插件使用方法
插件 for Snapic Page 选择性使用，作用是，当使用模板 Snapic Page 2022 创建了多个单页相册后，可以使用插件
for Snapic Page 将这些相册在指定位置归档显示，使用方法见下：
A 部署插件
1.将压缩包里的文件夹 forSnapicPage 及其内部的所有文件，上传至目录 usr/plugins 中。
2.后台》控制台》插件，找到 for Snapic Page 并启用。
B 调用插件
示例一：在文章页 post.php 的（全局）调用，即所有文章页都会显示。打开主题文章文件 post.php
在合适位置（如：文末）添加以下代码：
<?php Typecho_Plugin::factory('for_SnapicPage')->Lopwon(); ?>示例二：在文章页 post.php 的指定（单篇）文章调用，即只有指定的一篇文章显示。打开主题文章文件 post.php
在合适位置（如：文末）添加以下代码：
<?php if ($this->cid == '文章cid编码') { Typecho_Plugin::factory('for_SnapicPage')->Lopwon(); } ?>示例三：在文章页 post.php 的指定（多篇）文章调用，即限定哪些文章显示。打开主题文章文件 post.php
在合适位置（如：文末）添加以下代码：
<?php if (in_array($this->cid, array('文章cid编码一', '文章cid编码二', '以此类推'))) { Typecho_Plugin::factory('for_SnapicPage')->Lopwon(); } ?>