Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/adnane-ka/laravel-speaks-arabic
حزمة خفيفة الوزن تسهل التعامل مع المفاهيم العربية في لارافيل، بإستخدام مجموعة من الفئات، الأساليب والتوابع لجعل لارافل يتحدث العربي! مفاهيم من مثل السلاسل النصية العربي والتواريخ الهجرية وغيرها
https://github.com/adnane-ka/laravel-speaks-arabic
arabic-concepts arabic-numbers hijri-dates laravel-framework
Last synced: about 2 months ago
JSON representation
حزمة خفيفة الوزن تسهل التعامل مع المفاهيم العربية في لارافيل، بإستخدام مجموعة من الفئات، الأساليب والتوابع لجعل لارافل يتحدث العربي! مفاهيم من مثل السلاسل النصية العربي والتواريخ الهجرية وغيرها
- Host: GitHub
- URL: https://github.com/adnane-ka/laravel-speaks-arabic
- Owner: adnane-ka
- License: mit
- Created: 2021-03-24T16:13:42.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-05-15T14:09:24.000Z (over 2 years ago)
- Last Synced: 2024-11-08T05:25:50.839Z (about 2 months ago)
- Topics: arabic-concepts, arabic-numbers, hijri-dates, laravel-framework
- Language: PHP
- Homepage:
- Size: 88.9 KB
- Stars: 52
- Watchers: 1
- Forks: 14
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
## لارافيل يتحدث العربي - Laravel Speaks Arabic
[](https://packagist.org/packages/adnane/laravel-speaks-arabic)
[](LICENSE.md)
[](https://packagist.org/packages/adnane/laravel-speaks-arabic)
**حزمة خفيفة الوزن تسهل التعامل مع المفاهيم العربية في لارافيل، بإستخدام مجموعة من الفئات، الأساليب والتوابع لجعل لارافل يتحدث العربي! مفاهيم من مثل السلاسل النصية العربي والتواريخ الهجرية وغيرها**
**مثال**
```php
@toWords(12078437);
// اثنا عشر مليون و ثمان و سبعون ألف و أربع مئة و سبع و ثلاثون
```
## التثبيت
1. التثبيت عن طريق مدير الحزم composer
```
composer require adnane/laravel-speaks-arabic
```
2. قم بإضافة مزود خدمة الحزمة الى مصفوفة providers في ملف `config\app.php` كالتالي:
```php
'providers' => [
Adnane\Arabic\ArabicServiceProvider::class,
]
```
## كيفية الاستعمال
- بعد التأكد من تثبيت الحزمة على نحو صحيح، سيمكنك تضمين الفئة الرئيسية ```Adnane\Arabic\Arabic``` واستعمال توابعها بشكل عادي
> قم بتغيير ```method``` إلى التابع المراد كـ: ```Arabic::toWords(643646)``` أو كـ: ```arabic()->toWords(643646)```
```php
use Adnane\Arabic\Arabic;
Arabic::method($params)
// او مباشرة عن طريق الدالة المساعدة
arabic()::method($params)
```
## التوابع المتوفرة
**1.التعامل مع الأعداد**
```php
/**
* اعادة كتابة الاعداد كتابة لفظية انطلاقا من كتابة رمزية
* يسمى أيضا "تفقيط"
*
* @return string
*/
Arabic::toWords(int $integer)
/**
* اعادة كتابة الاعداد كتابة رمزية انطلاقا من كتابة لفظية
* هو عكس العملية السابقة
*
* @return int
*/
Arabic::fromWords(string $str)
/**
* جلب العدد الترتيبي انطلاقا من كتابة رمزية لعدد ما
* مثال: أول، ثان، ثالث
*
* @return string
*/
Arabic::toOrdinal(int $int)
/**
* اعادة كتابة الارقام الموجودة في سلسلة نصية ما
* كأرقام هندية (۰ - ۱ - ۲ - ۳ - ٤ - ٥ - ٦ - ٧ - ۸ - ۹)
*
* @return string
*/
Arabic::toIndianNums(string $str)
```
**2.التعامل مع التواريخ والتواقيت**
```php
/**
* تحويل تاريخ مكتوب بالتقويم الميلادي
* الى تاريخ مكتوب بالتقويم الهجري
* مكتوبا بصيغة معينة
*
* (الصيغ المدعومة : f , s , n )
* @return string
*/
Arabic::toHijri(string $format = 'f' ,string $date)
/**
* تحويل تاريخ مكتوب بالتقوم الهجري
* الى تاريخ مكتوب بالتقويم الميلادي
*
* @return string
*/
Arabic::fromHijri(string $date /*Y/m/d*/);
/**
* جلب فرق التوقيت بين وقتين او تاريخين.
* تمرير المعامل details بالقيمة true
* سيقوم باعادة فرق تفصيلي بين هاذين التوقيتين
*
* @return string
*/
Arabic::toRelative(string $date ,string $date2 = null ,boolean $detailed = false);
/**
* جلب توقيت ما انطلاقا من فرق مرفق
* مثال:
* Arabic::fromRelative('زد سنة')
* @return string
*/
Arabic::fromRelative(string $relative);
```
**3. التعامل مع السلاسل النصية**
```php
/**
* ازالة التشكيل من سلسلة نصية ما
*
* @return string
*/
Arabic::removeHarakat(string $str)
/**
* اعادة كتابة سلسلة نصية ما مكتوبة باللغة الانجليزية
* الى المرافق لها بلوحة مفاتيح عربية
* يمكن استعمال هاته الوظيفة في تحسين عمليات البحث داخل الموقع
*
* @return string
*/
Arabic::toKeyboardInput(string $str)
/**
* اعادة كتابة سلسلة نصية عربية ما
* بحروف انجليزية
* يمكن استعمال هاته الوظيفة في انشاء روابط صديقة البحث
* @return string
*/
Arabic::toSpelled(string $str)
/**
* المكافئ للدالة str_word_count في PHP
* من المهم جدا ملاحظة ان دالة ال PHP
* str_word_count
* لا تدعم اللغى العربية
* ولذلك ان هاته الوظيفة تعتبرا بديلا عنها في اللغة العريبة
* @return int
*/
Arabic::countWords(string $str);
/**
* التحقق من ما ان كانت سلسلة نصية ما تحوي على الأقل حرفا عربيا واحدا
* @return boolean
*/
Arabic::containsAr(string $str);
```
## أمثلة عن عدة استعمالات
```php
Arabic::toWords(56)
// ست وخمسون
Arabic::fromWords("ثمان مئة و خمسة")
// 805
Arabic::toOrdinal(12)
// الثاني عشر
Arabic::toIndianNums("ولد عليه الصلاة في 12 ربيع الأول")
// ولد عليه الصلاة في ۱۲ ربيع الاول
Arabic::toHijri('f' ,'2021/12/12')
// الثامن من جمادى الأولى من السنة الهجرية ألف و أربع مئة و ثلاث و أربعون
Arabic::fromHijri('1442/01/08')
// 8/27/2020
Arabic::toRelative('2010/01/10')
// منذ أحد عشر سنة
Arabic::toRelative('2010/01/10' ,'2008/01/10')
// ثلاث سنين
Arabic::toRelative('2010/01/10' ,'2008/01/10' ,true)
// [ "y" => 3 , "m" => 39 ,"w" => 156 , "d" => 1096 ,"h" => 26304 ,"mn" => 1578240 ,"s" => 94694400 ]
Arabic::fromRelative('زد سنة')
// 2022/03/28
Arabic::fromRelative('قل ست اشهر')
// 2020/09/28
Arabic::removeHarakat('لا حسَدَ إلَّا في اثنتيْنِ: رجلٌ آتاهُ اللهُ مالًا، فسلَّطَهُ على هلَكتِه في الحقِّ، ورجلٌ آتاهُ اللهُ الحِكمةَ، فهوَ يقضِي بِها، ويُعلِّمُها')
// لا حسد إلا في اثنتين: رجل آتاه الله مالا، فسلطه على هلكته في الحق، ورجل آتاه الله الحكمة، فهو يقضي بها، ويعلمها
Arabic::toKeyboardInput('dl;k hsjulhg ihji hg]hgm td jpsdk ulgdhj hgfpe fl,ru!')
// يمكن استعمال هاته الدالة في تحسين عمليات البحث بموقع!
Arabic::toSpelled("قد تساعد هاته الدالة في عمل slugs أو تحسين عمليات البحث")
// qd tsaaad haath āldaalt fii aml slugs āoo thsiin amliiāt ālbhth
Arabic::countWords("هاته الدالة هي المكافئة لاخرى بالبي اتش بي غير ان هاته لا تتجاهل ترميز اليو تي اف ايت")
// 18
Arabic::containsAr("this method checks if a given string contains arabic words or charachters , for example : if we mentioned لارفيل يتحدث عربي it will return true!")
// true
```
## الاستعمال في ملفات blade
> قم بتغيير ```method``` إلى التابع المراد كـ: ```Arabic::toWords(643646)``` أو كـ: ```arabic()->toWords(643646)```
```php
{{ Arabic::method($input) }}
// أو
{{ arabic()->method($input) }}
```
كما سيمكنك استعمال متغيرات القالب التالية لشيفرة أنظف
```php
@toWords(4367)
@toOrdinal(564)
@toIndianNums(ولد عليه الصلاة في 12 ربيع الأول)
@toHijri(2020/12/12)
@toRelative(2019/12/01)
@removeHarakat(فهوَ يقضِي بِها، ويُعلِّمُها)
```
## المساهمة
**لا تتردد في المساهمة أو مساعدتنا في جعل Laravel يتحدث اللغة العربية بشكل أفضل من خلال فتح مناقشة أو إضافة بعض الطرق الإضافية أو إصلاح خطأ أو المساعدة في تحسين بعض الأساليب!**