Skip to content

Abdipour/akaunting-jalali-date

Repository files navigation

فارسی | English (انگلیسی)

ماژول تاریخ شمسی اکانتینگ (نسخه ۲)

این ماژول پشتیبانی کامل از تقویم جلالی (شمسی) را به سیستم اکانتینگ نسخه ۳ اضافه می‌کند. تمامی تبدیل‌های تاریخی در سمت مرورگر انجام می‌شود تا سرعت و امنیت داده‌های شما حفظ شود.

⚠️ هشدار در مورد محدودیت‌های لایسنس

از نسخه 3.1.20 به بعد، سیستم Akaunting مکانیزمی را اضافه کرده که ماژول‌های شخصی یا محلی (که در مارکت رسمی ثبت نشده باشند) را به صورت خودکار حذف (Uninstall) می‌کند.

ما این مشکل را به تیم توسعه اکانتینگ گزارش دادیم، اما متاسفانه ایشو (Issue) مربوطه بدون هیچ پاسخی پاک شد: لینک ایشو حذف شده #3330.

برای حل این مشکل، ما یک اسکریپت «نصب‌کننده و پچ‌کننده» آماده کرده‌ایم که نام ماژول را در لیست سفید هسته برنامه قرار می‌دهد.


نصب خودکار و هوشمند (پیشنهادی)

راحت‌ترین راه برای نصب و جلوگیری از حذف خودکار ماژول، استفاده از اسکریپت اختصاصی ماست:

  1. فایل installer.php را از این مخزن دانلود کنید.
  2. آن را در پوشه اصلی (Root) اکانتینگ آپلود کنید (جایی که فایل .env قرار دارد).
  3. دستور زیر را در ترمینال اجرا کنید:
   php installer.php

این اسکریپت چه کارهایی انجام می‌دهد؟

  • آخرین نسخه سورس کد ماژول را دانلود می‌کند.
  • وابستگی‌های Composer را بررسی و نصب می‌کند.
  • فایل هسته /app/Traits/Modules.php را اصلاح می‌کند تا از حذف خودکار ماژول جلوگیری شود.
  • ماژول را نصب و فعال‌سازی می‌کند.

🛠 نصب دستی (برای کاربران حرفه‌ای)

اگر مایل به نصب دستی هستید:

  1. سورس ماژول را در مسیر modules/JalaliDate قرار دهید.
  2. اصلاح هسته: فایل app/Traits/Modules.php را باز کرده و عبارت if ($alias == 'core') { را پیدا کنید. آن را به شکل زیر تغییر دهید:
if ($alias == 'core' || $alias == 'jalali-date') {
  1. نصب وابستگی‌ها:
cd modules/JalaliDate && composer install
  1. فعال‌سازی:
php artisan module:install JalaliDate 1
php artisan optimize:clear

قابلیت‌های کلیدی

  • انتخابگر دوگانه: جابجایی سریع بین تقویم شمسی و میلادی در تمامی فیلدها.
  • تبدیل سمت کلاینت: بدون تغییر در دیتابیس اصلی سرور.
  • قالب فاکتور فارسی: طراحی اختصاصی فاکتور با فونت زیبای وزیرمتن.
  • سازگاری: تست شده روی اکانتینگ نسخه 3.1.2x.

لایسنس

MIT License.

About

An Akaunting module that adds full Jalali (Persian) calendar support for dates and datepickers.

Topics

Resources

Stars

Watchers

Forks

Contributors