Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/dru-id/wp-druid-woocommerce/archive/refs/heads/main.zipAdd-on para integrar wp-druid con WooCommerce. El plugin exige autenticacion mediante DruID durante el checkout y guarda el identificador DruID del comprador en el pedido.
Requisitos
- WordPress 6.8 o superior.
- PHP 7.4 o superior.
- WooCommerce 10.6.0 o superior.
wp-druid1.0.0 o superior instalado, activo y configurado.
Instalacion
- Empaquete o descargue el add-on como ZIP.
- En WordPress vaya a
Plugins -> Añadir nuevo -> Subir plugin. - Instale y active
WP DruID WooCommerce. - Verifique que WooCommerce y
wp-druidestan activos y configurados.
Si falta alguna dependencia, el add-on no ejecuta la integracion de checkout y muestra un aviso en el admin de WordPress a usuarios con permisos para gestionar plugins.
Comportamiento
El add-on aplica la regla de autenticacion DruID en el checkout de WooCommerce:
- Si el comprador no ha iniciado sesion con un usuario WordPress vinculado a DruID, se le redirige al login de DruID.
- Tras completar el login, el comprador vuelve al checkout.
- Antes de crear el pedido, el checkout se valida de nuevo en servidor.
- Cuando el pedido se crea correctamente, el identificador DruID del comprador se guarda en el pedido como metadato
_druid_id.
El identificador se guarda como snapshot del comprador en el momento de la compra.
Compatibilidad de checkout
El add-on esta preparado para los principales flujos de checkout de WooCommerce:
- Checkout clasico de WooCommerce.
- Checkout Block de WooCommerce.
- Checkouts construidos con Elementor, Essential Addons u otros widgets, siempre que usen el flujo estandar de checkout de WooCommerce.
Tambien declara compatibilidad con HPOS (High-Performance Order Storage) y usa la API de pedidos de WooCommerce para guardar metadatos.
Consideraciones
- La pagina de confirmacion de pedido (
order-received) no fuerza una nueva autenticacion. - El pago de pedidos pendientes (
order-pay) si requiere autenticacion DruID. - Si un constructor de checkout o funnel externo crea pedidos saltandose por completo el flujo estandar de WooCommerce, puede requerir integracion adicional.
- El add-on no crea tablas propias ni pantallas de configuracion propias.
Hooks publicos
El add-on expone acciones publicas para integraciones ligeras:
WPDRWC_ACTION_LOADED/wp_druid_woocommerce_loadedWPDRWC_ACTION_REQUIREMENTS_MET/wp_druid_woocommerce_requirements_metWPDRWC_ACTION_REQUIREMENTS_NOT_MET/wp_druid_woocommerce_requirements_not_metWPDRWC_ACTION_WOOCOMMERCE_LOADED/wp_druid_woocommerce_woocommerce_loadedWPDRWC_ACTION_WOOCOMMERCE_INIT/wp_druid_woocommerce_woocommerce_init
Ejemplo:
add_action('wp_druid_woocommerce_woocommerce_loaded', function ($status) {
if (!is_array($status)) {
return;
}
// Integracion personalizada cuando WooCommerce y wp-druid estan disponibles.
}, 10, 1);
Logging
El add-on registra errores recuperables solo cuando el logging esta habilitado. Por defecto, se habilita en entornos con WP_DEBUG.
Puede activarse o desactivarse mediante el filtro:
add_filter('wp_druid_woocommerce_enable_logging', '__return_true');
Verificacion recomendada
- Acceda al checkout sin iniciar sesion y compruebe que se redirige a DruID.
- Complete el login y confirme que vuelve al checkout.
- Finalice un pedido y compruebe que el pedido contiene el metadato
_druid_id. - Repita la prueba si la tienda usa Checkout Block o un checkout construido con Elementor o Essential Addons.
Desinstalacion
El add-on no elimina datos de pedidos al desinstalarse. Los metadatos ya guardados en pedidos permanecen como parte del historico de la tienda.