امتداد:Cargo

From mediawiki.org
This page is a translated version of the page Extension:Cargo and the translation is 63% complete.
الدليل المرجعي لامتدادات ميدياويكي
Cargo
حالة الإصدار مستقر
تنفيذ صفحة خاصة , واجهة برمجة التطبيقات , دوال المحلل اللغوي
بيان هو امتداد يسمح بتخزين البيانات الموجودة داخل القوالب والاستفسار عنها.
المؤلف/المؤلفون Yaron Koren <yaron57@gmail.com> (Yaron Korenنقاش)
آخر إصدار 3.5 (فبراير 2024)
سياسة التوافق النسخة الرئيسية تحافظ على التوافق مع الإصدارات السابقة.
MediaWiki 1.37+
تغييرات قاعدة البيانات نعم
Composer mediawiki/cargo
جداول cargo_tables
cargo_pages
cargo_backlinks
ترخيص رخصة جنو العمومية 2.0 أو ما بعدها
التنزيل
مثال صفحة تحتوي على عدة خانات إلى #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
  • recreatecargodata
  • deletecargodata
  • runcargoqueries
تنزيلات ربع سنوية 83 (Ranked 82nd)
ترجم الامتداد 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 أيضا عدة واجهات لاستعراض البيانات والمخزنة والتنقيب فيها. ولهذا السبب، تضيف الصفحات الخاصة التالية:

  • Special:CargoQuery
  • Special:CargoTableDiagram
  • Special:CargoTables
  • Special:Drilldown

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

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

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

التنصيب

See Download and Installation .

الإعداد

التالي هي إعدادات ضبط Cargo العمومية وكذلك قيمها الافتراضية.

لضبط Cargo كي يستخدم قاعدة بيانات مستقلة بدلًا من قاعدة بيانات ميدياويكي، تقدم الإعدادات التالية:

Separate database configuration settings
Setting Default Description
$wgCargoDBtype null Database type.
$wgCargoDBserver null Host name or IP address of database server.
$wgCargoDBname null Name of the database.
$wgCargoDBuser null Database username.
$wgCargoDBpassword null The password for $wgCargoDBuser.
$wgCargoDBprefix null Database table name prefix.
$wgCargoDBRowFormat null Data base row format.

لأغراض ضبط المحارف حينما يتعلق الأمر بالأرقام، تقدم إعدادات الضبط التالية:

Character configuration settings
Setting Default Description
$wgCargoDecimalMark . Decimal character for numbers.
$wgCargoDigitGroupingCharacter , Thousands digit separator.

وإعدادات الضبط العمومية المتبقية هي كما يلي:

Setting Default Description
$wgCargoAllowedSQLFunctions [] Sets allowed SQL functions. See Using SQL Functions for defaults.
$wgCargoRecurringEventMaxInstances 100 The number of max instances to store for recurring events with no set end date.
$wgCargoDefaultStringBytes 300 The default number of characters for fields of type Page, String, Wikitext string, File, URL, Email
$wgCargoDefaultQueryLimit 100 Number of results to show for #cargo_query if no limit is set
$wgCargoMaxQueryLimit 5000

The maximum allowed number of results for #cargo_query

$wgCargo24HourTime false If true uses 24-hour time for Datetime field types.
$wgCargoDefaultMapService OpenLayers Sets the default map service to Google Maps, if set to googlemaps, to Leaflet if set to leaflet, and to OpenLayers if set to openlayers.
$wgCargoGoogleMapsKey null API key for Google Maps, for the googlemaps display format.
$wgCargoMapClusteringMinimum 80 If the number of map points displayed is greater than the value of $wgCargoMapClusteringMinimum, the map displays the locations in "clusters" instead of individual points, for readability. If set to a very high number, does not display clustering.
$wgCargoDrilldownUseTabs true Displays Special:Drilldown table names as tabs at the top instead of a vertical list at the side.
$wgCargoDrilldownSmallestFontSize -1 If set to a positive number, sets the smallest font size, in pixels, for a tag-cloud-style display of filter values.
$wgCargoDrilldownLargestFontSize -1 If set to a positive number, sets the largest font size, in pixels, for a tag-cloud-style display of filter values.
$wgCargoDrilldownMinValuesForComboBox 40 Sets the minimum number of values before their display is converted to a combo box, instead of individual links.
$wgCargoDrilldownNumRangesForNumbers 5 For fields/filters of type Integer or Float, specifies the number of "buckets" into which values are divided.
$wgCargoMaxVisibleHierarchyDrilldownValues 30 If set to a positive integer, specifies the maximum number of values shown at a time for any hierarchy field (All the top-level values are shown irrespective of this value). The values are hidden beyond a certain depth of the hierarchy such that the count of total visible values is at most this number.
$wgCargoTablesPrioritizeReplacements false If true, all tables having a replacement appear at the top of the Special:CargoTables page, instead displaying them in alphabetical order.
$wgCargoPageDataColumns [] The set of fields to store in the _pageData Cargo table. See Storing page data.
$wgCargoFileDataColumns [] The set of fields to store in the _fileData Cargo table. See Storing file data.
$wgCargoHideNamespaceName [6] Array of namespaces to hide from query results.

أنظر أيضا