| Status: | effective |
| Progress: | 100% |
| Version: | 3.1.0+ |
$smwgQueryDependencyPropertyExemptionList
| Configuration parameter details: | |
| Name | $smwgQueryDependencyPropertyExemptionList |
| Description | Sets special properties that should be exempted from embedded queries updates |
| Default setting | See below |
| Software | Semantic MediaWiki |
| Since version | |
| Until version | still available |
| Configuration | Installation · Store settings · Experimental |
| Keyword | sqlstore · query setting · query dependency · query management · experimental |
__NOBREADCRUMBLINKS__
$smwgQueryDependencyPropertyExemptionList is a configuration parameter that sets special properties that should be exempted from a query dependency update, i.e. that when an value change to a property value occurs query dependencies for the related entity are not recorded. It was introduced in Semantic MediaWiki 2.3.0Released on an unknown date unknown versions of MediaWiki as configuration parameter $smwgPropertyDependencyDetectionBlacklist1 but was renamed in Semantic MediaWiki 2.4.0Released on an unknown date unknown versions of MediaWiki.2 It was further renamed from $smwgQueryDependencyPropertyExemptionlist with Semantic MediaWiki 2.5.1Released on an unknown date unknown versions of MediaWiki.3 The former configuration parameter name will be removed with the release of Semantic MediaWiki 3.1.0Released on an unknown date unknown versions of MediaWiki.4 At the same time this release also extended the setting to this configuration parameter by several further special properties.5
Default setting
$smwgQueryDependencyPropertyExemptionList = [ '_MDAT', '_SOBJ', '_ASKDU','_ASKDE', '_ASKSI', '_ASKFO', '_ASKST' ];
This means that by default the following special properties are not triggering a query dependency update:
- Special property "Has subobject"Holds the subobjects set on a page − it will however not exclude any properties defined by a subobject given that it is not part of an extended exclusion list
- Special property "Modification date"Holds a fixed value that corresponds to the date of the last modification of each page – to avoid a purge on each page edit
The following special properties are also exempted by default because changes to them should not trigger an update of possible query dependencies as this has no bearing on the result list:
- Special property "Query duration"Holds the value of the duration a query took to execute
- Special property "Query size"Holds the value of the number of conditions in a query
- Special property "Query depth"Holds the value of the property depth of a query
- Special property "Query format"Holds the name of the result format used in a query
- Special property "Query string"Holds the conditions of the query as a string
Changing the default setting
To modify the setting to this configuration parameter, add one of the following lines to your "LocalSettings.php" file after the enableSemantics() call:
- Disable query dependency updates on changes to special property "Is a new page"Holds a value marking a page as being new or not and special property "Last editor is"Holds the page name of the user who created the last page revision
$smwgQueryDependencyPropertyExemptionList = array_merge(
$smwgQueryDependencyPropertyExemptionList, [
'_NEWP',
'_LEDT'
]
);
- It is discouraged to remove one or all special properties set by default to this configuration parameter.
- See the "propertyLabels" section of the respective internationalization file6 for a complete list of property keys and the special properties they stand for that have to be added to set changes to this configuration parameter. (→ Search for special properties by key)
See also
- Help page on embedded query updates
- Help page on configuration parameter
$smwgEnabledQueryDependencyLinksStoreSets whether tracking and storing of dependencies of embedded queries may be used - Help page on configuration parameter
$smwgQueryDependencyAffiliatePropertyDetectionListSets affiliate special properties that additionally initiate a query dependency update when value change occurs - Help page on property keys (→ Search for special properties by key)
