[Sample plug-in: Date from now plug-in]

Purpose of the Sample Plug-in

This sample plug-in is available for educational purposes.
Use this plug-in to understand how Kintone plug-ins work, and how they are structured. A non-packaged version written with a single JavaScript file can be found here: https://kintone.dev/en/tutorials/manipulate-display-format/customize-date-formats/

What the plug-in does

This sample plug-in converts the date into a '~minutes/hours/etc ago' format in the selected language. The new format is placed in the Record List instead of the original date format.

Plug-in directory structure

This sample plug-in is created with the following directory structure.

src/
├── html/
│        └──── config.html
├── css/
│        ├──── 51-modern-default.css
│        └──── config.css
├── js/
│        ├──── config.js
│        └──── desktop.js
├── image/
│ └──── tear_off_calendar.png
└── manifest.json

How to use

To simply test out the plug-in on your Kintone domain, follow these steps:

1. Download the plug-in zip file
   Reference: https://github.com/kintone/SAMPLE-Show-DoW-plug-in/releases
2. Install the plug-in into your domain
   Reference: https://get.kintone.help/hc/en-us/articles/115001519707-Installing-Viewing-Plug-ins
3. Add the plug-in to a specific Kintone App
   Reference: https://get.kintone.help/hc/en-us/articles/115001511188-Adding-Plug-ins-to-an-App
4. Make sure that a Datetime field is placed in the form of your Kintone App. Access the plug-in settings, and enter in the necessary settings. Save the settings, and update the App.
5. Click the + button on the Record List page to start adding a new record. Select a date and time from the Datetime field and save the record. Navigate back to the Record List page. The Datetime field will now say "__ minutes/hours/days ago" in the selected language rather than the original date and time format.

How to modify

1. Fork to your repo
2. Make changes to files under /src
3. Repackage the plug-in by:
   i. Zipping the manifest.json file, css directory, html directory, image directory and js directory into one zip file.
   ii. Drag and dropping the file into the kintone plug-in packer.

Pull Request Policy

As this repo exists for educational purposes, we will most likely turn down pull requests that contain updates with new features.
Please feel free to host plug-ins with new features on your own repository.
Bug fixes are happily accepted.