• 使用方法

A 部署文件

  1. 将压缩包里的文件夹 Snapic 及其内部的所有文件，和文件 Snapic-Page.php 上传至目录 usr/themes 中的你的主题文件夹里。
  2. 重要：如果之前有使用 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(); } ?>
代码·备忘