Instalacion de oscomerce en un servidor en internet
Instalacion nueva de osCommerce en un servidor web Intrucciones por nicko107 Intrucciones por nicko107 Version de instalacion: osCommerce 2.2 Milestone 2 Fecha de realizacion del tutorial: 04 Septiembre de 2.005 Direcciones de interes:
Descarga de Oscommercel http://www.oscommerce.com Foro de oscommerce ingles http://forums.oscommerce.com Pagina de soporte en español de oscommerce http://oscommerce.qadram.com Foro en español http://oscommerce.qadram.com/modules.php?name=Forums Este tutorial se encuentra en la web: http://usuarios.lycos.es/creacionwebphp/ Esta traducion se ha trabajado sobre la version osCommerce 2.2 Milestone 2 4 Octubre 2.005
Este es un borrador inicial que hiremos actualizandolo con informacion mas detallada y añadiendo errores que se puedan dar y como resolverlos.
Instrucciones en español de la instalacion :
Versión de osCommerce : osCommerce 2.2 Milestone 2 Descripcion: osCommerce es una solucion Open Source de tienda de e-comercio online que esta disponible gratis bajo GNU. Posee un carrito de la compra que permite la venta directa por Internet gestionando la administracion de la web y el mantenimiento de la tienda online con el minimo de esfuerzo y sin ningun coste, cargos de licencia o limitaciones. Uno de los puntos fuertes es la extensa comunidad que da soporte a la contruccion del proyecto como a la creacion de contribuciones que proveen de herramientas adicionales a las ya amplias funcionalidades que brinda osCommerce. Este proyecto lleva ya 5 años en los que se han sumado una gran comunidad de desarrolladores y hoy esta comunidad consiste en al rededor de 62.000 tiendas, desarrolladores, diseñadores, seguidores de este proyecto y sobre unas 2.900 contribuciones de la comunidad que hacen de este proyecto mejor. osCommerce usa una solucion Open Source, Codigo Abierto, para proveer de una plataforma libre y abierta de e-comercio, que incluye el lenguaje PHP y el servidor estable Apache, y la rapida base de datos MySQL. No tiene especiales requerimientos, osCommere esta capacitado para funcionar a partir de PHP 4.1 mas un servidor con Linux, Solaris, BDS, MAc OS X, y tambien en Microsoft Windows.
http://usuarios.lycos.es/creacionwebphp/index.php?option=com_docman&task=doc_view&gid=3 (1 de 12)04/10/2005 22:08:42
Instalacion de oscomerce en un servidor en internet
En lo que respecta a la estructura. Hay una parte publica y una parte de administracion de la web, normalmente las webs se manejan desde el panel de control del proveedor subiendo los archivos html o de imagenes y la web solo responde mostrando el contenido que tiene mediante enlaces que hay en sus paginas. Con el osCommerce esto es mas completo porque dispone de programacion especial y de una base de datos con la que interactua el visitante de modo que ante consultas muestra resultados como lista de productos segun categorias o similitudes; o simples busquedas de productos, tambien dispone de herramientas como mostrar las ultimas novedades, ofertas, .... Dispone de menu por categorias de productos que se genera automaticamente y que enlaza a una lista con todos los productos de una clase o una categoria. Ademas de multiples opciones utiles que tambien dan mas dinamismo y mas posibilidades de presentar mejor sus productos Tambien dispone de carrito de la compra y pasarelas de pago confiables, aunque es modificable para no mostrarlo y solo disponer de una web informativa con catalogo de productos y mucho mas.
esta imagen corresponde a la portada de la web que se genera con la instalacion es completamente modificable y personalizable para adaptarla al dise単o o imagen de su empresa y tambien ampliable con contribuciones que dan mas herramientas y mas posibilidades
http://usuarios.lycos.es/creacionwebphp/index.php?option=com_docman&task=doc_view&gid=3 (2 de 12)04/10/2005 22:08:42
Instalacion de oscomerce en un servidor en internet
Pasos para instalarlo:
Pasos previos
Eleccion del hosting o hospedaje de la pagina de oscommerce
Si va a ser con oscommerce, como en otros sistemas parecidos a este como son joomla o similar debe cumplir estos requisitos minimos sin los que no es posible que funcione una web de este tipo. Los requisitos minimos deben ser los siguientes: ● ● ●
deben funcionar paginas en php debe trabajar con bases de datos mysql debe comprobarse antes si aceptan el uso del .htaccess para proteger carpetas con contraseña para proteger las carpeta del admin, existen otros metodos pero este es el mas conveniente. Este ultimo punto si no lo indica en las caracteristicas consultar en un buscador si alguna persona habla de ese servidor y si dejan el uso de ese archivo o no en el servidor que se quiere instalar el oscommerce. Cuando hayamos comprobado esos pasos pasar al punto siguiente.
1. Descargar el oscommerce de la web oficial de la direccion http://www.oscommerce.com/ Descomprimir el archivo zip Su composicion es la siguiente: oscommerce-2.2ms2 contiene dentro diversos archivos de ayuda, licencia y demas extras
dentro tiene diversos archivos y carpetas catalog
http://usuarios.lycos.es/creacionwebphp/index.php?option=com_docman&task=doc_view&gid=3 (3 de 12)04/10/2005 22:08:42
Instalacion de oscomerce en un servidor en internet
admin <--- contiene todos los archivos de la parte de administracion de la web download images <--- contiene las imagenes o graficos que se usan en la web includes <--- contiene modulos, las partes de la web, los idiomas.... install <--- contiene los archivos de instalacion de oscommerce, solo se usan en la instalacion y al final por seguridad se debe borrar todo su contenido y la carpeta install (ya se dira cuando en el tutorial) pub - contiene otros archivos .php necesarios
...
2. subir todos los archivos mediante FTP al servidor donde vamos a hospedar la pagina web de oscommerce todo el contenido lo debeis subir con la misma disposicion que se ve al descomprimirlo. Para subirlos correctamente usa el modo automatico, o bien todos los archivos .php subelos en modo ASCII mediante FTP Tras terminar crea una carpeta llamada backups dentro de la carpeta de catalog/admin quedaria asi: catalog/admin/backups [ esto corregira un error que sino saldria mas adelante con el siguiente mensaje: 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)]
Errores que puedes tener a la hora de subir tus archivos mediante FTP es que os de un error al subir el archivo .htaccess si este error contiene en ingles o en espaĂąol: "nombre de archivo prohibido" es que seguramente no permitira el uso de este tipo de archivos, era uno de los requisitos que deciamos mas arriba, y por tanto no te permitira usarlo para proteger la carpeta admin con contraseĂąa. Puedes de todas formas subirlo si lo renombras a htaccess.txt y tras subirlo lo vuelves a renombrar a .htaccess al final quedara asi tu web: www.tudominio.com/catalog y todos los demas archivos y carpetas que contiene catalog. Tambien existe la posibilidad de que los archivos esten en el directorio raiz y en vez de ser www.tudominio.com/catalog sea directamente www.tudominio.com Esto se hace subiendo los archivos y carpetas que contiene la carpeta catalog a el directorio raiz, y no dentro de la carpeta catalog en el directorio raiz. Luego donde en los datos que se introduzcan ponga /catalog/ no se debe poner nada. Por defecto suele instalarse como esta y sobreotodo para primeras instalacion o de prueba es recomendable no realizar muchos cambios.
http://usuarios.lycos.es/creacionwebphp/index.php?option=com_docman&task=doc_view&gid=3 (4 de 12)04/10/2005 22:08:42
Instalacion de oscomerce en un servidor en internet
3. Debeis cambiar los permisos chmod de algunas carpetas una vez subidos al servidor la carpeta includes en: catalog/admin/includes a: 755 la carpeta includes en: catalog/includes a: 755 el archivo configure en: catalog/admin/includes/configure.php a: 777 el archivo configure en: catalog/includes/configure.php a: 777 la carpeta images en: catalog/images a: 777 la carpeta que creaste antes llamada backups en: catalog/admin/backups a: 777
4. En el panel de control de la cuenta de la web crea o activa una base de datos MySQL en algunos servidores al activar el uso de PHP se crea tambien la base de datos, pudiendo tener que crear un nombre de usuario sino te dan uno y una contraseĂąa para la base de datos, anota esos dos datos que los necesitaras para la instalacion de oscommerce. Tambien puede ser que no haga falta contraseĂąa para la base de datos.
[ Antes de seguir, existe la posibilidad de que renombres la carpeta catalog al nombre que quieras, a catalogo, o a tienda o a otro que desees, solo que debes recordar que en cada paso cuando este escrito catalog/... debeis cambiarlo por el nombre que hayais escogido, para cambiarlo lo haceis mediante el programa de FTP que useis, seleccionando el archivo y pulsando en rename o renombrar. En una instalacion nueva es mejor dejarlo como viene por defecto y con la practica si se desea o es necesario se puede cambiar ]
comienza la instalaciĂłn: 5. tras haber subido los archivos y creado la base de datos y activado el PHP de la pagina, comienza la instalacion Abre tu navegador y escribe la siguiente direccion: http://www.tudominio.com/catalog/install/install.php debe ser la direccion que tengas, tanto si es de pago como un hosting gratuito la parte en negrita es la que debes agregar a la direccion que te hayan asignado o tengas de tu cuenta.
[Con esto comienza la instalacion, con los archivos que hay en esa carpeta install ]
http://usuarios.lycos.es/creacionwebphp/index.php?option=com_docman&task=doc_view&gid=3 (5 de 12)04/10/2005 22:08:42
Instalacion de oscomerce en un servidor en internet
Os saldra una ventana New Installation
Deja marcadas las dos casillas, si no lo estan marcalas. Pulsa en el boton Continue
6. la siguiente ventana, Database Import
En esta ventana debes intrucir varios datos de configuracion de tu pagina: Estos datos tienes que tenerlos en el panel de control de tu web, en los datos de conexion MySQL o de la base de datos. Puede que te enviaran un correo al dar el alta de la pagina web y te los pusieran tambien. Los nombres puede que no coincidan pero lo que quieren decir es lo siguiente: database server: Servidor de la base de datos, es la direccion donde se encuentra la base de datos en ese servidor, dependera de cada servidor, normalmente se pone localhost
http://usuarios.lycos.es/creacionwebphp/index.php?option=com_docman&task=doc_view&gid=3 (6 de 12)04/10/2005 22:08:42
Instalacion de oscomerce en un servidor en internet
pero el servidor en el que esta puede tener otra tipo mysql.tuservidor.com Localhost suele ser en la mayoria de los casos. username: este es el nombre de usuario de la cuenta que hayas creado, si no te especificado uno preciso como nombre de la base de datos. password: hay que no tienen contrase単a y otros que si, si te pidieron que la crearas escribe aqui entonces la contrase単a que creaste para la base de datos. Database name: Aqui va el nombre de la base de datos Persistent Connections: deja en blanco esta casilla Session Storage: Aqui debeis marcar donde quereis que se guarden los datos de las sesiones, si en un archivo o si en la base de datos, debeis escoger donde quereis
Tras esto pulsar en el boton Continuar
7. Errores: Si algo ha salido mal os dara un error:
pulsa entonces en el boton back y os devolvera a la ventana del punto anterior 6 - donde debeis corregir si ha habido algun error tras eso pulsar denuevo en el boton Continuar
http://usuarios.lycos.es/creacionwebphp/index.php?option=com_docman&task=doc_view&gid=3 (7 de 12)04/10/2005 22:08:42
Instalacion de oscomerce en un servidor en internet
8. Si todo ha ido bien y a importado la base de datos bien entonces os aparecera otra ventana:
Pulsar en el boton Continuar si todo ha ido bien saldra la ventana de instalacion correcta / successful
9. Os tendra que salir otra ventana de configuracion web server information: www Adress : http://www.tudominio.com/catalog/ Webserver Root Directory: /home/.../tunombreusuario/catalog/ <---- esto es la direccion real de tu pagina web, en el panel de configuracion debe de ponerte esta direccion
http://usuarios.lycos.es/creacionwebphp/index.php?option=com_docman&task=doc_view&gid=3 (8 de 12)04/10/2005 22:08:42
Instalacion de oscomerce en un servidor en internet
HTTP Cookie Domain: esta es la direccion normal de tu web sin el /catalog/ HTTP Cookie Path: /catalog/ Enable SSL Connections: deja en blanco esta casilla, a menos que sepas el uso y la quieras activar.
[ Puede que tras esto salga otra vez alguna de las ventanas anteriores, si es asi, simplemente pulsar en continuar si todo esta bien o si solo es para que confirmes los datos, o puede que salga la ventana final de todo instalado ]
10. Te saldra una ventana con dos botones Catalog y Admin Tools
Si pulsas en Catalog abrira una ventana donde aparecera ya la tienda montada de oscommerce Si pulsas en Admin Tools te saldra que debes borrar la carpeta Install del directorio catalog/install y todo su contenido antes de continuar, como requisito de seguridad Mediante el programa FTP borras todo el contenido de esa carpeta Install que esta en: catalog/install y tambien borras esa carpeta, no borres otra cosa.
Y ahora prueba a entrar en Admin Tools y ya podras entrar en la parte de administracion de tu web.
Las dos direcciones para hacerlo luego son: www.tudominio.com/catalog el catalogo de la tienda tal como lo veran los visitantes de la web www.tudominio.com/catalog/admin donde esta toda la administracion de tu web, donde se a単ade mas productos, se modifican, ....
Los siguientes pasos debes realizarlos tambien:
http://usuarios.lycos.es/creacionwebphp/index.php?option=com_docman&task=doc_view&gid=3 (9 de 12)04/10/2005 22:08:42
Instalacion de oscomerce en un servidor en internet
Tras esto comieza la post-instalación los cambios necesarios tras la instalación
Antes de hacer nada debes proteger con contraseña la carpeta admin (de la administracion) Sobre esto pusimos una respuesta en el foro de soporte en español de oscommerce, si teneis alguna duda podeis pasaros por el en la direccion: http://oscommerce.qadram.com/modules.php?name=Forums&file=viewtopic&t=7492 Para que no acceda nadie mas salvo el que tenga el nombre de usario y contraseña, se realiza del modo siguiente: 1. Primero debes elegir un nombre de usuario y una contraseña, y anotarlos bien o recordarlos. La contraseña de por lo menos ocho digitos, numeros y letras intercalados 2. Despues la contraseña tiene que encriptarse hay varios metodos para hacerlo, uno sencillo es el siguiente: hay paginas que hacen esto o que crean lo que se llama el contenido del archivo .htpasswd, como por ejemplo: http://www.flash.net/cgi-bin/pw.pl (o puedes buscar otras en google con la busqueda .htpasswd content generator) Al entrar en esa pagina, te saldra dos casillas para rellenar, una para el username o nombre de usuario que has escogido, y otra para la contraseña que quieres encriptar, anota o recuerda bien esos dos datos para poder entrar luego en tu admin. una vez que escribas los dos pulsa en el boton Encript eso generará una pagina en la que aparecera una linea en la que esta el nombre de usuario que elegiste y dos puntos y un grupo de numeros y letras que son la contraseña encriptada sera algo asi: juan:Di2fsdU6Wer7gh solamente esa linea tal como se ve ahi es la que debe ir en un archivo que se llamara .htpasswd para crear ese archivo puedes hacerlo con dreamweaver o con otro editor de codigo que tengas, creas una pagina nueva por ejemplo con el dreamweaver y borras el contenido del codigo para que no haya nada y esa linea la copias y la pegas ahi quedando en ese archivo solo como en el ejemplo de arriba: juan:Di2fsdU6Wer7gh luego grabas el archivo en tu ordenador, con el nombre htpasswd.txt fijate que debes grabarlo con ese nombre htpasswd.txt, con esa extension y sin el punto inicial (esto es porque debes subirlo al final cuando te explique ahora, mediante FTP con ese nombre y luego renonbrarlo en el servidor pero eso vendra ahora) Ya tienes creado ese archivo 3. ahora viene el contenido para el archivo .htaccess que es donde se pide que solicite un nombre de usuario y contraseña al entrar a una carpeta y en caso de no darlo o dar otro por error no deja ver nada del contenido Dentro de la carpeta admin debe haber un archivo con ese nombre, con lo que debes abrirlo y veras que ya tiene contenido, por lo que no debes borrar nada sino añadir lo siguiente que se dira aqui. Hay distintas formas de hacer una llamada a solicitar usuario y contraseña, aqui dire una que funciona perfectamente pero puedes encontrar mas en google buscando o bien en la pagina de Apache: http://httpd.apache.org/docs/2.0/es/howto/auth.html Una forma de hacerlo es la siguiente: Lo abres con Dreamweaver y al final del contenido que tenga escribiras lo siguiente, antes que nada decir que en la primera linea donde comienza lo que debes poner aparece lo siguiente: AuthUserFile y lo de despues es la direccion real de la pagina web, ya sabeis no la www.tudominio.com sino la direccion real del servidor mas la carpeta que queremos proteger, sera algo asi: home/.../nombredeusuario/ htdocs/catalog/admin/.htpasswd <--- en caso del oscommerce y si es la carpeta admin ese es el ejemplo
http://usuarios.lycos.es/creacionwebphp/index.php?option=com_docman&task=doc_view&gid=3 (10 de 12)04/10/2005 22:08:42
Instalacion de oscomerce en un servidor en internet
si no la sabeis en el panel de control de vuestro web seguramente estara la informacion o incluso en oscommerce en el menu Herramientas, seleccionando en el submenu Archivos, os sale los archivos y en la parte superior pone esa direccion real del servidor. lo que debeis añadir a ese archivo .htaccess es lo siguiente: AuthUserFile /data/members/...........estoestudireccionreal completa..../htdocs/catalog/admin/.htpasswd AuthGroupFile /dev/null AuthName ByPassword AuthType Basic <Limit GET POST> require valid-user </Limit> En AuthuserFile borra la direccion que yo he puesto ahi y pon tu direccion completa real mas la carpeta a proteger mas /.htpasswd En el caso de querer proteger la carpeta del admin en oscommerce seria: direccion real mas catalog/ admin/.htpasswd Eso hace una llamada al otro archivo donde estaba el nombre de usuario que elegiste y la contraseña encriptada. Ya añadido eso grabas el archivo, si lo has bajado con FTP lo grabas igualmente con la misma extension que el otro, seria: htaccess.txt sin el punto delante recuerda. 4. Ahora los dos los subes mediante FTP con el FileZilla o cute_FTP o el programa que tengas de FTP 5. Y una vez en el servidor los renombras: htaccess.txt -----> a ---> .htaccess htpasswd.txt ------> a ---> .htpasswd
y ya esta hecho
Ahora prueba en tu navegador a entrar en esa carpeta que has protegido, sera algo asi: http://www.tudominio.com/catalog/admin/ y te saldra una ventana pequeña en ella debes poner el nombre de usuario en la casilla que corresponde y la contraseña que habias elegido al principio en la casilla de contraseña y podras entrar ( no vayas a poner la contraseña encriptada en la casilla de la contraseña, eso es una medida de seguridad solo para ponerla en el fichero, escribe en la casilla de la contraseña la que elegiste en principio.)
Errores que aparecen tras instalar osCommerce Normalmente tras la instalacion salen tres advertencias en la parte superior Error o warning: Advertencia: El directorio de instalación existe en: /home/...../nombre/catalog/install. Por razones de seguridad, elimine este directorio completamente. debes borrar la carpeta install, su contenido y la carpeta esa. A esto ya se hacia referencia antes.
http://usuarios.lycos.es/creacionwebphp/index.php?option=com_docman&task=doc_view&gid=3 (11 de 12)04/10/2005 22:08:42
Instalacion de oscomerce en un servidor en internet
Error o warning: Una segunda advertencia: Reset the permissions on catalog/includes/configure. php to 644 (if you are still getting the warning message at the top of the page after setting this configure.php files to 644 then set the catalog/includes/configure.php file to 444 which is read only this happens on some servers that have been updated for security reasons). ESTO SE REFIERE QUE SI SALE ESTA ADVERTENCIA: Advertencia: Puedo escribir en el fichero de configuraci贸n: /data/......../includes/configure.php. En determinadas circunstancias esto puede suponer un riesgo - por favor corriga los permisos de este fichero Y ESTA A 644 ENTONCES PONER A 444 Lo que debeis hacer es mediante FTP poner los permisos de ese archivo configure.php en 644 y actualizar esa pagina, y si sige dando el error entonces poner los permisos de ese archivo en 444 que seria solo lectura [ esto es debido a que al instalar esta escribible ese archivo para que se guarden ahi todos los datos de configuracion, pero al finalizar se debe poner solo otra vez para lectura ]
Lo siguiente que se debe hacer tambien es: poner los permisos de la carpeta catalog/images en 777 y los de la carpeta admin/images/graphs en 777
Si os da otro error como este: Advertencia: El directorio para guardar datos de sesi贸n no existe: /tmp. Las sesiones no funcionar谩n hasta que no se corriga este error. entonces debeis crear una carpeta llamada backups dentro de la carpeta admin y ponerle de permisos 777 (a esto se hacia referencia antes en el tutorial por lo que seguramente no os aparecera ese aviso ahora)
Finaliza la instalaci贸n
ACTUALIZACIONES DE ESTE TUTORIAL: 04/10/05 Se crea esta guia por nicko107 para http://usuarios.lycos.es/creacionwebphp/
http://usuarios.lycos.es/creacionwebphp/index.php?option=com_docman&task=doc_view&gid=3 (12 de 12)04/10/2005 22:08:42