Skip to content

encima-io/novachecklists

Repository files navigation

Laravel Nova Checklist Field

Latest Version on Packagist License Total Downloads

E2Consult is a webdevelopment team based in Oslo, Norway. You'll find more information about us on our website.

This package is made to allow you to easily create checklists in Laravel Nova. All you need is a text/json column on you model to store the items.

Installation

You can install the package via composer:

composer require e2consult/novachecklists

Usage

use E2Consult\NovaChecklist\Checklist;

Checklist::make('Tasks')
    ->placeholder('Add another task')   // Defaults to "Add item"
    ->withPlaceholderCount()            // Not active by default
    ->logUsers()                        // Not active by default, accepts user-model column. Uses "name" when column isn't provided.
    ->showTimestamps()                  // Not active by default
    ->showItemStatusOnIndex()           // Not active by default
    ->showCompletionOnIndex(),          // Not active by default

To use this package you'll need a text or JSON column on you model to save the items/tasks, as they are persisted as json on your model.

Form-page

The ->placeholder() method allows you to specify your placeholder-text for the "add new item field".

The ->withPlaceholderCount() method lets you show the item number when adding new item. If there is already 5 items, then it will say "Add item 6".

The ->logUsers() method allows you to save which user created or completed the task/item. You specify which column on the User model you want to save on task, it default to use the "name" column.

Checklist-form-page

You can edit an existing item by clicking on it.

Checklist-form-page

Detail-page

The ->showTimestamps() method lets you show how long ago a task was completed.

Checklist-detail-page

Index-page

By default this package will only show the task count on the index page.

The ->showItemStatusOnIndex() will change the index to show how many tasks are completed of the total amount of tasks/items.

The ->showCompletionOnIndex() method will let you show how many percent of the tasks are completed.

Checklist-detail-page

use E2Consult\NovaChecklist\Checklist;

Checklist::make('Tasks')
    ->placeholder('Add task ')
    ->withPlaceholderCount()
    ->logUsers()
    ->showTimestamps()
    ->showItemStatusOnIndex()
    ->showCompletionOnIndex(),

License

The MIT License (MIT).