/README.md
Markdown | 201 lines | 145 code | 56 blank | 0 comment | 0 complexity | 804f905a5558c516fce0d6aeba08ffe4 MD5 | raw file
- # Bienvenido
-
- **Este plugin dejará de funcionar el 31 de Diciembre del 2017**. Leer más : https://www.cristiantala.cl/el-fin-una-era-adios-kcc-de-transbank/
-
- Bienvenidos al wiki de este plugin. Espero que me ayuden a hacer que este plugin sea el mejor que se pueda encontrar como gateway de pago para WooCommerce con Webpay.
-
- Esta versión es totalmente nueva. Se modificó todo el core de Woocommerce, por lo que se tuvo que modificar todo el plugin partiendo desde 0... ( Uff ! ).
-
- Aún se están haciendo cambios debido a que los chicos de soporte de webpay no se ponen de acuerdo entre ellos y han hecho cambios en la certificación que no aparecen en el manual.
-
- Siempre puedes encontrar la última versión estable por el buscador de plugins de wordpress.
- * http://wordpress.org/plugins/webpay-woocommerce-plugin/
-
- ##Problemas Conocidos.
- * Ninguno por el momento ( desde versión v3.5.7 )
-
- ##Estado del Arte
-
- * Este plugin funciona con las últimas versiones de woocommerce. (Version 2.1.*)
- * Este plugin ya no funciona con las versiones anteriores de Woocommerce.
-
- ## Descarga
-
- Si quieres editarlo recomiendo descargarlo con git:
-
- ```
- $ git clone https://ctala@bitbucket.org/ctala/woocommerce-webpay.git
- ```
-
-
- Siempre se puede obtener y descargar la última versión de esta página o del siguiente link:
-
- ```
- https://bitbucket.org/ctala/woocommerce-webpay/get/master.zip
- ```
-
- Todos los cambios y mejoras se hacen en la rama "devel" hasta ser estables.
-
- ## DEBUG MODE
- Si tienes habilitado en tu instalación de Wordpress el modo debug, el plugin creará mensaje dependiendo de donde se encuentre en el código de manera bien detallada.
- Si habilitas el login en wordpress puedes ver todo lo que está ocurriendo dentro del archivo *debug.log* dentro de la carpeta *wp-content*.
-
- Para habilitarlo debes agregar las siguientes variables en el archivo *wp-config.php*
-
- ```
- define('WP_DEBUG', true);
- define('WP_DEBUG_LOG', true);
- ```
-
- ###Ejemplo del debug.log
-
- ```
- #!bash
-
- ubuntu@ip-10-147-227-221:/var/www/wp-content$ tail -f debug.log -n 1000 | grep WEBPAY
- [25-Jun-2013 16:24:20 UTC] [WEBPAY - FORM] -> Entrando a la verificación de carpetas
- [25-Jun-2013 16:24:20 UTC] [WEBPAY - FORM] -> Se utilizará /var/www/wp-content/plugins/woocommerce-webpay-2.0/comun/dato20130625042420.log para guardar los datos
- [25-Jun-2013 16:24:20 UTC] [WEBPAY - FORM] -> Preparando para escribir 1000;35 en /var/www/wp-content/plugins/woocommerce-webpay-2.0/comun/dato20130625042420.log
- [25-Jun-2013 16:24:20 UTC] [WEBPAY - FORM] -> ARCHIVO CERRADO
- [25-Jun-2013 16:28:26 UTC] [WEBPAY - FORM] -> Entrando a la verificación de carpetas
- [25-Jun-2013 16:28:26 UTC] [WEBPAY - FORM] -> Se utilizará /var/www/wp-content/plugins/woocommerce-webpay-2.0/comun/dato20130625042826.log para guardar los datos
- [25-Jun-2013 16:28:26 UTC] [WEBPAY - FORM] -> Preparando para escribir 1000;36 en /var/www/wp-content/plugins/woocommerce-webpay-2.0/comun/dato20130625042826.log
- [25-Jun-2013 16:28:26 UTC] [WEBPAY - FORM] -> ARCHIVO CERRADO
- [25-Jun-2013 16:35:25 UTC] [WEBPAY - PROCESS - PAYMENT] -> Iniciando el proceso de pago para 37
- [25-Jun-2013 16:35:25 UTC] [WEBPAY - FORM] -> Entrando a la verificación de carpetas
- [25-Jun-2013 16:35:25 UTC] [WEBPAY - FORM] -> Se utilizará /var/www/wp-content/plugins/woocommerce-webpay-2.0/comun/dato20130625043525.log para guardar los datos
- [25-Jun-2013 16:35:25 UTC] [WEBPAY - FORM] -> Preparando para escribir 1000;37 en /var/www/wp-content/plugins/woocommerce-webpay-2.0/comun/dato20130625043525.log
-
- ```
-
- Puedes además revisar el código de manera directa en esta página.
-
-
- # Instalación. #
-
- Una ves descargado el plugin hay dos cosas que tienes que tener en consideración.
-
-
- 1. El plugin creará una carpeta dentro del directorio de uploads llamada webpay-data que contendrá la carpeta **comun**. Si esta carpeta no se ha creado por favor crearla con permisos de lectura y escritura.
-
- 2. Es my importante que se entiendan los conceptos de escritura y lectura de archivos. El script de transbank es ejecutado por el usuario de apache. Si este usuario no tiene permiso de acceso (Lectura y escritura ) a los archivos creados en la carpeta común, estos tendrán un problema de validación en las últimas etapas.
-
- 3. Debes de tener configurado los archivos CGI de WebPay. El plugin te preguntará por esta información dentro de la configuración. ( Woocommerce -> Settings -> Paymente Gateways -> Webpay Gateway).
-
- 4. La página usada por HTML_TR_NORMAL = http://DIRECCIONDETUPAGINA/?wc-api=WC_Gateway_Webpayplus&xt_compra
-
- 5. Es necesario crear una página en blanco con el shortcode [webpay_thankyou] al cual será redireccionada la transacción.
-
- 6. Es necesario modificar la configuración bajo WooCommerce -> Ajustes -> Finalizar Compra -> WebPayPlus.
-
- 7. Para que el plugin funcione los valores de la dirección del cgi, check path y return page deben de ser correctas. Los otros valores son estéticos y pedidos por parte de Transbank.
-
- 8. Es posible que debas agregar el guion " - " a la WhiteList de transbank para que no tire error de conexión.
-
- # Ejemplo **tbk_config.dat**. #
-
- ## Certificación ##
-
- OJO,PESTAÑA y CEJA. La configuración siguiente es para un ambiente de certificación.
-
- ```
- #!bash
-
- IDCOMERCIO = TUIDCOMERCIO
- MEDCOM = 2
- TBK_KEY_ID = 101
- PARAMVERIFCOM = 1
- URLCGICOM = http://DIRECCIONDETUPAGINA/cgi-bin/tbk_bp_resultado.cgi
- SERVERCOM = TUIP
- PORTCOM = 80
- WHITELISTCOM = ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz 0123456789./:=&?_-
- HOST = TUIP
- WPORT = 80
- URLCGITRA = /filtroUnificado/bp_revision.cgi
- URLCGIMEDTRA = /filtroUnificado/bp_validacion.cgi
- SERVERTRA = https://certificacion.webpay.cl
- PORTTRA = 6443
- PREFIJO_CONF_TR = HTML_
- HTML_TR_NORMAL = http://DIRECCIONDETUPAGINA/?wc-api=WC_Gateway_Webpayplus&xt_compra
-
- ```
-
- ## Producción ##
-
-
- ```
- #!bash
-
- IDCOMERCIO = TUIDCOMERCIO
- MEDCOM = 1
- TBK_KEY_ID = 101
- PARAMVERIFCOM = 1
- URLCGICOM = http://TUWEB/cgi-bin/tbk_bp_resultado.cgi
- SERVERCOM = TUIP
- PORTCOM = 80
- WHITELISTCOM = ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz 0123456789./:=&?_-
- HOST = TUIP
- WPORT = 80
- URLCGITRA = /cgi-bin/bp_revision.cgi
- URLCGIMEDTRA = /cgi-bin/bp_validacion.cgi
- SERVERTRA = https://webpay.transbank.cl
- PORTTRA = 443
- PREFIJO_CONF_TR = HTML_
- HTML_TR_NORMAL = http://TUWEB/?wc-api=WC_Gateway_Webpayplus&xt_compra
-
- ```
-
-
- #CHANGELOG
- * V3.5.9.1 : Se arregla problema con las fechas por nueva solicitud de transbank.
- * V3.5.7.1 : Se arregla bug con el logo.
- * V3.5.7.0 : Se agregan más validaciones al monto de la transacción.
- * V3.5.4.1 : Se cambia la palabra Fracasada por Rechazada en la página de fracaso.
- * V3.5.4.0 : Se cambia el formato de versiones. Se arregla pantalla blanca al actualizar woocommerce.
- * V3.0.5 : Se arregla problema con los permalinks.
- * V3.0.4 : Se agrega la palabra débito al mensaje de error. Se agrega el nombre del cliente a la tabla de información extra de la transacción.
- * V3.0.3 : Se elimina mensaje de contacto al banco en caso de error, Se elimina la información extra en caso de failure.
- * V3.0.2 : Se agregan las políticas de devoluciones, Se elimina frase repetida en fracaso
- * V3.0.1 : Se agrega al mail de administrador y cliente el método de pago cuando es WebPayPlus.
- * V3.0.0 : Remake del plugin para compatibilidad con WooCommerce 2.1.*
- * V2.4.1 : Arreglada la redirección con algunas versiones de php, en especial para hostgator.
- * V2.4 : Versión Certificada. Ahora no se deberían requerir modificaciones para pasar las certificaciones de transbank.
- * V2.3 : Se agregan los templates para los pagos con webpay.
- * V2.2 : Se establece el short-code [webpay-thankyou] para realizar las validaciones necesarias por parte de transbank. Es necesario cambiar en la página de recepción del pedido por [woocommerce-thankyou].
- * V2.1.9 : Se usa el estandar definido por woocommerce para los códigos de estado.
- * V2.1.8 : Arreglada posible duplicidad cuando la orden pasa a on-hold.
- * V2.1.7 :
- * V2.1.6 : Modificado para que funcionara con versiones más antiguas de php.
- * V2.1.5 : Se cambian los permisos por defecto de la carpeta común. Con esto se deben asegurar que el usuario que ejecuta los CGI sea el mismo que crea los archivos.
- * V2.1.2 : Se externaliza la carpeta común al directorio de uploads. De esta manera no se borra la información al actualizar el plugin.
- * V2.1 : Se agregan las variables de la tienda en la configuración del plugin.
-
- Y eso debería ser todo por ahora.
-
-
- Have fun!
-
- # CopyRight #
-
- Copyright 2011-2014 Cristian Tala Sánchez
- Si estás leyendo esta parte existe la posibilidad de que quieras modificar
- incluso vender este codigo. Solo quiero aclarar que estás en todo el derecho
- de hacerlo, sin embargo, no incluir el autor original del codigo es una
- infracción a la licencia GPLv3 y se pueden realizar acciones legales para
- quienes recurran en este acto.
- Por mi parte llevo años trabajando en este codigo no para hacerme millonario,
- si no, para ayudar a la comunidad y un poco de reconocimiento no le hace mal a
- nadie. En resumen no seas cagado y copies, pegues un codigo que no te pertenece
- sin dar las referencias necesarias.
-
- This program is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation, either version 3 of the License or any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program. If not, see <http://www.gnu.org/licenses/>.