|Requirements||Mediawiki 1.23 or greater|
|An extension that allows for the storage and querying of data contained within templates.|
|Adapted from the Cargo extension documentation.|
Cargo is an extension to MediaWiki that provides a lightweight way to store and query the data contained within the calls to templates, such as infoboxes. It is similar in concept to the Semantic MediaWiki extension, but offers a number of advantages, including ease of installation and ease of use.
Cargo stores all its data in database tables, which can be placed in either MediaWiki's own database (the default) or a separate database. For the most part, each stored template gets its data stored in a single DB table, with a column for each relevant template parameter. There are a few exceptions to this: the handling of template fields that hold arrays/lists of values, and of fields that hold geographical coordinates, is more complex, due to poor native handling of those data types in most DB systems. And multiple templates can be set to all store their data in one DB table.
The extension defines a number of parser functions; these three are the most important:
#cargo_declare- placed within the <noinclude> part of a template; it defines the schema for a table.
#cargo_store- stores one row to a Cargo table; usually placed within the <includeonly> part of a template.
#cargo_query- queries one or more Cargo data tables, using SQL components.
The other defined parser functions are:
#cargo_attach- defines a template as adding rows to a table declared elsewhere.
#cargo_compound_query- displays the results of multiple queries in one place.
#cargo_display_map- displays a map showing a single point.
#recurring_event- prints out the dates for a recurring event; for use by #cargo_store.
Cargo also defines various interfaces for viewing and drilling down through this stored data.
Cargo has been tested, and works, with the MySQL, PostgreSQL and SQL Server database systems. In theory, it also supports SQLite and Oracle, but it has not been tested with these systems and may not work.
Version 1.5 of the Cargo extension requires MediaWiki 1.23 or higher.
Click through the pages in the navigation bar "Cargo manual" above to learn more about Cargo, how it works, and how to use it. If you are completely new to Cargo, your best starting point is Quick start guide.
Maintenance scripts[edit | edit source]
There are some scripts available to Hydra Admins for the Cargo extension:
These have the same effect as the related maintenance scripts for Cargo. If you need any of these processes executed for your wiki, please contact a Hydra Admin.
Further reading[edit | edit source]