summaryrefslogtreecommitdiff
path: root/extensions/Gadgets/includes/GadgetRepo.php
blob: 18bf5b51a3864aff6ab675546fe42e8ba4fcb70a (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
<?php

abstract class GadgetRepo {

	/**
	 * @var GadgetRepo|null
	 */
	private static $instance;

	/**
	 * Get the ids of the gadgets provided by this repository
	 *
	 * @return string[]
	 */
	abstract public function getGadgetIds();

	/**
	 * Get the Gadget object for a given gadget id
	 *
	 * @param string $id
	 * @throws InvalidArgumentException
	 * @return Gadget
	 */
	abstract public function getGadget( $id );

	/**
	 * Get a list of gadgets sorted by category
	 *
	 * @return array array( 'category' => array( 'name' => $gadget ) )
	 */
	public function getStructuredList() {
		$list = array();
		foreach ( $this->getGadgetIds() as $id ) {
			$gadget = $this->getGadget( $id );
			$list[$gadget->getCategory()][$gadget->getName()] = $gadget;
		}

		return $list;
	}

	/**
	 * Get the configured default GadgetRepo. Currently
	 * this hardcodes MediaWikiGadgetsDefinitionRepo since
	 * that is the only implementation
	 *
	 * @return GadgetRepo
	 */
	public static function singleton() {
		if ( self::$instance === null ) {
			self::$instance = new MediaWikiGadgetsDefinitionRepo();
		}
		return self::$instance;
	}

	/**
	 * Should only be used by unit tests
	 *
	 * @param GadgetRepo|null $repo
	 */
	public static function setSingleton( $repo = null ) {
		self::$instance = $repo;
	}
}