Faragiri

Aprender WooCommerce WordPress

Dónde vive de verdad el dato antes y después del cambio de almacenamiento de pedidos, los cuatro hooks del carrito, y por qué la pasarela por defecto no sirve aquí.

4Secciones
4Minutos
5Profundidad

WooCommerce es un plugin que convierte WordPress en una tienda, lo que quiere decir que cada producto es una entrada, cada pedido es una entrada, y cada atributo es una taxonomía o una fila de metadatos. Entender esa sola frase explica por qué se integra con todo lo que WordPress ya hace y por qué se vuelve lento en un tamaño que una tienda pensada desde cero ni notaría.

La consecuencia es concreta: los datos del producto viven repartidos entre wp_posts y wp_postmeta, y desde el cambio a almacenamiento de alto rendimiento los pedidos viven en sus propias tablas y no como entradas. Una tienda en una instalación más vieja puede seguir teniendo los pedidos como entradas, y una consulta escrita para una de las dos formas no encuentra nada en la otra, que es lo primero que hay que revisar cuando un reporte vuelve vacío.

Los hooks que importan están alrededor del carrito y el pago

  • woocommerce_add_to_cart_validation es el filtro que puede rechazar un producto, devolviendo falso con un aviso, y es donde va una regla de stock o de elegibilidad
  • woocommerce_checkout_create_order deja poner valores en el pedido antes de que se guarde, que es el momento correcto y no después
  • woocommerce_payment_complete es el que conviene usar para el cumplimiento del pedido, no la página de agradecimiento, porque un cliente que cierra la pestaña nunca la carga
  • Los precios se filtran, no se leen: un plugin que cambia woocommerce_product_get_price cambia lo que ven todos los demás plugins

Ese último punto es el origen de los errores más confusos de este ecosistema. Un precio mostrado y un precio cobrado pasan por filtros distintos en momentos distintos, así que dos plugins haciendo cada uno algo razonable producen un total que nadie quiso, y arreglarlo exige saber en qué hook está cada uno.

Hooks del flujo de compra

Donde intervenir entre el precio mostrado y el pago completado

Cada momento de la compra corre en un hook distinto; elegir el incorrecto altera totales o deja pedidos sin cumplir.

  1. 01Filtrar precio con woocommerce_product_get_priceLos precios se filtran y no se leen; filtros distintos entre mostrado y cobrado rompen el total
  2. 02Validar con woocommerce_add_to_cart_validationPuede rechazar el producto devolviendo falso con aviso segun stock o elegibilidad
  3. 03Guardar datos en woocommerce_checkout_create_orderMomento correcto para fijar valores en el pedido antes de persistirlo
  4. 04Cumplir el pedido en woocommerce_payment_completeSe dispara aunque el cliente cierre la pestana antes de ver la pagina de agradecimiento

Depurar diferencias de cobro exige ubicar en que hook exacto esta modificando el precio cada plugin.

Dónde se va el rendimiento

El carrito y el pago no se pueden cachear, porque son por cliente, así que cada visita es una petición completa de PHP con sus propias consultas. Una tienda rápida en el catálogo y lenta en el pago es lo normal y no un error; una tienda lenta ya en el catálogo tiene un problema de caché, porque el catálogo sí se puede cachear.

Carga y consultas

Lo que se espera lento frente al cruce oculto de metadatos

El carrito y el pago siempre ejecutan PHP sin cache, pero los filtros por atributos degradan la base de datos por debajo.

  • Catalogo rapido con cache completaSi el catalogo ya es lento, el problema esta en la cache de pagina
  • Carrito y pago siempre en PHPSon por cliente y no se cachean; sus consultas en cada visita son normales
Comportamiento visible en tienda frente a costo en tablas
  • Cruces por cada filtro de atributoNavegar por atributos cruza filas de metadatos y se degrada con miles de productos
  • Indice dedicado para filtrosEs la solucion real en vez de seguir ajustando parametros genericos de base de datos

Distinguir entre falta de cache en catalogo y cruces de atributos ahorra semanas ajustando en la direccion equivocada.

El filtrado por atributos es el otro. La navegación por filtros sobre filas de metadatos es un cruce de tablas por cada atributo, y se degrada fuerte a partir de unos pocos miles de productos con varios atributos. La respuesta es un índice hecho para eso y no más ajuste de base de datos, y saberlo desde el principio ahorra un mes de trabajo en la dirección equivocada.

Qué activar antes de que el catálogo crezca

El almacenamiento de alto rendimiento de pedidos es el ajuste que conviene tener activado, gratis con WooCommerce, y mueve los pedidos a tablas propias con índices en vez de la tabla de entradas. Cualquier extensión que no se haya actualizado para eso es un riesgo de compatibilidad que vale la pena revisar antes de activarlo.

Antes de escalar

Tres piezas que activar antes de que el catalogo crezca

Preparar tablas de pedidos, medicion con volumen real y pasarela local evita bloqueos cuando suben las ventas.

Base lista para crecer
  • Almacenamiento de alto rendimientoGratis en WooCommerce; mueve pedidos a tablas propias indexadas tras revisar extensiones
  • Query Monitor con datos realesEl volumen cambia planes de consulta; veinte pedidos de prueba no muestran el limite
  • Pasarela local y cuenta comercialSumar extension gratuita como Mercado Pago y dar de alta la cuenta antes de cobrar
  • Almacenamiento de alto rendimientoGratis en WooCommerce; mueve pedidos a tablas propias indexadas tras revisar extensiones
  • Query Monitor con datos realesEl volumen cambia planes de consulta; veinte pedidos de prueba no muestran el limite
  • Pasarela local y cuenta comercialSumar extension gratuita como Mercado Pago y dar de alta la cuenta antes de cobrar

PayPal y Stripe vienen incluidos, pero las tiendas de la region necesitan medios locales aprobados con anticipacion.

Query Monitor contra una copia real de los datos es la segunda, gratis y de código abierto. La cantidad de pedidos cambia el plan de las consultas, así que un pago rápido con veinte pedidos de prueba no dice nada sobre uno con cincuenta mil. Reemplaza optimizar contra datos de ejemplo, que es la forma más común de arreglar nada.

La cuenta que WooCommerce no menciona por sí solo es la pasarela: la instalación trae PayPal y Stripe listos para configurar, y casi ninguna tienda de la región los usa como principal, porque el cliente paga con tarjeta local o con transferencia y espera ver Mercado Pago en el botón. Eso significa una extensión más, gratuita pero con su propia cuenta de comercio que hay que dar de alta aparte, antes de que el primer pago pueda entrar.

La plantilla copiada que la actualización deja atrás

Itzel vende artesanías de Oaxaca por su tienda y encargó un cambio en la pantalla de pago para mostrar el tiempo de envío según el estado del comprador. El diseñador editó directamente la plantilla del tema, funcionó ese mismo día, y tres meses después una actualización de WooCommerce cambió esa misma plantilla; la copia del tema se quedó atrás y dejó de mostrar el campo que el código nuevo ya esperaba.

Mantenimiento de vistas

Como una plantilla copiada en el tema queda atras al actualizar

Editar plantillas directamente funciona el primer dia y se quiebra meses despues cuando WooCommerce cambia el archivo original.

  1. Dia unoPlantilla copiada y editada en el temaAgrega el tiempo de envio por estado en el pago y sale funcionando de inmediato
  2. Tres mesesActualizacion de WooCommerceEl plugin modifica la plantilla base y el codigo nuevo espera un campo distinto
  3. DespuesLa copia del tema bloquea el cambioAl sobrescribir la vista nueva, desaparece el campo esperado por la tienda
  4. Regla fijaPreferir hooks y anotar la versionUsar hooks primero; si copiar es inevitable, registrar la version origen para revisarla

El caso de Oaxaca muestra por que cada plantilla copiada se vuelve deuda tecnica en la siguiente actualizacion.

Recurrir a un hook antes que a una plantilla propia, siempre, y cuando una copia sea de verdad necesaria, anotar la versión de la que se copió y revisarla en cada actualización. El sistema de hooks sobre el que está construido es Plugins, las plantillas que sobrescribe son Temas, y lo que corre por debajo de toda la tienda es WordPress.

Al lado de esto

Arriba de esto