السلام عليكم ورحمة الله وبركاته

• منذ فترة إحتجت بعض الخواص لإستخدامها ضمن إطار العمل فكتبت تلك الإضافة فأحببت أشاركها إياكم ربما يحتاجها أحد.

الإضافة على الرابط التالي:

خواص الإضافة:

1- إقتطاع النص العربي.

2- تحويل التاريخ.

3- تحويل الأرقام -ليست عملية التفقيط-

4- تحويل الوقت المنقضي، لشكل أكثر سهولة في تحديد الوقت المنقضي دون عناء.

كيف يتم تهيئة الإضافة من خلال الـ composer :

1- قم بتعديل ملف composer.json الموجود في المجلد الأساسي للمشروع وإضافة الحزمة للـ require كالتالي:

"require": {
    ...
    "ahmedsaoud31/arabic": "dev-master"
}

2- قم بالدخول لمجلد المشروع من خلال cmd على نظام Windows أو الـ terminal على نظام Linux أو غيرهم.

3- قم بتحديث المكتبات عبر الأمر composer update

4- إفتح الملف app/config/app.php وأضف السطر التالي لمصفوفة الـproviders:

'Ahmedsaoud31\Arabic\ArabicServiceProvider',

إستخدام الإضافة:

1- لإقتطاع النص:

    $arabicText = 'إضافة اللغة العربية لإطار العمل لارافيل';
    $len = 40;
    echo Arabic::cut($arabicText, $len);

سيكون الناتج على الشكل التالي:

إضافة اللغة العربية...

2- لتحويل التاريخ، الدالة adate تستخدم نفس نمط الدالة date ولكني لم أستخدم جميع الإختصارات فقط ما أحتجت له وهو أسماء الأشهر كاملة وأسماء الأيام كاملة وصباحاً ومساءاً، طبعاً يمكن التعديل بسهولة على الكود ليشمل التعديلات التي تريدها.

• ملاحظة: تم إستخدام التنسيق المستخدم في بلدي لتسمية الأشهر يمكن التعديل، أو تعميم الكود ليشمل عدة صيغ أخرى.

          echo Arabic::adate('w j من F Y g:i A');
  

وسيكون الناتج كالتالي:

٠ ١ من فبراير ٢٠١٥ ١:٠١ مساءاً

• ملاحظة: الدالة تأخذ وسيط هو الوقت عبارة عن التاريخ بالصيغة المستخدمة في الدالة strtotime أو على شكل timestamps في حال كان الوسيط فارغاً تعيد التوقيت الحالي للخادم.

3- لتحويل الأرقام مررها للدالة num كالتالي:

     echo Arabic::num('12.09');

ويكون الناتج كالتالي:

١٢٫٠٩

4- تحويل الوقت المنقضي من خلال الدالة since ويمكن تمرير الوقت لها بالصيغة المستخدمة في الدالة strtotime أو على شكل timestamps كالتالي:

echo 'منذ '.Arabic::since('1-1-2015');

ستكون الأشكال على النحو التالي:

منذ ثوان

منذ 32 دقيقة

منذ ساعة و 20 دقيقة

منذ 10 ساعات و 10 دقائق

منذ يوم و 15 دقيقة

منذ يوم و ساعة

منذ يوم و 12 ساعة

منذ إسبوع و ثوان

منذ إسبوع و ساعة

منذ إسبوع و 5 أيام

منذ شهر و يوم

منذ شهر و إسبوع

منذ شهر و إسبوعان

منذ 10 أشهر و 6 أيام

منذ عام و إسبوع

منذ عام و شهر

منذ 3 أعوام و 5 أشهر