ADP CREATOR / DOCUMENTATION / ATELIERUL LIBRARY

Atelierul Library
Documentation.

Documentație pentru sistemul custom de bibliotecă digitală construit pentru Atelierul de Sine: WooCommerce, My Account, ebook reader, audiobook streaming, progres și storage privat Cloudflare R2.

WOOCOMMERCECLOUDFLARE R2EPUBAUDIO STREAMINGMY ACCOUNT
01OVERVIEW

Bibliotecă digitală construită în jurul unui proiect real.

Atelierul Library este sistemul dezvoltat pentru Atelierul de Sine pentru livrarea ebook-urilor și audiobook-urilor cumpărate prin WooCommerce. Pluginul adaugă în My Account endpoint-ul biblioteca-mea, verifică accesul utilizatorului și livrează conținutul asociat produselor digitale.

Commerce

Accesul la conținut este legat de produsele WooCommerce cumpărate de utilizator.

Private storage

Fișierele digitale sunt mapate către obiecte păstrate în Cloudflare R2.

Experience

Bibliotecă personală, ebook reader, audiobook player și reluarea progresului.

02IMPLEMENTATION MODEL

Nu este un plugin „instalezi și funcționează”.

Atelierul Library este o soluție custom care necesită implementare dedicată pentru fiecare proiect nou. Codul poate constitui baza tehnică, însă integrarea depinde de magazin, produsele existente, structura contului, bucket-ul R2, fișierele digitale, designul și fluxurile comerciale ale proiectului.

DEDICATED IMPLEMENTATION REQUIREDInstalarea arhivei singure nu reprezintă o implementare completă. Sunt necesare configurare, integrare, maparea produselor, pregătirea storage-ului, testarea accesului și adaptarea frontend-ului.
03ARCHITECTURE

WooCommerce controlează dreptul. R2 păstrează conținutul.

01

WooCommerce Product

Produsul digital există în magazin și este cumpărat de client.

02

Product Map

Product ID-ul este asociat cu tipul digital și cheia obiectului din R2.

03

Access Check

Sistemul verifică utilizatorul autentificat și achiziția produsului.

04

Library / Reader / Stream

Conținutul eligibil este prezentat în cont și livrat prin fluxurile controlate ale pluginului.

04CLOUDFLARE R2

Storage separat pentru fișierele digitale.

Pluginul are setări pentru R2 Endpoint, Bucket, Access Key și Secret Key, poate testa conexiunea, încărca fișiere și sincroniza evidența upload-urilor. Request-urile către R2 sunt semnate în stil AWS Signature Version 4.

PRIVATE CONTENT FLOWFișierele nu sunt tratate ca simple download-uri publice din Media Library. Pluginul solicită obiectul din R2 după verificarea accesului utilizatorului.
05PRODUCT MAPPING

Produs WooCommerce → tip digital → obiect R2.

Zona „Produse digitale” permite maparea unui Product ID WooCommerce către un tip — audiobook sau ebook — și către cheia exactă a obiectului din Cloudflare R2. Există și sincronizare a mapărilor cu obiectele disponibile în R2.

06ACCESS CONTROL

Conținutul este afișat numai utilizatorilor eligibili.

În codul analizat, accesul este permis administratorilor sau clienților pentru care WooCommerce confirmă cumpărarea produsului prin wc_customer_bought_product(). Reader-ul și streaming-ul refac această verificare înainte de livrarea conținutului.

AUTHENTICATED DIGITAL PURCHASESVersiunea 2.5.2 include și validări care cer autentificarea clientului pentru produsele digitale înainte de add-to-cart / checkout.
07MY ACCOUNT / LIBRARY

„Biblioteca mea” trăiește direct în contul WooCommerce.

Pluginul înregistrează endpoint-ul biblioteca-mea și îl adaugă în meniul My Account. Biblioteca construiește lista din produsele mapate la care utilizatorul are acces, separă ebook-urile și audiobook-urile și poate evidenția un element început anterior.

All

Vizualizare comună pentru conținutul digital disponibil.

Audiobooks

Filtru dedicat materialelor audio cu progres salvat.

Ebooks

Filtru pentru cărțile digitale și acces la reader.

08EBOOK READER

Reader dedicat pentru conținut EPUB.

Reader-ul este randat separat după autentificare și verificarea achiziției. Versiunea analizată include manifest și asset handling pentru EPUB, cu interfață responsive și teme de lectură, inclusiv variante sepia și dark.

EPUB EXPERIENCEReader-ul nu este doar un link de download: sistemul construiește o experiență de lectură și păstrează informații despre capitol, scroll și procentul parcurs.
09AUDIOBOOK STREAMING

Streaming controlat cu suport pentru byte ranges.

Pentru audiobook-uri, pluginul verifică accesul, solicită obiectul din R2 și livrează audio inline. Request-urile HTTP Range valide sunt transmise către R2, iar răspunsul poate include Accept-Ranges, Content-Length și Content-Range, necesare unei experiențe audio cu seek.

10PROGRESS

Utilizatorul poate continua de unde a rămas.

Pluginul are endpoint-uri AJAX autentificate pentru progresul audio și ebook. Pentru ebook sunt stocate chapter index, chapter count, scroll ratio și percent. Biblioteca folosește progresul salvat pentru a calcula starea și pentru a identifica un element care poate fi continuat.

11DEPLOYMENT

Ce trebuie pregătit pentru un proiect nou.

01

Analiză WooCommerce

Produse, checkout, cont client, roluri și fluxul comercial.

02

Cloudflare R2

Bucket, credentials, structură de obiecte și testarea conexiunii.

03

Product mapping

Asocierea produselor cu ebook-urile și audiobook-urile reale.

04

Frontend integration

Adaptarea bibliotecii, reader-ului și playerului la tema și identitatea proiectului.

05

Access & device testing

Testare pe conturi reale, desktop și mobile, inclusiv streaming, progres și scenarii fără acces.

PROJECT-SPECIFICPașii exacți pot diferi de la un proiect la altul. Documentația descrie implementarea Atelierul de Sine și capabilitățile versiunii analizate, nu o instalare universală one-click.