/SAMPLE-Date-from-now-plug-in

This sample plug-in changes the displayed date on the record list into a different format, so as to display it in the format of "xx days ago".

Primary LanguageCSSMIT LicenseMIT

[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.