En este post te mostraré cómo instalar y compilar lo necesario para montar el código fuente del plugin de impresoras térmicas versión 2 que ya presenté anteriormente y que puedes ver en el siguiente post:

Presentando plugin para impresoras térmicas versión 2

En pocas palabras, ese plugin permite imprimir en impresoras térmicas usando una API de internet, pero al estar en un servidor web necesita una conexión estable a internet, por ello es que ya existe la versión 3.

Al tener el código fuente, tú mismo puedes vender el servicio de la API ESC POS o usarlo para ti mismo modificando los planes y brindándote un plan ilimitado.

Veamos entonces cómo instalar las herramientas necesarias para modificar el código fuente del plugin versión 2.

Lenguajes de programación

El plugin utiliza PHP y Go. La API está programada con PHP y el conector o plugin que se comunica con ella utiliza Golang.

Además, se necesita MySQL para la API pues ahí se almacenan los usuarios, administradores y usos del plugin.

El conector sirve prácticamente para cualquier lugar donde Go compile, así que puede funcionar en Android, Mac, Linux y Windows, pero solo lo garantizo en Linux y Windows.

PHP solo es necesario en el servidor, ya sea local o de internet.

Consideraciones del código fuente

Antes de comprar el código fuente toman en cuenta lo siguiente:

• Te enviaré el código fuente tal y como está, incluyendo posibles errores o falta de características (esto no significa que el código no funcione)
• Recomiendo que pruebes el plugin para ver sus características y lo que puede hacer
• La venta del código fuente no incluye soporte técnico ni respuesta a preguntas como “Cómo puedo cambiar tal cosa para X cosa”. Si quieres soporte puedo brindártelo con gusto, pero por un costo extra.
• La única guía que ofrezco es la publicada aquí junto con el vídeo de cómo compilar.
• No hay reembolsos

Comprar código fuente

El costo del código fuente es de 6000 pesos mexicanos. Para obtenerlo:

1. Lee las consideraciones en este post, citadas más arriba. También lee la guía del código y mira el vídeo, al hacer el pago estás aceptándolas
2. Procede al pago, puedes usar los siguientes métodos de pago: https://parzibyte.me/blog/pagos-venta-software/
3. Una vez hecho el pago, envíame un mensaje en https://parzibyte.me/#contacto
4. Yo te enviaré el código en un plazo de 36 horas una vez realizado el pago.

¿Dónde buscar errores?

Si tienes problemas, hay 3 niveles para buscar errores. El primero es el de la comunicación de JavaScript con el plugin. Puedes inspeccionar las peticiones de red.

El segundo es el del plugin con el servidor de la API. Los errores del plugin estarán en un archivo de registro con el año y mes, en el mismo directorio que el plugin. Ahí aparecerán errores del servidor de la API y del cliente.

El último nivel es el registro de errores de PHP, que estará en php-error.log en donde tienes ubicada la API. Ahí aparecerán los errores que tengan que ver con la API.

Instalación y compilación del código fuente

A continuación copio y pego el archivo INSTALL que utilizo yo mismo al compilar el plugin y configurar el servidor. Este archivo va junto con el plugin y la API:

Requisitos

Necesitarás tener instalado Go, PHP, MySQL y Composer. También necesitas tener a go y composer en la path para invocarlos desde cualquier lugar. Aquí algunas guías

• Instalar Go: https://parzibyte.me/blog/2017/12/07/instalar-configurar-go-golang-en windows-10/
• Instalar PHP y MySQL: https://parzibyte.me/blog/2017/12/11/configurar-instalar-php-7-apache-server-mysql-windows/
• Instalar composer: https://parzibyte.me/blog/2017/12/24/configurar-descargar-instalar-composer-gestor-dependencias/
• Agregar programas a la PATH: https://parzibyte.me/blog/2017/12/21/agregar-directorio-path-windows/
• Compilar Go de 32 en una computadora de 64 bits: https://parzibyte.me/blog/2019/08/16/compilar-go-32-bits-desde-64-bits-cross-compile/

Para probar que todo funciona, ejecuta:

• go version y debe aparecer algo como: go version go1.17 windows/amd64
• composer --version y debe aparecer algo como: Composer version 2.1.6 2021-08-19 17:11:08

Si aparece algo como no se reconoce como un comando interno o externo programa o archivo por lotes ejecutable es porque no lo agregaste a la PATH correctamente.

Compilar cliente

Necesitas estar en la carpeta cliente. Ahora puedes compilar con:

• Para desarrollo: go build -tags desarrollo
• Para producción: go build -tags produccion

Nota: si quieres que no aparezca una ventana, al compilar en Windows agrega -ldflags "-H windowsgui" por ejemplo go build -tags desarrollo -o plugin_development.exe -ldflags "-H windowsgui"

Nota 2: si quieres compilar para 32 bits, instala Go de 32 bits y antes de compilar establece la PATH así: SET PATH=C:\Go32\go\bin;%PATH% && SET GOROOT=C:\Go32\go\.

Recuerda que a partir de que la cambies, vas a seguir compilando en 32 bits hasta reiniciar la consola

Recuerda configurar constantes_desarrollo.go y constantes_produccion.go con la URL del servidor según sea el caso

Configurar servidor

Debes estar en la carpeta api.

• Procede a instalar dependencias con composer install
• Crea la base de datos e importa el archivo admin/esquema.sql
• Configura el archivo env.php con las credenciales necesarias
• Visita HOST/api/admin/login_admin.php. En mi caso tengo el sistema en C:\xampp\htdocs\escpos-api\ y para acceder voy a http://localhost/escpos-api/api/admin/login_admin.php

Recuerda que si colocas la API en un servidor debes cambiar ese valor en el plugin de Go y compilar de nuevo

Descuento de saldo

Debes visitar admin/cobrar.php para descontar el saldo a los usuarios. Debes hacer eso el 1 de cada mes.

Vídeo de apoyo