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.
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.
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.
WooCommerce controlează dreptul. R2 păstrează conținutul.
WooCommerce Product
Produsul digital există în magazin și este cumpărat de client.
Product Map
Product ID-ul este asociat cu tipul digital și cheia obiectului din R2.
Access Check
Sistemul verifică utilizatorul autentificat și achiziția produsului.
Library / Reader / Stream
Conținutul eligibil este prezentat în cont și livrat prin fluxurile controlate ale pluginului.
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.
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.
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.
„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.
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.
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.
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.
Ce trebuie pregătit pentru un proiect nou.
Analiză WooCommerce
Produse, checkout, cont client, roluri și fluxul comercial.
Cloudflare R2
Bucket, credentials, structură de obiecte și testarea conexiunii.
Product mapping
Asocierea produselor cu ebook-urile și audiobook-urile reale.
Frontend integration
Adaptarea bibliotecii, reader-ului și playerului la tema și identitatea proiectului.
Access & device testing
Testare pe conturi reale, desktop și mobile, inclusiv streaming, progres și scenarii fără acces.