HTMLRestrictionsField.php

Go to the documentation of this file.

<?php
 
use MediaWiki\MediaWikiServices;
use MediaWiki\Request\WebRequest;
 
class HTMLRestrictionsField extends HTMLFormField {
    protected const DEFAULT_ROWS = 5;
 
    private HTMLTextAreaField $ipField;
 
    public function __construct( array $params ) {
        parent::__construct( $params );
        $this->ipField = new HTMLTextAreaField( [
            'parent' => $params['parent'],
            'fieldname' => $params['fieldname'] . '-ip',
            'rows' => self::DEFAULT_ROWS,
            'required' => $params['required'] ?? false,
            'help-message' => 'restrictionsfield-help',
            'label-message' => 'restrictionsfield-label',
        ] );
    }
 
    public function loadDataFromRequest( $request ) {
        if ( !$request->getCheck( $this->mName . '-ip' ) ) {
            return $this->getDefault();
        }
 
        $ipValue = rtrim( $request->getText( $this->mName . '-ip' ), "\r\n" );
        $ips = $ipValue === '' ? [] : explode( "\n", $ipValue );
        return MWRestrictions::newFromArray( [ 'IPAddresses' => $ips ] );
    }
 
    public function getDefault() {
        return parent::getDefault() ?? MWRestrictions::newDefault();
    }
 
    public function validate( $value, $alldata ) {
        if ( $this->isHidden( $alldata ) ) {
            return true;
        }
 
        if (
            isset( $this->mParams['required'] ) && $this->mParams['required'] !== false
            && !$value->toArray()['IPAddresses']
        ) {
            return $this->msg( 'htmlform-required' );
        }
 
        if ( !$value->validity->isGood() ) {
            $statusFormatter = MediaWikiServices::getInstance()->getFormatterFactory()->getStatusFormatter(
                $this->mParent->getContext()
            );
            return $statusFormatter->getMessage( $value->validity );
        }
 
        if ( isset( $this->mValidationCallback ) ) {
            return call_user_func( $this->mValidationCallback, $value, $alldata, $this->mParent );
        }
 
        return true;
    }
 
    public function getInputHTML( $value ) {
        $ipValue = implode( "\n", $value->toArray()['IPAddresses'] );
        return $this->ipField->getDiv( $ipValue );
    }
 
    public function getInputOOUI( $value ) {
        $ipValue = implode( "\n", $value->toArray()['IPAddresses'] );
        return $this->ipField->getOOUI( $ipValue )->toString();
    }
}