Skip to content

Commit 761e0e1

Browse files
authored
Update README.md
1 parent ce6e6c9 commit 761e0e1

File tree

1 file changed

+51
-1
lines changed

1 file changed

+51
-1
lines changed

README.md

Lines changed: 51 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,51 @@
1-
# SAMPLE-Profile-tooltip-Plug-in
1+
# [Sample plug-in: Profile Tooltip Plug-in]
2+
## Purpose of the Sample Plug-in
3+
This sample plug-in is available for educational purposes.
4+
Use this plug-in to understand how Kintone plug-ins work, and how they are structured.
5+
6+
## What the plug-in does
7+
This plug-in displays tooltips next to users listed in the User Selection field when they are hovered over with a mouse.
8+
9+
## Plug-in directory structure
10+
This sample plug-in is created with the following directory structure.
11+
12+
src/
13+
├── html/
14+
│        └──── config.html
15+
├── css/
16+
│        ├──── 51-modern-default.css
17+
│        ├──── config.css
18+
│        └──── desktop.css
19+
├── js/
20+
│        ├──── config.js
21+
│        └──── desktop.js
22+
├── image/
23+
│        └──── comment.png
24+
└── manifest.json
25+
26+
## How to use
27+
To simply test out the plug-in on your Kintone domain, follow these steps:
28+
29+
1. Download the plug-in zip file
30+
Reference: https://github.com/kintone/SAMPLE-Date-input-button-Plug-in/releases
31+
2. Install the plug-in into your domain
32+
Reference: https://get.kintone.help/hc/en-us/articles/115001519707-Installing-Viewing-Plug-ins
33+
3. Add the plug-in to a specific Kintone App
34+
Reference: https://get.kintone.help/hc/en-us/articles/115001511188-Adding-Plug-ins-to-an-App
35+
4. Make sure that a User Selection field is placed in the form of your Kintone App. Access the plug-in settings, and set up the neccessary settings. Save the settings, and update the App.
36+
5. Click the + button on the Record List page to start adding a new record. Add a user (or multiple users) to the User Selection field and save the record. Hover over a user in the User Selection field. A black tooltip with user information should appear to the right.
37+
38+
## How to modify
39+
1. Fork to your repo
40+
2. Make changes to files under /src
41+
3. Repackage the plug-in by:
42+
i. Zipping the manifest.json file, css directory, html directory, image directory and js directory into one zip file.
43+
ii. Drag and dropping the file into the [kintone plug-in packer](https://kintone.github.io/plugin-packer/).
44+
45+
## Pull Request Policy
46+
As this repo exists for educational purposes, we will most likely turn down pull requests that contain updates with new features.
47+
Please feel free to host plug-ins with new features on your own repository.
48+
Bug fixes are happily accepted.
49+
50+
## More information
51+
This sample plug-in uses Tippy.js, found here: https://atomiks.github.io/tippyjs/

0 commit comments

Comments
 (0)