هي إضافة jQuery تم تعريبها في الأساس من إضافة أخرى لعرض الوقت و تحديثه تلقائياً في مشاريعك.
يمكنك إستخدام هذه الإضافة في كل صفحاتك التي تقوم ببرمجتها بأي لغة كانت.
يمكنك بكل بساطة إستخدامها عن طريق تحميل الملف الموجود في هذا المستودع وإرفاقه داخل صفحة الويب الخاصة بك، على سبيل المثال:
<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` بالوقت الذي تريد
بعد إضافة وسم الوقت ولكي تعمل الإضافة يجب إضافة شفرة JavaScript إلى نهاية وسم جسم الصفحة كالتالي:
<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');
يمكنك إستخدام هذه الإضافة مع إطار عمل Ruyb on Rails بشكل سهل كالتالي:
- قم بإرفاق الملف الموجود في هذا المستودع مع تطبيق Ruby on Rails الخاص بك
- قم بالإشارة إلى الملف في ملف `application.js` الأساسي الخاص بتطبيقك كالتالي
//= require arabic-timeago // for .js
or
#= require arabic-timeago // for .coffee
- قم بإضافة وسم الوقت عن طريق دوال Ruby on Rails المساعدة في صفحات الويب الخاصة بك كالتالي
<%= content_tag :time, '', class: 'timeago', datetime: "2015-04-11 13:00:00 Z" %>
- قم بإضافة شفرة JavaScript إلى نهاية وسم جسم الصفحة كالتالي
<body>
<!-- code here -->
<script>
$('.timeago').timeago();
</script>
</body>
يمكنك رؤية هذا المثال والذي يوضح كيفية إستخدام هذه الإضافة.
Bug reports and pull requests are welcome on GitHub at https://github.com/AliOsm/arabic-timeago.
The project is available as open source under the terms of the MIT License.