Как вывести переводимый текст с HTML ссылкой в WordPress

Поскольку функция esc_html_e экранирует HTML-ссылки (и, следовательно, будет отображать HTML-якорь как обычный текст), вам нужно разделить текст и экранировать не-HTML часть с помощью esc_html_e или esc_html__, а часть с HTML-ССЫЛКОЙ выводить без экранирования HTML.

Метод-1 (для понимания):

Можно сделать это по частям, например так:

esc_html_e( 'Уважаемый гость, по предоставленной информации мы не смогли найти свободных номеров.', 'text-domain' );
echo "<br><br>";

printf(
    esc_html__( '%1$s %2$s', 'text-domain' ),
    esc_html__( 'Пожалуйста, свяжитесь с нами через нашу', 'text-domain' ),
    sprintf(
        '<a href="%s">%s</a>',
        esc_url( 'http://www.example.com/contact-us/' ),
        esc_html__( 'Страницу контактов', 'text-domain' )
    )
);

printf(
    ' или <a href="%s">%s</a>',
    esc_url( 'mailto:info@example.com', array( 'mailto' ) ),
    esc_html__( 'Электронную почту', 'text-domain' )
);

Метод-2 (для понимания):

Очевидно, что в разных языках порядок текстов может отличаться, поэтому для предоставления переводчикам большей гибкости (в плане экранирования и порядка текста), можно сделать следующим образом:

printf(
    esc_html__( '%1$s%2$s%3$s%4$s%5$s', 'text-domain' ),
    esc_html__( 'Уважаемый гость, по предоставленной информации мы не смогли найти свободных номеров.', 'text-domain' ),
    nl2br( esc_html__( "\n\n", 'text-domain' ) ),
    sprintf(
        esc_html__( '%1$s %2$s', 'text-domain' ),
        esc_html__( 'Пожалуйста, свяжитесь с нами через нашу', 'text-domain' ),
        sprintf(
            '<a href="%s">%s</a>',
            esc_url( 'http://www.example.com/contact-us/' ),
            esc_html__( 'Страницу контактов', 'text-domain' )
        )
    ),
    esc_html__( ' или ', 'text-domain' ),
    sprintf(
        '<a href="%s">%s</a>',
        esc_url( 'mailto:info@example.com', array( 'mailto' ) ),
        esc_html__( 'Электронную почту', 'text-domain' )
    )
);

Такой подход позволяет:

1. Экранировать все необходимые переведенные тексты.

2. Разрешить HTML для ссылок, email (с синтаксисом mailto:) и т.д.

3. Дать переводчикам возможность менять порядок текста для разных языков. Используется нотация подстановки аргументов (%1$s, %2$s и т.д.), чтобы переводчики могли изменить порядок переведенного текста при необходимости.

Метод-3 (Обновленный и Рекомендуемый):

Как правильно отметил @shea, Метод-2 работает хорошо, но может быть сложным для переводчиков при поддержке разных языков. Поэтому нам нужно решение, которое:

1. Сохраняет предложения целыми (не разбивает их).

2. Обеспечивает правильное экранирование.

3. Предоставляет возможность менять порядок ссылок на контакты и email (или что-то подобное) в переведенном предложении.

Чтобы избежать сложностей метода-2, следующее решение сохраняет переводимые предложения целыми и одновременно обеспечивает правильное экранирование URL и подстановку аргументов (дополнительные пояснения в комментариях к КОДУ):

// пример URL контактов (может быть из ненадежного источника, например, пользовательского ввода)
$contact_url = 'http://www.example.com/contact-us/';
// экранирование $contact_url
$contact_url = esc_url( $contact_url );

// пример email для контактов (может быть из ненадежного источника)
$contact_email = 'info@example.com';
// экранирование, санитизация и скрытие $contact_email.
// Да, вам все еще может потребоваться санитизация и экранирование email при использовании функции antispambot()
$contact_email = esc_url( sprintf( 'mailto:%s', antispambot( sanitize_email( $contact_email ) ) ), array( 'mailto' ) );

esc_html_e( 'Уважаемый гость, по предоставленной информации мы не смогли найти свободных номеров.', 'text-domain' );
echo "<br><br>";

printf(
    esc_html__( 'Пожалуйста, свяжитесь с нами через нашу %1$s или по %2$s.', 'text-domain' ),
    sprintf(
        '<a href="%s">%s</a>',
        $contact_url,
        esc_html__( 'Страницу контактов', 'text-domain' )
        ),
    sprintf(
        '<a href="%s">%s</a>',
        $contact_email,
        esc_html__( 'Электронной почте', 'text-domain' )
        )
    );

Такой подход дает переводчикам два полных предложения и два отдельных слова для перевода. Таким образом, переводчикам нужно будет заботиться только о следующих простых строках (в то время как КОД позаботится обо всем остальном):

esc_html_e( 'Уважаемый гость, по предоставленной информации мы не смогли найти свободных номеров.', 'text-domain' );
// ...
esc_html__( 'Пожалуйста, свяжитесь с нами через нашу %1$s или по %2$s', 'text-domain' )
// ...
esc_html__( 'Страницу контактов', 'text-domain' )
// ...
esc_html__( 'Электронной почте', 'text-domain' )

Вот и все — простая структура, которая также обеспечивает правильное экранирование и подстановку аргументов.

Подробнее о интернационализации тем и интернационализации плагинов.