Extension:Semantic Compound Queries
Semantic Compound Queries Release status: stable |
|
---|---|
Implementation | Parser function |
Description | Defines a parser function, #compound_query , that can make multiple Semantic MediaWiki queries at the same time |
Author(s) | Yaron Koren and others |
Maintainer(s) | SMW Project |
Latest version | 2.2.0 (2022-01-20) |
MediaWiki | 1.31+ |
PHP | 7.3+ |
Database changes | No |
Composer | mediawiki/semantic-compound-queries |
License | GNU General Public License 2.0 or later |
Download | GitHub: RELEASE NOTES |
Example | A Google Map showing two different kinds of points, with a different marker for each |
Compatibility
|
|
Translate the Semantic Compound Queries extension | |
The Semantic Compound Queries extension is meant to work with Semantic MediaWiki and allows for the display of more than one SMW inline query in one results display set. It uses its own parser function, #compound_query, which takes inputs similar to that of #ask but can take in an unlimited number of queries, instead of just one.
Installation
editThe recommended way to install Semantic Compound Queries is by using Composer with an entry in MediaWiki's "composer.local.json" file:
{
"require": {
"mediawiki/semantic-compound-queries": "~2.2"
}
}
Now run the following in the shell:
php composer.phar update --no-dev --prefer-source
To invoke the extension add the following line to the bottom of your "LocalSettings.php" file:
wfLoadExtension( 'SemanticCompoundQueries' );
Usage
editNormal queries
editA normal inline query, using the #ask parser function, takes in arguments of three types:
- a filter that determines the results
- the names of properties to be displayed
- arguments that determine the format and other aspects of the display
Here is an example of a regular ask query:
{{#ask: [[Category:Stores]] [[Has type::Clothing]] |?Has country=Country |format=table }}
In this query there are three arguments separated by pipes and they belong to argument types 1, 2 and 3, respectively.
Compound queries
editFor compound queries the first two types of argument are unique to each sub-query and are separated from each other by semicolons (;) instead of pipes (|); pipes are used to separate one sub-query from the rest.
The third type of argument, setting the display of the results, is common across all sub-queries.
Here is an example of a call to #compound_query that shows both clothing stores and fast-food restaurants in a table:
{{#compound_query:
[[Category:Stores]] [[Has type::Clothing]] ;?Has country=Country
|[[Category:Restaurants]][[Has cuisine::Fast food]] ;?Has country=Country
|format=table
}}
One important exception to this rule is the limit= parameter, which sets the maximum number of results displayed: it must be used per sub-query, not for the overall compound query.
Maps
editTo make things more interesting, we can place all these results on a map, using the Maps extension. Here is the same set of results, using Maps 'googlemaps' format, and a different property displayed for both sets of points to set their geographical coordinates:
{{#compound_query:
[[Category:Stores]] [[Has type::Clothing]] ;?Has coordinates
|[[Category:Restaurants]] [[Has cuisine::Fast food]] ;?Has coordinates
|format=googlemaps
}}
We can set a different icon to appear for each location type in the map, by using the "icon" parameter, which Maps understands.Assuming your wiki contains uploaded images by the name of "Shirt.png" and "Hamburger.png", you could call the following:
{{#compound_query:
[[Category:Stores]] [[Has type::Clothing]] ;?Has coordinates ;icon=Shirt.png
|[[Category:Restaurants]] [[Has cuisine::Fast food]] ;?Has coordinates ;icon=Hamburger.png
|format=googlemaps |height=400 |width=600
}}
This query also sets the height and width of the map - additional arguments of the third type.
#compound_query
avoids displaying the same page more than once, so if a page gets returned by more than sub-query, it's displayed only for the first one.
In this way, a compound query can have specific sub-queries, and then a general catch-all sub-query at the end:
{{#compound_query:
[[Category:Restaurants]] [[Has cuisine::Fast food]] ;?Has coordinates ;icon=Hamburger.png
|[[Category:Restaurants]] [[Has cuisine::Italian]] ;?Has coordinates ;icon=Spaghetti.png
|[[Category:Restaurants]] ;?Has coordinates ;icon=Fork.png
|format=googlemaps
}}
Calendars
editThere's also special handling for the 'calendar' format, defined in Semantic Result Formats - if you display a calendar, you can set a different color for each set of events displayed.
Here is an example:
{{#compound_query:
[[Category:Events]] [[Has priority::High]] ;?Has date ;color=red
|[[Category:Events]] [[Has priority::Low]] ;?Has date ;color=#99cc99
|[[Category:Events]] ;?Has date
|format=calendar
}}
API
editStarting with version 1.0 this extension provides an API module called "compoundquery". The documentation is available semantic-mediawiki.org
Limitations
editUnlike regular #ask queries, #compound_query does not display a "further results" link if the number of results exceeds the limit. For this reason, the searchlabel parameter available for regular #ask queries cannot be used.
Authors
editSemantic Compound Queries was mostly written by Yaron Koren. Important contributions were made by James Hong Kong, Jeroen De Dauw and Peter Grassberger.
Semantic Compound Queries was funded initially by the KDZ - Centre for Public Administration Research in Vienna, Austria.
Version history
editSemantic Compound Queries is currently at version 2.2.0. See the entire version history.
Bugs and feature requests
editYou should use the Semantic MediaWiki mailing list, semediawiki-user, for any questions, suggestions or bug reports about Semantic Compound Queries.
If possible, please add "[SCQ]" at the beginning of the subject line, to clarify the subject matter.
This extension is included in the following wiki farms/hosts and/or packages: This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |