e2consult / novachecklists
A Laravel Nova field to display a list of items to complete.
Installs: 11 131
Dependents: 0
Suggesters: 0
Security: 0
Stars: 9
Watchers: 2
Forks: 5
Open Issues: 2
Language:Vue
Requires
- php: >=7.2.0
This package is not auto-updated.
Last update: 2024-11-12 15:59:47 UTC
README
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.
You can edit an existing item by clicking on it.
Detail-page
The ->showTimestamps()
method lets you show how long ago a task was completed.
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.
use E2Consult\NovaChecklist\Checklist; Checklist::make('Tasks') ->placeholder('Add task ') ->withPlaceholderCount() ->logUsers() ->showTimestamps() ->showItemStatusOnIndex() ->showCompletionOnIndex(),
License
The MIT License (MIT).