SlotDiffRenderer.php

Go to the documentation of this file.

<?php
use Wikimedia\Assert\Assert;

abstract class SlotDiffRenderer {

    abstract public function getDiff( Content $oldContent = null, Content $newContent = null );

    public function addModules( OutputPage $output ) {
    }

    public function getExtraCacheKeys() {
        return [];
    }

    protected function normalizeContents(
        Content &$oldContent = null, Content &$newContent = null, $allowedClasses = null
    ) {
        if ( !$oldContent && !$newContent ) {
            throw new InvalidArgumentException( '$oldContent and $newContent cannot both be null' );
        }

        if ( $allowedClasses ) {
            if ( is_array( $allowedClasses ) ) {
                $allowedClasses = implode( '|', $allowedClasses );
            }
            Assert::parameterType( $allowedClasses . '|null', $oldContent, '$oldContent' );
            Assert::parameterType( $allowedClasses . '|null', $newContent, '$newContent' );
        }

        if ( !$oldContent ) {
            $oldContent = $newContent->getContentHandler()->makeEmptyContent();
        } elseif ( !$newContent ) {
            $newContent = $oldContent->getContentHandler()->makeEmptyContent();
        }
    }

}