Extension:Cargo/Download and installation/ar

التنزيل
يمكنك تنزيل كود Cargo البرمجي في صيغة ملف .zip: https://github.com/wikimedia/mediawiki-extensions-Cargo/archive/2.7.zip

يمكنك أيضا تنزيل الكود البرمجي مباشرة مستخدما غت من مستودع الكود المصدري لميدياويكي (طالع الوسوم المتاحة). شغل الأمر التالي من واجهة سطر الأوامر من داخل دليل الامتدادات:

كي ترى النص البرمجي على الإنترنت، شاملا تاريخ الإصدار لكل ملف، اذهب إلى التالي:

تنصيب
كي تنصب الامتداد، ضع دليل 'Cargo' كاملا داخل دليل 'extensions' في ميدياويكي، ومن ثم أضف السطر التالي إلى ملف 'LocalSettings.php' لديك:

حال الانتهاء من إعداد الكود البرمجي، سيتطلب الأمر منك إعداد جداول قاعدتي بيانات في قاعدة البيانات الرئيسية في Cargo. سوف تحتاج لإعداد قاعدتي البيانات هاتين عن طريق الذهاب إلى دليل MediaWiki's /maintenance واستدعاء التالي:

php update.php

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

ضبط قاعدة بيانات Cargo
يستخدم Cargo تلقائيا قاعدة بيانات ميدياويكي القياسية في أغراض حفظ بياناته. (لو كنت قد أعددت عدة قواعد بيانات، لو استخدمت الإعداد ، سوف تستخدم أول قاعدة بيانات من بين قواعد البيانات تلك.) يميز Cargo بين جداول قواعد بياناته وبين كافة قواعد البيانات الأخرى عن طريق بدء كافة أسماءهم مستخدما بادئة، وهي البادئة "cargo__" دون تخصيص.

يمكنك تغيير هذا الأمر كي يستخدم Cargo أي قاعدة بيانات أخرى. (رغم أن جدولي Cargo من فئة "helper"، cargo_tables و cargo_pages، سوف يظلان في قاعدة بيانات ميدياويكي الرئيسية.) يوجد سببين اثنين رئيسيين يجعلان من استخدام قاعدة بيانات منفصلة أمرا طيبا:


 * ثمة احتمال أن يتعرض Cargo لحدوث تسريب أمني، أي أن استعلامات Cargo تسمح بضم أوامر SQL خبيثة تسمح للمستخدمين بالوصول إلى معلومات غير مسموح لهم بالوصول إليها أو حتى تعديل قاعدة البيانات. لا توجد تسريبات أمنية معروفة – كما أن Cargo يستعين بكم كبير من سبل الوقاية بغرض منع حدوث أي من هذه التسريبات – إلا أن هذا الأمر لا يعني بالضرورة أنه لا توجد تسريبات قائمة. إذا وجد أي من نقاط الضعف هذه، يعد وجود قاعدة بيانات منفصلة تستخدم حساب مستخدم منفصل لقاعدة البيانات يتمتع بتصاريح مقيدة خيارا آمنا.
 * لو حدث تشغيل استعلامات بطيئة أو مجهدة، سواء كان ذلك دون علم أو بنية خبيثة، قد يمنع وجود قاعدة بيانات منفصلة موجودة على خادوم قاعدة بيانات مستقل مثل هذه الاستعلامات من التأثير سلبا على الأعمال المعتادة لموقع الويكي.

يقدم Cargo الإعدادات العمومية التالية التي تسمح لك بإعداد قاعدة بيانات منفصلة:

تضبط هذه الإعدادات بذات الطريقة المتبعة مع مثيلاتها غير المرتبطة بالامتداد Cargo، والتي يمكن الوصول إليها من LocalSettings.php. كي تضبط قاعدة البيانات المخصصة هذه، أضف أسطر لما لا يقل عن أول خمسة متغيرات إلى LocalSettings.php، أما السادس (لأغراض البادئة) فهو متغير اختياري.

متطلبات أخرى

 * لو كنت تعتزم تصدير البيانات إلى جدول بيانات إكسيل، سيتعين عليك أن تنصب مكتبة PhpSpreadsheet على خادومك. يمكن عمل ذلك عن طريق إضافة  إلى  لديك ومن ثم تشغيل.
 * يستعين Cargo بواجهة برمجة تطبيقات ميدياويكي. واجهة برمجية التطبيقات ستكون ناشطة بصفة تلقائية، حتى لا تحتاج للقيام بأية خطوات إضافية. لكن إن كنت تشغل إصدار ميدياويكي سابق للإصدار 1.32 ووجدت أن الجداول لا تنشئ حينما تضغط على "Create table"، راجع LocalSettings.php لديك كي تتأكد من أنه لا يحتوي على