SubTask Due Date

• Adds a new due date field for subtasks.
• Adds Calendar Events for Subtasks to User and Project Calendars.
• Adds API Procedures for subtask due date field, createSubtaskdd & updateSubtaskdd
• Adds filter `subtask_due` - Chain-able, i.e. `subtask_due:today subtask:assignee:name` will filter for subtasks due `today`, assigned to `name`

Filter

Search by the due date

Attribute: subtask_due

• Search tasks due today: ``subtask_due:today``
• Search tasks due tomorrow: ``subtask_due:tomorrow``
• Search tasks due yesterday: ``subtask_due:yesterday``
• Search tasks due with the exact date: ``subtask_due:2015-06-29``
• Search tasks without a due date: ``subtask_due:none``

The date must use the ISO 8601 format: YYYY-MM-DD.

All string formats supported by the `strtotime()` function are supported, for example `next Thursday,-2 days,+2 months`, `tomorrow`, etc.

Operators supported with a date:

• Greater than: subtask_due:>2015-06-29
• Lower than: subtask_due:<2015-06-29
• Greater than or equal: subtask_due:>=2015-06-29
• Lower than or equal: subtask_due:<=2015-06-29

API

createSubtaskdd

• Purpose: Create a new subtask

• Parameters:

  - task_id (integer, required) - title (integer, required) - user_id (int, optional) - time_estimated (int, optional) - time_spent (int, optional) - status (int, optional) - due_date (int, optional)

• Result on success: subtask_id
• Result on failure: false

Request example:

{
    "jsonrpc": "2.0",
    "method": "createSubtaskdd",
    "id": 2041554661,
    "params": {
        "task_id": 1,
        "title": "Subtask #1",
        "due_date": 1523998125
    }
}

Response example:

{
    "jsonrpc": "2.0",
    "id": 2041554661,
    "result": 45
}

updateSubtaskdd

• Purpose: Update a subtask

• Parameters:

  - id (integer, required) - task_id (integer, required) - title (integer, optional) - user_id (integer, optional) - time_estimated (integer, optional) - time_spent (integer, optional) - status (integer, optional) - due_date (int, optional)

• Result on success: true
• Result on failure: false

Request example:

.. code:: json

{
    "jsonrpc": "2.0",
    "method": "updateSubtaskdd",
    "id": 191749979,
    "params": {
        "id": 1,
        "task_id": 1,
        "status": 1,
        "time_spent": 5,
        "user_id": 1,
        "due_date": 1523998125
    }
}

Response example:

.. code:: json

{
    "jsonrpc": "2.0",
    "id": 191749979,
    "result": true
}

Authors

• Manuel Raposo / Craig Crosby
• License MIT

Requirements

• Kanboard >= 1.0.34
• PHP >= 5.3.3

PS: _(This is automatic for Subtaskdate versions >= 1.1.1)_ - Commented dashboard hook to work with versions >=1.0.41, if you are using a version prior to that, just uncomment lines 33 and 34

Installation

You have the choice between 3 methods:

1. Install the plugin from the Kanboard plugin manager in one click (not yet)
2. Download the zip file and decompress everything under the directory `plugins/Subtaskdate`
3. Clone this repository into the folder `plugins/Subtaskdate`

Note: Plugin folder is case-sensitive.