顶!插件

cybozu发表于:2016年12月22日 18:03:32更新于:2023年04月07日 09:43:58

Index

注意事项

  • 直接使用此处提供的程序范例的情况,才望子不予以保证程序的正常运行。

  • 才望子不提供对程序范例的技术支持。

  • kintone的插件功能只可在标准版使用,简易版不可使用这点请大家注意一下。

概要

记录列表页面、记录详情页面可以设置 “顶” 按钮的插件。
※要导入这个范例的插件文件,需要事先进行打包工作。

完成的样子

001586f109bedeb808655ec61324aa1

001586f10aaa24e4011db39c9156ac3

設定画面

0015b446eed5e9a1d318f1ba4389781

范例插件

访问GitHub,并下载各个文件夹。这些文件夹的里面有一个叫 “examples/vote” 的,是这次使用的整个文件包。
以下是 “vote” 下的文件结构。

vote/
 css/
   -51-modern-default.css
   -vote.css
 html/
   -config.html
 image/
   -icon.png
 js/
   -config.js
   -vote.js
 manifest.json

※ 使用这个包,从v1.0升级到v1.1以上的时候,需要在插件的设置页面再保存一下之前的设置。

另外升级前点了顶的人和点了顶的人数,在升级后将不会被保留,需要注意。

更新履历

2015/1/10 v1.0 公开

2017/2/20 v1.1 公开:修正了重复利用记录时,点了顶的人和点了顶的人数不会被保留的问题。

2017/5/31 v1.2 公开:插件设置页面的样式表更换成了新样式(51-current-default.css)。

2017/7/19 v1.3 公开:样式表的文件名从“51-current-default.css”换成了“51-modern-default.css”。以及一些其他的细节修正。

2017/11/22 v1.4 公开:使用程序来获取表单的设置API做了以下的变更:

- config.js 替换成了获取表单的布局。

- vote.js 替换成了获取字段的列表。

2017/12/05 公开:修正了没有管理员权限的用户在列表页面无法点“顶”的bug(仅v1.4)。

2018/06/01 v1.6 公开:做了以下的对应。

- 设置页面的本地化对应(英语)

- 来宾空间内的应用里,修正成列表页面也可以显示“顶”按钮

- 创建时间的字段代码可以改成“创建时间”以外的

- 设置页面说明文的添加・修正

- 修正了设置页面的选择项目(下拉框)的设计

- 列表中记录编号设置成不显示时,删除原有的错误信息

 ※列表中记录编号设置成不显示时,虽然“顶”按钮不显示,无法在列表页面上使用这个功能,

  但是不会显示错误信息,可以正常使用列表。

2018/07/06 v1.6.1 公开:设置页面的本地化对应(中文)

2019/12/04 公开v1.7.0版:可在移动客户端的记录详情页面里显示顶按钮。

2023/2/15 公开v1.7.1 版:已采取以下措施,以便可以使用screen reader进行操作。

-可以使用 Tab 键将焦点放在“顶!”按钮上

-可以用回车键点击

注意事项

  • 直接使用此处提供的程序范例的情况,才望子不予以保证程序的正常运行。

  • 才望子不提供对程序范例的技术支持。

插件文件的结构

文件夹:css

  • 51-modern-default.css
    才望子所提供的插件设置页面的样式。

  • vote.css
    用于调整 “顶!” 图标的样式。

文件夹:html

  • config.html
    插件设置页面的HTML。

    此文件用于制作设置页面,可设置用于显示“顶!”的如下字段。

    • 「点了顶的人」使用的字段

    • 「点了顶的人数」使用的字段

文件夹:image

  • icon.png
    插件的图标

文件夹:js

  • config.js
    插件设置页面的程序。这里主要是下面的处理。

    1.点击 “保存” 按钮的时候,将设置值放入插件的变量里。

    2.点击 “取消” 按钮的时候,回到之前的页面。

    3.已经设置插件的变量的情况下,设置各个字段的值。

  • vote.js
    用于配置顶!图标的程序。这个文件主要进行下面的3个处理。

    1.在记录列表页面的 “记录编号” 字段里添加顶图标。

    2.在记录详情页面的 “记录编号” 字段里添加顶图标。

    3.在记录添加/编辑页面,作为 “点了顶的人” 和 “点了顶的人数” 使用的字段不可以编辑。

文件夹:manifest.json

插件的资源配置清单文件。

打包

请参考插件开发流程的 《插件开发流程》的 “打包插件所需的所有文件”

导入&动作确认

  1. 要使用插件,需要在应用里设置用户选择字段和数值字段。

  2. 在设置页面上,导入下载好的 “plugin.zip” 到kintone系统管理页面。

  3. 在待安装插件的应用设置页面上,安装 “顶!插件”。

  4. 在插件的设置页面,设置要作为 “点了顶的人” 的用户选择字段和要作为 “点了顶的人数” 的数值字段。

“kintone活动日历插件的作成范例 ”的教程里介绍了插件的安装方法和动作确认,大家可以参考一下。

限制事项

  • 记录详情页面或者列表页面上点击“顶”按钮,想要继续编辑记录的时候,需要在编辑前更新页面。

所使用的OSS许可证信息

此插件使用的OSS许可证如下: