Shopify

Ai un magazin Shopify? Publică-ți blogul direct în secțiunea lui de Blog posts. Fiecare articol pe care îl publici aici devine un articol Shopify real, în tema ta, la adresele magazinului tău, cu titlul și descrierea SEO, cu imaginea reprezentativă și cu stilizarea lui. Articolele scrise de tine nu sunt atinse niciodată.

Livrarea în Shopify trage, nu împinge. Aplicația DailySmith interoghează același flux de sincronizare pe care îl folosește și plugin-ul de WordPress, cu cheia publică a site-ului tău, așa că nicio credențială Shopify nu părăsește contul magazinului și nicio credențială DailySmith nu e stocată nicăieri.

Instalează aplicația

Instalează DailySmith în magazinul tău
Deschide linkul de instalare și aprobă-l. Shopify îți arată cele două permisiuni cerute: citire și scriere de content, adică bloguri și articole, și nimic altceva. Fără comenzi, fără clienți, fără produse.
Lipește cheia site-ului și alege un blog
Aplicația se deschide în interiorul admin-ului Shopify (care e în engleză). Introdu cheia publică a site-ului tău (pk_…, de pe pagina site-ului din dashboard-ul DailySmith) și alege blogul Shopify în care se publică. Un magazin cu un singur blog îl are deja selectat. Decide dacă articolele ajung publicate sau ascunse, ca să le poți vedea mai întâi în admin, și salvează.
Testează, apoi sincronizează
Test connection listează blogurile DailySmith care se vor sincroniza. Sync now rulează prima sincronizare pe loc. După aceea aplicația sincronizează singură, din oră în oră.

Ce ajunge

Câmp Shopify	De unde
Title	Titlul articolului
Handle (adresa)	Slug-ul articolului. Dacă un articol de-al tău îl ține deja, al nostru primește un sufix numeric și al tău își păstrează adresa
Content	HTML-ul randat, împachetat și stilizat (mai jos)
Excerpt	Rezumatul generat
Author	Numele setat în aplicație, care pornește de la numele magazinului. Setat o singură dată, la crearea articolului
Published date	Momentul publicării înregistrat aici
Visibility	Publicat sau ascuns, după setarea ta. O actualizare o aplică din nou
Featured image	Imaginea principală a articolului, cu textul ei alternativ, adusă o singură dată per imagine
Search engine listing	Titlul SEO și meta-descrierea, în aceleași câmpuri pe care le-ai edita manual

Fiecare blog DailySmith de pe site ajunge în singurul blog Shopify pe care l-ai ales. Un blog care publică în mai multe limbi trimite doar limba lui; vezi Limbi mai jos.

Ce nu e atins niciodată

Fiecare articol creat de aplicație poartă id-ul articolului DailySmith într-un metafield propriu (dailysmith.post_id). Actualizările și retragerile merg doar la articolul care poartă id-ul sincronizat, niciodată la unul găsit după handle sau titlu. Asta e ceea ce îi permite aplicației să împartă un blog cu articolele scrise de tine:

Un articol de-al tău pe același handle își păstrează handle-ul și conținutul. Al nostru ia handle-2.
Un articol de-al nostru pe care îl ștergi din admin rămâne șters până când articolul se schimbă în DailySmith, și atunci e creat din nou.
Un articol de-al nostru pe care îl editezi din admin e suprascris data viitoare când articolul se schimbă în DailySmith. Editează articolul aici, sau ascunde-l.
Dezinstalarea aplicației lasă fiecare articol la locul lui. La fel și reinstalarea: aplicația își recunoaște articolele după metafield și le preia din nou, în loc să creeze o a doua copie.

Stilizare

Articolele cu componente bogate (callout-uri, ghiduri pas cu pas, comparații, grafice) încarcă foaia de stil a componentelor de la DailySmith printr-un <link> la începutul conținutului, și poartă paleta blogului tău într-un <style> alături. Articolele simple poartă doar paleta. Totul e limitat la un wrapper din jurul articolului, așa că nu poate restiliza restul temei, iar wrapper-ul lasă tipografia pe seama temei, ca articolul să se citească la fel ca restul magazinului.

Limbi

Rulează-o tu

Nu ai nevoie de noi ca să găzduim aplicația. Pentru un singur magazin, creează o aplicație personalizată în propriul tău admin și rulează serviciul oriunde poate sta pornit un proces:

Creează o aplicație personalizată în Shopify
În admin-ul Shopify, mergi la Settings → Apps and sales channels → Develop apps și creează o aplicație. La Admin API integration, bifează read_content și write_content, instaleaz-o și copiază Admin API access token (shpat_…). Shopify îl arată o singură dată.
Rulează serviciul
```
git clone https://github.com/TechnicalInsideTI/dailysmith-shopify-app
cd dailysmith-shopify-app
npm ci
cat > .env <<'ENV'
SHOPIFY_CUSTOM_APP_TOKEN=shpat_…
SHOP=magazinul-meu.myshopify.com
DAILYSMITH_PUBLIC_KEY=pk_…
SHOPIFY_BLOG_HANDLE=news
ENV
node --env-file=.env bin/sync.js
```
Asta rulează o sincronizare și afișează ce a făcut. node --env-file=.env server.js rămâne pornit și sincronizează din oră în oră. README-ul din repository acoperă imaginea de container, celelalte setări și rularea ca aplicație pentru mai multe magazine.

Depanare

Ce vezi	Ce înseamnă
`unknown or unverified site key`	Cheia `pk_…` e greșită, sau site-ul nu e încă verificat. Copiaz-o din nou de pe pagina site-ului; verifică site-ul mai întâi.
„This store has no blog yet"	Creează unul din Online Store → Blog posts → Manage blogs, apoi reîncarcă aplicația.
„Not configured"	Salvează cheia site-ului și alege un blog; sincronizarea rulează doar când ambele sunt setate.
„Shopify refused the access token"	Aplicația a fost dezinstalată sau (la aplicația personalizată) token-ul a fost revocat. Reinstalează, sau creează un token nou și repornește serviciul.
Un articol a ajuns fără imagine	Shopify aduce imaginea de la DailySmith când creează articolul. Dacă acea aducere a eșuat, următoarea schimbare a articolului o trimite din nou.
Două articole pentru un singur articol DailySmith	Cineva l-a creat pe al doilea manual, sau o copie mai veche a fost scrisă înainte de instalarea aplicației. Șterge-l pe cel fără metafield-ul `dailysmith.post_id`; aplicația nu creează niciodată două.

Note de securitate

Aplicația stochează cheia publică a site-ului tău, aceeași cheie pe care o poartă și snippet-ul de embed. Ea dă acces de citire la conținutul deja publicat și la nimic altceva.
Permisiunea Shopify e doar content. Aplicația poate crea și actualiza articole de blog; nu poate vedea comenzi, clienți, produse sau setări.
Aplicația nu stochează date despre clienți. Dezinstalarea ei șterge tot ce ținea despre magazinul tău: setările, token-ul de acces și lista cu ce articol oglindește ce articol DailySmith. Articolele rămân.
Un token de aplicație personalizată dă acces de scriere la conținutul magazinului. Ține-l în mediul serviciului, niciodată într-o pagină, și revocă-l din pagina aplicației personalizate din admin în ziua în care nu-l mai folosești.