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

From semantic-mediawiki.org
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


$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 and compatible with . in late 2018.4

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

Default setting[edit]

$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[edit]

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[edit]



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"