امتداد:Cargo

الدليل المرجعي لامتدادات ميدياويكي

Cargo حالة الإصدار مستقر
تنفيذ	صفحة خاصة , واجهة برمجة التطبيقات , دوال المحلل اللغوي
بيان	هو امتداد يسمح بتخزين البيانات الموجودة داخل القوالب والاستفسار عنها.
المؤلف/المؤلفون	Yaron Koren <yaron57@gmail.com> (Yaron Korenنقاش)
آخر إصدار	3.4.2 (أبريل 2023)
سياسة التوافق	النسخة الرئيسية تحافظ على التوافق مع الإصدارات السابقة.
MediaWiki	1.35+
تغييرات قاعدة البيانات	نعم
Composer	mediawiki/cargo
جداول	cargo_tables cargo_pages
ترخيص	رخصة جنو العمومية 2.0 أو ما بعدها
التنزيل	تنزيل الامتداد غت [?]: تنزيل ملف غت الرئيسي تصفح المستودع (Phabricator · GitHub) تاريخ الالتزام مساهمو المستودع (غت هب) مراجعة الكود البرمجي
مثال	صفحة تحتوي على عدة خانات إلى #cargo_query
المتغيرات $wgCargoFileDataColumns $wgCargoDrilldownLargestFontSize $wgCargoDecimalMark $wgCargoDefaultStringBytes $wgCargoAllowedSQLFunctions $wgCargoHideNamespaceName $wgCargoPageDataColumns $wgCargoMaxVisibleHierarchyDrilldownValues $wgCargoDrilldownSmallestFontSize $wgCargoIgnoreBacklinks $wgCargoRecurringEventMaxInstances $wgCargoDefaultMapService $wgCargoStoreUseTemplateArgsFallback $wgCargoLegacyNullLuaFieldsAsEmptyString $wgCargoTablesPrioritizeReplacements $wgCargoDigitGroupingCharacter $wgCargoDefaultQueryLimit $wgCargoDrilldownNumRangesForNumbers $wgCargo24HourTime $wgCargoMaxQueryLimit $wgCargoDrilldownUseTabs $wgCargoMapClusteringMinimum $wgCargoDrilldownMinValuesForComboBox
الروابط المستخدمة AdminLinks ApprovedRevsRevisionApproved ApprovedRevsRevisionUnapproved CategoryAfterPageAdded CategoryAfterPageRemoved LinksUpdate LoadExtensionSchemaUpdates MakeGlobalVariablesScript PageForms::TemplateFieldEnd PageForms::TemplateFieldStart PageMoveComplete PageSaveComplete PageSchemasRegisterHandlers ParserFirstCallInit ResourceLoaderGetConfigVars ScribuntoExternalLibraries SidebarBeforeOutput SkinTemplateNavigation::Universal UploadComplete
الروابط المقدمة CargoSetFormatClasses CargoBeforeStoreData CargoDisplayExportData CargoTablesSetAllowedActions CargoTablesSetActionLinks
تنزيلات ربع سنوية	175 (Ranked 61st)
ترجم الامتداد Cargo
المسائل	المهام المفتوحة · الإبلاغ عن عطل تقني

Cargo هو امتداد يضاف إلى ميدياويكي يوفر سبيل خفيف لتخزين البيانات والاستعلام عنها الموجودة في داخل طرق استدعاء القوالب، مثل صناديق المعلومات. هذا الامتداد يشبه في مفهومه امتداد Semantic MediaWiki إلا أنه يوفر عدد من الميزات تشمل سهولة التثبيت وسهولة الاستخدام.

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

يحدد الامتداد عدد من وظائف المعرب اللغوي وما يلي هي أهم ثلاث من هذه الوظائف:

• #cargo_declare - توع في جزء ‎<noinclude> من القالب وهي تحدد مخطط أي جدول.
• #cargo_store - تخزن صف واحد في جدول Cargo وهي توضع عادة داخل الجزء ‎<includeonly> من أي قالب.
• #cargo_query - تستعلم في واحد من جداول بيانات Cargo أو أكثر من واحد باستخدام مكونات SQL.

وظائف المعرب اللغوي الأخرى المحددة هي كالتالي:

• #cargo_attach - تحدد قالب ما على أنه يضيف صفوف إلى جدول معلن عنه في مكان آخر.
• #cargo_compound_query - تعرض نتائج عدة استعلامات في مكان واحد.
• #cargo_display_map - تعرض خريطة تبين نقطة واحدة.
• #recurring_event - تطبع تواريخ حدث متكرر؛ تستخدم هذه الخاصية #cargo_store.

كما يحدد Cargo أيضا عدة واجهات لاستعراض البيانات والمخزنة والتنقيب فيها.

جرى على Cargo أعمال اختبار وهو يعمل مع أنظمة قواعد بيانات MySQL وPostgreSQL. يدعم الامتداد نظريا SQLite، إلا أنه لم يختبر كما ينبغي باستخدام SQLite وربما لا يعمل.

يتطلب هذا الإصدار من امتداد Cargo الإصدار MediaWiki 1.35+.

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

أنظر أيضا

• Manual:Managing data in MediaWiki – نظرة عامة ومقارنة.
• DynamicPageList – يسمح باستخلاص البيانات من الصفحات.
• Semantic MediaWiki – يسمح بتخزين البيانات داخل الصفحات والاستفسار عنها.
• WikiDB – يقدم سمات قواعد بيانات، يشبه إلى حد ما السمات الدلالية.
• Wikibase – يسمح بتمثيل البيانات المنظمة والتعامل معها بصفتها جزءا من مشروع ويكي بيانات.