Introduzione

L'editoria ha fatto passi da gigante dalla vendita dei libri di carta ai libri elettronici ed oggi con l'avvento dei "readers" e l'abbassamento dei costi di tali tecnologie si prevede il sopravvento di un nuovo modo di leggere i libri che non soppianterà il vecchio ma lo affiancherà.

Diverse editorie in Italia si stanno aggiornando offrendo oltre la copia cartacea anche l'alternativa del formato elettronico più facile da gestire e meno ingombrante, problema noto per chi ama leggere decine di libri ogni anno.

Uno dei maggiori distributori in Italia di eBooks è Stealth con il suo servizio Simplicissimus che offre a tutti gli editori di poter aderire senza alcun costo fisso (né di ingresso, né ricorrente) ma con l’unico costo da sostenere del 5% delle vendite effettuate.

Inoltre il servizio Simplicissimus offre alle librerie online la possibilità di connettere il proprio negozio direttamente al servizio scaricando i cataloghi aggiornati e sincronizzare gli ordini di vendita effettuati nel proprio negozio on line.

Vendere i libri on line mantenendo aggiornato il proprio catalogo adesso è molto più semplice utilizzando Magento ed il modulo di sincronizzazione adatto per la connessione fra Magento e Simplicissimus. Il modulo si installa seguendo i passi indicati nella seguente guida.

Installazione del modulo Shine Simplicissimus

Requisiti

- Connessione ssh
- Hosting Certificato Magento
- Magento Ultima Versione

Setup del modulo

1. Caricare il pacchetto contenuto nella cartella Magento nella root del negozio Magento
2. Caricare la cartella Simplicissimus 2.0 nella root del negozio Magento e rinominarlo in simplicissimus
3. Disabilitare la cache di Magento dal pannello di controllo
4. Impostare i permessi 777 a tutti i files e cartelle temporaneamente
5. Accedere all'area amministrativa
6. Fare click su Sistema > Configurazione > Shine Software > Simplicissimus Stealth
7. Impostare le credenziali ed il campo Active su YES
7.1 - Per la fase di test bisogna impostare il campo Endpoint con questo url: http://sandbox.webservice.stealth.simplicissimus.it/stealthimport.asmx?WSDL
7.2 - Per la pubblicazione ufficiale del servizio richiedere il link alla Simplicissimus
8. Salvare la configurazione
9. Sezione amministrativa di Magento: accedere alla sezione Sistema > Configurazione > Avanzate > LOG Settings > Enabled = YES
10. Sezione amministrativa di Magento: disabilitare le scorte di Magazzino. Sistema > Configurazione > Inventario > Opzioni Scorte Prodotto > Gestione Scorte = NO

Permessi dei files e delle cartelle

Impostare i permessi in scrittura per la cartella "simplicissimus" e sottocartelle.

IMPORTAZIONE TEST - MODALITA' COMPLETA

Dopo aver impostato le credenziali di accesso al database di Magento e le credenziali di accesso al sistema Simplicissimus bisogna accedere via SSH alla shell di sistema offerta dal vostro provider.
Al primo avvio del modulo verranno scaricati tutti i libri e tutte le copertine all'interno della cartella covers presente dentro la cartella del modulo "simplicissimus".

Ecco ciò che vi apparirà se avete seguito tutti i passi correttamente e se i requisiti sono stati rispettati. Accedete via shell linux nel vostro profilo web.
Accedete alla cartella simplicissimus digitando:

cd simplicissimus [INVIO]

website/simplicissimus$ ./run.sh [INVIO]

Magento Importer v.1.0
========================================
The process will take some time. Please be patient.
Date: 12-11-2011 19:09:47
Download Covers ... please wait.
Save: Metropolis
Category Fantascienza saved
---> Added to the categories: FICTION / Fantascienza / Generale
---> Added to the categories: FICTION / Generale
---> Add the image: 300.png
---> Product Saved: Metropolis
---> Process time spent: 3.9289000034332
---> Total time spent: 3.9289000034332
---> Record: 0

Save: Witch Wood
Category Religioso saved
---> Added to the categories: FICTION / Religioso
---> Added to the categories: FICTION / Romantico / Generale
---> Added to the categories: FICTION / Generale
---> Add the image: 362.png
---> Product Saved: Witch Wood
---> Process time spent: 3.6676001548767
---> Total time spent: 7.5965001583099
---> Record: 1

Attendete lo scaricamento dei dati.
Il tempo necessario deve essere calcolato dalle impostazioni del server ed in base alla connessione internet offerta dal vostro provider di servizi.

Al termine dello scaricamento Magento ricreerà l'indice di tutti i dati all'interno del database.

Al termine delle operazioni indicate in precedenza accedete al vostro sito internet e noterete la lista delle categorie realizzate automaticamente dal modulo Simplicissimus della Shine Software con all'interno tutti gli eBooks.

TEST ACQUISTO

L'acquisto del libro avviene regolarmente sfogliando i prodotti dalla lista delle categorie realizzata automaticamente dal modulo di importazione e con la selezione del prodotto dalla scheda del prodotto nell'area pubblica di Magento.
Durante la fase di Test sono attivi esclusivamente i prodotti che hanno la possibilità di essere scaricati in ePUB. Qualsiasi altro formato non sarà accettato durante tale fase.

Ecco i passi che devono essere eseguiti:

- Inserire il prodotto nel carrello
- Registrarsi nel negozio
- Inserire un prodotto in carrello e scegliere nell'opzione PDF (solo durante la fase di test)
- Effettuare la procedura di Checkout
- Effettuare il pagamento
- Se il pagamento va a buon fine e Magento riceve il segnale di creare l'ordine.
- L'esercente emetterà la fattura manualmente. Il modulo intercetterà l'azione di creazione della fattura e creerà l'ordine presso i servers di Stealth recuperando i links di scaricamento degli ebook richiesti dall'utente ed invierà un'email al cliente con il link per il download degli ebooks acquistati.
- Il cliente riceverà le seguenti emails:
--> Email Ordine
--> Email Fattura con links per la richiesta degli ebooks
-----> Al click da parte del cliente sul link di richiesta presente nell'email della fattura, il cliente riceverà un'altra email personalizzabile attraverso l'uso delle emails per transazioni di Magento con i links dei libri acquistati.

MODALITA' PRODUZIONE

La modalità Produzione differisce dalla modalità test nelle seguenti sezioni:

- Link in area amministrativa Magento: Sistema > Configurazione > Shine Software > Simplicissimus Stealth:
---> Endpoint Products
---> Endpoint Orders

Assistenza Tecnica

Se si desidera assistenza tecnica il nostro team di supporto vi potrà configurare il modulo in uno dei nostri piani hosting certificati per Magento che vi offrirà il massimo delle prestazioni. Il modulo è stato testato in un'installazione standard di Magento con le condizioni richieste nei requisiti di funzionamento. L'installazione, la configurazione ed eventuali modifiche di comportamento, nonchè gli aggiornamenti non sono gratuiti.

Video Tutorials

Passo 1 - Configurazione base

 

Passo 2 - Importazione dati

 

Passo 3 - Acquisto eBooks



English Version

"Shine Simplicissimus" downloads the first time all the categories, ebooks, covers, it sets the product attributes for the new "ebook product" attribute set.

"Shine Simplicissimus" check all the aspects of selling the ebooks with the Stealth Webservice.

These are the steps:
- Add an ebook in the cart (Check of the availability using a Soap request)
- The client buys the ebooks selected using the normal onepage checkout
- Before to pay the module will re-checks the availability
- The client pays by the payment module that the administrator has set in the admin panel
- An order will be created in Magento
- "Shine Simplicissimus" waits the creation of the invoice (you can automate the process of the invoice creation)
- The invoice will be created by the system or by you.
- "Shine Simplicissimus" calls by a "soap call" to create the order in the Stealth company database
- Simplicissimus returns the OrderID.
- "Shine Simplicissimus" calls another "Soap method" to get the autorization ebooks links
- Magento sends the email to the customer with the invoice and the links to request the download links
- When the client clicks on that links he/she will receive an email with the definitive links for download the ebooks that will expire after few days (ask to stealth for the days)