Snapic Logs 使用文档

版本型号：Snapic Logs（单页版）
适用程序：Typecho
皮肤类型：页面模板
模板作者：Lopwon
作者博客：Lopwon.com
发布页面：Lopwon.com/snapic-logs.html
许可方式：付费使用
官方演示：Snapic Logs

我要购买：37.00元/人

付款时别忘了留下邮箱收取文件包，勿留 Gmail 邮箱。

敬告：模板 Lopwon Logs 需要在新窗口单独使用，如果你在用的主题限制新窗口打开独立页面，请自行联系该主题作者，解除限制，感谢网友（浪荡子）的反馈。

模板说明

Typecho 常见的说说、微言微语功能，大都是通过在后台建立（文章），在前台改变样式来呈现。如果每天发布了多条说说、微言微语，就会造成后台有大量的文章，这些文章通常也就只有一句话。

而 Snapic Logs 只需要建立一篇（独立页面），通过附件上传的方式添加图片，继而为每一张图片生成独立的 Cid 后，让每一张图片具有接近于文章的添加描述和评论功能。而且每一张图片具有独立的时间戳（上传时间），并且可以在页内搜索这些图片和排序。图片区可以按照列表方式或瀑布流显示，整体布局类似于 Instagram 和 Weibo 风格。

理论上，使用 Snapic Logs 可以建立很多个这样的（独立页面），你可以创建一篇用于日常记录的说说、微言微语页面，也可以为每一次旅行分别创建一篇实时打卡的图文页面。

1. 单页版 Snapic Logs 独立运作，不对你现有的主题产生影响，操作简单无需过多配置。

2. 可以单独为每一张图片添加描述。

3. 理论上，可以建立很多个相册页面。

主要功能

1. 首屏随机大图。文章内插入任意数量的外链图片，前端随机输出一张，刷新页面可见效果。

2. 自定义置顶图。可自选 1~4 张图片作为置顶推荐图文，也可以隐藏不显示。

3. 单图片单属性。可对每张图片添加描述、添加评论等，支持显示图片 Exif 信息（默认仅显示拍摄设备）。

4. 标签快捷筛选。可使用自定义标签对图片进行筛选。

5. 快速搜索页面。可在页面内搜索图片。

6. 正反随机排序。可对图片按正序、反序和随机排序。

7. 图片布局可选。可选择使用单栏列表或双栏、三栏瀑布流的方式显示图片，并且具有延迟加载功能。

8. 图片描述编辑。每张图片的描述，支持插入链接。若描述超出指定字数则自动截断，点击（全文）后显示全文。

9. 外观显示设置。依喜好通过自定义字段，设置外观布局。

主题更新

2023年11月01日 发布 Snapic Logs v2.1 修正已知问题，感谢网友（yan）的反馈。

2023年10月06日 发布 Snapic Logs v2.0 修正已知问题，优化功能代码。

2022年08月31日 发布 Snapic Logs

使用方法

A 部署文件

1. 将压缩包里的文件夹 Snapic 及其内部的所有文件，和文件 Snapic-Logs.php 及 attachment.php 上传至目录 usr/themes 中的你的主题文件夹里（需要注意的是：文件 attachment.php 将接管博客的附件页面，提供给模板 Snapic Logs 调用附件评论）。

2. 将压缩包里的文件 Readme.txt 中的代码，复制粘贴到你的主题文件夹里的文件 functions.php 中。为避免操作错误，请按照文件 Readme.txt 中的说明严格部署。

3. 为什么评论作者链接无效？由于模板使用弹窗方式加载评论框架，为避免在弹窗内直接打开外部链接，所以，模板默认设置不启用评论作者的链接。如果想开启此功能，需按照以下步骤操作：

① 打开主题文件 functions.php 搜索两处 Helper::options()->commentsShowUrl = false; 将 false 替换为 true
② 打开博客文件 var/Widget/Base/Comments.php 第 272 行，将 '>' 替换为 ' target="new">'
③ 以上替换注意有单引号，如果博客程序版本为 1.1-17.10.30 时，文件 Comments.php 的路径是 var/Widget/Abstract/Comments.php 在第 376 行，替换方式同上。

B 配置相册

后台》管理》独立页面》新增，新建独立页面，除以下提到的事项外，其余正常操作即可。

1. 在“内容文本框”上方选择性输入你对相册（独立页面）的介绍，可使用文本链接。

2. 在“内容文本框”里插入任意数量的外链图片，这些图片将作为相册（独立页面）的顶部大图展示，随机输出一张，当刷新页面时可见效果。建议图片尺寸宽大于1920px。对显示效果无要求的可无视。

3. 此编辑页面右侧的“自定义模板”里，请选择“Snapic Logs”。

4. 此编辑页面右侧的“附件”里，请上传你需要展示的图片（不需要插入“内容文本框”中），并添加描述（见下）。

5. 此编辑页面右侧的“高级选项”，在“公开度”选择“隐藏”后，可将此相册（独立页面）的标题不展示在某些主题的分类菜单里。

C 添加描述

1. 方法一：在以上提到的编辑页面右侧的“附件”里，上传你需要展示的图片后，依次点击每个图片附件的“编辑”（铅笔状图标），进入图片信息的编辑页面，在右侧的“描述”里，输入你对这张图片的介绍，提交修改即可。如需插入链接，可用 Markdown 语法 [链接文本](链接)

2. 方法二：后台》管理》文件，也可以从这里进入图片信息的编辑页面，给每张图片添加描述。

D 新增图片

后台》管理》独立页面，打开你需要新增图片的相册（独立页面），继续在“附件”里上传图片即可。最新上传的图片将展示在前台的最前面。

E 设置外观

通过使用对应的自定义字段，可以改变模板的布局和功能。打开你创建的相册（独立页面），按以下介绍依喜好设置即可。

1. 如果添加字段后，需要取消功能，则把对应的字段删除。例如：不想使用置顶功能，就把自定义字段（zd）整行删除。

2. 如果添加字段后，发现该字段对应的功能未生效，请先排查在用的博客主题是否也存在相同的字段名称。

作用 标签 导航 翻图 瀑布 日期 数据 头像 圆角 置顶 字段名称 bq dh ft pb rq sj tx yj zd 字段值格式 #标签#标签 mid,mid,mid 数值 数值 php 日期格式 数值 图片链接 数值 cid,cid,cid 字段值示例 #旅行#风景 1,32,68 1 2 Y-m-d h:i a 1 http://cdn.snapic.cn/img/logo.png 2 1,7,4,5 说明 使用 # 号开头紧跟关键词，仅支持两组。同时需在图片描述中同步添加，用于快捷筛选图片 填入要显示的分类 mid 以半角逗号隔开，不填入的 mid 该分类则隐藏 填入 1 时，图片灯箱效果有翻图功能 填入 2 时，图片区瀑布流为两栏，填入 3 时为三栏，填入 1 或删除字段 pb 则默认单栏（移动端统一单栏显示） 作用于每组图文的发布时间格式，具体写法请参考 PHP 日期格式 填入 1 时，鼠标滑过图片区时显示图片信息，如：编号、大小、Exif 等 填入图片链接则头像显示该图片，默认使用 Gravatar 头像，请确保该服务访问顺畅 填入 1 或 2 或 3 时，图片的四个直角对应倒圆角，圆角程度 3>2>1 填入要置顶的图片 cid（即该附件 cid 或图片信息中的编号）以半角逗号隔开，支持 1~4 张图片