Variables personalizadas en WC – APG SMS Notifications

WC - APG SMS Notifications. versión 2.13.1.1

Probablemente la consulta más recurrente que tenemos acerca del uso del plugin para WooCommerce de APG WC – APG SMS Notifications sea sobre cómo se usan las variables personalizadas. Por ello hoy nos hemos decidido por hacer este pequeño tutorial para explicar el uso de las variables personalizadas en el plugin y ver si así sus usuarios y los muchos que nos repiten una y otra vez la misma pregunta entienden mejor su uso en WC – APG SMS Notifications.

Cuando hablamos de variables personalizadas hablamos de la capacidad que tiene el plugin para añadir en los mensajes SMS cualquier tipo de información contenida en el pedido y que no es accesible de forma nativa por el código PHP que posee el plugin.

Recordemos que las variables soportadas de forma nativa por el plugin son: %id%, %order_key%, %billing_first_name%, %billing_last_name%, %billing_company%, %billing_address_1%, %billing_address_2%, %billing_city%, %billing_postcode%, %billing_country%, %billing_state%, %billing_email%, %billing_phone%, %shipping_first_name%, %shipping_last_name%, %shipping_company%, %shipping_address_1%, %shipping_address_2%, %shipping_city%, %shipping_postcode%, %shipping_country%, %shipping_state%, %shipping_method%, %shipping_method_title%, %payment_method%, %payment_method_title%, %order_discount%, %cart_discount%, %order_tax%, %order_shipping%, %order_shipping_tax%, %order_total%, %status%, %prices_include_tax%, %tax_display_cart%, %display_totals_ex_tax%, %display_cart_ex_tax%, %order_date%, %modified_date%, %customer_message%, %customer_note%, %post_status%, %shop_name%, %order_product% y %note%.

Cabe recordar que las variables personalizadas se añaden en el campo de texto Variables personalizadas de WC – APG SMS Notifications sin incluir los símbolos % antes y después de la misma.

Tipos de variables personalizadas

Para empezar, y para ser lo más precisos posible, debemos dejar claro que existen dos tipos de variables personalizadas que podemos usar en WC – APG SMS Notifications.

Por un lado existen variables que no son nativas de WooCommerce y que no están contenidas en el listado de variables soportadas de forma nativa por el plugin pero que son fácilmente accesibles conociendo su nombre interno.

Un ejemplo muy concreto de este tipo de variable que es accesible directamente por el plugin sería el típico campo personalizado en el formulario de facturación y/o envío, que puede haber sido creado por nosotros mismos o por algún plugin gratuito o premium para WooCommerce que tengamos instalado en nuestra tienda virtual. Por ejemplo nuestro plugin para WooCommerce WC – APG NIF/CIF/NIE Field añade un campo NIF en el formulario de facturación que es fácilmente accesible añadiendo _billing_nif en el campo Variables personalizadas. También se puede obtener el valor del campo _shipping_nif del formulario de envío añadiéndolo en el mismo campo.

Por otro lado tenemos la capacidad de crear una variable personalizada que no sea accesible directamente desde los datos contenidos en el pedido o que requieran de programación adicional.

Este tipo de variables personalizadas no se tienen que añadir previamente en el campo Variables personalizadas.

Nociones preliminares

Lo primero que tenemos que tener en cuenta antes de afrontar este tutorial es que necesitamos tener sólidos conocimientos de PHP y de las funciones nativas de WooCommerce.

Si careces de cualquiera de las dos cosas es mejor que no pierdas el tiempo y que te pongas en contacto con APG para solicitar un presupuesto acorde a tus necesidades concretas.

Si sigues leyendo esta entrada es por que posees ambas capacidades, enhorabuena.

Veamos cómo podemos crear variables personalizadas en WC – APG SMS Notifications.

Nuestra propia variable personalizada

La mejor forma de ilustrar este tutorial es con un ejemplo práctico donde vamos a crear una variable personalizada llamada order_product_completo. En nuestro ejemplo concreto sólo vamos a añadir una variable personalizada, pero puedes añadir tantas variables personalizadas como necesites.

Esta variable de ejemplo nos va a permitir leer todos los atributos de un producto variable. También es muy útil si usas el plugin premium Product Add-Ons ya que leerá el contenido de todos los campos del formulario que hayas añadido al producto.

Para poder añadir una o varias variables personalizadas al plugin de APG sólo tienes que crear una pequeña función PHP en el fichero functions.php de tu tema hijo o crear un pequeño plugin para poder hacer uso de ella. Es importante reseñar que la función PHP tiene que hacer uso del filtro personalizado de WC – APG SMS Notifications apg_sms_message. Un ejemplo totalmente funcional de uso de una variable personalizada es este:

Donde siempre que se encuentre la variable %order_product_completo% en un mensaje SMS será reemplazada por algo similar a esto:

cantidad x nombre de producto
nombre de atributo: atributo
cantidad x nombre de producto 2
nombre de atributo: atributo
nombre de atributo 2: atributo

Como ves teniendo el conocimiento necesario es muy sencillo poder personalizar los mensajes SMS que envías a tus clientes o ti mismo añadiéndoles cualquier tipo de información contenida en el pedido. Recuerda que si careces de los conocimientos necesarios para hacerlo lo mejor que puedes hacer es ponerte en contacto con APG para solicitar un presupuesto que resuelva tus necesidades.

Esperamos que os resulte útil este tutorial y quedamos a la espera de vuestros apuntes y comentarios, pero recuerda antes de publicar que APG no proporciona ningún tipo de soporte gratuito sobre sus plugins.

2018-06-12T15:18:33+00:0020 de diciembre de 2017|Categorías: Manuales|Etiquetas: , , , |Sin comentarios

Deja tu comentario

Información básica sobre Protección de Datos

  • Responsable: EMILIO JOSÉ CALVO CARRASCO.
  • Fin del tratamiento: Mantener una relación comercial y el envío de comunicaciones sobre nuestros productos y servicios.
  • Legitimación: El consentimiento del usuario.
  • Comunicación de los datos: No se comunicarán los datos a terceros, salvo por una obligación legal.
  • Derechos: Acceder, rectificar y suprimir los datos, así como otros derechos, como se explica en la información adicional.
  • Contacto: info@artprojectgroup.es.
  • Información adicional: Puede consultar la información adicional y detallada sobre Protección de Datos en Política de Privacidad.