Guida completa alla configurazione e utilizzo della funzionalità AI nel WooCommerce Support System Premium. Configurazione passo-passo, esempi pratici, personalizzazione avanzata e risoluzione problemi.
Documentation
Home >
Installation and Activation
Installation and Activation To use the Carte Cultura app in your Shopify store, you must first install it from the Shopify App Store and complete the initial authentication and setup. Install from the Shopify App Store Log in to your Shopify admin panel. Navigate to...
Understanding the App Dashboard
Understanding the App Dashboard When you first open the Carte Cultura app, you land on the main dashboard. This page provides a comprehensive overview of your app's configuration and license status, allowing you to quickly see if everything is set up correctly for...
Managing Your Subscription and Billing
Managing Your Subscription and Billing Your subscription status for the Carte Cultura app is managed directly through your Shopify admin. The app uses Shopify's billing system to handle your plan, trial period, and payments. Viewing Your Current Plan and Status Your...
Configuring the App: Certificate and Mode
Configuring the App: Certificate and Mode To enable voucher validation, you must configure a digital certificate and choose the operating mode. The app uses a .pem certificate to securely communicate with the Carte Cultura (formerly 18app) ministerial platform....
Testing the Certificate Connection
Testing the Certificate Connection Before you can validate real Carte Cultura vouchers, you must test the connection between your Shopify store and the Ministry's API using your uploaded certificate. This built-in tool performs a dummy SOAP call to verify your...
Configuring Product Category Mappings
Configuring Product Category Mappings To enable voucher validation, you must map your Shopify product collections to the eligible cultural categories defined by the Ministry of Culture. This mapping tells the app which products in your store can be purchased with a...
Synchronizing Product Metafields
Synchronizing Product Metafields This feature allows you to manually trigger the synchronization of product metafields based on your configured category mappings. The synchronization process reads your saved mappings and applies the corresponding voucher category and...
Understanding the Automatic Discount
Understanding the Automatic Discount When you install the ilGhera Carte Cultura app, it automatically creates a special discount in your Shopify store called "Sconto Carte Cultura". This is not a regular discount code that customers enter; it is an Automatic Discount...
How the Checkout Widget Works
How the Checkout Widget Works The Carte Cultura app adds a custom widget to your Shopify checkout page. This is not a payment method, but a checkout extension that allows customers to enter their Carte Cultura voucher code to receive a discount on their order. Widget...
The Voucher Validation Process
The Voucher Validation Process The ilGhera Carte Cultura for Shopify app validates voucher codes through a two-step process that communicates directly with the Italian Ministry of Culture's official API. This process ensures the voucher is valid, has sufficient funds,...
Public API for Widget Status
Public API for Widget Status The app provides a public API endpoint that the checkout widget uses to determine if it should be displayed to the customer. This endpoint checks the app's configuration status for the specific shop. API Endpoint and Usage The public...
Public API for Voucher Validation
Public API for Voucher Validation The app provides a public API endpoint that is called by the checkout widget to validate Carte Cultura voucher codes. This endpoint performs the validation by communicating with the official Ministry of Culture SOAP service. Endpoint...
Handling Orders with Vouchers
Handling Orders with Vouchers When a customer successfully places an order using a Carte Cultura voucher, the app automatically confirms (consumes) the voucher with the Ministry's API. This process is handled by a dedicated webhook that triggers immediately after the...
Managing App Settings via Shopify Metafields
Managing App Settings via Shopify Metafields All configuration for the ilGhera Carte Cultura app is stored and managed using Shopify's private app metafields. This system ensures your settings are securely saved within your Shopify store and are automatically...
GDPR Compliance and Data Handling
GDPR Compliance and Data Handling The ilGhera Carte Cultura for Shopify app is designed to comply with GDPR requirements. It implements the mandatory Shopify webhooks for handling customer data requests and shop data redaction. The app is built to store minimal data,...
Uninstalling the App
Uninstalling the App When you uninstall the "ilGhera Carte Cultura for Shopify" app from your Shopify admin, the process is handled automatically by Shopify's platform and the app's mandatory webhooks. No manual cleanup is required from you. Automatic Session Cleanup...
Settings Page: Certificate and Sandbox
Settings Page: Certificate and Sandbox This page allows you to configure the certificate required to validate Carta del Docente vouchers and manage the sandbox mode for testing. Certificate Upload To use the app in production mode, you need to upload a valid .pem...
Dashboard Page and Configuration Status
Dashboard Page and Configuration Status The app’s main page shows the configuration status of the Carta del Docente service for your Shopify store. From here, you can check if the widget is ready to be used in the checkout. Widget Status The dashboard...
Subscription and Premium License Management
Subscription and Premium License Management The ilGhera Carta Docente for Shopify app offers a 7-day free trial period. At the end of this period, you must activate a paid subscription to continue using the voucher validation service. 7-Day Trial Period Upon...
Connection Test and Certificate Validity
Connection Test and Certificate Validity After uploading your .pem certificate to the app, it's crucial to verify its validity and ensure that the connection with the ministerial servers is working correctly. The app includes a dedicated test function for this...
Automatic Product Metafield Synchronization
Automatic Product Metafield Synchronization The automatic synchronization system is designed to fully automatically manage product eligibility for Carta del Docente vouchers. When you configure category mappings, the app automatically updates the metafields of all...
What the customer sees during checkout
What the customer sees during checkout When a customer arrives at your Shopify store's checkout page, they can use the Carta del Docente widget to pay with their voucher. Entering the voucher code On the checkout page, the customer will find a section dedicated to the...
Usage Scenarios and Troubleshooting
Usage Scenarios and Troubleshooting License Management and Automatic Protection The app includes an automatic protection system that manages active or expired license scenarios. Active License With a valid license entered, the "Carta del Docente" widget functions...
App Installation and Activation
App Installation and Activation To integrate the Carta del Docente service into your Shopify store, follow these steps to install and configure the app. 1. Install the app from the Shopify App Store Log in to your Shopify Admin. Go to the Apps and sales channels...
.pem Certificate Configuration (Production)
.pem Certificate Configuration (Production) To use the app in production mode and validate real Carta del Docente vouchers, you need to generate and upload a .pem certificate. This certificate is obtained from the official portal cartadeldocente.istruzione.it and is...
Activating and Using Sandbox Mode
Activating and Using Sandbox Mode Sandbox mode allows you to test the functionality of the Teacher's Card widget in your Shopify checkout without using a valid certificate issued by the Ministry. In this mode, the app uses a demo certificate and communicates with the...
Category-Collection Mapping Configuration
Category-Collection Mapping Configuration For the Carta del Docente discount to function correctly, you need to associate ministerial categories with your Shopify store's collections. This step is crucial as it determines which products in the cart are eligible for...
App Installation
App Installation Log in to your Shopify Partner Dashboard or your Shopify admin store. Go to the Apps section and search for “ilGhera Carta Docente for Shopify” in the Shopify App Store. Click the button to Add the app to your store. Authorize the app by...
Widget Configuration in Checkout
Widget Configuration in Checkout The app ilGhera Carta Docente for Shopify allows you to manually manage the visibility of the widget for voucher entry directly from your store's checkout settings. Enable or disable the widget manually For a better user experience, we...
Pre-purchase question?
If you have any doubt about how a plugin works and its functionalities ask us using this form