osCommerce-Manual spanish.pdf

oscdox com proyecto de documentaci n de oscommerce gu a de instalaci n y modificaci n volumen 1 oscdox proyecto de documentaci n oscom merce gu a de instalaci n y modificaci n por michael sasek y melinda odom osc and michael sasek p o box 16123 phoenix az 85011 1623 admin traducci n al espa ol yolanda gonz lez versi n 1 10 de septiembre de 2002 para ampliar informaci n sobre oscommerce en espa ol n d i c e introducci n cap tulo 1 convenciones t rminos y asunciones palabras clave 3 cap tulo 2 instalar la tienda estructura de directorios 5 ejecutar el script de instalaci n 6 proteger tu instalaci n 13 instalaci n de la ra z del documento 14 finalizar la instalaci n 14 cap tulo 3 gu a de modificaci n qu archivos edito 15 convenciones de c digo y otros conceptos generales 16 ejercicio 1 tu primer proyecto 18 ejercicio 2 establecer el ancho de tu tienda 27 el sistema de bloques laterales 28 a adiendo bloques enlaces y p ginas nuevas 30 a adir enlaces fuera de los bloques 34 modificar el aspecto de los bloques laterales 36 secci n de c mo hacer ejemplos y procedimientos 39 editar la hoja de estilos 45 introducci n sta es una gu a para instalar oscommerce y hacer cambios est ticos y funcionales a oscommerce la soluci n de comercio electr nico de c digo abierto esta gu a asume que conoces el html b sico y c mo funciona si no es as consigue un buen libro sobre html para aprenderlo aunque hemos tratado de ser muy generalistas esto no significa que sea una fuente de conocimiento exhaustivo ya que est planteado como un punto de inicio ten en cuenta que oscommerce est en constante desarrollo y el c digo cambia todos los d as esto quiere decir que esta gu a debe serte til para localizar los archivos adecuados y las partes correctas dentro de esos ficheros donde modificar si encuentras esta gu a til y quieres mostrarnos tu trabajo o hacer una contribuci n t cnica a la gu a por favor visita y nete a los foros de discusi n e c o n v e n c i o n e s t r m i n o s y p r e s u p u e s t o s convenciones t rminos y asunciones lo largo de esta gu a comprobar s que se hace referencia muchas veces a rutas de directorio referencias a localizaciones de archivos y otras palabras clave siempre que te encuentres con un t rmino que no te resulte familiar consulta esta secci n adem s esta gu a presupone varias cosas sobre tu primera instalaci n primero asumimos que instalar s tu tienda en el subdirectorio catalog del directorio ra z de tu servidor web tambi n asumimos que instalar s la administraci n de tu tienda en el subdirectorio admin de directorio ra z de tu servidor web todos los ejemplos de c digo dependen de estas asunciones palabras clave ra z se refiere al directorio ra z de los archivos en tu servidor ra z del documento se refiere al public html o al directorio base de publicaci n web ordenador local es tu ordenador personal no tu servidor web webserver localhost este es otro t rmino que usamos para referirnos a tu servidor web path absoluto es una ruta de directorio que se inicia en tu ra z del servidor path relativo es una ruta relativa al directorio de archivo actual cap tulo 1 i c n o s informaci n valiosa ejercicio de teclado a i n s t a l a c i n d e l c a r r i t o instalar la tienda scommerce puede instalarse bajo windows 98 2000 xp linux y m quinas basadas en unix la instalaci n recomendada es en una m quina linux pero funcionar bien en todas cada una con sus propias singularidades los requerimientos b sicos para hacerlo funcionar son un servidor web que funcione como apache o iis a continuaci n necesitar s instalar un servidor de base de datos mysql y php el lenguaje de scripting en el que est escrito oscommerce si no est s seguro de cumplir con todos esos requerimientos compru balo ahora si estos requerimientos m nimos oscommerce no funcionar estas instrucciones de instalaci n son espec ficas para la versi n 2 2 cvs y no se aplica a cualquier versi n anterior de oscommerce a continuaci n debes subir los archivos y la estructura de directorios a tu servidor web esto puede llevarse a cabo de maneras diferentes usa el m todo que te resulte m s familiar por ejemplo descomprimiendo el archivo de oscommerce en tu ordenador local y usando tu programa favorito de ftp para subir esos archivos o usando wget y tar para evitar el aburrimiento de descargar y volver a subir los archivos s lo en unix linux los archivos pueden subirse a la ra z o alg n otro subdirectorio como catalog nota si est usando ftp para subir los archivos debes subir todos los archivos php en modo ascii no binario antes de continuar asegurat de que sabes crear bases de datos y tablas mysql si no tendr s que contactar con tu administrador y pedirle que cree la base de datos para ti otra herramienta valiosa para manipular bases de datos mysql es phpmyadmin que puedes descargarte de muchos administradores ya te proporcionan esta herramienta pero es muy f cil de instalar si lo necesitas aseg rate de proteger con contrase a tu directorio phpmyadmin ahora est s listo para crear tu base de datos este procedimiento es m s directo si usas phpmyadmin y muchos administradores que proporcionan mysql tienen alg n tipo de interfaz para que crees tu base de datos los tutoriales mysql abarcan mucho m s que el objetivo de esta gu a as que si tienes alg n problema consulta la documentaci n de crea y da un nombre a tu base de datos establece la contrase a asigna el usuario y mant n esta informaci n a mano porque la necesitar s pronto cap tulo 2 o i n s t a l a c i n d e l c a r r i t o 5 estructura del directorio una vez que abras el archivo zip o tar de oscommerce podr s ver la estructura de directorios del archivo hay dos niveles de directorios de catalogaci n y de administraci n los archivos que quieras subir est n en el segundo nivel de cada rbol de directorios catalog catalog admin admin a continuaci n copia las carpetas inferiores en negrita arriba sobre tu directorio ra z del documento de tu servidor as document root public html o www catalog admin o si quieres que el cat logo est en tu documento ra z en vez de en el subdirectorio catalog simplemente estruct ralo as document root sube los contenidos de la carpeta del cat logo aqu admin a continuaci n es importante establecer los permisos de directorios adecuados en los sistemas unix hazlo usando el comando chmod los valores chmod son los siguientes directorio niveles de permiso admin includes chmod 755 catalog includes chmod 755 admin includes configure php chmod 777 catalog includes configure php chmod 777 catalog images chmod 777 ahora crea el directorio backups dentro de la carpeta admin esto arregla el error de backup que obtendr s luego cuando hagas clic en el enlace database backup dentro de tools y el mensaje de error en la barra superior de la p gina error backup directory does not exist please set this in configure php error el directorio de backup no existe por favor establ zcalo en configure php aseg rate de establecer los permisos de este directorio a chmod 777 i n s t a l a c i n d e l c a r r i t o 6 resumen 1 transfiere los archivos a la ra z del documento preservando la estructura del directorio puedes hacerlo usando los comandos wget y tar en servidores unix linux o puedes usar ftp para subir los archivos y la estructura de directorios 2 aseg rate de transferir los archivos php en modo ascii si usas ftp 3 establece los permisos de directorios de archivos como se explic anteriormente 4 crea tu base de datos mysql vac a y conserva el nombre nombre de usuario y la contrase a de la base de datos necesitar s esto para el script de instalaci n ejecutar el script de instalaci n el siguiente paso de la instalaci n crear las tablas de la base de datos mysql instala datos de pruebas y configura tu tienda oscommerce para ajustar la configuraci n del servidor introduce en tu navegador la siguiente url reemplaza yourserver por tu nombre de dominio o direcci n ip esto iniciar el script de instalaci n de oscommerce m s abajo examina las capturas de pantalla de las p ginas de instalaci n esto explicar el proceso entero paso a paso figure 1 1 selecciona el bot n new install i n s t a l a c i n d e l c a r r i t o 7 figure 1 2 para el n mero 1 aseg rate de que ambas casillas est n seleccionadas para el n mero 2 introduce la ruta correcta la informaci n que se presenta en la captura de pantalla no es la adecuada para tu servidor aseg rate de que todas las rutas son correctas 2 por favor introduce la informaci n de tu servidor web directorio ra z del servidor web este es un ejemplo de ruta de ra z absoluta home myaccountname public html directorio de publicaci n del cat logo este es un ejemplo de ruta relativa a oscommerce catalog directorio publicaci n de la herramienta de administraci n admin i n s t a l a c i n d e l c a r r i t o 8 figura 1 3 para la pregunta 3 introducir la informaci n de la base de datos que anotaste antes cuando creaste tu base de datos mysql haz clic en el bot n continue database server servidor de la base de datos el servidor de la base de datos puede se un nombre de host como o una direcci n ip como 192 168 0 1 normalmente localhost funcionar bien username nombre de usuario el nombre de usuario se usa para conectarse al servidor de la base de datos un ejemplo el nombre de usuario es mysql 10 nota si el cat logo va a ser importado seleccionado m s arriba la cuenta usada para conectarse al servidor de la base de datos necesita tener permisos para crear y borrar permisos de creaci n y eliminaci n password contrase a la contrase a se usa junto con el nombre de usuario y forman la cuenta de usuario de la base de datos database base de datos la base de datos se usa para guardar los datos del cat logo un ejemplo de nombre de base de datos es mysql catalog i n s t a l a c i n d e l c a r r i t o 9 figura 1 4 a continuaci n se te pedir que importes la base de datos haz clic en continue figura 1 5 si todo va bien aparecer la pantalla de xito haz clic en el bot n continue i n s t a l a c i n d e l c a r r i t o 10 figura 1 6 si los permisos son incorrectos aparecer esta pantalla establece tus permisos y haz clic en retry i n s t a l a c i n d e l c a r r i t o 11 figura 1 7 esta es la primera parte de la pantalla de resumen toda la informaci n deber a ser correcta ver la p gina siguiente i n s t a l a c i n d e l c a r r i t o 12 figura 1 8 esta es la segunda parte de la pantalla de resumen tienes dos opciones nuevas al final puedes activar las conexiones continuas y puedes decidir como almacenar tus sesiones en servidores con mucha actividad desactiva las conexiones continuas y guarda las sesiones como archivos pulsa el bot n continue figura 1 9 cuando llegues a esta p gina habr s completado con xito la instalaci n de oscommerce el bot n catalog te llevar directamente a tu tienda y el bot n administration tool te llevar a la consola de administraci n i n s t a l a c i n d e l c a r r i t o 13 proteger tu instalaci n felicidades has instalado con xito una copia funcional de oscommerce en tu servidor web ahora necesitas proteger esa instalaci n primero lo m s f cil de todo borra totalmente el directorio catalog install despu s usa htaccess en tu directorio admin de manera que tu contrase a est protegida puedes usar el administrador de contrase a en tu cuenta si tiene un panel de control o haz una b squeda por la web de htaccess y encontrar s informaci n de c mo hacerlo normalmente tu administrador tendr informaci n de soporte sobre esto en su documentaci n a continuaci n a ade default php al listado del ndice de tu directorio en el archivo httpd conf para apache esto har que aparezca tu p gina default php sin tener que teclear toda la direcci n esto har que apache no env e el archivo entero y el listado del directorio de tu cat logo puedes hacer estos cambios t mismo editando el archivo de configuraci n de apache llamado httpd conf para editar este archivo directamente en el servidor entra dentro con una shell y usa el comando pico path to apache conf httpd conf si no tienes acceso por consola puedes hacerlo usando htaccess que adem s es m s seguro para los principiantes atenci n no toques tu httpd conf si no sabes lo que est s haciendo podr as cargarte todo tu servidor si cometes alg n error aseg rate de hacer una copia de seguridad del archivo antes de editarlo si editas tu httpd conf a ade la sentencia directoryindex default php a la secci n de tu archivo httpd conf permisos despu s de la instalaci n establece tus permisos para concuerden con esto directorio nivel de permisos admin includes chmod 755 catalog includes chmod 755 admin includes configure php chmod 644 catalog includes configure php chmod 644 catalog images chmod 777 p a s o s p a r a u n a i n s t a l a c i n s e g u r a borrar por completo el directorio de instalaci n establecer el archivo de acceso y los permisos del directorio ver m s abajo insertar un archivo en blanco llamado index html en todos los directorios cr ticos proteger tu directorio admin con htaccess i n s t a l a c i n d e l c a r r i t o 14 adem s en el directorio catalog puedes colocar un archivo vac o html llamado index html esto evitar que apache env e el rbol del directorio y no permitir que la gente vea con el navegador el contenido de tus directorios instalaci n de la ra z del documento cuando copies tus archivos en el servidor en vez de copiar el directorio y los archivos del cat logo en el subdirectorio catalog simplemente copia los archivos y directorios a la ra z del documento tu directorio www o public html copia la carpeta admin en la ra z del documento como en las instrucciones originales despu s introduce en tu navegador sustituye yourserver por tu dominio o direcci n ip cambia lo siguiente tras la instalaci n includes configure php esta l nea en configure php define dir ws catalog catalog el path absoluto requerido puede cambiarse a define dir ws catalog el path absoluto requerido y cambia estas l neas define dir fs document root document root define dir fs catalog dir fs document root dir ws catalog a define dir fs document root home serverusername public html define dir fs catalog home serverusername public html cambia el admin includes configure php para que concuerde tambi n fin de la instalaci n esperamos que estas instrucciones hayan sido lo bastante claras para ayudarte a instalar este programa pero eso s no has terminado realmente m s bien no has hecho m s que empezar en los siguientes cap tulos nos adentraremos en las profundidades de modificar el aspecto de oscommerce prep rate para la diversi n g u a d e m o d i f i c a c i n 15 gu a de modificaci n qu archivos edito como un futuro dise ador de oscommerce necesitar familiarizarse con los archivos que en realidad establecen qu aspecto tendr oscommerce la forma en que oscommerce genera din micamente las p ginas al menos permite un proceso de edici n consistente estos son los archivos con los que necesitar familiarizarse con el fin de cambiar el aspecto de su tienda virtual catalog catalog includes catalog includes languages stylesheet css default php casi todos los archivos php tienen un duplicado html que crea el aspecto del sitio y deben editarse para cambiar el aspecto del sitio en todos y cada uno de los archivos application top php column left php column right php configure php footer php header php english php languages english todos los archivos php de este directorio m s abajo hay una lista de las localizaciones por directorio de otros archivos importantes catalog images im genes del cat logo distintas de los botones de navegaci n y las im genes de productos catalog includes languages english icono de la bandera del idioma catalog includes languages english images buttons botones de navegaci n para el sitio web cap tulo 3 g u a d e m o d i f i c a c i n 16 catalog includes boxes archivos que definen el tama o de los bloques laterales y lo que hacen antes de continuar asegurate de hacer copias de seguridad de todos los archivos anteriormente mencionados por si acaso cometieses alg n error adem s no trabajes en el sitio web activo podr as estropear alg n fichero que impidiera que funcionase tu tienda te sugiero que montes un entorno de desarrollo privado en el que puedas trabajar este puede estar simplemente en otro directorio o subdominio en el mismo servidor el archivo stylesheet css es una hoja de estilo y controla todos los colores y fuentes de la tienda sugiero que te tomes una hora en familiarizarte con cada punto definido en la hoja de estilos y en qu hacen muchos son muy evidentes y si no c mbialos para ver lo que hacen creo que lo mejor es abrir este archivo en un buen editor css recomiendo topstyle esta herramienta hace que trabajar con hojas de estilo sea muy f cil al final de este documento hay un ndice de stylesheet css con informaci n de lo que controla cada punto a continuaci n el archivo default php es la p gina principal del cat logo que se ve nada m s entrar en la tienda ahora nos ocuparemos del contenido html de este archivo php hay muchas secciones que controlan varios anchos estructuras etc de las tablas cada una de estas secciones necesita ser modificada para que tu tienda tenga un aspecto diferente sugiero que marques todos tus cambios con un comentario de este modo despu s podr s copiar y pegar los cambios f cilmente en los dem s archivos de la tienda esto tambi n es buena idea en caso de que decidas actualizar a una nueva versi n m s adelante buena suerte si intentas recordar d nde pegaste dos l neas de c digo seis meses antes convenciones de c digo y otros conceptos generales el modo en que oscommerce est construido parece complicado al principio pero una vez que aprendes sus convenciones puedes modificar eficazmente tu tienda en muchos sentidos primero si miras el archivo default php en un editor ver s que el c digo est dividido en secciones estas secciones se definen del siguiente modo g u a d e m o d i f i c a c i n 17 el c digo define el comienzo de una secci n espec fica y el c digo define el final de esa se