Plugin oficial de Webpay para WooCommerce
Este plugin oficial de Transbank te permite integrar Webpay fácilmente en tu sitio WooCommerce. Está desarrollado en base al SDK oficial de PHP
Puedes ver las instrucciones de instalación y su documentación completa en la página de Transbank Developers
Al instalar el plugin, este vendrá configurado para funcionar en modo integración (en el ambiente de pruebas de Transbank). Para poder operar con dinero real (ambiente de producción), debes completar el proceso de validación simplificado para plugins. Revisa el paso a paso acá.
A continuación, encontrarás información necesaria para el desarrollo de este plugin.
El plugin depende de las siguientes librerías:
Para cumplir estas dependencias, debes instalar Composer, e instalarlas con el comando composer install
.
Para apoyar el levantamiento rápido de un ambiente de desarrollo, hemos creado la especificación de contenedores a través de Docker Compose.
Para probar el plugin, ponemos a disposición los siguientes contenedores:
Si necesitas subir el plugin a Woocommerce y obtienes un error por que no se puede mover el archivo a wp-contentent
entonces ejecuta
docker-compose run webserver chmod -Rv 767 wp-content/
Para actualizar la versión del SDK de Transbank se debe editar el archivo composer.json y cambiar
el valor de la propiedad "transbank/transbank-sdk"
por la versión que se desea instalar y luego ejecutar el bash update
que esta en la carpeta docker-woocommerce-php*
lo que actualizara la dependencia del plugin.
./package.sh
Para generar una nueva versión, se debe crear un PR (con un título "Prepare release X.Y.Z" con los valores que correspondan para X
, Y
y Z
). Se debe seguir el estándar semver para determinar si se incrementa el valor de X
(si hay cambios no retrocompatibles), Y
(para mejoras retrocompatibles) o Z
(si sólo hubo correcciones a bugs).
En ese PR deben incluirse los siguientes cambios:
plugin/readme.txt
para incluir una nueva entrada (al comienzo) para X.Y.Z
que explique en español los cambios. (bajo el título == Changelog ==)plugin/readme.txt
para incluir una nueva entrada en la sección == Upgrade Notice == con una explicación breve de porque se debe actualizar.Luego de obtener aprobación del pull request, debes mezclar a master e inmediatamente generar un release en GitHub con el tag vX.Y.Z
. En la descripción del release debes poner lo mismo que agregaste al changelog.
Con eso Travis CI generará automáticamente una nueva versión del plugin y actualizará el Release de Github con el zip del plugin, además de crear el release en el SVN de Wordpress.org.
WIP
= En progreso
feat
= Nuevos features
fix
= Corrección de un bug
docs
= Cambios solo de documentación
style
= Cambios que no afectan el significado del código (espaciado, formateo de código, comillas faltantes, etc)
refactor
= Un cambio en el código que no arregla un bug ni agrega una funcionalidad
perf
= Cambio que mejora el rendimiento
test
= Agregar test faltantes o los corrige
chore
= Cambios en el build o herramientas auxiliares y librerías
1️⃣ - Si no se añaden test en el pull request, se debe añadir un video o gif mostrando el cambio realizado y demostrando que la rama no rompe nada.
2️⃣ - El pr debe tener 2 o mas aprobaciones para hacer el merge
3️⃣ - si un commit revierte un commit anterior deberá comenzar con "revert:" seguido con texto del commit anterior
Igual que en el asunto, usar imperativo y en tiempo presente. Debe incluir una mayor explicación de lo que se hizo en el pull request. Si no se añaden test en el pull request, se debe añadir un video o gif mostrando el cambio realizado y demostrando que la rama no rompe nada.