Download the PHP package karnoweb/livewire-datepicker without Composer
On this page you can find all versions of the php package karnoweb/livewire-datepicker. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package livewire-datepicker
karnoweb/livewire-datepicker
Datepicker component for Livewire 3 with Alpine.js, supporting Jalali (Persian) and Gregorian calendars. Suitable for Laravel applications that need Persian date selection with optional Gregorian export.
Features
- Jalali & Gregorian — Display and select dates in Persian (Jalali) or Gregorian calendar
- Livewire 3 — Full integration with
wire:model(single, range, multiple) - Alpine.js — No jQuery; lightweight and reactive
- Export format — Show Jalali in UI but store Gregorian (e.g.
Y-m-d) in database - Date range — Select start and end date
- Multiple selection — Select multiple dates with optional
maxSelections - Min/Max & disabled dates — Limit selectable dates
- Theme — Light, dark, or auto (follows system)
- RTL — Right-to-left layout for Persian
- Accessible — ARIA attributes and keyboard navigation
- Customizable — Config file and optional view/asset publishing
Requirements
- PHP ^8.2
- Laravel ^11.0 | ^12.0
- Livewire ^3.0 | ^4.0
- Alpine.js (included with Livewire)
No extra npm packages or Vite setup are required in your app — the component loads its script automatically (jalaali-js is bundled inside the package).
Calendar conversion (tested packages)
- PHP: morilog/jalali (^3.4) — Jalali/Gregorian conversion; used by the package helpers
jalali_to_gregorian()andgregorian_to_jalali(). - JavaScript: jalaali-js — Borkowski algorithm; bundled inside the package and served automatically.
Installation
Publish config (optional)
Edit config/datepicker.php to set default formats, theme, first day of week, and locale strings.
The datepicker script (including jalaali-js) is loaded automatically when you use <x-jalali-datepicker>. No npm install or Vite entry in your app is required.
Usage
The component is registered as <x-jalali-datepicker> to avoid collision with Mary-UI's <x-datepicker>.
Basic (Jalali, single date)
With label and placeholder
Gregorian calendar (display)
Show Jalali, store Gregorian
Useful when the database column is a standard date (Y-m-d):
Date range
wire:model will receive an object like { "start": "1403/01/01", "end": "1403/01/15" } (or Gregorian if export-calendar="gregorian").
Multiple dates
Optional: limit number of selections:
Min / max date
Use the same format as input-format (default Y/m/d for Jalali).
Disabled dates
Pass an array of date strings in the same format:
Custom formats
- input-format — Format shown in the input and used for min/max/disabled (e.g.
Y/m/d,d/m/Y). - export-format — Format sent to Livewire (e.g.
Y-m-d,Y/m/d).
Theme
light/dark/auto(default from config). Override:
Position
Dropdown position (e.g. bottom-start, top-end):
Inline
Show calendar always open (no dropdown):
Required / disabled
Default value
Set initial value (same format as export):
Component attributes
| Attribute | Type | Default | Description |
|---|---|---|---|
wire:model |
string | — | Livewire property (required for binding) |
id |
string | auto | Unique ID for the wrapper |
label |
string | null | Label text above the input |
jalali |
bool | true | Use Jalali (true) or Gregorian (false) |
range |
bool | false | Enable date range selection |
multiple |
bool | false | Allow multiple date selection |
required |
bool | false | HTML required |
disabled |
bool | false | Disable input |
inline |
bool | false | Always show calendar (no dropdown) |
min-date |
string | null | Minimum selectable date |
max-date |
string | null | Maximum selectable date |
disabled-dates |
array | [] | List of disabled date strings |
input-format |
string | from config | Display/input format (e.g. Y/m/d) |
export-format |
string | from config | Value format sent to Livewire (e.g. Y-m-d) |
export-calendar |
string | same | same or gregorian (when jalali=true) |
placeholder |
string | locale default | Input placeholder |
default |
string | null | Initial value |
theme |
string | from config | light / dark / auto |
position |
string | bottom-start | Dropdown position |
max-selections |
int | null | Max dates when multiple=true |
Configuration
After publishing config (config/datepicker.php):
- default_calendar —
jalaliorgregorian - formats.input — Default input/display format (e.g.
Y/m/d) - formats.export — Default export format (e.g.
Y-m-d) - jalali / gregorian — Month and weekday names for i18n
- theme —
auto,light, ordark - first_day_of_week — 0 (Sunday) or 6 (Saturday) for Gregorian/Jalali
- holidays — Reserved for future use
Helper functions (PHP)
The package provides two helpers for server-side conversion:
Publishing views / assets
- Config:
php artisan vendor:publish --tag=datepicker-config - Views:
php artisan vendor:publish --tag=datepicker-views→ customize Blade underresources/views/vendor/datepicker - Assets (optional):
php artisan vendor:publish --tag=datepicker-assets→ copies raw JS sources topublic/vendor/datepicker(only if you want to build them in your app; normally the bundled script is served by the package)
Namespace
- Package:
karnoweb/livewire-datepicker - PHP namespace:
Karnoweb\LivewireDatepicker - Blade component:
<x-jalali-datepicker />(prefixjalalito avoid Mary-UI collision)
Releasing a new version
So clients can get the latest changes via Composer, each release must be tagged. Steps:
- Bump version in
composer.json(e.g.1.0.2→1.0.3). - Rebuild the JS bundle (if you changed
resources/js/): runnpm install && npm run buildand commitdist/datepicker.js. -
Commit your changes:
-
Create tag (match the version in composer.json):
- Push branch and tags:
Clients using "karnoweb/livewire-datepicker": "^1.0" can then run composer update karnoweb/livewire-datepicker to get the new release.
License
MIT.
All versions of livewire-datepicker with dependencies
illuminate/support Version ^11.0|^12.0
livewire/livewire Version ^3.0 || ^4.0
morilog/jalali Version ^3.4