Carbon Footprint + Offset Checkout — Guía completa
Instale y utilice la versión 2.0: asistente de configuración, importe de la contribución, proyectos y transferencias, factores de emisión y método, datos de productos, visualización, textos para clientes y verificador de redacción, finalizar compra por bloques, registro, página de transparencia, migración desde 1.x y herramientas para desarrolladores.
Presentación
DataFirefly – Contribución climática estima las emisiones de gases de efecto invernadero de sus productos WooCommerce y permite a los clientes añadir una contribución a proyectos climáticos al finalizar la compra. Cada contribución se anota en un registro que sigue el pedido, cada transferencia a un proyecto se conserva con su justificante y una página de transparencia muestra a los clientes lo que se recauda, a dónde va y cómo se calcula.
La versión 2.0 añade la página de finalizar compra por bloques, el registro, los proyectos y las transferencias, un asistente de configuración, un escritorio, factores de emisión editables con sus fuentes, un verificador de redacción en ocho idiomas y una pestaña “Contribuciones climáticas” en Mi cuenta.

En resumen: instale el plugin, siga el Asistente de configuración, verifique los factores de emisión que utiliza en Clima > Método y factores, publique la página de transparencia y, después, registre cada transferencia a su proyecto con su justificante.
Instalación y actualización
- En Plugins > Añadir nuevo plugin > Subir plugin, elija
df-carbon-offset-2.0.0.zipy, a continuación, active DataFirefly – Contribución climática. - Se abre el asistente de configuración. Puede volver a él en cualquier momento con el botón Asistente de configuración del menú Clima.
Requisitos: WordPress 6.4 o posterior, WooCommerce 8.2 o posterior, PHP de 7.4 a 8.5. El plugin es compatible con HPOS y con los bloques Carrito y Finalizar compra.
Actualización desde 1.x: suba el nuevo zip y elija Reemplazar la versión actual por la subida. Se conservan los ajustes, los factores, la asignación de categorías y las contribuciones; la clave de Climatiq se traslada a una opción protegida; se crea un proyecto a partir de su antiguo “proveedor” para que pueda completarlo. Las contribuciones cobradas a través de la página de finalizar compra por bloques con la versión 1.x pero nunca registradas se localizan y se añaden al registro.
Asistente de configuración
Cinco pasos breves:
- Contribución: cómo se calcula el importe (véase más abajo) y el mínimo.
- Proyecto: el proyecto que recibe las contribuciones: nombre, socio, tipo, estándar, país, enlace al registro público y descripción.
- Datos de productos: un factor de emisión para cada categoría de producto, preseleccionado a partir de los nombres de las categorías.
- Visualización: emisiones estimadas en las páginas de producto, umbral de calidad de los datos, estilo y pestaña de Mi cuenta.
- Transparencia: crea la página de transparencia como borrador y muestra lo que queda por hacer antes de activarlo.

La contribución al finalizar la compra
La opción aparece en el resumen del pedido de la página de finalizar compra por bloques, o encima de los métodos de pago de la página de finalizar compra clásica (y, opcionalmente, en la página del carrito). Nunca está preseleccionada y se solicita de nuevo en cada pedido. Cuando el cliente la marca, se añade al pedido una línea Contribución climática; al desmarcarla, la línea se elimina. “¿Cómo se calcula?” muestra la fórmula, el proyecto y un enlace a la página de transparencia.

Elija cómo se calcula el importe en Clima > Ajustes > Contribución:
- A partir de las emisiones estimadas: emisiones del pedido × precio por tonelada. Utilice el precio que realmente cobra su socio, para que el importe corresponda a lo que se financia.
- Importe fijo: el mismo importe para todos los pedidos.
- Redondeo al alza: el total del pedido redondeado al alza hasta el siguiente múltiplo de 1, 2, 5 o 10.
- Porcentaje: una parte del total de los productos.
El mínimo, el máximo y el redondeo (de 0,01 a 1) se aplican a los modos primero, segundo y cuarto. Por defecto, la contribución no está sujeta a impuestos; puede someterla a impuestos con la clase de impuesto que elija, y el importe mostrado al cliente incluye entonces los impuestos. El tratamiento fiscal depende de su país y de la forma en que transfiere el dinero: consulte a su asesor fiscal.

La vista previa de la derecha se actualiza mientras escribe, con un pedido de ejemplo.
Tras el pago, el cliente ve un mensaje de agradecimiento, la contribución en los correos electrónicos del pedido y la pestaña Contribuciones climáticas de Mi cuenta.

Proyectos y transferencias
En Clima > Proyectos y transferencias, describa cada proyecto que financia. Los clientes ven el proyecto al finalizar la compra y en la página de transparencia, así que limítese a hechos verificables: quién lo gestiona, con qué estándar (Gold Standard, Verra VCS, Label Bas-Carbone, Puro.earth…), dónde y el enlace a su entrada en un registro público. Un proyecto recibe las nuevas contribuciones; los demás pueden seguir activos para mostrarse o desactivarse.
Cada vez que pague a un proyecto, haga clic en Registrar una transferencia: fecha, importe y divisa, las toneladas certificadas indicadas en el certificado del socio (opcional), la referencia y un enlace al justificante. El panel muestra, por divisa, lo recaudado, lo transferido y lo que queda por transferir.

El plugin no compra créditos de carbono. Recauda las contribuciones con los pedidos. Transfiera los importes a su proyecto y registre cada transferencia: ese es el justificante que sus clientes pueden comprobar.
Estimaciones de emisiones y método
Para cada producto, la estimación es:
producción = peso (kg) × factor de la categoría (o factor por artículo, o valor del producto)
entrega = peso (t) × distancia (km) × factor de transporte (kg CO₂e / t·km)
estimación = producción + entrega
El factor se toma, por este orden, del valor introducido en la variación o en el producto (con su fuente), del factor elegido en el producto, del factor de la categoría del producto (las variaciones utilizan las categorías de su producto) o del factor genérico si usted lo permite. Un factor por litro requiere que se introduzca el volumen en el producto.

En la pestaña Factores de emisión, cada factor tiene un valor, una base (por kg, por artículo, por litro, por tonelada-kilómetro), una fuente, una referencia, un enlace y un año. Los valores predeterminados son órdenes de magnitud indicativos. Compare los factores que utiliza con una fuente publicada (por ejemplo, la ADEME Base Empreinte o los análisis de ciclo de vida de sus proveedores), rellene la referencia y marque He verificado este valor con la fuente indicada arriba. Con una clave de Climatiq (Ajustes > Datos y API), puede importar el valor de un factor a partir de su ID de actividad; aun así, debe verificarlo antes de utilizarlo.
La pestaña Productos por revisar enumera los productos sin estimación (sin peso, sin factor) o cuya estimación no es lo bastante fiable para mostrarse.
Entrega: en Ajustes > Entrega, defina la distancia media, el modo de transporte y, opcionalmente, una distancia por zona de envío.
Lo que ven los clientes en las páginas de producto
Las emisiones estimadas por artículo aparecen en un bloque sobrio (tarjeta, línea o solo texto), con “¿Cómo se estima esto?”, que muestra el factor, la fuente, la hipótesis de entrega y la calidad de los datos. Una comparación opcional con un trayecto en coche utiliza el factor de ADEME Impact CO2 (0,142 kg CO₂e por km por defecto).

La estimación solo se muestra cuando la calidad de sus datos alcanza el umbral definido en Ajustes > Visualización: por defecto, un factor verificado o un valor introducido para el producto. Puede ocultar el bloque en un producto (pestaña Clima del producto) o colocarlo usted mismo con el bloque Emisiones estimadas del producto o el shortcode [dfcarbon_badge].
Textos para clientes y verificador de redacción
En Ajustes > Textos para clientes, puede cambiar el título y el texto de la casilla de la opción, la nota de transparencia, el nombre de la línea del pedido, el mensaje de agradecimiento y el título del bloque del producto. Deje un campo vacío para conservar el texto predeterminado, traducido al idioma de cada cliente. Con Polylang o WPML, sus textos se registran para su traducción.
Cada texto, así como cada nombre y descripción de proyecto, se comprueba mientras escribe, en ocho idiomas:
- No permitido: alegaciones de que un producto tiene un impacto neutro, reducido o positivo gracias a la compensación de emisiones (“neutro en carbono”, “compensamos su huella”, “entrega con cero emisiones netas”…), prohibidas en la UE desde el 27 de septiembre de 2026.
- Por justificar: alegaciones genéricas (“ecológico”, “opción verde”…) que exigen un comportamiento medioambiental excelente reconocido.
- Etiqueta: redacciones que parecen una etiqueta de sostenibilidad de creación propia.

El verificador le ayuda a redactar con precisión; no constituye asesoramiento jurídico. Haga revisar sus textos por un abogado, especialmente en Francia, donde la transposición de la Directiva (UE) 2024/825 seguía en debate en noviembre de 2026.
Escritorio y registro
El escritorio muestra los importes recaudados (contribuciones confirmadas, netas de reembolsos) y pendientes de pago, lo que queda por transferir, el número y la media de las contribuciones, la tasa de participación en 30 días, las toneladas certificadas indicadas en sus justificantes de transferencia, un gráfico mensual con su tabla de datos, la cobertura de los datos de productos, la comprobación de redacción y una lista de comprobación de la configuración.
En Clima > Contribuciones, el registro enumera cada contribución con su pedido, importe, reembolsos, emisiones estimadas, calidad de los datos, proyecto y estado: Pendiente de pago, Confirmada, Cancelada, Reembolsado o Eliminada del pedido. Sigue el pedido automáticamente, incluidos los reembolsos parciales de la línea de contribución. Filtre por estado, proyecto, fechas o número de pedido y exporte a CSV.

Página de transparencia, bloques y shortcodes
El asistente crea una página con dos bloques: Informe de contribuciones climáticas (importes recaudados y transferidos, proyectos, transferencias con justificantes) y Método de cálculo de emisiones (fórmula, contribución, factores utilizados y sus fuentes). Revísela, publíquela y selecciónela en Ajustes > Visualización: la página de finalizar compra, el bloque del producto, el mensaje de agradecimiento y Mi cuenta enlazan a ella.

[dfcarbon_impact figures="yes" projects="yes" transfers="yes"]: informe de transparencia.[dfcarbon_methodology]: método de cálculo.[dfcarbon_badge id="123" style="card"]: emisiones estimadas de un producto (card,inlineominimal).[dfcarbon_projects],[dfcarbon_cart_summary]y[dfcarbon_stats](solo cifras, conservados de 1.x).

Desarrolladores
- API REST:
GET /wp-json/dfcarbon/v1/impact(cifras públicas, sin datos personales),GET /dfcarbon/v1/products/<id>/footprint(solo estimaciones que se pueden mostrar),GET /dfcarbon/v1/contributionsyPOST /dfcarbon/v1/check-text(gestores de la tienda). - WP-CLI:
wp dfcarbon status,wp dfcarbon product <id>,wp dfcarbon sync <order>,wp dfcarbon reconcile,wp dfcarbon check-text "<text>". - Filtros:
dfcarbon_product_footprint,dfcarbon_contribution_amount,dfcarbon_convert_amount(multidivisa),dfcarbon_capability,dfcarbon_template. - Plantillas: copie un archivo de
templates/enyourtheme/df-carbon-offset/. - Se incluyen una prueba de Salud del sitio, un exportador de datos personales y un texto sugerido para la política de privacidad.
Desinstalación
Al borrar el plugin se conservan todos los datos, salvo que marque Borrar todos los datos cuando se borre el plugin en Ajustes > Datos y API. En ese caso, el registro, las transferencias, los factores, los proyectos, los ajustes y los metadatos del plugin se eliminan en todos los sitios de la red. Exporte antes el registro: justifica los importes recaudados. Las líneas de contribución permanecen siempre en los pedidos.
Preguntas frecuentes
¿Puedo decir que mis pedidos son neutros en carbono?
No. En la UE, desde el 27 de septiembre de 2026 están prohibidas las alegaciones basadas en la compensación de emisiones según las cuales un producto tiene un impacto neutro, reducido o positivo. Presente en su lugar su apoyo a los proyectos, con hechos verificables.
¿Por qué no se muestran las estimaciones en mis páginas de producto?
La calidad de sus datos está por debajo del umbral definido en Ajustes > Visualización. Verifique con una fuente los factores que utiliza y márquelos como verificados, o introduzca un valor para el producto. Método y factores > Productos por revisar enumera los productos afectados.
La opción no aparece al finalizar la compra.
Compruebe que la contribución está activada y se ofrece en la página de finalizar compra (Ajustes > Contribución). En el modo “A partir de las emisiones estimadas”, el carrito debe contener al menos un producto físico con estimación; los productos virtuales no tienen ninguna.
¿Funciona con plugins multidivisa?
El importe se calcula en la moneda de la tienda y se convierte con el multidivisa de WPML o con el filtro dfcarbon_convert_amount. El registro y los informes mantienen cada divisa por separado.