MediaWiki REL1_31
addSite.php
Go to the documentation of this file.
1<?php
2
4
5$basePath = getenv( 'MW_INSTALL_PATH' ) !== false ? getenv( 'MW_INSTALL_PATH' ) : __DIR__ . '/..';
6
7require_once $basePath . '/maintenance/Maintenance.php';
8
17class AddSite extends Maintenance {
18
19 public function __construct() {
20 $this->addDescription( 'Add a site definition into the sites table.' );
21
22 $this->addArg( 'globalid', 'The global id of the site to add, e.g. "wikipedia".', true );
23 $this->addArg( 'group', 'In which group this site should be sorted in.', true );
24 $this->addOption( 'language', 'The language code of the site, e.g. "de".', false, true );
25 $this->addOption( 'interwiki-id', 'The interwiki ID of the site.', false, true );
26 $this->addOption( 'navigation-id', 'The navigation ID of the site.', false, true );
27 $this->addOption( 'pagepath', 'The URL to pages of this site, e.g.' .
28 ' https://example.com/wiki/\$1.', false, true );
29 $this->addOption( 'filepath', 'The URL to files of this site, e.g. https://example' .
30 '.com/w/\$1.', false, true );
31
32 parent::__construct();
33 }
34
40 public function execute() {
41 $siteStore = MediaWikiServices::getInstance()->getSiteStore();
42 $siteStore->reset();
43
44 $globalId = $this->getArg( 0 );
45 $group = $this->getArg( 1 );
46 $language = $this->getOption( 'language' );
47 $interwikiId = $this->getOption( 'interwiki-id' );
48 $navigationId = $this->getOption( 'navigation-id' );
49 $pagepath = $this->getOption( 'pagepath' );
50 $filepath = $this->getOption( 'filepath' );
51
52 if ( !is_string( $globalId ) || !is_string( $group ) ) {
53 echo "Arguments globalid and group need to be strings.\n";
54 return false;
55 }
56
57 if ( $siteStore->getSite( $globalId ) !== null ) {
58 echo "Site with global id $globalId already exists.\n";
59 return false;
60 }
61
62 $site = new MediaWikiSite();
63 $site->setGlobalId( $globalId );
64 $site->setGroup( $group );
65 if ( $language !== null ) {
66 $site->setLanguageCode( $language );
67 }
68 if ( $interwikiId !== null ) {
69 $site->addInterwikiId( $interwikiId );
70 }
71 if ( $navigationId !== null ) {
72 $site->addNavigationId( $navigationId );
73 }
74 if ( $pagepath !== null ) {
75 $site->setPagePath( $pagepath );
76 }
77 if ( $filepath !== null ) {
78 $site->setFilePath( $filepath );
79 }
80
81 $siteStore->saveSites( [ $site ] );
82
83 if ( method_exists( $siteStore, 'reset' ) ) {
84 $siteStore->reset();
85 }
86
87 echo "Done.\n";
88 }
89}
90
91$maintClass = AddSite::class;
92require_once RUN_MAINTENANCE_IF_MAIN;
$maintClass
Definition addSite.php:91
$basePath
Definition addSite.php:5
Maintenance script for adding a site definition into the sites table.
Definition addSite.php:17
__construct()
Default constructor.
Definition addSite.php:19
execute()
Imports the site described by the parameters (see self::__construct()) passed to this maintenance scc...
Definition addSite.php:40
Abstract maintenance class for quickly writing and churning out maintenance scripts with minimal effo...
addArg( $arg, $description, $required=true)
Add some args that are needed.
getArg( $argId=0, $default=null)
Get an argument.
addDescription( $text)
Set the description text.
addOption( $name, $description, $required=false, $withArg=false, $shortName=false, $multiOccurrence=false)
Add a parameter to the script.
getOption( $name, $default=null)
Get an option, or return the default.
Class representing a MediaWiki site.
MediaWikiServices is the service locator for the application scope of MediaWiki.
require_once RUN_MAINTENANCE_IF_MAIN