https://github.com/ctsit/prevent_past_or_future_dates

This REDCap module adds actions tags @PREVENT-FUTUREDATE and @PREVENT-PASTDATE that can be applied to date fields - i.e., a text field with date validation applied.
https://github.com/ctsit/prevent_past_or_future_dates

redcap redcap-external-module redcap-repo

Last synced: about 1 month ago
JSON representation

This REDCap module adds actions tags @PREVENT-FUTUREDATE and @PREVENT-PASTDATE that can be applied to date fields - i.e., a text field with date validation applied.

• Host: GitHub
• URL: https://github.com/ctsit/prevent_past_or_future_dates
• Owner: ctsit
• License: other
• Created: 2021-01-21T16:23:31.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2024-09-17T00:16:47.000Z (3 months ago)
• Last Synced: 2024-09-18T03:05:36.685Z (3 months ago)
• Topics: redcap, redcap-external-module, redcap-repo
• Language: JavaScript
• Homepage:
• Size: 99.6 KB
• Stars: 1
• Watchers: 6
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Prevent Past or Future Dates

[![DOI](http://zenodo.org/badge/DOI/10.5281/zenodo.4681708.svg)](http://doi.org/10.5281/zenodo.4681708)

This REDCap module adds actions tags __@PREVENT-FUTUREDATE__ and __@PREVENT-PASTDATE__ that can be applied to date fields - i.e., a text field with date validation applied - to disallow entry of dates in the future or past, respectively. The tags are mutually exclusive, applying both tags will not result in any date restrictions. To enforce today's date use the __@TODAY__ action tag instead.

![Prevent Future Date](img/prevent_futuredate_mdy.png)

## Prerequisites

- REDCap >= 14.0.2

- PHP >= 7.4

## Installation

- Clone this repo into to `/modules/prevent_past_or_future_dates_v0.0.0`.

- Go to **Control Center > Manage External Modules** and enable _Prevent Past or Future Dates_.

- For each project you want to use this module, go to the project home page, click on **Manage External Modules** link, and then enable _Prevent Past or Future Dates_ for that project.

## Expected Behavior

### Scenarios

|                              | Applied Tags                             | Dates available in Datepicker                                                         |

| -------------                | -------------                            | -------------                                                                         |

| Scenario 1                   | @PREVENT-FUTUREDATE                      | past - today                                                                          |

| Scenario 2                   | @PREVENT-PASTDATE                        | today - future                                                                        |

| Scenario 3 __NOT SUPPORTED__ | @PREVENT-FUTUREDATE && @PREVENT-PASTDATE | N/A - supplying both tags will not apply any date restrictions use __@TODAY__ instead |

### Existing Data

The action tags will _only_ apply to empty fields; if data already exists in a field when the form is loaded the action tag will _not_ apply to that field. This is to prevent annoyances when revisiting forms.

### Date vs Datetime field

This module handles date fields and datetime fields slightly differently:

* If a datetime field fails validation and the datetimepicker is opened and loses focus, the input will be updated automatically to the closest valid date.

* If a date field fails validation and the datepicker is opened and loses focus, the input will not be updated automatically. A validation alert will display and the value will need to be updated manually.