README

PropertySuggester is an extension to Wikibase to provide suggested properties when a user tries to add new statements to an item.

On Packagist:

Installation

The recommended way to use this library is via Composer.

Composer

To add this package as a local, per-project dependency to your project, simply add a dependency on propertysuggester/property-suggester to your project's composer.json file. Here is a minimal example of a composer.json file:

{
    "require": {
        "propertysuggester/property-suggester": "*"
    }
}

Setup

This extension adds a new table "wbs_propertypairs" that contains the information that is needed to generate suggestions. You can use property-suggester-scripts to generate this data from a wikidata dump.

• add wfLoadExtension( 'PropertySuggester' ); to your localsettings
• run maintenance/update.php to create the necessary table
• follow the readme of PropertySuggester-Python to generate and load suggestion data

Configuration

• $wgPropertySuggesterMinProbability - a float that sets a minimum threshold for suggestions (default 0.05)
• $wgPropertySuggesterDeprecatedIds - a list of ints that won't be used for suggestions
• $wgPropertySuggesterInitialSuggestions - a list of ints that will be suggested when no statements exist
• $wgPropertySuggesterSchemaTreeUrl - a string that contains the URL of the endpoint for the SchemaTree suggester (required if the default suggester is SchemaTree or if A/B testing is enabled)
• $wgPropertySuggesterABTestingState - a boolean representing the state of A/B testing
• $wgPropertySuggesterDefaultSuggester - a string representing the default suggester used (either SchemaTreeSuggester or PropertySuggester)
• $wgPropertySuggesterTestingRatio - a float that represents the ratio of suggesters used when A/B testing is enabled. Value of 2 will result in an approximate 50/50 split, values greater than 2 will result in the PropertySuggester being used more often

Release notes

3.2.1 (2018-11-14)

• Added compatibility with Wikibase DataModel 9.x

3.2.0 (2017-04-24)

• Converted extension to use MediaWiki extension registration.

3.1.7 (2017-03-27)

• Added compatibility with Wikibase DataModel 7.x
• Raised minimal required Wikibase DataModel version to 6.1
• Added safe guard to make sure SimpleSuggester does not index non-Items as Items

3.1.6 (2017-01-03)

• Adapted entity suggester for changes in Wikibase.

3.1.5 (2016-12-02)

• Adapted entity suggester for changes in Wikibase.

3.1.4 (2016-10-03)

• Handle MediaWiki's OutputPage::getTitle returning null.

3.1.3 (2016-08-31)

• Only get suggestions once when the property input field is initially focused.

3.1.2 (2016-08-04)

• Follow up fix for entity suggester, update cache management in EntitySuggester.

3.1.1 (2016-08-03)

• Follow up fix for entity suggester, update method call in EntitySuggester.

3.1.0 (2016-08-03)

• Adapted entity suggester for changes in Wikibase.

3.0.2 (2016-06-20)

• Adapt entity type for namespaces
• Minor cleanups

3.0.1 (2016-03-14)

• Defined compatibility with Wikibase DataModel ~6.0

3.0.0 (2016-02-25)

• Now requires PHP 5.5.0 or higher
• Defined compatibility with Wikibase DataModel ~5.0

2.4.5 (2015-12-27)

• Add i18n to the wbsgetsuggestions api module. This makes MediaWiki's ApiDocumentationTest pass.

2.4.4 (2015-10-14)

• Fixed ResourceLoader dependencies of the jquery.wikibase.entityselector module.

2.4.3 (2015-09-17)

• Defined compatibility with Wikibase DataModel Services ~3.0

2.4.2 (2015-09-03)

• Defined compatibility with Wikibase DataModel Services ~2.0

2.4.1 (2015-08-27)

• Added explicit dependency on Wikibase DataModel.
• wbsgetsuggestions API never returns more than one aliases entry per match.
• wbsgetsuggestions does not return aliases when the label already is a successful match.
• wbsearchentities is explicitely called with the uselang option set.

2.4.0 (2015-08-12)

• Require DataModelServices ~1.1
• Use EntityLookup interface from DataModelServices to replace removed WikibaseLib interface

2.3.1 (2015-07-13)

• Fix use of WikibaseApiTestCase due to namespace change

2.3.0 (2015-06-26)

• Replace use of Wikibase\TermIndex::getMatchingIDs with Wikibase\TermIndex::getTopMatchingTerms.
• EntitySelector no longer passes "type" parameter to wbsgetsuggestions which avoids an "Unrecognized parameter" warning.

2.2.1 (2015-06-18)

• Replace use of Wikibase\Term with Wikibase\TermIndexEntry, per change in Wikibase.

2.2.0 (2015-04-29)

• Adjust api code for core api changes (this requires a newer mediawiki core)
• Replace deprecated Item::addClaim

2.1.0 (2015-04-02)

• Suggest initial properties for items and properties with no statements yet.

2.0.6 (2015-02-20)

• No longer use Wikibase\Utils as it was renamed
• Remove obvious function-level profiling

2.0.5 (2015-01-29)

• Fix TermIndex method call in ResultBuilder

2.0.4 (2015-01-13)

• Adjust to changes in ValueView 0.10.0.

2.0.3 (2015-01-06)

• Adjust to removal of claimview

2.0.2 (2014-12-17)

• Fix TermIndex method call in ResultBuilder

2.0.1 (2014-11-11)

Adjust to new version of DataModel-JavaScript

2.0.0 (2014-11-10)

• Consider classifying properties (needs version 2.0.0 of PropertySuggester-Python)

1.1.4 (2014-10-22)

• Replace usage of Wikibase\NamespaceUtils for compatibility with Wikibase Repo.
• Specified GPL-2.0-or-later license

1.1.3 (2014-10-17)

• Wikibase Data Model 2.0 compatibility fixes.

1.1.2 (2014-09-05)

• Wikibase Data Model 1.0 compatibility fixes.

1.1.1 (2014-08-27)

• Update namespace of EntityTitleLookup, per change in Wikibase.

1.1.0 (2014-07-25)

• Suggest properties for qualifiers and references based on the property of the mainsnak

1.0.0 (2014-07-01)

• Provide Property-Suggestions based on correlations to other properties in the item