instructivo del sitio web caipeen la gura 1 se ilustra un esquema general de c omo se relaciona la...

Instructivo del sitio web CAIPE

FSF

CacuijaSoft Instructivo del sitio web CAIPE

Indice

1. Productos 2

1.1. Agregar, quitar y modificar productos de tablas existentes . . . . . . . . . . . . 2

1.2. Agregar, quitar y modificar tablas y categorıas . . . . . . . . . . . . . . . . . . . 5

2. Descargas 7

3. Contacto 9

1


1. Productos

En la figura 1 se ilustra un esquema general de como se relaciona la informacion ingresadapor el usuario con el catalogo y el sitio Web de CAIPE.

Sitio web

Archivo .ods

Catálogo

Figura 1: Relacion entre los archivos .xlsx, el catalogo y el sitio Web. El usuario modificaunicamente el archivo .xlsx y los cambios son reflejados en el catalogo y el sitio Web. Rojo: Linkde la hoja de datos del producto en cuestion. Naranja: Nombre de la imagen. Celeste: Datos del

producto. Violeta: Descripcion. Verde: ID de cada archivo asociado al producto separados por”,”(excepto la hoja de datos que es detallada en URL). Notar que la relacion entre los IDs y los

archivos se encuentra en un documento llamado archivos.csv.

1.1. Agregar, quitar y modificar productos de tablas existentes

Las acciones de alta, baja y modificacion de productos estan ligadas a la estructura delcatalogo de productos. Cualquier modificacion en la lista de productos de las distintas tablasde cada una de las categorıas pre-existentes en el catalogo se vera reflejada en el sitio web. Lospasos a seguir son los siguientes:

2


1. Editar, mediante LibreOffice Calc, los archivos de formato .xlsx del catalogo de produc-tos, para modificar, agregar o quitar un producto de una tabla que exista previamente.Es importante mantener la estructura establecida para las tablas de productos:

Las primeras dos filas estan reservadas para la definicion de los campos que establecenlas especificaciones posibles del producto.

• La primera corresponde a los nombres de los campos propiamente dichos.

• La segunda permite el agregado de subcampos, habiendo combinado horizon-talmente las celdas superiores, como se ilustra en la figura 2. Cuando no haysubcampos para un campo, las dos primeras celdas de la columna (las corres-pondientes a las filas de campos y subcampos) deben combinarse verticalmente.

Campos sin subcamposy

combinación vertical

Campos con subcamposy

combinación horizontal

Figura 2: Descripcion de la combinacion de los campos en una tabla de productos.

Cada producto ocupara dos filas, como se indica en la figura 3:

a) Especificaciones, imagen, URL y archivos asociados, en funcion de los campospreviamente definidos.

b) Descripcion del producto, mediante una fila combinada, que combina todas lascolumnas activas de la tabla, como se ilustra en la figura.

Descripción del producto con combinación horizontal hasta el último campo activo

Información del producto Nombre de la hoja de datos

}}}}

Obligatorio en la primer

columna

Opcional Opcional siempre en la

última columna

Obligatorio en el orden y posición indicados

Figura 3: Descripcion de los campos y subcampos en una tabla de productos.

La columna especial Modelo (obligatoria) debe ser la primera de todas las columnas.

Las columnas especiales IMG (obligatoria), URL (obligatoria) y Archivos (opcional)deben ser las ultimas, en ese orden, y respetando mayusculas y minusculas, como semuestra en la imagen 3.

3


• La columna IMG es obligatoria, y debe contener el nombre del archivo de imagenque se desea que se muestre en la pagina del producto, en la lista de productoscuando se selecciona una categorıa, y en el catalogo. Es conveniente que, paraque no haya perdida de informacion, el nombre del archivo de imagen utilizadosea el codigo del producto, y no posea espacios. El archivo de imagen se debeubicar en el directorio /img de la carpeta de catalogo.

• La columna URL es obligatoria, y debe contener la direccion de la hoja de datosdel producto en cuestion. Si el archivo aun no se subio al servidor (como se expli-cara mas adelante), alcanzara con elegir su nombre y escribir, en el campo URL, eltexto: http://caipe.com.ar/docs/datasheet/nombre-hoja-datos.pdf, reem-plazando nombre-hoja-datos por el nombre elegido. Es importante mantenerla extension .pdf.

• La columna de Archivos es opcional (puede no estar), y contendra numerosenteros separados por coma, como se indica en la misma figura. Estos numeroscorresponden a los identificadores de los archivos asociados, explicados en la sec-cion 2, y permiten asociar a cada producto un conjunto de archivos determinadomanualmente.

El resto de las columnas, las anteriores a las 3 nombradas previamente y posterioresa Modelo, pueden tener cualquier nombre o formato, respetando las consideracionesde combinacion de celdas descriptas previamente.

2. En Windows, hacer doble clic sobre el archivo recopilarInfoWeb.exe, ubicado en lacarpeta de edicion. Este programa movera las imagenes y los archivos con la informacionactualizada a los directorios correspondientes (/csvs/ e /imagenes/).

3. Conectarse, por medio de FTP, al servidor, utilizando para ello el Explorador de Windows,y pegar las carpetas creadas en el paso anterior (/csvs/ e /imagenes/), sobreescribiendolas anteriores.

a) En la barra de direcciones del Explorador de Windows, ingresar la URL del servidorFTP provisto por el servicio de Hosting contratado. La misma se encuentra en elarchivo de contrasenas, dentro de la carpeta de edicion del sitio web.

b) Ingresar el nombre de usuario y contrasena, tambien especificados en el archivo decontrasenas de la carpeta de edicion.

c) Copiar las carpetas recientemente creadas, y pegarlas, sobreescribiendo los archivosexistentes, en el directorio del servidor FTP.

4. Subir al mismo servidor las hojas de datos, si fuera necesario, cuyos nombres debencoincidir con los especificados en los campos URL de los archivos .xlsx modificadospreviamente (marcado en verde en la figura 3). Se deben pegar dentro de la carpeta/docs/datasheets/, donde los archivos no estan ordenados en directorios.

5. Una vez que los archivos de informacion, las imagenes y las hojas de datos fueron subidas alservidor web, solo es necesario ejecutar el script de actualizacion de datos, accediendo a laURL http://www.caipe.com.ar/recargar-db.php, donde se pide usuario y contrasena,y comienza la reorganizacion de los datos.

4


1.2. Agregar, quitar y modificar tablas y categorıas

La modificacion de tablas y categorıas, ası como su creacion y eliminacion, esta tambienvinculada al catalogo de productos. Primero debe crearse una nueva tabla o categorıa, seguncorresponda, recrear el catalogo de productos, modificar el ındice de categorıas y tablas ma-nualmente (para establecer su posicion jerarquica dentro del menu de productos del sitio web),y finalmente realizar los pasos descriptos en la seccion 1.1.

Para efectuar lo comentado en el parrafo anterior, se deben seguir los siguientes pasos:

1. Creacion de una categorıa nueva: Si se desea crear una nueva categorıa, seranecesario crear una nueva carpeta dentro del catalogo, bajo la jerarquıa deseada, cuyonombre debera ser sin espacios (reemplazarlos por guiones bajos, ” ”). Por ejemplo, paracrear una nueva categorıa dentro de la seccion de Instrumentacion Industrial, se debecrear la carpeta:

CATALOGO/instrumentacion industrial/CATALOGO/nueva categorıa/.

Crear una subcarpeta dentro de la misma, llamada /img/, donde se deben ubicarlas imagenes que correspondan a los productos que van a estar incluidos en la nue-va categorıa. Recordar que los nombres de las imagenes deben corresponderse, porprolijidad y seguridad, con el codigo del producto, y que no deben contener espacios.

2. Creacion de una tabla: Si se desea crear una tabla (dentro de la nueva categorıa,o dentro de una categorıa preexistente), se debe crear un archivo de formato .xlsx,mediante LibreOffice Calc, cumpliendo las especificaciones de formato dadas en la seccion1.1. Agregar, en este archivo, los productos correspondientes a la tabla, siguiendo lasinstrucciones de la misma seccion.

3. Modificar el archivo indice-productos.txt, procurando realizar la menor cantidad decambios posible a la estructura original, siguiendo las siguientes pautas:

Las jerarquıas estan dadas por tabulaciones (tabs), como se observa en la figura 4.Una mayor jerarquıa en el arbol de productos se obtiene cuando antes del nombredel item (seccion, categorıa o tabla) se agrega la menor cantidad posible de tabs (elmınimo es cero, el maximo es dos).

• Ningun tab: Seccion.

• Un tab: Categorıa

• Dos tabs: Tabla

El caracter reservado @ separa el tıtulo de la categorıa o tabla, del archivo asociadoa la misma. Este archivo es el creado automaticamente por el generador de catalogo,y es el que contiene la informacion del producto.

• El tıtulo puede contener espacios y caracteres unicode.

• Si es una tabla, el nombre del archivo generado automaticamente tiene el for-mato:nombre categoria nombre archivo tabla xlsx.csv

• Si es una categorıa, el nombre del archivo es:nombre categoria nombre categoria.csv

5


}

}

Sec

cion

es(s

in ta

bula

ción

)

Categorías

(1 tabulación)

Tablas

(2 tabulaciones)

Producto destacado(Se ubican en posición de sección)

Categoría con tabla propia(clickeable en el menú de productos)

Nombre del archivo .csvcon la información asociada

a la tabla

Categorías sintabla

Figura 4: Esquema de jerarquıas en el archivo indice-productos.txt, y relacion con la forma enque se muestra la informacion en el menu de productos del sitio web. Se debe prestar especial

atencion a las tabulaciones, ası como a la sintaxis y la importancia del sımbolo @ para vincularnombres con informacion.

6


• En general, los nombres de las categorıas no tienen archivos asociados, por loque no poseen un caracter @ delimitante. Esas categorıas no seran clickeablesen el sitio web, dado que no poseen una tabla asociada que pueda ser mostrada.

• En general, los nombres de las secciones tampoco poseen un archivo de tablarelacionado, aunque si la seccion corresponde a un producto destacado, se uti-lizara la misma sintaxis, donde luego del caracter @ se ubicara el archivo .php

que contiene la informacion del producto destacado.

2. Descargas

Para agregar, quitar o modificar los archivos que se muestran en la seccion Descargas delsitio Web, se requiere modificar el documento llamado archivos.csv ubicado en la carpetaproporcionada por CacuijaSoft.

Los pasos a seguir se detallan a continuacion:

Figura 5: Configuracion necesaria para abrir los archivos .csv con LibreOffice Calc.

1. Abrir el archivo archivos.csv con LibreOffice Calc, segun los lineamientos de la figura5.

7


2. Los campos de archivos.csv que deben ser agregados, modificados y/o eliminados, seexplican en los siguientes puntos:

ID: Es un identificador numerico, que debe ser unico para cada archivo. Ademas, esutilizado para la vincular archivos a cada producto mediante el campo Archivos dela tabla .xlsx de cada producto, como se muestra en la figura 6.

Categorıa: Es la clasificacion asignada al archivo en cuestion que sera reflejada enla pagina Web como se muestra en la figura 6. Las clasificaciones posibles son 5 y selistan a continuacion:

• Software

• Drivers

• Notas de aplicacion

• Ejemplos

• Otros

Nombre: Es el nombre del archivo a descargar.

Descripcion: Se detalla una breve explicacion del archivo.

URL: Es el nombre del archivo a descargar que debe estar ubicado en el servidoren la ruta /archivos/.

archivos.csv

Descargas(sitio Web)

{archivo de

producto .ods

vinc

ulac

ión

Figura 6: Esquema de la relacion entre los datos de los archivos y la pagina de descargas del sitioWeb. Ademas, se muestra en rojo la vinculacion entre archivos con un producto especıfico.

3. Conectarse, por medio de FTP, al servidor, utilizando para ello el Explorador de Windows,y pegar el documento archivos.csv en el directorio raız, sobreescribiendo el anterior.

8


a) En la barra de direcciones del Explorador de Windows, ingresar la URL del servidorFTP provisto por el servicio de Hosting contratado. La misma se encuentra en elarchivo de contrasenas, dentro de la carpeta de edicion del sitio web.

b) Ingresar el nombre de usuario y contrasena, tambien especificados en el archivo decontrasenas de la carpeta de edicion.

c) Copiar el archivo archivos.csv recientemente creado, y pegarlo, sobreescribiendoel archivo existente, en el directorio del servidor FTP.

4. Subir al mismo servidor los archivos, si fuera necesario, cuyos nombres deben coincidir conlos especificados en el campo URL de archivos.csv, modificado previamente. Se debenpegar dentro de la carpeta /archivos/.

5. Una vez que los archivos fueron subidos al servidor web, solo es necesario ejecutar el scriptde actualizacion de datos, accediendo a la URL http://www.caipe.com.ar/recargar-db.php,donde se pide usuario y contrasena, y comienza la reorganizacion de los datos.

3. Contacto

La pagina de contacto permite la modificacion de los vendedores externos a CAIPE, me-diante el archivo contactos.csv.

1. Abrir el archivo contactos.csv provisto en la carpeta de edicion del sitio web, utilizandoLibreOffice de la misma forma en que fue especificado en la figura 5.

El campo ID es un numero creciente y unico que permite la identificacion del con-tacto.

Los campos Nombre, Direccion, Telefono, Mail y URL son simples campos de textosin validacion previa.

Los dos ultimos campos, Latitud y Longitud son valores numericos que establecenla ubicacion que se desea mostrar en el mapa cuando se hace clic sobre el boton delcontacto en particular.

2. Agregar, eliminar o modificar los contactos, segun necesidad.

Si se desea agregar un marcador de posicion en el mapa a un contacto, se debeacceder al sitio http://www.openstreetmap.org/, ubicar manualmente la posicionen el mapa que se desea, hacer clic derecho sobre la misma, y seleccionar la opcionShow address, que abre un menu lateral donde indica la latitud y longitud delpunto seleccionado, separadas por coma, como se indica en la figura 7. Estos datos,incluyendo el signo, deben ser asignados al contacto correspondiente.

Conectarse, por medio de FTP, al servidor, utilizando para ello el Explorador deWindows, para pegar el archivo contactos.csv en su ubicacion correspondiente.

a) En la barra de direcciones del Explorador de Windows, ingresar la URL delservidor FTP provisto por el servicio de Hosting contratado. La misma se en-cuentra en el archivo de contrasenas, dentro de la carpeta de edicion del sitioweb.

9


Latitud Longitud

Figura 7: Pasos para obtener la latitud y longitud de una posicion en el mapa, de manera que luegoexista un marcador en el mapa.

10


b) Ingresar el nombre de usuario y contrasena, tambien especificados en el archivode contrasenas de la carpeta de edicion.

c) Copiar el archivo contactos.csv recientemente creado, y pegarlo, sobreescri-biendo el archivo existente, en el directorio del servidor FTP.

Una vez que el archivo fue subidos al servidor web, solo es necesario ejecutar el scriptde actualizacion de datos, accediendo a la URL

http://www.caipe.com.ar/recargar-db.php, donde se pide usuario y contrasena,y comienza la reorganizacion de los datos.

11

instructivo del sitio web caipeen la gura 1 se ilustra un esquema general de c omo se relaciona la...

Documents