Jump to content

Semantic MediaWiki/Implementation/Code

From Meta, a Wikimedia project coordination wiki

Organization

[edit]

Semantic MediaWiki is an extension to MediaWiki. The Special:Version page displays its version and lists its hooks into MediaWiki.

Contributing

[edit]

See https://www.semantic-mediawiki.org/wiki/Contributing_to_Semantic_MediaWiki

Architectural Overview

[edit]

smwfParserHook() in SMW_Hooks.php looks for the special [[relation:page]] and [[attribute:=value]] patterns in wikitext and calls smwfParseRelationsCallback and smwfParseAttributesCallback. These functions extract the information for each relation or attribute and store it in the SMWSemanticData object implemented in SMW_SemanticData.php.

Attribute handling is more complicated than relation handling. SMWSemanticData creates a SMWDataValue instance for each attribute value. The datavalue figures out the datatype of the attribute and uses SMWTypeHandlerFactory to load the appropriate SMW_DT_*.php file with a SMW*TypeHandler (e.g. SMW_DateTimeHandler) that can parse the value. All the type handlers implement the SMWTypeHandler interface.

Some attributes and relations are built-in to SMW and are required for its operation, such as "Has type" and "main display unit". SMWSemanticData detects these and handles them separately, storing them in a special properties table.

Other hooks in SMW_Hooks.php store, delete, and move the semantic data by calling global functions and methods of the SMWSemanticData object. These call functions in SMW_Storage.php that talk to the SMW database tables.

The parser hook in SMW_Hooks.php also prints the factbox at the bottom of the page.

Querying is handled separately. SMW_InlineQueries.php sets a hook for <ask.

Development Tips

[edit]

Useful links in http://www.mediawiki.org/wiki/Development such as How to become a MediaWiki hacker.

Eclipse tips

[edit]

Eclipse with the PHPEclipse plug-in is a reasonable development environment.

Eclipse will complain if you try to have two project, MediaWiki and SemanticMediaWiki, where the latter is nested inside the other. A workaround is to create MediaWiki and within it create a new folder, but in [Advanced] options Link to folder in file system and navigate to your Apache mediawiki folder.

If you have Subversion commit access, you can use the Subversive Ecliple plug-in to manage it.