$smwgCategoryFeatures

Configuration parameter details:
Name	$smwgCategoryFeatures
Description	Sets the behaviour of the query features related to category handling
Default setting	See below
Software	Semantic MediaWiki
Since version	3.0.0
Until version	still available
Configuration	Query settings
Keyword	category

$smwgCategoryFeatures is a configuration parameter that sets the behaviour of the query features related to category handling. The configuration parameter was introduced in Semantic MediaWiki 3.0.0Released on 11 October 2018 and compatible with MW 1.27.0 - 1.31.x.1 and deprecated the configuration parameters as indicated in the section on available options below.

The deprecated configuration settings as indicated in the section on available options should be migrated to this configuration parameter in "LocalSettings.php" since they will be removed with the release of Semantic MediaWiki 3.1.0Released on 23 September 2019 and compatible with MW 1.31.0 - 1.33.x. in 2019.1

Default setting

$smwgCategoryFeatures = SMW_CAT_REDIRECT | SMW_CAT_INSTANCE | SMW_CAT_HIERARCHY;

This means that the three respective features as explained in the following sections on available options are enabled.

Available options

The options enabled by default are highlighted bold.

• SMW_CAT_NONE – Disables query features related to the handling of categories
• SMW_CAT_REDIRECT – Set that redirects on categories should be detected and used as annotation values

  Note: This option replaces configuration parameter $smwgUseCategoryRedirectSet whether redirects on categories should be detected and used as annotation value.

• SMW_CAT_INSTANCE – Sets that a category statement should be treated as an element of the category

  Note: This option replaces configuration parameter $smwgCategoriesAsInstancesSets whether a category statement should be treated as an element of the category.

• SMW_CAT_HIERARCHY – Sets that MediaWiki's subcategory hierarchy should be considered as hierarchy elements in the annotation process

  Note: This option replaces configuration parameter $smwgUseCategoryHierarchySets whether elements of the subcategory hierarchy are considered as hierarchy elements in the annotation process.

For further information on the available options listed above see the documentation pages of the respective deprecated configuration parameters as stated above.

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:

Removing a specific query feature related to category handling

To disable a specific feature e.g. that redirects on categories should be detected and used as annotation values just redefine the configuration parameter by defining it without including the corresponding constant as shown in the above section on available options:

$smwgCategoryFeatures = SMW_CAT_INSTANCE | SMW_CAT_HIERARCHY;

or alternatively remove the option from the existing definition of the configuration parameter like e.g.

$smwgCategoryFeatures = ( $smwgCategoryFeatures & ~SMW_CAT_REDIRECT );

  Note: Please use parentheses2 when combining different bit-operations to avoid a possible mismatch.

Disabling all query features related to category handling

To disable all features related to category handling just remove all constants as shown in the above section on available options:

$smwgCategoryFeatures = '';

or add the constant for disabling all category handling features

$smwgCategoryFeatures = SMW_CAT_NONE;

See also

• Help page on configuration parameter $smwgUseCategoryHierarchySets whether elements of the subcategory hierarchy are considered as hierarchy elements in the annotation process
• Help page on configuration parameter $smwgCategoriesAsInstancesSets whether a category statement should be treated as an element of the category
• Help page on configuration parameter $smwgUseCategoryRedirectSet whether redirects on categories should be detected and used as annotation value