Help:Con­figu­ration para­meter "$smwgQueryDependencyPropertyExemptionList"

From semantic-mediawiki.org
Jump to: navigation, search
edit with form


Title $smwgQueryDependencyPropertyExemptionList
Description Sets special properties that should be exempted from embedded queries updates
Default setting See below
Software Semantic MediaWiki
First version supported
Last version supported still available
Configuration Installation · Store settings · Experimental
Keyword sqlstore · query setting · query dependency · query management · experimental

$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 29 October 2015 and compatible with MW 1.19.0 - 1.25.x. as configuration parameter $smwgPropertyDependencyDetectionBlacklist1 but was renamed in Semantic MediaWiki 2.4.0Released on 9 July 2016 and compatible with MW 1.19.0 - 1.27.x..2 It was further renamed from $smwgQueryDependencyPropertyExemptionlist with Semantic MediaWiki 2.5.1Released on 22 April 2017 and compatible with MW 1.23.0 - 1.29.x..3 The former configuration parameter name will be removed with the release of Semantic MediaWiki 3.1.0Released on an unknown date and compatible with unknown versions of MediaWiki. in late 2018.4

This configuration parameter only takes effect if the embedded query update feature was enabled and is considered experimental.

Default setting

$smwgQueryDependencyPropertyExemptionList = array( '_MDAT', '_SOBJ', '_ASKDU' );

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 but it will 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
  • Special property "Query duration"Holds the value of the duration a query took to execute because changes to the duration of a query should not trigger an update of possible query dependencies (as this has no bearing on the result list

Changing the default setting

To modify this configuration setting, 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, array(
                '_NEWP',
                '_LEDT'
        )
);
NoteNote:
  • 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 file5 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



References

  1. ^  Semantic MediaWiki: GitHub pull request gh:smw:1135
  2. ^  Semantic MediaWiki: GitHub pull request gh:smw:1626
  3. ^  Semantic MediaWiki: GitHub pull request gh:smw:2364
  4. ^  Semantic MediaWiki: GitHub pull request gh:smw:2384
  5. ^  Semantic MediaWiki: Source code quote for "propertyLabels"