 |
الملخص | يضيف Discourse Animated Avatars للمستخدمين إمكانية رفع صور رمزية متحركة بصيغتي gif/webp، والتي ستتحرّك عند التحويم فوقها أو اختيارها في المنشورات وبطاقات المستخدمين وصفحات الملف الشخصي. |
 |
رابط المستودع | https://github.com/discourse/discourse-animated-avatars |
 |
دليل التثبيت | كيفية تثبيت الإضافات في Discourse |
الميزات
بشكل افتراضي، يتم إيقاف الحركة مؤقتًا عندما لا تكون الصورة الرمزية في بؤرة التركيز. داخل المواضيع، ستُوقَف الحركة مؤقتًا عندما لا يتم التحويم فوق المنشور أو اختياره.
animated_avatars_always_animate: يتجاوز إيقاف الحركة المؤقت المذكور أعلاه، ويجبر الصور الرمزية على الحركة دائمًا.
animated_avatars_min_trust_level_to_display يقيّد تحريك الصور الرمزية بناءً على مستوى الثقة.
يحترم خيار prefers-reduced-motion في إعدادات إمكانية الوصول بالمتصفح: سيتم تعطيل الحركات بالكامل.
تتم تحويل ملفات gif المتحركة تلقائيًا إلى صيغة webp عند الرفع، مما يقلل من حجم الملف الإجمالي. يمكن ضبط ذلك باستخدام animated_gif_avatar_to_webp (الافتراضي: true).
الإعدادات
تحتوي هذه الإضافة على اعتماد اختياري على gifsicle. يُستخدم هذا الأداة لتغيير حجم صور gif المرفوعة لتناسب صورة رمزية مربعة، مما يساعد على ضبط نسب العرض إلى الارتفاع، بالإضافة إلى توحيد أي اختلافات في الأحجام بين الصور الثابتة والمتحركة للحصول على تبديل أكثر سلاسة. ستعمل الإضافة بشكل صحيح حتى بدونها، ولكن قد تظهر الصور الرمزية غير المربعة ممدودة عند عرضها.
animated_gif_avatar_to_webp. سيتم تحويل ملفات gif المتحركة إلى صيغة webp مع قصّها لتكون صورًا رمزية مربعة.
لتمكين هذا الخيار، ستضيف استدعاءً لسكربت التثبيت في ملف app.yml. مثال على شكل خطاف after_code هو الآتي:
hooks:
after_code:
- exec:
cd: $home/plugins
cmd:
- git clone https://github.com/discourse/discourse-animated-avatars.git
- exec:
cd: $home/plugins/discourse-animated-avatars
raise_on_fail: false
cmd:
- $home/plugins/discourse-animated-avatars/scripts/install.sh
الإعدادات
| الاسم | الوصف |
|---|---|
| animated avatars min trust level to display | الحد الأدنى لمستوى الثقة لعرض صورة رمزية متحركة |
| animated avatars always animate | تحريك الصور الرمزية دائمًا |
| animated gif avatar to webp | تحويل الصور الرمزية المتحركة بصيغة gif إلى صيغة webp تلقائيًا عند الرفع، مما يقلل من حجم الملف. (الافتراضي: true) |
| animated gif avatar webp quality | جودة التحويل من gif إلى webp. الإعدادات الموصى بها بين 75% و 100% (الافتراضي: 80%) |
تقني
تتضمن الإضافة أوامر سطر أوامر إضافية (CLI) للمساعدة في تحديد عدد صور gif/webp الرمزية، وتحويل صور gif الرمزية الموجودة إلى صيغة webp.
bin/rake animated_avatars:count_animated يحسب العدد الإجمالي للصور الرمزية المتحركة، مجمعة حسب صيغة gif/webp
bin/rake animated_avatars:gif_to_webp يحول صور gif الرمزية المتحركة الموجودة إلى صيغة webp. يتم تطبيق الصور الرمزية الجديدة تلقائيًا، وتُحذف صور gif الرمزية القديمة بواسطة مهمة CleanUpUploads.