Arabic Timeago

هي إضافة جي كويري تم تعريبها في الأساس من إضافة أخرى لعرض الوقت و تحديثه تلقائياً في مشاريعك .

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

التركيب

يمكنك بكل بساطة إستخدامها عن طريق تحميل الملف الموجود في هذا المستودع و إرفاقه داخل صفحة الويب الخاصة بك على سبيل المثال :

<script src="arabic-timeago.js" type="text/javascript"></script>

لماذا تستخدم إضافتنا المعربة ؟

إضافتنا ستقوم بتحديث الوقت في كل دقيقة تمر أثناء فتح صفحة الويب الخاصة بك تلقائياً للاوقات الموجودة داخل الصفحة ، لكن هذه ليست القاعدة ، على سبيل المثال إذا كان هناك وقت في صفحتك يشير إلى التالي "منذ ساعتين" في هذه الحالة لن تقوم الإضافة بمحاولة التحديث كل 60 ثانية بل ستقوم بزيادة وقت التحديث إلى 30 دقيقة .

قواعد التحقق من تحديث الوقت :

الوقت في الصفحة من 1 دقيقة إلى 50 دقيقة سيتم تحديثه بفاصل زمني 1 دقيقة .

الوقت في الصفحة من 51 دقيقة إلى 89 دقيقة سيتم تحديثه بفاصل زمني 22 دقيقة .

الوقت في الصفحة من 90 دقيقة إلى 42 ساعة سيتم تحديثه بفاصل زمني 30 دقيقة .

الوقت في الصفحة أكثر من 42 ساعة سيتم تحديثه بفاصل زمني نصف يوم .

من المميزات الأخرى لإضافتنا بعد التعريب أنها تدعم صيغة المثنى ، كمثال إذا كان لديك وقت تريد حسابه و قد مضى عليه دقيقتين أو يومين أو شهرين أو حتى سنتين ستظهر لك بهذه الصورة "منذ دقيقتين" أو "منذ ساعتين" ... بدﻻً من "منذ 2 دقائق" أو "منذ 2 ساعات" ، أيضاً إضافتنا تدعم قواعد اللغة العربية كمثال إضافتنا تقوم بكتابة "منذ 15 ساعة" بدﻻً من "منذ 15 ساعات" و هذا شيء جديد كلياً في هذه الإضافة .

الإستخدام

إستخدام الإضافة سهل جداً ، بعد إرفاق ملف الإضافة في صفحتك قم بإضافة وسم الوقت كالتالي :

<time class="timeago" datetime="2015-03-06 07:51:50 Z"></time>

`datetime` | مع إمكانية تغيير خاصية الوقت و التاريخ بالوقت الذي تريد

بعد إضافة وسم الوقت ولكي تعمل الإضافة يجب إضافة كود جافا سكريبت إلى نهاية وسم جسم الصفحة كالتالي :

<body>
  <!-- code here -->
  
  <script>
    $('.timeago').timeago();
  </script>
</body>

بهذا الشكل سيتم تحديث كل الأوقات الموجودة في صفحتك .

غير ذلك يمكنك تحديث الوقت في مجال معين كالتالي :

<div class="timeLables">
 <time class="timeago" datetime="2015-03-06 07:51:50 Z"></time>
 <time class="timeago" datetime="2015-03-06 07:51:50 Z"></time>
</div>

$('.timeLables').timeago();

بهذا الشكل سيقوم بتحديث الوقت الموجود داخل المجال `timeLables`

أما إذا كنت تحتاج إلى تحديث الوقت بشكل يدوي يمكنك إستخدام الدالة `refresh`

 $('.timeago').timeago('refresh');

الإستخدام على إطار عمل روبي أون ريلز

يمكنك إستخدام هذه الإضافة مع إطار عمل روبي أون ريلز بشكل سهل كالتالي :

قم بإرفاق الملف الموجود في هذا المستودع مع تطبيق روبي أون ريلز الخاص بك
قم بالإشارة إلى الملف في ملف الجافا سكريبت الأساسي الخاص بتطبيقك كالتالي

//= require arabic-timeago // for .js
or
#= require arabic-timeago // for .coffee

قم بإضافة وسم الوقت عن طريق دوال روبي أون ريلز المساعدة في صفحات الويب الخاصة بك كالتالي

<%= content_tag :time, '', class: 'timeago', datetime: "2015-04-11 13:00:00 Z" %>

قم بإضافة كود الجافا سكريبت إلى نهاية وسم جسم الصفحة كالتالي

<body>
  <!-- code here -->
  
  <script>
    $('.timeago').timeago();
  </script>
</body>

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

يمكنك رؤية هذا المثال والذي يوضح كيفية إستخدام هذه الإضافة .

License

Released under the MIT License

smart-time-ago License

mabras / arabic-timeago