Personalizar WooCommerce con hooks sin tocar el núcleo ni el tema padre

Prompt

Actúa como desarrollador sénior de WordPress y WooCommerce que sigue los estándares de codificación de WordPress.

Contexto:
- Personalización que necesito: {{personalizacion}}
- Dónde debe aparecer o actuar: {{zona}}
- Versiones de WordPress y WooCommerce: {{versiones}}
- Tema y constructor que uso: {{tema}}

Entregables:
1. Enfoque: qué hooks (actions o filters) de WooCommerce o WordPress usarás y por qué; si existe una opción nativa o un ajuste que lo resuelva sin código, dímelo primero.
2. Aviso de compatibilidad: si {{zona}} usa el carrito o el checkout por bloques, explica qué hooks clásicos no funcionan ahí y la alternativa (API de extensibilidad de bloques o Store API).
3. Código completo como plugin pequeño (cabecera de plugin, prefijo único en funciones, comprobación de ABSPATH y de que WooCommerce está activo), no en el functions.php del tema padre.
4. Seguridad: sanitizar entradas, escapar salidas (esc_html, esc_attr, wp_kses_post), nonces en formularios y comprobación de capacidades en el administrador.
5. Datos de pedido compatibles con HPOS: usar los métodos del objeto WC_Order (get_meta, update_meta_data, save) en lugar de acceder directamente a postmeta, y declarar la compatibilidad.
6. Textos traducibles con __() y el text domain del plugin.
7. Plan de pruebas en un entorno de staging: casos normales, productos variables, cupones, usuario invitado y desactivación del plugin.

Restricciones:
- No modifiques archivos del núcleo de WordPress ni de WooCommerce.
- Si no estás seguro de que un hook exista en mi versión, márcalo como [VERIFICAR en la documentación de WooCommerce].
- Haz una copia de seguridad antes de instalar código en producción.
- Si la personalización es ambigua, pregúntame antes de escribir el código.

Formato: secciones numeradas, el plugin en un bloque de código PHP y pasos de instalación.

Cómo usarlo

Ejemplo de uso

Resultado de ejemplo

<?php
/**
 * Plugin Name: Aviso de envío gratis
 * Description: Muestra en el carrito clásico cuánto falta para el envío gratis.
 * Version:     1.0.0
 * Requires Plugins: woocommerce
 * Text Domain: aviso-envio-gratis
 */

defined( 'ABSPATH' ) || exit;

const AEG_UMBRAL = 50.0; // [COMPLETAR] igual al importe mínimo del método «Envío gratuito»

add_action( 'before_woocommerce_init', function () {
	if ( class_exists( \Automattic\WooCommerce\Utilities\FeaturesUtil::class ) ) {
		\Automattic\WooCommerce\Utilities\FeaturesUtil::declare_compatibility( 'custom_order_tables', __FILE__, true );
	}
} );

add_action( 'woocommerce_before_cart', 'aeg_mostrar_aviso' );

function aeg_mostrar_aviso(): void {
	if ( ! function_exists( 'WC' ) || ! WC()->cart ) {
		return;
	}
	$falta = AEG_UMBRAL - (float) WC()->cart->get_displayed_subtotal();

	if ( $falta > 0 ) {
		wc_print_notice(
			sprintf(
				/* translators: %s: importe que falta para el envío gratis */
				esc_html__( 'Añade %s más y el envío te sale gratis.', 'aviso-envio-gratis' ),
				wp_kses_post( wc_price( $falta ) )
			),
			'notice'
		);
	}
}

Datos clave

Categoría

Programación y desarrollo · WordPress

Tipo de resultado

Código

Nivel

Intermedio

Pensado para

ChatGPT, Claude, Gemini y Microsoft Copilot

Verificado en

Pendiente de verificación editorial

Variables

Personalización, Zona, Versiones y Tema y constructor

Idioma

Español

Precio

Gratis, sin registro

Actualizado

07/11/2026

Preguntas frecuentes