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، سوف يظلان في قاعدة بيانات ميدياويكي الرئيسية.) There are two main reasons why using a separate database may be a good idea:


 * There is the possibility that Cargo has a security leak, i.e. that Cargo queries allow for the inclusion of malicious SQL that would let users access information that they're not supposed to, or even modify the database. There are no known security leaks - and Cargo uses a lot of safeguards to try to prevent any such leaks - but that does not mean that no leak exists. If there is any such vulnerability, having a separate database using a separate database user with restricted permissions is the safer option.
 * If slow, intensive queries are run, either unknowingly or maliciously, having a separate database on a separate database server would prevent such queries from interfering with the regular operation of the wiki.

Cargo offers the following global settings to let you set a separate database:

These are set in the same way as their non-Cargo equivalents, which can be found in LocalSettings.php. To set this custom database, add lines for at least the first five variables to LocalSettings.php; the sixth (for the prefix) is optional.

متطلبات أخرى

 * If you plan to export data to an Excel spreadsheet, you need to install the PhpSpreadsheet library on your server. This can be done by adding  to your  and running.
 * Cargo uses MediaWiki's API. The API is enabled by default, so you don't need to do any extra steps. But if you're running a MediaWiki version less than 1.32 and you find that tables are not being created when you click "Create table", check your LocalSettings.php to make sure that it doesn't contain