wikimedia/mediawiki-extensions-DonationInterface

<?php

class ResultPages {
    /**
     * Get the URL for a page to show donors after a successful donation,
     * with information about the donation appended as query string variables
     * @param GatewayType $adapter
     * @param array $extraParams any extra parameters to add to the URL
     * @return string full URL of the thank you page
     */
    public static function getThankYouPage( GatewayType $adapter, $extraParams = [] ) {
        $page = $adapter::getGlobal( "ThankYouPage" );
        if ( $page ) {
            $page = self::appendLanguageAndMakeURL(
                $page,
                $adapter->getData_Unstaged_Escaped( 'language' )
            );
        }
        $keysToPassThrough = [
            'amount',
            'country',
            'currency',
            'frequency_unit',
            'order_id',
            'payment_method',
            'recurring',
        ];

        foreach ( $keysToPassThrough as $key ) {
            $extraParams[$key] = $adapter->getData_Unstaged_Escaped( $key );
        }

        // Map from internal-facing old utm_ prefixes to wmf_ prefixes that hopefully
        // are less likely to be stripped by privacy-preserving browsers.
        $mappedKeys = [
            'utm_medium' => 'wmf_medium',
            'utm_source' => 'wmf_source',
            'utm_campaign' => 'wmf_campaign',
        ];

        foreach ( $mappedKeys as $key => $mappedKey ) {
            $extraParams[$mappedKey] = $adapter->getData_Unstaged_Escaped( $key );
        }

        return wfAppendQuery( $page ?? '', $extraParams );
    }

    /**
     * Get the URL for a page to show donors who cancel their attempt
     * @param GatewayType $adapter instance to use for logger and settings
     * @return string full URL of the cancel page
     */
    public static function getCancelPage( GatewayType $adapter ) {
        $cancelPage = $adapter->getGlobal( 'CancelPage' );
        if ( !$cancelPage ) {
            return '';
        }
        return self::appendLanguageAndMakeURL(
            $cancelPage,
            $adapter->getData_Unstaged_Escaped( 'language' )
        );
    }

    /**
     * For pages we intend to redirect to. This function will take either a full
     * URL or a page title, and turn it into a URL with the appropriate language
     * appended onto the end.
     * @param string $url Either a wiki page title, or a URL to an external wiki
     * page title.
     * @param string $language
     * @return string localized full URL
     */
    public static function appendLanguageAndMakeURL( $url, $language ) {
        // make sure we don't already have the language in there...
        $dirs = explode( '/', $url );
        if ( !in_array( $language, $dirs ) ) {
            $url .= "/$language";
        }

        if ( str_starts_with( $url, 'http' ) ) {
            return $url;
        } else { // this isn't a url yet.
            $returnTitle = Title::newFromText( $url );
            $url = $returnTitle->getFullURL( [], false, PROTO_CURRENT );
            return $url;
        }
    }
}