Snapic Logs 使用文档

2022-08-08


版本型号:Snapic Logs(单页版)
适用程序:Typecho
皮肤类型:页面模板
模板作者:Lopwon
作者博客:Lopwon.com
发布页面:Lopwon.com/snapic-logs.html
官方演示:Snapic Logs
网友案例:(留言申请)

我要购买:Lopwon.com/snapic.html

敬告:模板 Lopwon Logs 需要在新窗口单独使用,如果你在用的主题限制新窗口打开独立页面,谨慎购买,感谢网友(浪荡子)的反馈。

模板说明

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

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

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

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

2. 不使用外部公共JS,无被挂马风险。

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

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

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

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

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

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

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

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

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

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

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

主题更新

2022年08月31日 发布 Snapic Logs


使用方法

A 部署文件

1. 将压缩包里的文件夹 Snapic 及其内部的所有文件,和文件 Snapic-Logs.php 及 attachment.php 上传至目录 usr/themes 中的你的主题文件夹里。如:你的主题文件夹是 default,那么就上传至 usr/themes/default 里(需要注意的是:文件 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图示2

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

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 张图片
Store

2 条评论

  1. 浪荡子 3

    同时购买两个不同的单页同时使用冲突吗?

    1. Lopwon Lopwon 博主
      @ 浪荡子

      不冲突,演示的所有插件和单页模板,都是使用一个博客 snapic.cn/demo 显示。

Typecho Store

免费获取 Typecho 限定插件

使用 Lopwon POP 实现
修仙 修仙