Woocommerce
Indice:
Premessa
- Versioni di WooCommerce supportate: dalla 3.5 in poi (verificata fino alla 11.1.2)
- L'integrazione usa l'API REST WooCommerce v3 e l'API media di WordPress
- Il sito deve usare https://
- Plugin di sicurezza o firewall non devono bloccare le chiamate a /wp-json/
- Alcuni hosting (Apache in modalità CGI/FastCGI) scartano l'intestazione di autenticazione Authorization e il collegamento non funziona: in quel caso chiedi al tuo hosting di lasciarla passare (di solito con una regola nel file .htaccess)
- Quando verifichi le credenziali, SellRapido carica il proprio logo nella libreria media del sito per provare il caricamento delle immagini: è normale
WordPress precedente alla 5.6 (serve il plugin Application Passwords)
Per configurare il tuo sito WooCommerce in SellRapido segui questi passaggi:
Ottieni le chiavi di accesso da inserire in SellRapido (WordPress precedente alla 5.6)
1. Entra nel back office di WooCommerce e clicca su WooCommerce > Impostazioni > Avanzate > API REST > Aggiungi chiave

2. Inserisci:
- Descrizione: Sellrapido
- Utente: scegli lo user tra quelli disponibili
- Permessi: Leggi/Scrivi
Clicca su Genera chiave API.

3. Copia Chiave Utente e Utente nascosto. Queste chiavi andranno successivamente inserite su SellRapido per completare la configurazione.
Attenzione: se non incolli subito questi dati, dovrai generare nuovamente le chiavi, in quanto una volta usciti da questa maschera non saranno più visibili

4. Vai alla sezione Plugin e attiva il plugin Application Passwords

Il plugin è necessario per caricare immagini via API su Wordpress, dal momento che WooCommerce non permette di farlo.
5. Accedi alla sezione Utenti > Aggiungi Nuovo

Inserisci:
- Nome utente: Sellrapido
- Nome
- Cognome
- Sito web
- Lingua
- Password
Clicca su Aggiungi nuovo utente.

6. Copia la password generata in un qualsiasi documento di testo.
Attenzione: se non incolli subito questi dati, dovrai generare nuovamente la password, in quanto una volta usciti da questa maschera non sarà più visibile.
A questo punto avrai a disposizione tutte le credenziali da inserire all'interno di SellRapido.
Collega WooCommerce a SellRapido (WordPress precedente alla 5.6)
Dopo aver ottenuto le chiavi di accesso, segui questi passaggi per collegare il tuo account WooCommerce a SellRapido:
1. Accedi al tuo account SellRapido e vai su Impostazioni > Credenziali Marketplace > Woocommerce

2. Clicca sul segno "+" per aggiungere la credenziale.

3. Inserisci i dati dell'account WooCommerce:
- Website: url completo del sito
Nota: l'indirizzo inserito deve caricarsi nel browser "così come si trova", quindi se è presente il "www" questo deve rimanere
- Consumer Key: Chiave utente (vedi il punto 3 della sezione Ottieni le chiavi di accesso da inserire in SellRapido (WordPress precedente alla 5.6))
- Consumer Secret: Utente nascosto (vedi il punto 3 della sezione Ottieni le chiavi di accesso da inserire in SellRapido (WordPress precedente alla 5.6))
- Username
- Password
Clicca su Salva.

WordPress 5.6 o successivo
Per configurare il tuo sito WooCommerce in SellRapido segui questi passaggi:
Ottieni le chiavi di accesso da inserire in SellRapido (WordPress 5.6 o successivo)
1. Entra nel back office di WooCommerce e accedi alla sezione Utenti > Aggiungi

Inserisci:
- Ruolo: "Gestore negozio" oppure "Amministratore"
- Nickname: Sellrapido
- Nome pubblico da visualizzare: Sellrapido
- email: qualsiasi email

2. Scorri la pagina:
- Inserisci SellRapido nella sezione Aggiungi nuova password applicazione
- Clicca su Aggiungi una nuova password dell'applicazione

- Copia la password generata in un qualsiasi documento di testo.
Attenzione: se non incolli subito questi dati, dovrai generare nuovamente la password, in quanto una volta usciti da questa maschera non sarà più visibile.
3. Vai su WooCommerce > Impostazioni > Avanzate > API REST > Aggiungi chiave

4. Inserisci:
- Descrizione: Sellrapido
- Utente: scegli l'utente creato al punto 1
- Permessi: Leggi/Scrivi
Clicca su Genera chiave API.

5. Copia Chiave Utente e Utente nascosto. Queste chiavi andranno successivamente inserite su SellRapido per completare la configurazione.
Attenzione: se non incolli subito questi dati, dovrai generare nuovamente le chiavi, in quanto una volta usciti da questa maschera non saranno più visibili

Nota: il plugin "Application Passwords" non serve: da WordPress 5.6 le password applicazione sono già incluse
A questo punto avrai a disposizione tutte le credenziali da inserire all'interno di SellRapido.
Collega WooCommerce a SellRapido (WordPress 5.6 o successivo)
Dopo aver ottenuto le chiavi di accesso, segui questi passaggi per collegare il tuo account WooCommerce a SellRapido:
1. Accedi al tuo account SellRapido e vai su Impostazioni > Credenziali Marketplace > Woocommerce

2. Clicca sul segno "+" per aggiungere la credenziale.

3. Inserisci i dati dell'account WooCommerce:
- Website: url completo del sito
Nota: l'indirizzo inserito deve caricarsi nel browser "così come si trova", quindi se è presente il "www" questo deve rimanere
- Consumer Key: Chiave utente (vedi il punto 5 della sezione Ottieni le chiavi di accesso da inserire in SellRapido)
- Consumer Secret: Utente nascosto (vedi il punto 5 della sezione Ottieni le chiavi di accesso da inserire in SellRapido)
- Nome Utente: Sellrapido
- Password: vedi il punto il 2 della sezione Ottieni le chiavi di accesso da inserire in SellRapido
Clicca su Salva.
