> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Risoluzione dei problemi: Upcart non si apre o reindirizza alla pagina del carrello

> Guida alla risoluzione dei problemi del cart drawer in Upcart, tra cui il drawer che non si apre, il reindirizzamento alla pagina del carrello, due carrelli che appaiono contemporaneamente, il carrello che non si carica o Upcart che non risponde quando si aggiungono articoli al carrello.

Se Upcart non si apre quando i clienti aggiungono articoli al carrello, si apre e poi reindirizza alla pagina del carrello, appare un carrello doppio o non ne appare nessuno, questa guida ti aiuterà a identificare e risolvere il problema.

<div id="what-are-you-experiencing">
  ## Che problema stai riscontrando?
</div>

Parti da qui per andare direttamente alla soluzione giusta:

* [**Upcart si apre brevemente, poi reindirizza alla pagina del carrello**](#issue-1--2-upcart-redirecting-to-the-cart-page)
* [**I clienti vengono portati direttamente alla pagina del carrello invece di vedere Upcart**](#issue-1--2-upcart-redirecting-to-the-cart-page)
* [**Appaiono due carrelli contemporaneamente (Upcart e il carrello del tema)**](#3-change-theme-cart-type-to-page)
* [**Upcart non si apre affatto**](#issue-4-upcart-is-not-opening-at-all)

Non sai quale caso si applica? Parti dal [Passaggio 1](#step-1-make-sure-upcart-is-fully-active) per confermare che Upcart sia completamente attivo prima di approfondire un problema specifico.

La maggior parte dei problemi con il cart drawer di Upcart è causata da:

* Upcart non completamente attivato
* Impostazioni del carrello del tema in conflitto con Upcart
* Configurazione di Enhanced AJAX API Compatibility
* App di terze parti che sovrascrivono il comportamento del carrello
* Cart drawer del tema in conflitto con Upcart

Segui i passaggi qui sotto in ordine e fai un test dopo ogni modifica.

***

<div id="step-1-make-sure-upcart-is-fully-active">
  ## Passaggio 1: assicurati che Upcart sia completamente attivo
</div>

Prima di risolvere qualsiasi altra cosa, verifica che Upcart sia correttamente abilitato.

<div id="1-ensure-the-cart-is-activated">
  ### 1. Assicurati che il carrello sia attivato
</div>

Se il carrello è disattivato all'interno dell'editor di Upcart, non apparirà sul tuo storefront.

* Apri Upcart
* Vai su **Manage all carts**
* Verifica che il carrello sia pubblicato

<div id="2-enable-the-app-embed">
  ### 2. Attiva l'app embed
</div>

Se l'app embed è disattivato, Upcart non si caricherà.

* Vai su **Shopify Admin > Online Store > Themes > Customize**
* Apri **App Embeds**
* Attiva **Upcart**
* Salva

Testa il carrello dopo aver attivato queste impostazioni.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-activate-cart-app-embed.gif?s=244802191623615202cc95d61431de84" alt="Attivazione del carrello Upcart e abilitazione del suo app embed nell'admin Shopify" width="2044" height="1080" data-path="images/upcart/cart-not-opening-activate-cart-app-embed.gif" />

***

<div id="issue-1--2-upcart-redirecting-to-the-cart-page">
  ## Problemi 1 e 2: Upcart reindirizza alla pagina del carrello
</div>

Se Upcart si apre brevemente e poi reindirizza, o se i clienti vengono portati direttamente alla pagina del carrello, di solito la causa è una delle seguenti. Segui ogni passaggio e fai un test dopo ogni modifica.

<div id="1-check-checkout-button-setting-in-upcart">
  ### 1. Controlla l'impostazione del pulsante Checkout in Upcart
</div>

Se i clienti fanno clic su Checkout e vengono rimandati alla pagina del carrello:

1. Vai su **Upcart > Cart Editor > Settings > Cart settings**
2. Individua **"Go to cart page when pressing checkout button"**
3. **Disattivala**
4. Salva e testa

Quando è attiva, questa impostazione forza il pulsante di checkout a reindirizzare alla pagina del carrello invece di procedere al checkout.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-go-to-cart-page-setting.gif?s=96670b4dedac961d37c1e39b80caea4a" alt="Impostazioni del carrello Upcart con evidenziata l'opzione Go to cart page when pressing checkout" width="1180" height="1080" data-path="images/upcart/cart-not-opening-go-to-cart-page-setting.gif" />

<div id="2-check-enhanced-ajax-api-compatibility">
  ### 2. Controlla Enhanced AJAX API Compatibility
</div>

Vai su **Upcart > Cart Editor > Settings > Cart settings**, espandi **Advanced Settings** e individua **Enhanced AJAX API Compatibility**.

Questa impostazione cambia il modo in cui Upcart gestisce gli eventi Add to Cart:

* **Disattivata (consigliata per la maggior parte degli store)** - Upcart intercetta le chiamate Add to Cart e previene i reindirizzamenti
* **Attivata** - Upcart smette di intercettare le chiamate Add to Cart, consentendo ad altre app di controllare il comportamento del carrello, inclusi i reindirizzamenti

Questa impostazione è **disattivata per impostazione predefinita**. Attivala SOLO se il tuo store usa un'API AJAX del carrello non standard e Upcart non sta intercettando gli eventi di aggiunta al carrello. Se l'attivazione di questa impostazione causa reindirizzamenti, disattivala e usa invece l'API manuale di Upcart (`upcartRegisterAddToCart`).

Per una guida completa, consulta [Enhanced AJAX API Compatibility](/it/upcart/enhanced_ajax_api_compatibility).

<img src="https://mintcdn.com/aftersell/Dz_83h-jRD2tmZWk/images/upcart/cart-not-opening-enhanced-ajax-api-compatibility.gif?s=7c3a3fc600bca7b421d57241bb740a78" alt="L'impostazione Enhanced Ajax API compatibility e la sua descrizione in Upcart" width="2084" height="1080" data-path="images/upcart/cart-not-opening-enhanced-ajax-api-compatibility.gif" />

<div id="3-change-theme-cart-type-to-page">
  ### 3. Cambia il tipo di carrello del tema in "Page"
</div>

Il cart drawer o popup del tuo tema potrebbe sovrascrivere Upcart.

1. Vai su **Shopify Admin > Online Store > Themes**
2. Fai clic su **Customize**
3. Apri **Theme Settings > Cart**
4. Cambia **Cart Type** in **Page**
5. Salva e testa

Impostare il carrello su "Page" impedisce che il drawer nativo del tema si apra al posto di Upcart.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-type-theme-editor-settings-option.gif?s=81eef4e6af5190720b3eb86be578c605" alt="Impostazione del Cart type del tema su Page nelle impostazioni del tema Shopify" width="644" height="1080" data-path="images/upcart/cart-type-theme-editor-settings-option.gif" />

<Note>
  Se il tuo tema non include un'impostazione "Cart Type" (o equivalente), contatta lo sviluppatore del tema per individuare o aggiungere l'opzione corretta. Upcart non può modificare direttamente le impostazioni del tema.
</Note>

<div id="4-disable-theme-cart-redirect-settings">
  ### 4. Disattiva le impostazioni di reindirizzamento al carrello del tema
</div>

Alcuni temi reindirizzano automaticamente i clienti alla pagina del carrello dopo l'aggiunta di un prodotto, bypassando completamente Upcart.

1. Vai su **Shopify Admin > Online Store > Themes > Customize**
2. Apri **Theme Settings > Products** (o Cart)
3. Cerca impostazioni come:
   * Enable cart redirection
   * Redirect to cart after add
   * Go to cart after add
4. **Disattivale**, salva e testa

<div id="5-check-for-conflicts-with-other-apps">
  ### 5. Verifica i conflitti con altre app
</div>

Molte app di terze parti sovrascrivono il comportamento del carrello. Apri le impostazioni di qualsiasi app relativa al carrello e cerca opzioni come:

* Redirect to cart
* Go to cart after add
* Automatically open cart page
* Action after product is added

Impostale su **Stay on page** o **Do nothing** e testa dopo ogni modifica.

**Soluzioni comuni specifiche per app:**

* **Globo Product Options** - Disattiva "Redirect to the shopping cart page after adding a product"
* **Zepto Product Personalizer** - Vai su Zepto > Settings > Add to Cart Settings e cambia "Action after a product is added to the cart" in "Stay on the product page and show a success message"
* **PageFly** - Disattiva qualsiasi regola di reindirizzamento al carrello nelle impostazioni di PageFly
* **Replo** - Modifica le impostazioni "go to page" per consentire l'apertura del cart drawer

Se non sai quale app stia causando il conflitto, disattiva le app relative al carrello una alla volta e testa dopo ognuna finché Upcart non inizia a funzionare.

***

<div id="issue-4-upcart-is-not-opening-at-all">
  ## Problema 4: Upcart non si apre affatto
</div>

Se non succede nulla quando i clienti aggiungono al carrello o fanno clic sull'icona del carrello, di solito la causa è un conflitto con il tema oppure Upcart che non rileva i pulsanti corretti.

<div id="disable-themes-native-cart-drawer">
  ### Disattiva il cart drawer nativo del tema
</div>

1. Vai su **Shopify Admin > Online Store > Themes > Customize**
2. Apri **Theme Settings > Cart**
3. Imposta il tipo di carrello su **Page**
4. Salva

Assicurati che le modalità Drawer o Popup siano disattivate.

<div id="upcart-not-detecting-your-buttons">
  ### Upcart non rileva i tuoi pulsanti?
</div>

Alcuni temi usano codice personalizzato che impedisce a Upcart di rilevare automaticamente il pulsante Add to Cart o l'icona del carrello. In tal caso, puoi specificare manualmente i selettori dei pulsanti.

**Passaggio 1: trova il nome della classe**

1. Apri il tuo store in **Google Chrome**
2. Fai clic con il tasto destro sul **pulsante Add to Cart** o sull'**icona del carrello**
3. Fai clic su **Inspect**
4. Nel codice evidenziato, cerca qualcosa come:

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
class="icon icon-cart"
```

oppure

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
class="product-form__submit button"
```

Copia solo **un nome di classe** (per esempio: `icon-cart`). Non copiare `class=` né le virgolette.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-devtools-find-class.gif?s=1899e34961f704c4e9919620e3159376" alt="Ispezione dell'icona del carrello nei DevTools di Chrome per trovare il nome della sua classe" width="1600" height="1080" data-path="images/upcart/cart-not-opening-devtools-find-class.gif" />

**Passaggio 2: aggiungilo in Upcart**

Devi aggiungere un **punto (.)** prima del nome della classe quando lo inserisci in Upcart. Per esempio: `.icon-cart`

1. Apri **Upcart**
2. Vai su **Cart Editor > Settings > Cart settings**, poi espandi **Advanced Settings**
3. Trova il gruppo di selettori di cui hai bisogno:
   * **Open cart button selector** — per l'icona del carrello
   * **Add to cart button selector** — per il pulsante di aggiunta al carrello
4. Nel menu a discesa **Options** di quel gruppo, scegli **Add additional selector** (mantiene il rilevamento di Upcart e aggiunge il tuo) o **Use custom selector** (solo il tuo). Il campo **Custom selector** rimane disabilitato finché è selezionato **Use default selector**.
5. Incolla `.icon-cart` in **Custom selector** e salva

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-custom-open-selector.gif?s=d437f6359066a7aa26467f85611f13d2" alt="Inserimento di un selettore personalizzato Open cart button nelle impostazioni avanzate di Upcart" width="1064" height="1080" data-path="images/upcart/cart-not-opening-custom-open-selector.gif" />

***

<div id="additional-troubleshooting">
  ## Ulteriore risoluzione dei problemi
</div>

Se il problema persiste dopo aver seguito i passaggi qui sopra, prova quanto segue uno alla volta, testando dopo ogni modifica.

<div id="toggle-shadow-dom-onoff">
  ### Attiva/disattiva Shadow DOM (ON/OFF)
</div>

In alcuni temi, l'impostazione Shadow DOM influisce sul modo in cui Upcart rileva pulsanti ed eventi del carrello.

1. Vai su **Upcart > Cart Editor > Settings > Cart settings**, poi espandi **Advanced Settings**
2. Individua **Render cart in shadow DOM**
3. Attivala, salva e testa
4. Disattivala, salva e testa di nuovo

Usa l'impostazione che produce un comportamento coerente.

<div id="toggle-ajax-setting-onoff">
  ### Attiva/disattiva l'impostazione AJAX (ON/OFF)
</div>

Alcuni store si comportano meglio invertendo la gestione AJAX, a seconda della configurazione di tema e app.

1. Vai su **Upcart > Cart Editor > Settings > Cart settings**, poi espandi **Advanced Settings**
2. Individua **Enhanced Ajax API compatibility**
3. Attivala, salva e testa
4. Disattivala, salva e testa di nuovo

Tieni presente che questa impostazione disattiva anche la gestione Add to Cart di Upcart, quindi se attivarla risolve il reindirizzamento vale la pena verificare che l'aggiunta al carrello si comporti ancora come previsto. Consulta [Enhanced Ajax API compatibility](/it/upcart/enhanced_ajax_api_compatibility).

<div id="clear-browser-cache">
  ### Svuota la cache del browser
</div>

Vecchi script memorizzati nella cache possono mantenere il comportamento precedente del carrello e impedire a Upcart di caricarsi correttamente.

1. Apri le impostazioni del browser
2. Vai su **Privacy & Security**
3. Seleziona **Clear Browsing Data**
4. Cancella immagini, file e cookie memorizzati nella cache
5. Aggiorna la pagina e testa

<div id="test-with-a-default-shopify-theme">
  ### Testa con un tema Shopify predefinito
</div>

1. Vai su **Shopify Admin > Online Store > Themes**
2. Aggiungi un tema gratuito come Dawn
3. Attivalo temporaneamente
4. Testa Upcart

Se Upcart funziona con Dawn, il problema è specifico del tuo tema personalizzato. Contatta lo sviluppatore del tema per assistenza.

<div id="disable-apps-one-by-one">
  ### Disattiva le app una per una
</div>

1. Vai su **Shopify Admin > Apps**
2. Disattiva un'app relativa al carrello alla volta
3. Testa dopo ognuna

Quando Upcart inizia a funzionare, hai identificato l'app in conflitto.

<div id="check-browser-console-for-errors">
  ### Controlla gli errori nella console del browser
</div>

1. Apri il tuo store
2. Premi **F12** (o tasto destro > Inspect)
3. Apri la scheda **Console**
4. Aggiungi un prodotto al carrello
5. Cerca errori, in particolare qualsiasi cosa relativa ad add.js o agli eventi del carrello
6. Fai uno screenshot degli errori da condividere con il supporto

***

<div id="when-to-contact-support">
  ## Quando contattare il supporto
</div>

Se hai completato tutti i passaggi e Upcart ancora non funziona, contatta il supporto fornendo:

* Nome e versione del tema
* Elenco delle app relative al carrello installate
* Screenshot degli errori della console
* Passaggi che hai già provato

Puoi contattare il supporto Upcart tramite la chat in-app o scrivendo a [support@upcart.app](mailto:support@upcart.app).
