ويكيبيديا:إضافات
 | هذه صفحة معلوماتٍ في ويكيبيديا العربية. |
 | تحذير: أنت وحدك تتحمل المسؤولية الكاملة عن أي إجراء تقوم به باستخدام أي إضافة. ينبغي عليك قراءة وفهم سياسات ويكيبيديا واستخدام هذه الأداة ضمن هذه السياسات، وإلا فإنك تخاطر بمنعك من التحرير. |
إضافة ويكيبيديا هي برنامج JavaScript و/أو قصاصة CSS يمكن تمكينها ببساطة عن طريق تحديد خيار في تفضيلاتك. يجري توفير وظيفة الإضافة من خلال ملحق إضافات ميدياويكي.
بدأت العديد من الإضافات كبرامج نصية للمستخدم [الإنجليزية]. بمجرد الموافقة على نص سكريبت المستخدم كإضافة، سيزال من وب:نصوص سكريبت مستخدم/قائمة [الإنجليزية].
المعايير العامة للإضافات
لكي تنشر على ويكيبيديا العربية، يجب أن تجتاز الإضافات عمومًا الشروط التالية:
- يجب أن تعمل الإضافات فقط إذا جرى تضمينها دون أي تكوين إضافي. يمكن تكوينها عبر ملف common.js الشخصي، ولكن يجب أن تعمل بدون تكوين.
- يجب أن تكون الإضافات متوافقة مع جميع المتصفحات الرئيسية، أي يجب ألا تنتهي بالأخطاء.
- يجب أن تكون الإضافات متوافقة مع معظم المتصفحات الرئيسية (التوافق بين المتصفحات). ينبغي ذكر الاستثناءات بوضوح.
- لا ينبغي أن يجري نسخ الإضافات إلا إذا كان ذلك معقولاً.
- ينبغي تقسيم مجموعات البرامج النصية إذا كانت تحتوي على وظائف متباينة.
- يجب وضع علامة على الإضافات التي تتطلب أذونات ويجب أن تفشل بشكل سليم عند غياب الأذونات.
- يجب وضع علامة على الإضافات التي تعمل في بعض أشكال المظهر فقط إذا كانت هذه البيانات متاحة.
الإضافات التي جرى وضع علامة عليها باعتبارها افتراضية ويجري تحميلها لمجموعات كبيرة من المستخدمين لها معايير إضافية يجب أن تتوافق معها.
الاقتراحات
ينبغي اقتراح إضافات جديدة في ميدان التقنية.
تاريخيًا، جرى اقتراح إضافات جديدة في صفحة فرعية من هذه الصفحة، ولكن جرى وضع وسم على هذه الصفحة كتاريخية بسبب انخفاض المشاركة. بالإضافة إلى ذلك، كان يجري تقييم نصوص مستخدمي مشاريع ويكي الموجودة لتحويلها إلى إضافات، ولكن جرى أيضًا وضع علامة على هذه العملية على أنها تاريخية.
التنصيب
يمكن تركيب الإضافات بعد مناقشتها في القسم الفني للميدان بواسطة إداريي الواجهة بالطريقة التالية:
- أضف العنوان أدناه وكود البرنامج النصي إلى ميدياويكي:Gadget- scriptname .js
- اختياريًا، أضف العنوان أدناه وكود CSS إلى ميدياويكي:Gadget -scriptname .css
- أضف وصفًا للبرنامج النصي إلى ميدياويكي:Gadget- scriptname . يرجى الربط بالصفحة الرئيسية للبرنامج النصي و/أو صفحة المساعدة وبيان متطلبات المتصفح إذا لزم الأمر.
- أضف إلى ميدياويكي:Gadgets-definition تحت العنوان المناسب
* scriptname|scriptname.js[|scriptname.css|otherscript.js|...]
يجب أن تظهر الإضافة الآن في خاص:إضافات.
تعليقات
يمكن إضافة التعليقات أو التحذيرات إلى قوالب وصف الإضافة بطريقتين:
- علامة noinclude (مرئية في صفحة الوصف مع الوصلات):
تعليق - تعليقات HTML (مرئية في نص المصدر فقط):
<!-- تعليق -->
سيجري تجاهل التعليقات المضافة بهذه الطريقة تلقائيًا أثناء عملية إنشاء الصفحة.
رأس الصفحة
ينبغي إضافة العنوان التالي إلى ملفات الإضافة:
/* _____________________________________________________________________________
* | |
* | === WARNING: GLOBAL GADGET FILE === |
* | Changes to this page affect many users. |
* | Please discuss changes on the talk page or on [[WT:Gadget]] before editing. |
* |_____________________________________________________________________________|
*
* Imported from version XXXX as of DATE from [[SCRIPT_SOURCE]]
* SHORT_DESCRIPTION, see [[SCRIPT_HOME_PAGE]]
*/
الإضافات الافتراضية
جرى تمكين إضافة ذات كلمة رئيسية افتراضي لجميع زوار ويكيبيديا ويمكن فقط للمستخدمين المسجلين تعطيلها. سيجري تمكين الإضافة ذات الوصف [default|rights=minoredit] تلقائيًا للمستخدمين المسجلين فقط.
معايير
يجب أن تلتزم الإضافات التي يجري تمكينها افتراضيًا لجميع المستخدمين بقواعد أكثر صرامة. تعتبر هذه هي القواعد الأساسية نفسها التي تنطبق على كافة التعليمات البرمجية المرسلة افتراضيًا. ويرجع ذلك إلى أن المستخدمين لا يملكون خيارًا نشطًا في تمكين هذه الإضافات، ويمكن أن تؤثر هذه الإضافات على أداء وأمان واستقرار موقع الويب بأكمله. ينبغي لهذه الإضافات أن:
- جرى مراجعتها من قبل مطور JavaScript ذي الخبرة (عادةً ما يكون إداري الواجهة).
- يجب أن تكون "في حالة جيدة".
- متوافقة مع سياسة موارد الطرف الثالث.
- يجب كتابتها لتشغيلها بكفاءة، أي باستخدام أقل قدر ممكن من التعليمات البرمجية المطلوبة. إذا كانت الوظيفة الكاملة للأداة تتطلب قدرًا كبيرًا من أكواد JavaScript، فيجب تحميل هذا الكود بشكل مشروط وببطء، أو فقط عند الطلب (انقر للتحميل).
- لا تسبب مشاكل في إمكانية الوصول.
- لا يشترط أن يكون المحتوى قابلاً للقراءة، باستثناء الإضافات ذات الأنماط فقط.
- لا تتداخل مع طباعة الصفحات.
- الالتزام بمعايير الأمان والخصوصية الحالية.
لا ينبغي اعتبار هذه القائمة شاملة.
إضافات قالب
تُعد إضافات القالب فئة خاصة من الإضافات الافتراضية. يجري تشغيل هذه الإضافات فقط على الصفحات الموجودة في فئات تشغيل محددة، ويجري التحكم فيها عادةً عن طريق إضافة قالب إلى الصفحة. يجب أن تكون فئات المشغل محمية من النقل لأنها مدمجة مع التعريف.
الإضافات المثبتة حاليًا
يمكن للمستخدمين تصفح قائمة بجميع الإضافات المتاحة في قسم الإضافات في صفحة التفضيلات الخاصة بهم:
راجع خاص:إضافات للحصول على قائمة بجميع الإضافات النشطة وروابط لملفات النصوص الخاصة بها.
إيجابيات وسلبيات تغيير نص المستخدم إلى إضافة
الايجابيات
- يضيف البرنامج النصي إلى خاص:تفضيلات، مما يجعل تثبيته أسهل كثيرًا.
- يضيف البرنامج النصي إلى خاص:تفضيلات، مما سيساعد في تسويق البرنامج النصي وتعزيز أعداد التثبيتات بمرور الوقت.
- يمنح البرنامج النصي للمستخدم إلى المجتمع، مما يجعل إداريو الواجهة أكثر ميلاً إلى منح طلبات التحرير من المستخدمين الآخرين، مما يقلل من الحاجة إلى تقسيم البرنامج النصي للمستخدم إذا أصبح المشرف غير نشط.
- القدرة على وضع علامة عليها كـ "إضافة افتراضية"، والتي سيجري تحميلها للجميع.
- تعتمد وحدات ResourceLoader وCSS التي يعتمد عليها البرنامج النصي على التحميل عند تحميل الصفحة، مما يسمح للبرنامج النصي بأن يكون جاهزًا بشكل أسرع.
وخاصة عندما يكون نص المستخدم يحمل من طرف الكثير من المستخدمين...
- توفر الإضافات إمكانية التصغير والتجميع مع الإضافات الأخرى، مما يقلل من أحجام الملفات وحركة مرور HTTP.
- حماية ممكنة ضد القرصنة. يتمتع جميع إداريو الواجهة بالمصادقة الثنائية بعاملين، ويجري إزالتهم إذا أصبحوا غير نشطين. قد يصبح أحد الإداريين العاديين غير نشط ثم يجري اختراق حسابه في وقت لاحق.
- حماية محتملة ضد مطور نصوص المستخدم المحتال. لقد مر إداريو الواجهة بعملية التصويت ومن المحتمل أن يكونوا أقل عرضة للوقوع في أخطاء.
السلبيات
- يسمح باستخدام ميزات JavaScript حتى ES7 فقط. يمكن استخدام بعض ميزات ES8 مثل async–await مع علم
requiresES6. - إذا لم يكن الإداري مسؤولاً عن الواجهة، فسوف يحتاج الآن إلى تقديم طلبات {{Edit interface-protected}} من أجل إجراء أي تغييرات في الكود، مما يؤدي إلى إبطاء عملية التطوير.
- الكثير من الخطوات. يجب التأكد من موافقة المشرف على الأمر، والحصول على إجماع في ويكيبيديا:الميدان/تقنية، ثم الحصول على صلاحية إداري الواجهة لإعداد كل شيء. قد تكون هناك حاجة إلى خطة لتحويل الجميع من البرنامج النصي القديم للمستخدم إلى الإضافة. إذا كان هناك أي قلق بشأن الأخطاء، فقد تكون هناك حاجة إلى إجراء طرح متدرج.
أنظر أيضًا
- نقاش ميدياويكي:Gadgets-definition، مناقشة التفاصيل الفنية لصنع وصيانة الإضافات
- خاص:GadgetUsage، يوفر إحصائيات حول استخدام الإضافات
- mw:Extension:Gadgets، وثائق ميدياويكي الخاصة بامتداد الإضافات
- قالب:تقرير عن خطأ ، رسالة قالب تطلب معلومات مفصلة تتعلق بالخطأ
- mw:مطبخ الإضافات ، برنامج تعليمي حول كتابة الإضافات
- ويكيبيديا:Gadget/Repositories ، قائمة بمستودعات التحكم في الإصدارات للأدوات والبرامج النصية للمستخدم