Vai al contenuto

Messaggio di conferma personalizzato

In questa pagina vediamo come Personalizzare il messaggio che include il token di conferma della prenotazione (il messaggio di conferma della prenotazione inviato quando i pagamenti online sono disabilitati).

A partire dalla versione 1.0.2, il plugin Simple Bike Rental invia l'email di conferma in formato HTML, rendendo il messaggio più leggibile e professionale.

Sono stati introdotti anche due filtri WordPress per consentire agli sviluppatori di personalizzare l'oggetto e il contenuto del messaggio.

In questa guida ti mostreremo come farlo in pochi semplici passaggi.

Modificare l'oggetto dell'email

Puoi modificare l'oggetto dell'email utilizzando il filtro simpbire_email_subject nel file functions.php del tuo tema (o in un plugin personalizzato): 

add_filter('simpbire_email_subject', 'custom_sbr_email_subject', 10, 2);
function custom_sbr_email_subject($subject, $name) {
  return "Confirm your bike rental, $name!";
}

Modifica del contenuto dell'email

Il filtro simpbire_email_message consente di personalizzare l'intero messaggio HTML , incluso il collegamento di conferma: 

add_filter('simpbire_email_message', 'custom_sbr_email_message', 10, 3);
function custom_sbr_email_message($message, $name, $link) {

  $name = esc_html($name);
  $link = esc_url($link);

  return "
  <p>Hi $name,</p>

  <p>Thanks for booking your bike with us!</p>

  <p>Please confirm your rental by clicking the button below:</p>

  <p>
  <a href=\"$link\"
  style=\"display:inline-block;
  padding:12px 24px;
  background-color:#2271b1;
  color:#ffffff;
  text-decoration:none;
  border-radius:4px;
  font-weight:600;\">
  Confirm your reservation
  </a>
  </p>

  <p>If the button does not work, copy and paste this link into your browser:</p>
  <p><a href=\"$link\">$link</a></p>

  <p>Looking forward to seeing you!</p>
  ";
}

Puoi usare liberamente l'HTML e inserire immagini, loghi o uno stile personalizzato.

Sicurezza e compatibilità

Il plugin sanitizza $name con sanitize_text_field() e $link con esc_url_raw() prima di passarli ai filtri. La sanitizzazione non sostituisce l’escaping specifico per il contesto di output: quando costruisci un messaggio HTML personalizzato, usa esc_html($name) per il nome ed esc_url($link) per il link di conferma, come nell’esempio precedente. L’oggetto dell’email è testo semplice e non richiede escaping HTML.

Il plugin passa l’oggetto e il messaggio restituiti dai filtri a wp_mail() senza ulteriori operazioni di sanitizzazione o escaping. Applica l’escaping appropriato a tutti i dati dinamici inseriti nel messaggio HTML, inclusi campi personalizzati, metadati utente e input utente.

  • esc_html() per il testo all’interno dell’HTML
  • esc_url() per gli URL, inclusi quelli di link e immagini
  • esc_attr() per i valori degli altri attributi HTML

Hai bisogno di aiuto?

Se hai domande su come applicare questi filtri, puoi contattarci tramite la pagina Contatti o aprire una discussione nel forum di supporto su WordPress.org.