El CLI de Bootic es una herramienta para diseñadores y desarrolladores que quieran realizan tareas con la API de Bootic en forma local, ya sea para ver o modificar datos, o bien para realizar cambios en la plantilla de la tienda.
El CLI lo proveemos como una gema en rubygems.org, y requiere de
Ruby 2.2 o superior. Afortunadamente, en versiones recientes de macOS,
ya viene instalado Ruby 2.3 (esto lo puedes comprobar corriendo ruby -v
en un terminal).
$ ruby -v
ruby 2.3.3p222 (2016-11-21 revision 56859) [universal.x86_64-darwin17]
Perfectirijillo. El paso siguiente es asegurarse que estén instaladas las Developer Tools de Xcode:
$ xcode-select --install
Hecho eso, podemos instalar la gema:
$ sudo gem install bootic_cli
Lo cual debería escupir un montón de texto, y terminar con algo así como "23 gems installed" si todo salió bien.
Antes de poder usarlo, el CLI necesita saber que tú eres tú para saber a qué datos darte acceso. Para eso corremos:
$ bootic setup
Te va a hacer algunas preguntas, pero el resumen es que debes entrar a https://auth.bootic.net/dev/cli, seguir los pasos, y luego copiar las credenciales de acceso que veas ahí.
Esto sólo hay que hacerlo una vez, por si aca.
-
En el terminal, para moverte entre carpetas se escribe
cd [nombreCarpeta], por ejemplocd proyectos. Si quieres subir un nivel, el comando escd .. -
Siempre puedes correr el comando
pwdpara saber la ruta completa de la carpeta en la que estás. el comandols(con ELE) te muestra los archivos y carpetas que hay en la ruta que estés. -
Una vez dentro de tu carpeta de trabajo (por ejemplo,
/Users/pedro/proyectos/supercliente), escribebootic themes clone. -
Con esto se va a descargar una copia de la plantilla de tu tienda (la que esté asociada a la cuenta con la que te logueaste antes).
-
La plantilla se guardará en una carpeta con el mismo subdominio que la tienda. deberías verla si corres
ls.
-
Luego, una vez dentro de esa carpeta (cd subdominio), puedes correr los siguientes comandos:
bootic themes comparepara comparar los cambios entre tu version local y la versión que está arriba,bootic themes pullpara bajar cualquier cambio que haya arriba,bootic themes pushpara subir cualquier cambio que hagas local,bootic themes syncpara sincronizar los cambios de arriba con los tuyos (gana el archivo más reciente en cada lado), y por último,bootic themes watchque se queda escuchando cualquier cambio local que ocurra, y cuando crees o cambies o elimines un archivo lo sube automáticamente.
El sitio lo sigues viendo "a distancia", remotamente, pero usando bootic themes watch
es casi instantáneo.
Todos estos cambios los puedes hacer directamente sobre el sitio público,
o bien hacerlo sobre el sitio/plantilla de desarrollo, que puedes crear al
momento de correr el comando clone.
Si elijes crear una plantilla de desarrollo todos los cambios que hagas van
a ser sobre un sitio de desarrollo, en https://url.del.sitio/preview/dev.
Los sitios de desarrollo no tienen caché, así que cualquier cambio que hagas
deberías verlo ipso-facto y sin retrasos.
Y finalmente, cuando quieras subir los cambios de la plantilla de desarrollo
al sitio público, corres bootic themes publish. Esto obviamente no aplica
en caso de que estés trabajo directamente sobre la plantilla pública.
En caso de que inicialmente no hayas creado una plantilla de desarrollo y
luego quieras hacerlo, basta con que elimines la carpeta y corras el comando
bootic clone de nuevo.
En ese caso debes correr bootic login para loguearte usando las credenciales
asociadas a la otra tienda. El CLI te advertirá que ya estás logueado (en caso
de que ya lo estés), pero simplemente dile que sí, que quieres reemplazar las
credenciales actuales por otras.
Escríbenos a [email protected] o por el chat de soporte dentro del panel de la tienda. Y si hay algo que no esté funcionando bien, crea un nuevo issue en este repositorio!