Instalación

en PrestaShop:

Antes de instalar, ir a Back Office > Preferencias > Rendimiento y marcar "Forzar la compilación":

Después ir a Módulos > Añadir un módulo a partir de mi ordenador y subir directamente el archivo zip desde el pc usando la casilla derecha:


Se habrá instalado dentro de la sección "Pagos" de módulos:

Hacemos click en "Instalar" y cambiará su icono a amarillo. Si no se ve, volvemos a hacer click en "Instalar":

Ahora deberemos configurar el módulo haciendo click en "Configurar":

URL de llamada del entorno: https://tpv01.cajarural.com/nuevo_tpv/tpv/jsp/tpvjp_validaComercio.jsp
Clave secreta de encriptación (CIP): 111111111111 (para modo pruebas)
Nombre del comercio: Nombre de comercio que hay en RuralVia
Número de comercio (FUC): te lo facilita Ruralvia
Número de terminal: 001 (comprobar con tu banco por si varía)
Tipo de moneda EURO
Tipo de transacción : 0

SSL en URL de validación : marcar activado solo si usas SSL en tu web.
Activar los idiomas en el TPV: Activado


Tras ello, guardamos y el icono del módulo aparecerá por fin en color verde:




en Ruralvía:

en el Panel de RuralVia se deben completar los campos: (importante: si se tiene SSL en el website entonces usar "https://" ):

marcar URL + URL NOTIFICACION
URL: http://www.tutienda.com/modules/cajarural/respuesta_tpv.php
URL notificacion: http://www.tutienda.com/modules/cajarural/respuesta_tpv.php


En el panel de Ruralvia también se debe poner el CIP de modo pruebas (111111111111) y el de modo real una vez acabadas las pruebas. Se deben completar el resto de datos: emails, etc. Para hacer pruebas de compra en Ruralvia, usar esta tarjeta ficticia

TARJETAS PARA PRUEBAS:
Tarjeta: 4599830100592012
Fecha caducidad: 12/20
CVV: 111



Comprobar

Con un usario de pruebas, hacemos un pedido y al final del proceso veremos que el módulo aparecerá como forma de pago. Al hacer click saltaremos hacia la pasarela de Ruralvía:



Para acabar

- Una vez constatada que la instalación del módulo ha sido exitosa, se debe ir a Preferencias -> Rendimiento y desmarcar "Forzar la compilación". De lo contrario la reducción de velocidad es considerable.
- Cuando las pruebas de compra funcionen no hay razón para pensar que no funcionen también en modo real, así que podemos pedir el cambio a Ruralvía.
- Para pasar a modo real se ha de cambiar la clave secreta de encriptación (CIP) tanto en el módulo como en el panel de RuralVia, y sustituirla por  una cadena de números a voluntad.

- Se debe llamar siempre a Ruralvia para cambiar de pruebas a modo real, o a la inversa.



¿Problemas en la instalación? 

el módulo crea una carpeta /cajarural dentro de la carpeta /modules (ejemplo: /public_html/modules/cajarural). En caso de que tras seguir los pasos aquí descritos el módulo no se instale o no aparezca, hacer lo siguiente:

- ir a Back Office > Preferencias > Rendimiento y comprobar que la opción "Forzar la compilación" está activada. Reintentar la instalación.

- Comprobar en Herramientas -> Informaciones que todo salga en OK


- Si lo anterior no es la causa, entonces conectarse por FTP al website con un programa como Filezilla y eliminar cualquier carpeta llamada /cajarural o con un nombre muy similar que esté dentro de /modules. y reintentar la instalación




----------------------------------------------------------------------------------------------------------------------------------------------


Dificultades extra para la instalación de nuevos módulos: aplicando permisos

Este punto debe ignorarse si no se tienen algunos conocimientos, de lo contrario la tienda PrestaShop puede resultar dañada.

La carpeta /modules debe tener los permisos correctos y para ello miraremos siempre en Herramientas -> Informaciones que salga todo en "OK". Prestashop debe detectar siempre este asunto por lo que no haría falta más. Si no nos fiamos de la detección y queremos hacerlo manualmente, hemos de saber que en algunos servidores es necesario que los permisos de /modules sean 0707 o 0777, mientras que en otros servidores es suficiente con 0755 o 0705. Por motivos de seguridad estos permisos no deben nunca aplicarse recursivamente a todos los ficheros sino sólo a las subcarpetas dentro de /modules. 


En servidores Linux, se puede ejecutar un script semejante a éste (dependiendo del tipo de alojamiento y suponiendo que nuestra tienda está alojada en /home/midominio/public_html/ ) para corregir los permisos de toda la tienda (la carpeta de administración no está incluida):

#!/bin/bash 

#----------------------------------       

# configura permisos PrestaShop           
#----------------------------------       
# grabar como:  /home/midominio/permisos_tienda.sh 
# ejecutar:  sh /home/midominio/permisos_tienda.sh
# Empieza poniendo todo a 0705
chmod -R 0705 /home/midominio/public_html/*


# Aplicar a .htaccess y sitemap
chmod 0644 /home/midominio/public_html/.htaccess
chmod 0707 /home/midominio/public_html/sitemap.xml


# sólo carpetas NO RECURSIVO
chmod 0707 /home/midominio/public_html/config
chmod 0707 /home/midominio/public_html/upload
chmod 0707 /home/midominio/public_html/download
chmod 0707 /home/midominio/public_html/tools/smarty/compile
chmod 0707 /home/midominio/public_html/tools/smarty/cache
chmod 0707 /home/midominio/public_html/tools/smarty_v2/compile
chmod 0707 /home/midominio/public_html/tools/smarty_v2/cache
chmod 0707 /home/midominio/public_html/log


# RECURSIVO carpetas y subcarpetas pero NO FICHEROS
find /home/midominio/public_html/img -type d -exec chmod 0707 {} \;
find /home/midominio/public_html/mails -type d -exec chmod 0707 {} \;
find /home/midominio/public_html/modules -type d -exec chmod 0707 {} \;
find /home/midominio/public_html/themes/prestashop/lang -type d -exec chmod 0707 {} \;
find /home/midominio/public_html/themes/theme329/lang -type d -exec chmod 0707 {} \;
find /home/midominio/public_html/translations -type d -exec chmod 0707 {} \;





Los permisos iniciales pueden ser 0644 para más seguridad dependiendo del entorno de servidor, si bien seguramente disminuirá la velocidad. Quienes no tengan acceso a terminal pueden hacerlo manulamente usando un programa de FTP como Filezilla. 


No obstante, hay que insistir en que la sección de "Informaciones" siempre se debería quejar si los permisos no están bien puestos, por lo que es posible que el motivo no sea este. Si sale todo OK y no hay otros modulos con un nombre parecido a "cajarural" entonces todo está correcto y el módulo debería instalarse correctamente. Si todavía no puede instalarse cuando otros módulos si que se instalan, entonces tu versión de PrestaShop quizás no sea compatible; por favor deja un comentario en la sección de Comentarios.






_