La documentación necesaria para instalar y configurar WordPress se encuentra en la siguiente liga: Install WordPress. Todos los requisitos mínimos (PHP y MySQL) deben ser cumplidos para que el plugin desarrollado pueda funcionar correctamente.
La documentación necesaria para instalar WooCommerce se encuentra en la siguiente liga: Install WooCommerce. Allí también se encuentra información necesaria para hacer troubleshooting relacionado con la instalación.
El proyecto entero deberá estar comprimido en formato .zip para poder ser subido como un plugin de WordPress. Liga: GlobalPay WooCommerce Plugin.
Este proyecto es un plugin de WordPress que se comunica con el plugin de WooCommerce dentro de WordPress, de tal manera que una vez instalado y activado se entabla la comunicación por medio de hooks y actions de WooCommerce y WordPress.
Cuando ya tengamos el proyecto comprimido en formato .zip, procedemos a la instalación por medio del WordPress Admin.
- El primer paso será hacer login dentro del WordPress Admin como administrador.
- Estando en la pantalla principal del admin damos clic en la pestaña de Plugins.
- Dentro de la pantalla de Plugins damos clic en Add New.
- Dentro de la pantalla de Add Plugins damos clic en Upload Plugin.
- Se desplegará la opción para subir nuestro plugin en formato .zip. Lo subimos y damos clic en el botón Install Now.
- Seremos redireccionados a la pantalla de instalación del plugin.
- Esperamos a obtener el mensaje Plugin Installed Successfully y damos clic en el botón de Activate Plugin.
- Seremos redireccionados a la pantalla de Plugins dónde veremos nuestro plugin instalado y activado.
Por defecto, cuando se Activa y Desactiva el plugin, se crea y elimina la tabla correspondiente a la base de datos del proyecto. La tabla se creará en la base de datos que se configuró en la instalación de WordPress. El nómbre de la tabla se compone por el prefijo de tablas configurado en la instalación de WordPress (por defecto wp_) y el nombre globalpay_plugin. La base de datos almacena los registros con detalle de todas las transacciones que se hagan en el comercio. Los datos mas relevantes que se almacenan son:
- orderId el cual es el identificador único de las transacciones en el comercio.
- Transaction Code el cual es el identificador único de las transacciones en GlobalPay
El idioma del plugin es seleccionado dinámicamente de acuerdo al idioma que esté configurado en WordPress. Los idiomas que están disponibles son:
- Español CO
- Inglés (Por defecto)
Es importante aclarar que si el idioma de WordPress es alguno que no está en la lista, se seleccionará inglés por defecto. Ésto no afecta al idioma del checkout el cual es independiente de WordPress.
Después de haberse instalado nuestro plugin en WordPress debemos proceder a configurarlo en el Admin de WooCommerce. Éste se encuentra en la pestaña de WooCommerce del dashboard de WordPress. Luego damos clic en la opción de Settings y posteriormente en la pestaña de Payments.
Para activar nuestro gateway dentro de nuestro comercio WooCommerce, necesitamos estár dentro de la pestaña WooCommerce->Settings->Payments y veremos nuestro plugin instalado y detectado. Para habilitarlo deberemos activar el botón Enabled. Ésta habilitación del plugin es distinta a la de WordPress la cual hicimos anteriormente.
Al habilitar nuestro plugin en el admin de WooCommerce, tendremos algunas opciones para configurar. Para hacerlo damos click al botón Manage que aparecerá al costado de nuestro plugin. Las opciones para configurar son las siguientes:
- Staging Environment: Cuando está habilitada, el plugin apuntará al servidor de pruebas de GlobalPay.
- Title: Ésta opción configura el texto que verá el cliente en la ventana de checkout junto al logo de GlobalPay.
- Customer Message: Ésta opción configura el mensaje que verá el cliente en la ventana del checkout cuando seleccione GlobalPay como método de pago.
- Checkout Language: Ésta opción selecciona el idioma que se mostrará en la ventana del checkout. Las opciones disponibles son Español, Portugués e Inglés (por defecto).
- App Code Client: Identificador único en GlobalPay.
- App Key Client: Clave utilizada para cifrar la comunicación con GlobalPay.
- App Code Server: Identificador único en el servidor de GlobalPay.
- App Key Server: Clave usada para la comunicación con el servidor de GlobalPay.
Cuando tengamos todo nuestro plugin activado y configurado en WooCommerce, lo veremos disponible para seleccionarse por los clientes en la página de Checkout de nuestro comercio. Sólo basta con seleccionarlo, llenar los Billing Details y dar click en el botón de Place Order. Dando click llegaremos a la ventana de Order-Pay o Pay For Order en el cual veremos un resumen de nuestro pedido. Se mostrará el botón de Purchase el cual abrirá el checkout de GlobalPay.
- El proceso de refund empezará en la ventana principal del dashboard de WordPress.
- Seleccionamos la pestaña de WooCommerce y hacemos click en la opción Orders.
- Seleccionamos el pedido que queremos reembolsar y se abrirá la ventana de Edit Order.
- En el detalle del item encontraremos el botón de Refund, hacemos click y se desplegarán las opciones del refund.
- Tecleamos la cantidad a reembolsar y damos click al botón de Refund Manually.
- El estatus dentro de WooCommerce cambiará y también el estatus en GlobalPay.