CRONICA ISTORICA - tema WordPress
==================================

INSTALARE
---------
1. WordPress Admin > Aspect > Teme > Adaugă temă > Încarcă temă.
2. Alege fișierul cronica-istorica.zip și apasă "Instalează acum".
3. Apasă "Activează".

CULORI ȘI FONTURI (fără cod)
-----------------------------
Aspect > Personalizare:
- "Culori site" - schimbi orice culoare a temei (fundal, text, accent, antet).
- "Fonturi" - alegi fontul pentru titluri și pentru textul articolelor dintr-o listă.
- "Pagina principală" - alegi dacă articolele afișate în fiecare categorie sunt
  cele mai recente sau alese aleatoriu, câte articole (2-6) și câte categorii
  apar pe prima pagină (0 = toate).

ZONE DE RECLAMĂ (ca Ad Inserter - tu decizi unde)
--------------------------------------------------
Mergi la Aspect > Widgeturi. Vei găsi aceste zone dedicate de reclamă:
- Reclamă - sub antet (toate paginile)
- Reclamă - pagina principală, sus / la mijloc / jos
- Reclamă - articol, înainte de conținut / în mijlocul textului / după conținut
- Reclamă - coloana dreapta
- Reclamă - footer

În oricare din aceste zone, adaugă un widget "HTML personalizat" și lipește
codul reclamei tale (Google AdSense, banner, script etc). O zonă fără niciun
widget rămâne complet invizibilă - nu ocupă spațiu pe site.

COLOANA DREAPTA
----------------
Aspect > Widgeturi > "Coloana Dreapta" - adaugă orice widgeturi vrei
(căutare, categorii, articole recente, HTML personalizat etc), în orice ordine.

CATEGORII ȘI ARTICOLE
-----------------------
La activare, tema creează câteva categorii utile pentru un site de istorie
(Istorie Antică, Istorie Medievală, Istorie Modernă, Personalități Istorice,
Curiozități, Cultură Generală) - le poți edita, șterge sau adăuga altele din
Articole > Categorii. Fiecare categorie cu cel puțin un articol publicat apare
automat ca secțiune pe pagina principală, cu câte 3 articole (recente sau
aleatorii, configurabil).

MENIU
-----
Aspect > Meniuri - creează un meniu și atribuie-l poziției "Meniu principal"
(și opțional "Meniu footer").

LOGO
----
Aspect > Personalizare > Identitate site - încarcă logo-ul tău.

GAMIFICARE (retenție cititori) - NOU
--------------------------------------
Tema are acum 4 funcții care încurajează cititorii să revină, fără să
fie nevoie de cont/login (progresul e păstrat local, în browserul lor):

1. SIGILII DE CITITOR
   Pentru fiecare categorie din care un cititor citește măcar
   3 articole (nu doar unul - pragul se poate ajusta din
   assets/js/gamificare.js, constanta PRAG_ARTICOLE_PT_SIGILIU),
   "câștigă" sigiliul acelei categorii. Progresul parțial (ex. "2/3")
   se vede direct pe sigiliul necâștigat încă. Progresul se vede pe
   pagina "Jurnalul meu de cronicar" (creată automat la activarea temei,
   la adresa /jurnalul-meu/).

2. SERIE DE VIZITE (STREAK)
   Un indicator mic apare în antet ("🔥 X zile consecutive") când
   cititorul revine pe site zile la rând. Apare doar după prima
   vizită dublă (nu ocupă loc dacă streak-ul e 0).

3. QUIZ SCURT LA FINAL DE ARTICOL
   Când editezi un articol, apare o casetă "Quiz scurt (opțional)"
   sub editor. Poți adăuga până la 3 întrebări, fiecare cu 3 variante
   de răspuns - bifează varianta corectă. Dacă nu completezi nimic,
   quiz-ul pur și simplu nu apare la acel articol.

4. "ZIUA DIN ISTORIE" (widget)
   Un widget nou, "Cronica: Ziua din istorie", disponibil în
   Aspect > Widgeturi. Afișează automat 2-4 evenimente istorice
   petrecute în ziua curentă (sursă: Wikipedia), actualizate zilnic.
   Apare implicit în coloana dreapta dacă nu ai adăugat alte widgeturi
   acolo; altfel, adaugă-l manual unde vrei.

5. TOP CITITORI (clasament anonim)
   Pe pagina "Jurnalul meu de cronicar" apare acum și un clasament
   cu cei mai activi cititori, calculat din punctele acumulate
   (articole citite, sigilii, quiz-uri corecte). Fără cont: fiecare
   cititor primește automat un ID anonim (fără date personale) și o
   poreclă generată automat (ex. "Cititor #482"), pe care o poate
   schimba oricând dintr-un câmp simplu.
   Din Aspect > Personalizare > Gamificare - conținut bonus poți
   alege câți cititori apar în top (implicit 5).
   IMPORTANT: tehnic, această funcție creează automat o mică tabelă
   în baza de date la prima încărcare a site-ului cu tema activă
   (nu necesită nimic manual din partea ta). Fiind un clasament
   public și anonim, fără login, cineva tehnic priceput ar putea
   în teorie trimite un scor manipulat direct către server - pentru
   un site de istorie, cu miză mică, e un risc acceptabil.

   Poți afișa acest clasament oriunde vrei (nu doar pe Jurnalul meu)
   cu widgetul "Cronica: Top cititori", disponibil în
   Aspect > Widgeturi - trage-l în "Coloana Dreapta". Poți alege din
   widget titlul afișat și câți cititori apar (implicit, moștenește
   setarea din Personalizare).

6. DISTRIBUIRE + SIGILIUL DIFUZORULUI
   La finalul fiecărui articol apar butoane de distribuire
   (Facebook, WhatsApp, X, copiază link). Primul click pe oricare
   dintre ele deblochează un sigiliu special, "Difuzorul", vizibil
   pe pagina Jurnalul meu alături de sigiliile de categorie -
   plus 20 de puncte bonus către nivelul de cronicar.

7. RECOMPENSA "CRONICAR DESĂVÂRȘIT" (deblocare grea, intenționat)
   Pe pagina Jurnalul meu apare o listă de 3 condiții, cu bifă vizuală
   pe măsură ce le îndeplinești:
     - toate sigiliile de categorie câștigate (fiecare cere acum 3
       articole, nu 1 - vezi punctul 1)
     - minim 5 răspunsuri corecte la quiz, în total
     - cel puțin o distribuire făcută (sigiliul difuzorului)
   Recompensa (text + link opțional) rămâne editabilă din
   Aspect > Personalizare > Gamificare - conținut bonus. Pragurile
   de mai sus sunt constante ușor de schimbat la începutul fișierului
   assets/js/gamificare.js (PRAG_ARTICOLE_PT_SIGILIU,
   PRAG_QUIZ_CORECTE_BONUS, CERE_DISTRIBUIRE_PT_BONUS).

8. RECOMPENSE PE NIVELURI (harta vizibilă de la început)
   Pe pagina Jurnalul meu apare acum și o listă cu recompensa fiecărui
   nivel (Cronicar, Cronicar Priceput, Maestru Cronicar) - vizibilă
   integral chiar și înainte de a o debloca, ca cititorul să știe
   pentru ce lucrează. Cardul e estompat cât nu e deblocat, și devine
   viu + capătă buton de acțiune odată atins nivelul respectiv.

   Totul e editabil din Aspect > Personalizare > Gamificare -
   recompense pe niveluri: titlu, text și link, separat pentru
   fiecare din cele 3 niveluri (Ucenic Cronicar, primul nivel, nu are
   recompensă - e punctul de plecare). Lași titlul gol la un nivel
   dacă nu vrei nicio recompensă acolo - cardul pur și simplu nu
   apare. Așa poți avea bonusuri intermediare (ex. un articol bonus
   la nivelul 2) și un premiu final la nivelul maxim.

   IMPLICIT, nivelul maxim (Maestru Cronicar) NU are recompensă
   prescrisă - titlu, text și link, toate goale. Tu decizi complet
   liber ce pui acolo (temă, aplicație, imagine, orice), oricând,
   din Personalizare - fără nicio presupunere lăsată în cod.

9. MATUSALEM - punctele nu se opresc niciodată la nivelul maxim
   După ce cineva atinge Maestru Cronicar (300 puncte), punctele
   continuă să crească normal (din articole citite, sigilii, quiz-uri,
   distribuiri). La fiecare 100 de puncte suplimentare, cititorul
   "urcă" un rang nou de Matusalem (ex. "Maestru Cronicar — Matusalem 3"),
   cu bară de progres și toast de felicitare la fiecare rang nou -
   nu se mai oprește niciodată, spre deosebire de restul nivelurilor.
   Pragul de 100 de puncte per rang e constanta PUNCTE_CICLU_MATUSALEM
   din assets/js/gamificare.js, ușor de schimbat.

10. CONTOR GLOBAL "X bonusuri descărcate"
    Pe pagina Jurnalul meu, deasupra listei de recompense pe niveluri,
    apare un contor - "🎁 X bonusuri descărcate de cititori până acum".
    Se incrementează automat de fiecare dată când cineva dă click pe
    orice buton de recompensă (fie de la un nivel, fie de la
    "Cronicar Desăvârșit") - contorul e global, pentru toți vizitatorii
    site-ului, nu doar pentru tine.

REPARAT: butonul "Șterge progresul" de pe Jurnalul meu ștergea doar
progresul de citire (articole, sigilii, quiz), dar NU și identitatea
anonimă folosită pentru clasament (ID-ul + porecla) - ceea ce lăsa
intrarea veche din Top Cititori "agățată" de vechea identitate, cu
punctaj vechi, needatorat nimănui. Acum, la resetare, se trimite mai
întâi scor 0 pentru identitatea veche (dispare din clasament), apoi
se curăță complet identitatea locală - la reîncărcare, cititorul
primește o poreclă și un ID complet noi.
DACĂ AI ACTUALIZAT DE LA O VERSIUNE ANTERIOARĂ ȘI VEZI O INTRARE
VECHE ÎN TOP CITITORI: intră pe /jurnalul-meu/ și apasă din nou
"Șterge progresul salvat în acest browser" - de data asta o rezolvă
corect. Dacă site-ul are un plugin de cache (WP Rocket, LiteSpeed
Cache etc.), golește și cache-ul acestuia, ca să nu vezi o versiune
veche, memorată, a widgetului.

7. "X CITITORI AZI" (contor per articol)
   Sub titlul fiecărui articol apare un mic contor cu numărul de
   cititori din ziua curentă (se resetează automat la miezul nopții).
   Nu contorizează vizualizările tale, cât timp ești logat ca autor
   sau administrator - ca să nu umfle artificial numărul cât editezi
   articolul. Funcționează corect și dacă site-ul are cache de
   pagini (WP Rocket, LiteSpeed Cache etc.), pentru că se actualizează
   printr-un mic apel separat, nu din pagina cache-uită în sine.

PAGINA "JURNALUL MEU DE CRONICAR"
-----------------------------------
Se creează automat, publicată, la activarea temei (dacă nu există deja
o pagină cu adresa /jurnalul-meu/). O poți edita din Articole > Pagini
ca să adaugi text introductiv - conținutul tău apare sub sigilii.
Dacă vrei să o muți în meniu, adaug-o normal din Aspect > Meniuri.
