blob: 2f6649a5d0fa11546c47e948e6714300c46c3a29 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
## Register new datatype
This example shows how to register a new dataType/dataValue in Semantic MediaWiki.
* [Datatype](https://www.semantic-mediawiki.org/wiki/Help:Datatype)
* [DataValue](https://www.semantic-mediawiki.org/wiki/Help:DataValue)
### Type registration
All IDs must start with an underscore, two underscores indicate a truly internal
(non user-interacted type), three underscores should be used by an extension.
`TypesRegistry::getDataTypeList` expects that the following information are provided:
* A type id (e.g. `FooValue::TYPE_ID`)
* An associated class
* An item type (storage type)
* A declaration whether it is a subData type (e.g subobject) or not
* Whether a type is browsable or not
<pre>
return array(
// ...
FooValue::TYPE_ID => [ FooValue::class, DataItem::TYPE_WIKIPAGE, false, false ],
);
</pre>
<pre>
class FooValue extends DataValue {
/**
* DV identifier
*/
const TYPE_ID = '_foo';
/**
* @see DataValue::parseUserValue
*
* @param string $value
*/
protected function parseUserValue( $userValue ) {
...
}
}
</pre>
### Label registration
By default, DataTypes (Date, URL etc.) are registered with a corresponding property
of the same name to match the expected semantics. For an exemption, see
`smwgDataTypePropertyExemptionList`.
Find `i18n/extra/en.json` and extend the canonical description (which is English) with something like:
<pre>
"dataTypeLabels":{
"_foo": "SomeType"
...
},
"dataTypeAliases":{
"SomeType": "_foo"
"ExtraAlias": "_foo"
...
},
</pre>
|