Come stampare testo con supporto alla traduzione e URL HTML

Poiché esc_html_e eseguirà l'escape del link HTML (mostrando quindi l'ancora HTML come testo normale), dovrai segmentare il testo e applicare l'escape alla parte non-HTML con esc_html_e o esc_html__, e stampare la parte del LINK HTML senza escape HTML.

Metodo-1 (solo per la tua comprensione):

Puoi farlo in parti, in questo modo:

esc_html_e( 'Gentile Ospite, con le Sue informazioni al momento non abbiamo trovato alcuna camera disponibile.', 'text-domain' );
echo "<br><br>";

printf(
    esc_html__( '%1$s %2$s', 'text-domain' ),
    esc_html__( 'La preghiamo di contattarci sulla nostra', 'text-domain' ),
    sprintf(
        '<a href="%s">%s</a>',
        esc_url( 'http://www.example.com/contattaci/' ),
        esc_html__( 'Pagina di Contatto', 'text-domain' )
    )
);

printf(
    ' oppure <a href="%s">%s</a>',
    esc_url( 'mailto:info@example.com', array( 'mailto' ) ),
    esc_html__( 'Email', 'text-domain' )
);

Metodo-2 (solo per la tua comprensione):

Ovviamente, lingue diverse avranno un ordine diverso dei testi, quindi per dare ai traduttori più flessibilità (con l'escape e l'ordine del testo), puoi farlo nel seguente modo:

printf(
    esc_html__( '%1$s%2$s%3$s%4$s%5$s', 'text-domain' ),
    esc_html__( 'Gentile Ospite, con le Sue informazioni al momento non abbiamo trovato alcuna camera disponibile.', 'text-domain' ),
    nl2br( esc_html__( "\n\n", 'text-domain' ) ),
    sprintf(
        esc_html__( '%1$s %2$s', 'text-domain' ),
        esc_html__( 'La preghiamo di contattarci sulla nostra', 'text-domain' ),
        sprintf(
            '<a href="%s">%s</a>',
            esc_url( 'http://www.example.com/contattaci/' ),
            esc_html__( 'Pagina di Contatto', 'text-domain' )
        )
    ),
    esc_html__( ' oppure ', 'text-domain' ),
    sprintf(
        '<a href="%s">%s</a>',
        esc_url( 'mailto:info@example.com', array( 'mailto' ) ),
        esc_html__( 'Email', 'text-domain' )
    )
);

Questo metodo permetterà di:

1. Applicare l'escape a tutti i testi tradotti necessari.

2. Permettere l'HTML per link, email (con sintassi mailto:) ecc.

3. Permettere ai traduttori di avere qualsiasi ordine di testo per lingue diverse. La notazione di scambio argomenti (%1$s, %2$s ecc.) viene utilizzata in modo che i traduttori possano riordinare il testo tradotto dove necessario.

Metodo-3 (Aggiornato e Consigliato):

Come @shea ha giustamente sottolineato, il Metodo-2 sopra funziona bene, ma potrebbe essere difficile per i traduttori aggiungere supporto per lingue diverse. Quindi abbiamo bisogno di una soluzione che:

1. Mantenga le frasi intatte (senza spezzarle).

2. Esegua l'escape corretto.

3. Fornisca modi per avere un ordine diverso per i link di contatto e email (o qualsiasi cosa simile) all'interno della frase tradotta.

Quindi per evitare la complicazione del metodo-2, la soluzione seguente mantiene intatte le frasi traducibili e allo stesso tempo esegue l'escape degli URL e lo scambio di argomenti (ulteriori note nei commenti del CODICE):

// URL di contatto di esempio (potrebbe provenire da un'origine non sicura come input utente)
$contact_url = 'http://www.example.com/contattaci/';
// escape di $contact_url
$contact_url = esc_url( $contact_url );

// email di contatto di esempio (potrebbe provenire da un'origine non sicura come input utente)
$contact_email = 'info@example.com';
// escape, sanificazione e nascondimento di $contact_email.
// Sì, potresti ancora dover sanificare e eseguire l'escape dell'email mentre usi la funzione antispambot()
$contact_email = esc_url( sprintf( 'mailto:%s', antispambot( sanitize_email( $contact_email ) ) ), array( 'mailto' ) );

esc_html_e( 'Gentile Ospite, con le Sue informazioni al momento non abbiamo trovato alcuna camera disponibile.', 'text-domain' );
echo "<br><br>";

printf(
    esc_html__( 'La preghiamo di contattarci sulla nostra %1$s oppure via %2$s.', 'text-domain' ),
    sprintf(
        '<a href="%s">%s</a>',
        $contact_url,
        esc_html__( 'Pagina di Contatto', 'text-domain' )
        ),
    sprintf(
        '<a href="%s">%s</a>',
        $contact_email,
        esc_html__( 'Email', 'text-domain' )
        )
    );

Questo modo di procedere darà ai traduttori due frasi complete e due parole separate da tradurre. Quindi un traduttore dovrà solo preoccuparsi delle seguenti semplici righe (mentre il CODICE si occupa del resto):

esc_html_e( 'Gentile Ospite, con le Sue informazioni al momento non abbiamo trovato alcuna camera disponibile.', 'text-domain' );
// ...
esc_html__( 'La preghiamo di contattarci sulla nostra %1$s oppure via %2$s', 'text-domain' )
// ...
esc_html__( 'Pagina di Contatto', 'text-domain' )
// ...
esc_html__( 'Email', 'text-domain' )

Ecco fatto, struttura semplice e che esegue correttamente l'escape e lo scambio di argomenti.

Leggi di più su internazionalizzazione per temi e internazionalizzazione per plugin.