Extensions maintained by the project try follow some simple guidelines, also to make maintenance easier with a common infrastructure and setup:

• Use Composer as deployment tool
• Loaded via MediaWiki's extension.json
• Use Travis-CI as continuous integration platform

Guidelines and conventions

Some general guidelines are:

• An extension specifies its dependency to ensure it is tested and usable for the Semantic MediaWiki release it was intended for by maintaining a composer.json
• Use PSR-4 and a PHP namespace to distinguish a codebase from other repositories that may use similar (or even the same) class/interface names.
• Code quality should be considered when writing an extension in order for fellow developers to be able to understand, read, and review the code.
• See also the https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/docs/architecture/coding.conventions.md "coding conventions" defined by Semantic MediaWiki
• Deploy and write tests as part of the extension

Getting started ...

The following extensions can be used as inspiration on "How to write an extension" in connection with Semantic MediaWiki.

• SemanticMetaTags
• SemanticApprovedRevs
• SemanticExtraSpecialProperties
• SemanticBreadcrumbLinks
• SemanticScribunto
• SemanticGlossary

Technical notes

Files and folders

It has been good practice to code around the following files and folders structure:

docs/
i18n/
src/
tests/

Continuous integration

Using Travis-CI is fairly easy to set up and integrable with Semantic MediaWiki, the best approach is to select an existing repository and copy files such as:

• .travis.yml
• tests/travis folder and adapt the necessary references
• When you host your extension with GitHub remember to register your Travis-CI either as App or via the webhook (see the documentation from the provider)
• phpunit.xml.dist and the tests/bootstrap.php and make necessary changes

composer.json

    "require": {
        "php": ">=5.6.0",
        "composer/installers": "1.*,>=1.0.1",
        "mediawiki/semantic-media-wiki": "~3.0"
    },
    "extra": {
        "branch-alias": {
            "dev-master": "0.1.x-dev"
        }
    },
    "autoload": {
        "files" : [
            "Foo.php"
        ],
        "psr-4": {
            "Foo\\": "src/"
        }
    }

extension.json

{
    "name": "Foo",
    "version": "0.1-alpha",
    "author": [
        "Foo",
        "..."
    ],
    "descriptionmsg": "foo-desc",
    "namemsg": "foo-name",
    "license-name": "GPL-2.0-or-later",
    "type": "foo",
    "requires": {
        "MediaWiki": ">= 1.30"
    },
    "MessagesDirs": {
        "Foo": [
            "i18n"
        ]
    },
    "callback": "Foo::initExtension",
    "ExtensionFunctions": [
        "Foo::onExtensionFunction"
    ],
    "load_composer_autoloader":true,
    "manifest_version": 1
}

Foo.php

/**
 * Extension ...
 *
 *