Cum să afișezi text cu traducere și URL HTML

Deoarece esc_html_e va escapa legăturile HTML (prin urmare va afișa ancorajul HTML ca text simplu), va trebui să segmentați textul și să escapați partea non-HTML cu esc_html_e sau esc_html__, iar partea de LEGĂTURĂ HTML să o afișați fără escapare HTML.

Metoda-1 (doar pentru înțelegerea dumneavoastră):

Puteți face acest lucru pe părți, astfel:

esc_html_e( 'Dragă Oaspete, cu informațiile dumneavoastră nu am putut găsi nicio cameră în acest moment.', 'text-domain' );
echo "<br><br>";

printf(
    esc_html__( '%1$s %2$s', 'text-domain' ),
    esc_html__( 'Vă rugăm să ne contactați pe', 'text-domain' ),
    sprintf(
        '<a href="%s">%s</a>',
        esc_url( 'http://www.example.com/contact-us/' ),
        esc_html__( 'Pagina de Contact', 'text-domain' )
    )
);

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

Metoda-2 (doar pentru înțelegerea dumneavoastră):

Evident, diferite limbi vor avea o ordine diferită a textelor, așa că pentru a oferi traducătorilor mai multă flexibilitate (cu escaparea și ordonarea textului), puteți face acest lucru în felul următor:

printf(
    esc_html__( '%1$s%2$s%3$s%4$s%5$s', 'text-domain' ),
    esc_html__( 'Dragă Oaspete, cu informațiile dumneavoastră nu am putut găsi nicio cameră în acest moment.', 'text-domain' ),
    nl2br( esc_html__( "\n\n", 'text-domain' ) ),
    sprintf(
        esc_html__( '%1$s %2$s', 'text-domain' ),
        esc_html__( 'Vă rugăm să ne contactați pe', 'text-domain' ),
        sprintf(
            '<a href="%s">%s</a>',
            esc_url( 'http://www.example.com/contact-us/' ),
            esc_html__( 'Pagina de Contact', 'text-domain' )
        )
    ),
    esc_html__( ' sau ', 'text-domain' ),
    sprintf(
        '<a href="%s">%s</a>',
        esc_url( 'mailto:info@example.com', array( 'mailto' ) ),
        esc_html__( 'Email', 'text-domain' )
    )
);

Acest mod de a face acest lucru va:

1. Escapa toate textele traduse necesare.

2. Permite HTML pentru legătură, email (cu sintaxa mailto:) etc.

3. Permite traducătorilor să aibă diferite ordonări ale textelor pentru diferite limbi. Notația de schimbare a argumentelor (%1$s, %2$s etc.) este folosită astfel încât traducătorii să poată reordona textul tradus unde este necesar.

Metoda-3 (Actualizată & Recomandată):

După cum @shea a subliniat corect, Metoda-2 de mai sus funcționează bine, dar poate fi dificil pentru traducători să adauge suport pentru diferite limbi. Deci avem nevoie de o soluție care:

1. Păstrează propozițiile întregi (nu le desparte).

2. Face escaparea corectă.

3. Oferă modalități de a avea o ordonare diferită pentru legăturile de contact și email (sau orice altceva similar) în cadrul propoziției traduse.

Deci pentru a evita complicațiile metodei-2, soluția de mai jos păstrează propozițiile traduse întregi și face escaparea URL-urilor și schimbarea argumentelor în același timp (mai multe note în comentariile din COD):

// exemplu de URL de contact (poate proveni dintr-o sursă nesigură ca inputul utilizatorului)
$contact_url = 'http://www.example.com/contact-us/';
// escaparea $contact_url
$contact_url = esc_url( $contact_url );

// exemplu de email de contact (poate proveni dintr-o sursă nesigură ca inputul utilizatorului)
$contact_email = 'info@example.com';
// escaparea, sanitizarea și ascunderea $contact_email.
// Da, poate fi necesar să sanitizați și să escapați emailul chiar și când folosiți funcția antispambot()
$contact_email = esc_url( sprintf( 'mailto:%s', antispambot( sanitize_email( $contact_email ) ) ), array( 'mailto' ) );

esc_html_e( 'Dragă Oaspete, cu informațiile dumneavoastră nu am putut găsi nicio cameră în acest moment.', 'text-domain' );
echo "<br><br>";

printf(
    esc_html__( 'Vă rugăm să ne contactați pe %1$s sau prin %2$s.', 'text-domain' ),
    sprintf(
        '<a href="%s">%s</a>',
        $contact_url,
        esc_html__( 'Pagina de Contact', 'text-domain' )
        ),
    sprintf(
        '<a href="%s">%s</a>',
        $contact_email,
        esc_html__( 'Email', 'text-domain' )
        )
    );

Acest mod de a face acest lucru va oferi traducătorilor două propoziții complete și două cuvinte separate de tradus. Deci un traducător va trebui doar să se preocupe de următoarele linii simple (în timp ce CODul se ocupă de restul):

esc_html_e( 'Dragă Oaspete, cu informațiile dumneavoastră nu am putut găsi nicio cameră în acest moment.', 'text-domain' );
// ...
esc_html__( 'Vă rugăm să ne contactați pe %1$s sau prin %2$s', 'text-domain' )
// ...
esc_html__( 'Pagina de Contact', 'text-domain' )
// ...
esc_html__( 'Email', 'text-domain' )

Atât, o structură simplă și care face escaparea și schimbarea argumentelor corect.

Citiți mai multe despre internaționalizarea pentru teme și internaționalizarea pentru pluginuri.