PHPackages qadir/pashto-calendar - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Localization & i18n](/categories/localization) 4. / 5. qadir/pashto-calendar ActiveLibrary[Localization & i18n](/categories/localization) qadir/pashto-calendar ===================== A Laravel package for Pashto Solar Hijri calendar with localization and RTL support 10BladeCI failing Since Jun 18Pushed todayCompare [ Source](https://github.com/Abdulqadir1234/Pashto-calendar)[ Packagist](https://packagist.org/packages/qadir/pashto-calendar)[ RSS](/packages/qadir-pashto-calendar/feed)WikiDiscussions main Synced today READMEChangelogDependenciesVersions (1)Used By (0) Pashto Calendar for Laravel =========================== [](#pashto-calendar-for-laravel) [![Tests](https://github.com/Abdulqadir1234/Pashto-calendar/actions/workflows/tests.yml/badge.svg)](https://github.com/Abdulqadir1234/Pashto-calendar/actions/workflows/tests.yml)[![Latest Version on Packagist](https://camo.githubusercontent.com/9a75469eaeeeef4054c63c9e24a2c9438e399641b065df2547e7b889addb973d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f71616469722f70617368746f2d63616c656e6461722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/qadir/pashto-calendar)[![Total Downloads](https://camo.githubusercontent.com/4214a3c1723fca74d6d3cf6edc6006a2fe1d6e982d325239f0923c50e2d683a8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f71616469722f70617368746f2d63616c656e6461722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/qadir/pashto-calendar)[![License](https://camo.githubusercontent.com/2be8d1c2d5211db5d549c9426d9b24242ec2feb3ebaad714f6d328dbac93d71f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f416264756c7161646972313233342f50617368746f2d63616c656e6461723f7374796c653d666c61742d737175617265)](LICENSE.md)[![Laravel 10+](https://camo.githubusercontent.com/ef42137a084ea4260a0468ebba9e13704a042c3aa519fc965662092975f0ea2f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31302532422d4646324432303f7374796c653d666c61742d737175617265266c6f676f3d6c61726176656c)](https://laravel.com)[![Calendar Demo](https://raw.githubusercontent.com/Abdulqadir1234/Pashto-calendar/main/docs/screenshot.png)](https://raw.githubusercontent.com/Abdulqadir1234/Pashto-calendar/main/docs/screenshot.png) A comprehensive Laravel package for the **Pashto Solar Hijri (Shamsi) calendar** system used throughout Afghanistan. Includes bidirectional date conversion, event management, prayer times, interactive calendar UI, and full RTL/Pashto localization support. Table of Contents ----------------- [](#table-of-contents) - [Features](#features) - [Requirements](#requirements) - [Installation](#installation) - [Configuration](#configuration) - [Usage](#usage) - [Basic Date Operations](#basic-date-operations) - [Event Management](#event-management) - [Prayer Times](#prayer-times) - [Blade Components](#blade-components) - [Blade Directives](#blade-directives) - [Carbon Macros](#carbon-macros) - [Helper Functions](#helper-functions) - [Validation Rules](#validation-rules) - [Eloquent Cast](#eloquent-cast) - [iCal Export](#ical-export) - [Demo](#demo) - [Multi-Language Support](#multi-language-support) - [Artisan Commands](#artisan-commands) - [Testing](#testing) - [Contributing](#contributing) - [License](#license) - [Credits](#credits) Features -------- [](#features) - **πŸ”„ Bidirectional Date Conversion** β€” Convert seamlessly between Gregorian and Pashto (Jalali) calendars - **πŸ“… Event Management** β€” Create, update, and delete events with full recurrence support (daily, weekly, monthly, yearly) - **πŸ•Œ Prayer Times** β€” Accurate prayer times for all 34 Afghan provinces using Muslim World League method with Hanafi Asr - **πŸ† Holiday System** β€” 30+ built-in Afghan national holidays with Artisan refresh command - **πŸ“₯ iCal Export** β€” Export events to Google Calendar, Outlook, and Apple Calendar formats - **βš™οΈ Interactive Calendar UI** β€” AJAX-powered calendar with Alpine.js and Tailwind CSS - **🌍 Multi-Language Support** β€” Pashto, Dari, and English with automatic RTL layout - **πŸŒ™ Dark/Light Mode** β€” Theme persistence with localStorage - **🎨 Blade Components** β€” Pre-built components: ``, ``, `` - **✨ Blade Directives** β€” Convenient directives: `@pashtoDate`, `@pashtoNow`, `@pashtoNumber`, `@ifHoliday` - **πŸ”— Carbon Macros** β€” Fluent API: `now()->toPashto()`, `Carbon::parsePashto()` - **πŸ› οΈ Helper Functions** β€” `pashto_now()`, `pashto_number()`, `to_shamsi_pashto()`, and more - **βœ… Validation Rules** β€” `pashto_date`, `pashto_date_format`, `before_pashto_date`, `after_pashto_date` - **πŸ’Ύ Eloquent Cast** β€” `PashtoDateCast` for automatic model attribute conversion - **βš™οΈ Fully Configurable** β€” Language, numerals, RTL direction, week start, and more - **πŸ§ͺ Comprehensive Test Suite** β€” Pest tests with GitHub Actions CI/CD Requirements ------------ [](#requirements) - PHP 8.1 or higher - Laravel 10.0 or higher - SQLite, MySQL, PostgreSQL, or other supported database Installation ------------ [](#installation) ### 1. Install via Composer [](#1-install-via-composer) ``` composer require qadir/pashto-calendar ``` Publish Configuration & Assets: ``` php artisan vendor:publish --provider="Qadir\PashtoCalendar\PashtoCalendarServiceProvider" php artisan migrate ``` This publishes: - Configuration file: `config/pashto-calendar.php` - Database migrations - Language files: `lang/ps/`, `lang/fa/`, `lang/en/` - View components Run Migrations: ``` php artisan migrate ``` (Optional) Seed Holidays: ``` php artisan pashto:refresh-holidays ``` Configuration ------------- [](#configuration) ``` return [ // Default language: 'ps' (Pashto), 'fa' (Dari), 'en' (English) 'language' => env('PASHTO_CALENDAR_LANGUAGE', 'ps'), // Display RTL: auto-detected based on language, or force true/false 'rtl' => true, // Use Pashto numerals (Ϋ°Ϋ±Ϋ²Ϋ³...) or Western (0123...) 'use_pashto_numbers' => true, // First day of week: 0 = Sunday, 6 = Saturday 'first_day_of_week' => 6, // Saturday (Afghanistan standard) // Demo route path 'demo_route' => '/pashto-calendar', // Enable demo route 'enable_demo_route' => true, // Database table prefix 'table_prefix' => 'pashto_', ]; ``` Usage ----- [](#usage) ### Basic Date Operations [](#basic-date-operations) #### Get Current Pashto Date [](#get-current-pashto-date) ``` use Qadir\PashtoCalendar\Facades\PashtoCalendar; $today = PashtoCalendar::now(); echo $today->year; // 1405 echo $today->month; // 3 echo $today->day; // 23 echo $today->monthName(); // "غویی" (Pashto month name) echo $today->dayName(); // "ΫŒΪ©Ψ΄Ω†Ψ¨Ω‡" (Sunday in Pashto) ``` #### Convert Gregorian to Pashto [](#convert-gregorian-to-pashto) ``` $pashto = PashtoCalendar::fromGregorian('2024-03-20'); echo $pashto->format('Y/m/d'); // "1403/01/01" echo $pashto->format('Y-m-d H:i'); // "1403-01-01 00:00" ``` #### Convert Pashto to Gregorian [](#convert-pashto-to-gregorian) ``` $gregorian = PashtoCalendar::toGregorian(1403, 1, 1); // Returns: Carbon instance for 2024-03-20 echo to_gregorian(1403, 1, 1); // "2024-03-20" ``` #### Generate Calendar Grid [](#generate-calendar-grid) ``` $days = PashtoCalendar::make(1405, 3); // Year 1405, Month 3 foreach ($days as $day) { if ($day['empty']) continue; // Skip empty cells echo $day['day']; // Day number echo $day['is_today']; // Is today? echo $day['is_friday']; // Is Friday? echo $day['is_holiday']; // Is holiday? echo $day['holiday_name']; // Holiday name if applicable echo $day['events']; // Associated events array } ``` ### Event Management [](#event-management) #### Create Event [](#create-event) ``` use Qadir\PashtoCalendar\Events\EventManager; $event = EventManager::add([ 'title' => 'Team Meeting', 'description' => 'Quarterly planning', 'year' => 1405, 'month' => 3, 'day' => 15, 'time' => '10:00', 'color' => '#3b82f6', 'recurrence' => 'weekly', // 'none', 'daily', 'weekly', 'monthly', 'yearly' 'recurrence_end_date' => '1405-06-15', ]); ``` #### Retrieve Events [](#retrieve-events) ``` // Events for specific date $events = EventManager::forDate(1405, 3, 15); // Events for entire month $events = EventManager::forMonth(1405, 3); // Today's events $events = EventManager::today(); // All events $events = EventManager::all(); ``` #### Update Event [](#update-event) ``` EventManager::update($eventId, [ 'title' => 'Updated Meeting', 'time' => '14:00', 'color' => '#ef4444', ]); ``` #### Delete Event [](#delete-event) ``` EventManager::delete($eventId); // Clear all events for a month EventManager::clearMonth(1405, 3); ``` ### Prayer Times [](#prayer-times) #### Prayer Times Component [](#prayer-times-component) ``` ``` Available cities: Kabul, Kandahar, Herat, Mazar-i-Sharif, Jalalabad, Kunduz, Bamyan, Badakhshan, Baghlan, Balkh, Daykundi, Faryab, Farah, Ghazni, Ghor, Hilmand, Jawzjan, Kapisa, Kunar, Lagman, Logar, Nangarhar, Nimruz, Nurestan, Paktia, Paktika, Panshir, Parwan, Samangan, Saripul, Takhar, Urozgan, Wardak, Zabul. API Endpoint GET /pashto-calendar/prayer-times/{city} **Response:** ``` { "city": "kabul", "city_name": "Ϊ©Ψ§Ψ¨Ω„", "latitude": 34.5553, "longitude": 69.2075, "fajr": "02:47 AM", "sunrise": "04:37 AM", "dhuhr": "11:55 AM", "asr": "03:45 PM", "maghrib": "07:14 PM", "isha": "09:04 PM" } ``` ### Blade Components [](#blade-components) #### Full Calendar [](#full-calendar) ``` ``` #### Mini Calendar [](#mini-calendar) ``` ``` #### Prayer Times [](#prayer-times-1) ``` ``` ### Blade Directives [](#blade-directives) #### Display Pashto Date [](#display-pashto-date) ``` {{-- Display Pashto Date --}} @pashtoDate($post->created_at) {{-- Display Current Pashto Date --}} @pashtoNow {{-- Convert Number to Pashto --}} @pashtoNumber(1405) {{-- Holiday Conditional --}} @ifHoliday(1, 1) πŸŽ‰ Happy Nowroz! (Afghan New Year) @endIfHoliday ``` ### Carbon Macros [](#carbon-macros) ``` use Illuminate\Support\Carbon; // Convert Carbon to Pashto $pashtoDate = now()->toPashto(); echo $pashtoDate->year; // 1405 // Parse Pashto date to Carbon $carbon = Carbon::parsePashto(1405, 3, 23); echo $carbon->format('Y-m-d'); // 2026-06-14 // Check if Pashto holiday if (now()->isPashtoHoliday()) { echo "Today is a holiday!"; } ``` ### Helper Functions [](#helper-functions) ``` // Get current Pashto date $today = pashto_now(); echo $today->year; // 1405 // Convert number to Pashto numerals $pashtoNum = pashto_number(1405); echo $pashtoNum; // Ϋ±Ϋ΄Ϋ°Ϋ΅ // Convert Gregorian to Pashto $shamsi = to_shamsi_pashto(2024, 3, 20); echo $shamsi; // "Ϋ±Ϋ΄Ϋ°Ϋ³/Ϋ°Ϋ±/Ϋ°Ϋ±" // Convert Pashto to Gregorian $gregorian = to_gregorian(1403, 1, 1); echo $gregorian; // "2024-03-20" // Get Pashto month name $month = pashto_month_name(3); echo $month; // "غویی" // Get Pashto day name $day = pashto_day_name(0); // 0 = Sunday echo $day; // "ΫŒΪ©Ψ΄Ω†Ψ¨Ω‡" ``` ### Validation Rules [](#validation-rules) ``` $request->validate([ 'birth_date' => 'required|pashto_date', 'event_date' => 'required|pashto_date_format:Y/m/d', 'start_date' => 'required|before_pashto_date:1406/12/29', 'end_date' => 'required|after_pashto_date:1403/01/01', ]); ``` ### Eloquent Cast [](#eloquent-cast) ``` use Qadir\PashtoCalendar\Casts\PashtoDateCast; use Illuminate\Database\Eloquent\Model; class Event extends Model { protected $casts = [ 'event_date' => PashtoDateCast::class, ]; } // Usage $event = Event::find(1); echo $event->event_date->year; // 1405 echo $event->event_date->month; // 3 ``` ### iCal Export [](#ical-export) Export events to .ics format for Google Calendar, Outlook, and Apple Calendar ``` πŸ“₯ Export to Calendar ``` Or via API: GET /pashto-calendar/export/{year}/{month}.ics Demo ---- [](#demo) Visit the interactive calendar demo at: The demo includes: ✨ Full interactive calendar with month navigation πŸ“… Event creation, editing, and deletion πŸ•Œ Real-time prayer times πŸŒ™ Dark/Light mode toggle 🌍 Multi-language support πŸ“± Fully responsive design Disable demo route in config/pashto-calendar.php: 'enable\_demo\_route' => false, Multi-Language Support ---------------------- [](#multi-language-support) The package supports Pashto (ps), Dari (fa), and English (en). Set Application Language In config/app.php: ``` 'locale' => 'ps', // or 'fa', 'en' ``` Or dynamically: ``` App::setLocale('ps'); ``` ### Publish Language Files: [](#publish-language-files) ``` php artisan vendor:publish --tag=pashto-calendar-lang ``` Artisan Commands ---------------- [](#artisan-commands) Refresh Holidays Update holiday database from configuration: Refresh for current year Refresh for specific year ``` php artisan pashto:refresh-holidays php artisan pashto:refresh-holidays 1406 php artisan pashto:refresh-holidays --year=1405-1410 ``` Testing ------- [](#testing) ``` composer test composer test tests/Unit/PashtoCalendarTest.php composer test -- --coverage ``` Contributing ------------ [](#contributing) We welcome contributions! Please read CONTRIBUTING.md for guidelines. License ------- [](#license) This package is licensed under the MIT License. See LICENSE.md for details. Credits ------- [](#credits) - Author: Abdul Qadir Nasrat - Contributors: See CONTRIBUTORS.md - Inspired by: Laravel ecosystem best practices and Hijri Calendar implementations ### Health Score 21 β€” LowBetter than 18% of packages Maintenance65 Regular maintenance activity Popularity2 Limited adoption so far Community6 Small or concentrated contributor base Maturity11 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits β€” single point of failure How is this calculated?**Maintenance (25%)** β€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** β€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** β€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** β€” Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/211700242?v=4)[Abdul Qadir Nasrat](/maintainers/Abdulqadir1234)[@Abdulqadir1234](https://github.com/Abdulqadir1234) --- Top Contributors [![Abdulqadir1234](https://avatars.githubusercontent.com/u/211700242?v=4)](https://github.com/Abdulqadir1234 "Abdulqadir1234 (83 commits)") ### Embed Badge ![Health badge](/badges/qadir-pashto-calendar/health.svg) ``` [![Health](https://phpackages.com/badges/qadir-pashto-calendar/health.svg)](https://phpackages.com/packages/qadir-pashto-calendar) ``` ### Alternatives [php-translation/translator Translator services 25224.8k5](/packages/php-translation-translator)[longman/laravel-multilang Package to integrate multi language (multi locale) functionality in Laravel 5.x 5514.5k1](/packages/longman-laravel-multilang)[smmoosavi/php-gettext Wrapper for php-gettext by danilo segan. This library provides PHP functions to read MO files even when gettext is not compiled in or when appropriate locale is not present on the system. 1926.6k1](/packages/smmoosavi-php-gettext)[amendozaaguiar/laraveles-spanish-for-jetstream Archivos de traducciΓ³n al espaΓ±ol latinoamericano para Laravel con Jetstream (auth, pagination, passwords, validation + todas las cadenas de Jetstream). 1512.6k](/packages/amendozaaguiar-laraveles-spanish-for-jetstream)[laradevs/spanish labels translated to spanish 166.7k](/packages/laradevs-spanish) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)