mediawiki-skins-MinervaNeue/includes/Menu/Entries/LanguageSelectorEntry.php
Fomafix f1b2416fbf Use PHP types
* Add type hints where possible.
* Add initialization values to properties where needed.
* Remove @var block if redundant to type declaration.
* Use single line /** @var type $var */ instead of multi line.
* Add improvements to avoid Phan warnings.

Change-Id: I8e391700dcbfbbcc88cceb589dc3a36fb8e3b357
2024-05-08 07:38:21 +00:00

122 lines
3 KiB
PHP

<?php
/**
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
namespace MediaWiki\Minerva\Menu\Entries;
use MediaWiki\Title\Title;
use MessageLocalizer;
/**
* Model for a menu entry that represents a language selector for current title
*/
class LanguageSelectorEntry implements IMenuEntry {
private MessageLocalizer $messageLocalizer;
private Title $title;
private bool $doesPageHaveLanguages;
/** @var string Associated icon name */
private string $icon;
/** @var string A translatable label used as text and title */
private string $label;
/** @var string additional classes */
private string $classes;
/**
* LanguageSelectorEntry constructor.
* @param Title $title Current Title
* @param bool $doesPageHaveLanguages Whether the page is also available in other
* languages or variants
* @param MessageLocalizer $messageLocalizer Used for translation texts
* @param bool $isButton
* @param string $classes page classes
* @param string $label Menu entry label and title
*/
public function __construct(
Title $title,
$doesPageHaveLanguages,
MessageLocalizer $messageLocalizer,
$isButton = false,
$classes = '',
$label = 'mobile-frontend-language-article-heading'
) {
$this->title = $title;
$this->doesPageHaveLanguages = $doesPageHaveLanguages;
$this->messageLocalizer = $messageLocalizer;
$this->icon = 'language-base20';
$this->label = $label;
$this->classes = $classes;
}
/**
* @inheritDoc
*/
public function getName(): string {
return 'language-selector';
}
/**
* @inheritDoc
*/
public function getCSSClasses(): array {
return [];
}
/**
* @inheritDoc
*/
public function getComponents(): array {
$switcherLink = false;
$switcherClasses = ' language-selector';
if ( $this->doesPageHaveLanguages ) {
$switcherLink = '#p-lang';
} else {
$switcherClasses .= ' disabled';
}
$msg = $this->messageLocalizer->msg( $this->label );
return [
[
'tag-name' => 'a',
'classes' => $this->classes . ' ' . $switcherClasses,
'label' => $msg,
'data-icon' => [
'icon' => $this->icon,
],
'array-attributes' => [
[
'key' => 'href',
'value' => $switcherLink,
],
[
'key' => 'data-mw',
'value' => 'interface',
],
[
'key' => 'data-event-name',
'value' => 'menu.languages',
],
[
'key' => 'title',
'value' => $msg,
],
],
],
];
}
}