|
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