{"id":34927,"date":"2019-12-08T09:18:00","date_gmt":"2019-12-08T09:18:00","guid":{"rendered":"https:\/\/contactform7.com\/?p=34927"},"modified":"2020-05-01T18:48:52","modified_gmt":"2020-05-01T18:48:52","slug":"customizing-mail-tag-replacement","status":"publish","type":"post","link":"https:\/\/contactform7.com\/es\/2019\/12\/08\/customizing-mail-tag-replacement\/","title":{"rendered":"Personalizar la sustituci\u00f3n de las etiquetas de correo"},"content":{"rendered":"\n

Una etiqueta de correo electr\u00f3nico tiene una etiqueta de formulario correspondiente<\/a>; cuando se compone un correo electr\u00f3nico, una etiqueta de correo, en la plantilla de correo electr\u00f3nico, se sustituye con el valor de entrada del usuario que viene a trav\u00e9s del campo de entrada representado por la etiqueta de formulario correspondiente.<\/p>\n\n\n\n\n\n\n\n\n\n\n

Por defecto, una etiqueta de correo se sustituye por el valor en bruto que el remitente introduce. Puedes personalizar la sustituci\u00f3n de las etiquetas de correo. Para ello, usa el gancho de filtro wpcf7_mail_tag_replaced<\/code>, como se muestra en el siguiente ejemplo:<\/p>\n\n\n

\nadd_filter( 'wpcf7_mail_tag_replaced',\n\n  function( $replaced, $submitted, $html, $mail_tag ) {\n    if ( is_numeric( $submitted ) ) {\n      $replaced = number_format( $submitted );\n    }\n\n    return $replaced;\n  },\n\n  10, 4\n);\n<\/pre><\/div>\n\n\n
Esta funci\u00f3n de filtrado formatea valores num\u00e9ricos usando la funci\u00f3n number_format<\/a><\/code> (observa que los ejemplos de esta entrada usan funciones an\u00f3nimas<\/a> que est\u00e1n disponibles desde PHP 5.3 en adelante). Cuando el usuario introduzca \u00ab1234567890\u00bb, ver\u00e1s \u00ab1,234,567,890\u00bb en el mensaje de correo electr\u00f3nico.<\/p>\n\n\n\n
El filtro de gancho wpcf7_mail_tag_replaced<\/code> pasa cuatro par\u00e1metros a una funci\u00f3n de gancho: $replaced<\/code>, $submitted<\/code>, $html<\/code>, y $mail_tag<\/code>.<\/p>\n\n\n\n
$replaced<\/code> tiene el valor generado como resultado de la sustituci\u00f3n de la etiqueta de correo.<\/p>\n\n\n\n
$submitted<\/code> tiene el valor original que ha sido introducido por el remitente.<\/p>\n\n\n\n
$html<\/code> tiene un valor booleano; que ser\u00e1 \u00abtrue<\/em>\u00bb si la etiqueta de correo se usa en el cuerpo de un mensaje HTML<\/a>.<\/p>\n\n\n\n
$mail_tag<\/code> tiene un objeto WPCF7_MailTag<\/code> que representa la etiqueta de correo electr\u00f3nico en s\u00ed.<\/p>\n\n\n\n
Apuntando a un campo espec\u00edfico<\/h4>\n\n\n\n
En el c\u00f3digo de ejemplo anterior, la funci\u00f3n number_format<\/code> se aplica a todos los campos en los que la entrada sea un valor num\u00e9rico. Si quieres apuntar a un campo espec\u00edfico, puedes hacerlo usando el cuarto argumento $mail_tag<\/code>, como en este ejemplo:<\/p>\n\n\n
\nadd_filter( 'wpcf7_mail_tag_replaced',\n\n  function( $replaced, $submitted, $html, $mail_tag ) {\n    if ( 'your-number' == $mail_tag->field_name() ) {\n      if ( is_numeric( $submitted ) ) {\n        $replaced = number_format( $submitted );\n      }\n    }\n\n    return $replaced;\n  },\n\n  10, 4\n);\n<\/pre><\/div>\n\n\n
Haci\u00e9ndolo de esta manera, la funci\u00f3n number_format<\/code> se aplica solo cuando el nombre del campo de la etiqueta de correo es \u00abyour-number\u00bb.<\/p>\n\n\n\n
Apuntando a un tipo espec\u00edfico de etiqueta de formulario<\/h4>\n\n\n\n
Hay variantes del gancho de filtro wpcf7_mail_tag_replaced<\/code> que se aplican solo a las etiquetas de correo correspondientes a un tipo de etiqueta de formulario<\/a> espec\u00edfico. Estos ganchos de filtro tienen el tipo de etiqueta de formulario como sufijo.<\/p>\n\n\n\n
Por ejemplo, usa el gancho wpcf7_mail_tag_replaced_number<\/strong><\/code> cuando quieras apuntar a las etiquetas de formulario de tipo number<\/a><\/code> (n\u00famero):<\/p>\n\n\n
\nadd_filter( 'wpcf7_mail_tag_replaced_number',\n\n  function( $replaced, $submitted, $html, $mail_tag ) {\n    if ( is_numeric( $submitted ) ) {\n      $replaced = number_format( $submitted );\n    }\n\n    return $replaced;\n  },\n\n  10, 4\n);\n<\/pre><\/div>","protected":false},"excerpt":{"rendered":"
Una etiqueta de correo electr\u00f3nico tiene una etiqueta de formulario correspondiente; cuando se compone un correo electr\u00f3nico, una etiqueta de correo, en la plantilla de correo electr\u00f3nico, se sustituye con el valor de entrada del usuario que viene a trav\u00e9s del campo de entrada representado por la etiqueta de formulario correspondiente.<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_locale":"es_ES","_original_post":"33728","footnotes":"","jetpack_post_was_ever_published":false},"categories":[19],"tags":[],"class_list":["post-34927","post","type-post","status-publish","format-standard","hentry","category-cookbook","es-ES"],"jetpack_featured_media_url":"","jetpack_likes_enabled":true,"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/contactform7.com\/wp-json\/wp\/v2\/posts\/34927","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/contactform7.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/contactform7.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/contactform7.com\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/contactform7.com\/wp-json\/wp\/v2\/comments?post=34927"}],"version-history":[{"count":0,"href":"https:\/\/contactform7.com\/wp-json\/wp\/v2\/posts\/34927\/revisions"}],"wp:attachment":[{"href":"https:\/\/contactform7.com\/wp-json\/wp\/v2\/media?parent=34927"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/contactform7.com\/wp-json\/wp\/v2\/categories?post=34927"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/contactform7.com\/wp-json\/wp\/v2\/tags?post=34927"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}