Indice:

1. Prefazione
   
2. Requisiti di Sistema
3. Installazione
4. Configurazione
5. Verifica della configurazione
6. Verifica quali prodotti sono compatibili con Icecat
   
7. Scarica le foto ed inserisci i le descrizioni nel database
   
   
8. RISULTATO DI COMPILAZIONE DELLE SCHEDE
   

---

Prefazione:

• Cos'è IceCART:

• che vantaggi offre tale integrazione:

1. Il vostro sito diventerà senza alcun sforzo ricco di informazioni complete e dettagliate;
2. grazie ai prodotti correlati, i vostri clienti saranno guidati nella scelta degli accessori dell'articolo interessato;
   
3. il vostro sito sarà sicuramente meglio indicizzato dai vari motori di ricerca avendo una ricchezza tale di informazioni;
4. Avrete a disposizione ben 22 lingue con il quale affrontare le vendite anche al di fuori del vostro bacino di clientela nazionale.
   

ICEcart è in grado inoltre di interfacciarsi con "Tab Product PRO", per una organizzazione automatica in tab dei contenuti delle schede prodotto*

Requisiti di sistema:

Per effettuare l'installazione di IceCART, nella versione 4.0, è richiesto:

• ZenCART versione 1.3.8 o superiore intallata e configurata
  
• Server PHP 5 con mySQL
• Avere un accont presso Open Icecat o Full Icecat

* no versione FREE.

---

Installazione:

1. Prima di tutto esegui una copia di backup del sito e del Database
2. Estrai in una directory provvisioria il contenuto del file zippato contenente il modulo, mantenendo inalterata la struttura delle directory
3. Copia il contenuto della cartella Admin di IceCART all'interno della cartella di amministrazione di Zencart.
   
4. Copia la cartella Include di IceCART all'interno della cartella Zencart, dove già è presente una cartella Include.
   
5. A questo punto sono possibili due soluzioni equivalenti:
   
   
           Metodo A)
   Modificare il file /includes/template/nome_del_vostro_template_/Templates/tpl_product_info_display.php come segue:
   
1. Editare il file tpl_product_info_display.php
2. Cercate all'inizio del file il primo "?>"
3. Appena dopo inserire:
   
   <?php
   
   /* -----bof icecart related----*/
   require(DIR_WS_MODULES . 'related_icecat.php');
   $products_description = $products_description. get_related($_GET['products_id']);
   /* -----eof icecart related----*/
   ?>
   
4. Salvate il file così modificato
   
   
Metodo B) Copiare e sostituire il vostro template, con quello contenuto nel file zippato di IceCART, che si trova nella cartella:
          /includes/template/Your_Template_/Templates/tpl_product_info_display.phped
           Attenzione che il file va rinominato da .phped a .php




6. Copiare dall'archivio zippato i file iceCart.css nella directory radice di Zencart
7. Istallare la patch SQL install.php, contenuta nell'archivio, attraverso il pannello Strumenti di Zencart
8. L'intallazione è così conclusa.
   

---

Configurazione IceCart

A questo punto è necessario eseguire la configurazione del modulo attraverso il pannello apposito all'interno del menù configurzione di Zen Cart . (figura 1)

---

Verifica dell'Installazione di IceCART

Prima di cominciare con l'aggiornamento dei prodotti è necessario verificare la corretta configurazione del modulo e di Icecat.

Per fare questo, vai al menù Icecart di Zen Cart e seleziona la voce Icecart.

Premi il pulsante ESEGUI alla voce: Verifica la configurazione di Icecat
Se tutto è stato compilato correttamente dovrebbe apparire la scritta Icecat User configuration: OK (Fig.4)
In caso contrario sarà necessario verificare di aver inserito Username e Password di Icecat correttamente, Inoltre sarà necessario verificare di aver abilitato dal pannello di Icecat (http://icecat.it/it/menu/openicecat/index.htm) il catalogo XML settando correttamente l'indirizzo IP del proprio server web nella lista degli ip abilitati.

Verifica i tuoi prodotti

Una volta installato e configurato IceCART, si è pronti ad interfacciare il proprio shop Zen Cart con il database on line Open Icecat o Full Icecat


Da Zencart selezionare la voce IceCART all'interno del menù Strumenti.


Il primo passo da effettuare è l'associazione tra i vostri prodotti a catalogo e quelli presenti nel database di Icecat.
Questa operazione può essere fatta una volta al giorno per tutti i prodotti che avete a catalogo.
L'operazione processerà minimo 1, massimo 1000 prodotti simultaneamente (vedi configurazione Numero elaborazioni massime)  per ogni pressione del tasto ESEGUI sotto la voce Verifica i tuoi prodotti.
Per processare tutti i prodotti sarà quindi necessario premere più volte il testo ESEGUI.


Nella figura è visibile l'avanzamento del processo di Indicizzazione

E' possibile monitorare l'intero processo verificando i valori riportati nella parte alta del pannello di amministrazione (Fig.5)
Da qui possiamo vedere il totale prodotti da Verificare che dovrà essere a 0 per avere la certezza di aver Indicizzato tutti i prodotti; Il totale prodotti da Aggiornare che indicherà quali sono i prodotti associati al database di Icecat non ancora scaricati sul proprio sito; Il totale Prodotti Aggiornati che indicherà quanti prodotti del tuo sito sono stati aggiornati con le schede di Icecat.
   
                                                   Figura 5. Riepilogo Aggiornamento

NB.
Ogni 24 ore, il conteggio dei prodotti da verificare torna al valore massimo, questo permette di verificare la presenza di nuove schede per i prodotti non ancora aggiornati con le informazioni/foto di Icecat.

---

Scarica FOTO ed inserisci i dati nel DB

Attraverso questo tasto è possibile eseguire il download Automatico delle Foto, l'inserimento nel Database delle descrizioni, delle schede tecniche e dei prodotti correlati (prodotti correlati NON nella versione FULL)
Il processo effettuerà l'elaborazione di minimo 0, massimo 1000 prodotti alla volta secondo quanto impostato nella configurazione alla voce Numero elaborazioni massime. E' importante inserire un valore adeguato alle capacità del server per evitare, in caso di valori troppo elevati, il blocco dell'intera elaborazione.

      NOTA BENE: Il software procede ad inserire le descrizioni nel database indipendentemente dalla presenza di descrizioni già inserite manualmente.

Il software IceCART è compatibile con la plugin Tab Product PRO, per poter avere le schede descrittive dei prodotti, organizzate in Tab, con tutte le informazioni disponibili raggruppate e meglio consultabili.   


Premendo sul tasto Esegui relativo alla voce scarica FOTO ed inserisci i dati nel DB, potrete :

• Inserire le descrizioni degli articoli del vostro ecommerce
  
• Copiare in locale le immagini ed associarle al relativo prodotto venduto
• Creare la scheda tecnica ad importarla automaticamente nel database.
• Scaricare eventuali foto aggiuntive*
• Creare l'elenco dei prodotti correlati*
  
  * NON PRESENTE NELLA VERSIONE FULL

                                       Fig.6 Schermata Principale Gestione Download 

Il procedimento è molto semplice ed automatico: selezionando Start nella tabella di sinistra, il programma comincerà il download automatico di tutte le informazioni necessarie.
Nella tabella a destra viene mostrato un riepilogo che vi darà lo stato di avanzamento della procedura, e l'esito dell'aggiornamento prodotto per prodotto(dettaglio in Fig.7).

                                                         Figura 7. Dettaglio Aggiornamento

Attraverso questa schermata è possibile anche verificare eventuali anomalie presenti durante l'aggiornamento.
Tali anomalie verranno comunicate direttamente da Icecat e visualizzate in rosso affianco al codice del prodotto che le ha generate(Vedi fig. 8) senza però causare l'interruzzione dello script

                                            Figura 8. Dettaglio Errore Aggiornamento.


NB
Su alcuni piani di hosting l'avanzamento dell'aggiornamento non viene visualizzato in tempo reale ma solo alla fine dell'elaborazione. In questi casi consigliamo di ridurre il valore del Numero elaborazioni massime in modo da poter mantenere correttamente sotto controllo il processo.
     

---

Risultato di compilazione delle schede
Questi sono degli esempi di come le informazioni scaricate da Icecat e importate in Zencart, vengono visualizzate nella scheda descrittiva del prodotto.

Descrizione Breve descrizione con le caratteristiche principali del prodotto	Caratteristiche Tecniche Descrizione dettagliata con tutte le informazioni tecniche relative il prodotto.
Link Utili Link utili di vario genere, messi a disposizione dal produttore, recensioni, manuali d'uso, prove comparative, ...	Accessori Compatibili Elenco dei prodotti compatibili o accessori che sono presenti nello shop, e che potrebbero interessare per l'acquisto al visitatore.