Τεκμηρίωση / Shopify

Τι χρειάζεται το Pico

Το Pico χρησιμοποιεί το GraphQL Admin API του Shopify για συγχρονισμό καταλόγου και theme app embed για το widget. Τα Admin API tokens δεν εμφανίζονται ποτέ στον browser.

Εγκατάσταση και εξουσιοδότηση στο Pico

1. 1
   Ανοίξτε τις Ενσωματώσεις

   Στο dashboard του Pico ανοίξτε Integrations και πατήστε Connect Shopify.

2. 2
   Εισάγετε το domain

   Χρησιμοποιήστε το κανονικό *.myshopify.com (π.χ. acme.myshopify.com).

3. 3
   Εγκρίνετε scopes στο Shopify

   Το Shopify ζητά πρόσβαση ανάγνωσης καταλόγου. Το Pico αποθηκεύει το token κρυπτογραφημένο και δεν το εμφανίζει ξανά.

4. 4
   Επιστροφή στο onboarding

   Μετά την έγκριση επιστρέφετε στο Pico με κατάσταση σύνδεσης και βήματα. Η σύνδεση δεν σημαίνει ότι ο συγχρονισμός ολοκληρώθηκε.

Συγχρονισμός καταλόγου

1. 1
   Ο αρχικός συγχρονισμός μπαίνει στην ουρά αυτόματα

   Μετά την επιτυχή εγκατάσταση το Pico προγραμματίζει συγχρονισμό. Παρακολουθήστε την πρόοδο στο Catalog.

2. 2
   Ελέγξτε προϊόντα

   Επιβεβαιώστε τίτλους, εικόνες, τιμές, παραλλαγές και URLs σε δείγμα προϊόντων.

3. 3
   Επανάληψη αν χρειαστεί

   Αποτυχημένοι συγχρονισμοί μπορούν να επαναληφθούν από το Catalog. Προσωρινά rate limits επαναλαμβάνονται με backoff.

Ενεργοποίηση theme app embed

Το Pico διατίθεται ως Shopify theme app embed (πλωτός βοηθός). Οι έμποροι το ενεργοποιούν στο Theme Editor—χωρίς χειροκίνητες αλλαγές Liquid.

1. Στις Ενσωματώσεις Pico ανοίξτε τον σύνδεσμο Theme Editor (ή Theme Editor → App embeds).
2. Ενεργοποιήστε το Pico Assistant.
3. Επικολλήστε το public widget ID (ξεκινά με pw_) και το Pico API base URL στις ρυθμίσεις embed.
4. Αποθηκεύστε, ανοίξτε το storefront και επιβεβαιώστε ότι το widget φορτώνει μία φορά.

<script
  src="https://YOUR_PICO_API_HOST/pico-widget.js"
  data-public-widget-id="pw_..."
  data-api-url="https://YOUR_PICO_API_HOST/api/v1"
  defer
></script>

Στο Online Store το add-to-cart χρησιμοποιεί το Ajax cart του Shopify ώστε το καλάθι να μένει συγχρονισμένο. Προτιμήστε το theme app embed αντί να επικολλήσετε το script χειροκίνητα.

Γλώσσες αυτού του οδηγού

Αυτός ο οδηγός ρύθμισης για εμπόρους είναι διαθέσιμος σε όλες τις γλώσσες του site Pico. Χρησιμοποιήστε τον επιλογέα γλώσσας στην κεφαλίδα.

Γλώσσες widget βοηθού

Το shopper-facing Pico assistant υποστηρίζει προς το παρόν αυτά τα locale packs. Ορίστε την προεπιλογή στις ρυθμίσεις Assistant.

API (headless)

Τα καταστήματα Shopify δημιουργούνται μέσω OAuth, όχι με POST /stores και credentials. Τυπική ροή:

POST /api/v1/integrations/shopify/install
{ "shop": "your-store.myshopify.com" }

# Follow authorize_url, then Shopify redirects to the Pico callback.
GET /api/v1/integrations/shopify/{storeId}/status
POST /api/v1/stores/{storeId}/test
POST /api/v1/catalog/{storeId}/sync

Όρια MVP

• Υποστηρίζονται συγχρονισμός καταλόγου, τεκμηριωμένη αναζήτηση, επιλογή παραλλαγής και add-to-cart.
• Χωρίς checkout extensions, εκπτώσεις ή APIs παραγγελιών/πελατών σε αυτόν τον οδηγό.
• Το Pico δεν γράφει δεδομένα προϊόντων πίσω στο Shopify.
• App Store listing και Shopify Billing είναι ξεχωριστά βήματα κυκλοφορίας.

Επίσημες αναφορές Shopify

Επαληθεύστε auth, scopes και theme extension στα docs του Shopify:

• Authorization code grant (standalone apps)
• Theme app extensions
• GraphQL Admin API

← Πίσω στην επισκόπηση τεκμηρίωσης