Extension:Gadgets documentation: Difference between revisions

Latest revision as of 11:11, 19 April 2025

```wiki

إضافة: الأدوات - توثيق

إضافة: الأدوات هي إضافة قوية لـ MediaWiki تسمح للمستخدمين بتخصيص تجربة تصفحهم من خلال إضافة أدوات وميزات إضافية إلى واجهة المستخدم. يتيح ذلك للمسؤولين توفير أدوات مساعدة للمستخدمين دون الحاجة إلى تعديل التعليمات البرمجية الأساسية للويكي. هذه المقالة عبارة عن دليل شامل للمبتدئين حول كيفية استخدام إضافة الأدوات، بما في ذلك التكوين، وإنشاء الأدوات، وإدارتها.

ما هي الأدوات؟

الأدوات هي مقتطفات من JavaScript و/أو CSS التي يمكن للمستخدمين تفعيلها أو تعطيلها لتغيير طريقة عرض أو سلوك ويكي. يمكن أن تتراوح الأدوات من بسيطة مثل إضافة زر جديد إلى شريط الأدوات إلى معقدة مثل تغيير تخطيط الصفحة بالكامل.

الفوائد الرئيسية لاستخدام إضافة الأدوات

التخصيص للمستخدم: تسمح للمستخدمين بتخصيص تجربة ويكي الخاصة بهم لتلبية احتياجاتهم الخاصة.
سهولة الصيانة: يمكن تحديث الأدوات وتغييرها بسهولة دون الحاجة إلى تعديل التعليمات البرمجية الأساسية للويكي.
المرونة: يمكن استخدامها لإضافة مجموعة متنوعة من الميزات والوظائف إلى ويكي.
لا تتطلب معرفة برمجية متقدمة: يمكن للمسؤولين إنشاء أدوات بسيطة دون الحاجة إلى معرفة متعمقة بـ JavaScript أو CSS.

المتطلبات الأساسية

MediaWiki 1.18 أو أحدث (موصى به 1.40).
حقوق المسؤول على الويكي.
فهم أساسي لـ JavaScript و CSS (مفيد ولكنه ليس ضروريًا لجميع الحالات).

التثبيت

1. قم بتنزيل أحدث إصدار من إضافة الأدوات من MediaWiki Extensions. 2. قم بتحميل الملفات إلى دليل `extensions/` على خادم الويكي الخاص بك. 3. أضف السطر التالي إلى ملف `LocalSettings.php`:

   ```php
   wfLoadExtension( 'Gadgets' );
   ```

4. احفظ ملف `LocalSettings.php`.

التكوين

بعد التثبيت، تحتاج إلى تكوين الإضافة.

`$wgGadgetsDefines` : هذا المتغير هو المكان الذي تحدد فيه الأدوات المتاحة. إنه عبارة عن مصفوفة، حيث يكون كل عنصر عبارة عن مصفوفة أخرى تحتوي على معلومات حول الأداة.

   مثال:

   ```php
   $wgGadgetsDefines = array(
       'exampleGadget' => array(
           'class' => 'ExampleGadget', // اسم الفئة التي تحتوي على كود الأداة
           'description' => 'أداة مثال بسيطة', // وصف الأداة
           'documentation' => 'Help:ExampleGadget', // رابط إلى صفحة التوثيق
           'skin' => array( 'vector', 'monobook' ), // الجلود التي تعمل عليها الأداة (اختياري)
           'dependencies' => array( 'jquery' ), // التبعيات (اختياري)
       ),
   );
   ```

`$wgGadgetAutoLoadModules` : يحدد هذا المتغير ما إذا كان يجب تحميل وحدات الأداة تلقائيًا. إذا تم تعيينه على `true`، فسيتم تحميل الوحدات تلقائيًا عند طلب الصفحة.

`$wgGadgetDefaultOptions` : يحدد هذا المتغير الخيارات الافتراضية للأدوات.

إنشاء أداة

لإنشاء أداة جديدة، تحتاج إلى إنشاء ملف JavaScript يحتوي على كود الأداة. يجب أن يكون الملف موجودًا في دليل `extensions/Gadgets/`.

مثال:

`extensions/Gadgets/ExampleGadget.js`:

```javascript ( function() {

   'use strict';

   var button = $('<button>مثال</button>').click(function() {
       alert('تم النقر فوق زر المثال!');
   });

   $('#mw-toolbar-container').append(button);

})(); ```

ثم قم بإنشاء صفحة توثيق للأداة (في هذا المثال، `Help:ExampleGadget`) لشرح كيفية استخدامها.

إدارة الأدوات

صفحة الأدوات الخاصة بالمستخدم: يمكن للمستخدمين إدارة الأدوات التي يستخدمونها من خلال صفحة خاصة تسمى "تفضيلات" -> "الأدوات".
صفحة إدارة الأدوات للمسؤول: يمكن للمسؤولين إدارة الأدوات المتاحة من خلال صفحة خاصة تسمى "إدارة الأدوات". يمكن الوصول إلى هذه الصفحة من خلال رابط في قائمة "الإدارة".

الاستراتيجيات والتحليل الفني في الخيارات الثنائية (روابط ذات صلة)

نصائح وأفضل الممارسات

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

استكشاف الأخطاء وإصلاحها

الأداة لا تعمل: تحقق من أن الأداة مفعّلة في تفضيلات المستخدم. تحقق من أن كود الأداة صحيح ولا يحتوي على أي أخطاء. تحقق من أن الأداة متوافقة مع جلد الويكي الذي تستخدمه.
الأداة تتسبب في مشاكل في الويكي: حاول تعطيل الأداة لمعرفة ما إذا كانت هي السبب في المشكلة. إذا كان الأمر كذلك، فحاول تصحيح كود الأداة.
لا تظهر صفحة إدارة الأدوات: تأكد من أنك قمت بتثبيت الإضافة بشكل صحيح وأن لديك حقوق المسؤول.

موارد إضافية

MediaWiki Gadgets documentation (باللغة الإنجليزية)
MediaWiki Extension:Gadgets (صفحة الإضافة على MediaWiki.org)
Help:Gadgets (صفحة المساعدة العامة للأدوات)

الخلاصة

إضافة الأدوات هي أداة قوية لتخصيص تجربة المستخدم في MediaWiki. من خلال فهم كيفية تثبيت الإضافة وتكوينها وإنشاء الأدوات وإدارتها، يمكنك توفير ميزات ووظائف إضافية لمستخدمي الويكي الخاص بك. تذكر دائمًا اختبار أدواتك جيدًا وتوثيقها بشكل صحيح لضمان سهولة الاستخدام والصيانة. مع الأخذ في الاعتبار استراتيجيات التداول المختلفة مثل استراتيجية التداول باستخدام مؤشرات التجميع والتشتت أو استراتيجية التداول باستخدام أنماط الدعم والمقاومة المزدوجة، يمكن للأدوات المخصصة أن تعزز بشكل كبير تجربة المستخدم في مجتمعات تداول الخيارات الثنائية. ``` ```

ابدأ التداول الآن

سجّل في IQ Option (الحد الأدنى للإيداع 10 دولار) افتح حساباً في Pocket Option (الحد الأدنى للإيداع 5 دولار)

انضم إلى مجتمعنا

اشترك في قناة Telegram الخاصة بنا @strategybin لتصلك: ✓ إشارات تداول يومية ✓ تحليلات استراتيجية حصرية ✓ تنبيهات اتجاهات السوق ✓ مواد تعليمية للمبتدئين