Platformă de blog simplă pe fișiere Markdown, în PHP, pentru hosting shared, fără bază de date.
  • PHP 76%
  • CSS 14.3%
  • JavaScript 9.7%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
ThinkRoot 151c3b749e Initial import of foaie
Public copy of the project, without personal or sensitive data.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 16:46:52 +02:00
admin Initial import of foaie 2026-11-06 16:46:52 +02:00
assets Initial import of foaie 2026-11-06 16:46:52 +02:00
content Initial import of foaie 2026-11-06 16:46:52 +02:00
data Initial import of foaie 2026-11-06 16:46:52 +02:00
lib Initial import of foaie 2026-11-06 16:46:52 +02:00
templates Initial import of foaie 2026-11-06 16:46:52 +02:00
tools Initial import of foaie 2026-11-06 16:46:52 +02:00
uploads Initial import of foaie 2026-11-06 16:46:52 +02:00
.gitignore Initial import of foaie 2026-11-06 16:46:52 +02:00
.htaccess Initial import of foaie 2026-11-06 16:46:52 +02:00
index.php Initial import of foaie 2026-11-06 16:46:52 +02:00
LICENSE Initial import of foaie 2026-11-06 16:46:52 +02:00
README.md Initial import of foaie 2026-11-06 16:46:52 +02:00

Foaie, un blog pe fișiere Markdown

Platformă de blog simplă pentru hosting shared: PHP, fără bază de date, fără dependențe. Articolele și paginile sunt fișiere .md, iar totul se administrează dintr-un panou web.

Cerințe

  • PHP 8.0 sau mai nou.

  • Extensiile PHP:

    • GD cu suport WebP, pentru imagini (cu suport AVIF, se pot urca și imagini AVIF);
    • mbstring, obligatorie;
    • curl, pentru mențiunile trimise și primite;
    • dom, pentru citirea mențiunilor primite;
    • zip, pentru copia de siguranță din panou (fără ea, copia se face prin FTP);
    • iconv, opțională: ajută la adresele făcute din titluri cu caractere speciale.

    Sunt active implicit pe majoritatea hostingurilor; dacă lipsește una, se activează din selectorul de extensii PHP al panoului de hosting.

  • Funcția mail() a serverului, pentru abonarea prin e-mail, notificările de comentarii și resetarea parolei (fără ea, restul merge).

  • Apache cu .htaccess (aproape orice hosting shared: cPanel, DirectAdmin, Plesk etc.) sau LiteSpeed.

Instalare

  1. Urcă tot conținutul folderului pe server (prin FTP sau managerul de fișiere), în public_html/ sau într-un subfolder (de exemplu public_html/blog/), inclusiv fișierele ascunse .htaccess.
  2. Asigură-te că serverul poate scrie în: content/posts, content/pages, data, uploads (permisiuni 755; dacă nu merge, 775).
  3. Deschide site-ul în browser. Vei ajunge la pagina de configurare, unde îți creezi contul de administrator. Fă acest pas imediat după încărcare, pentru că până atunci oricine poate crea contul.
  4. În Setări, completează numele blogului, motto-ul, autorul, subsolul și adresa pentru notificări.
  5. Gata. Panoul de administrare este la /admin.

Dacă link-urile către articole dau eroare 404, serverul nu are mod_rewrite: dezactivează „Adrese curate” din Setări (link-urile vor arăta ca index.php?r=titlu). Dacă blogul e într-un subfolder și tot nu merge, decomentează RewriteBase din .htaccess.

La actualizare, urcă tot în afară de content/, data/ și uploads/: acolo sunt textele, contul și imaginile tale.

Ce poți face din panou

  • Articole cu titlu sau fără titlu (note scurte, ca pe un microblog). Notele fără titlu apar integral pe prima pagină, cu un buton clar „Deschide” și un link „Comentează”.
  • Notă rapidă direct din panoul principal: publicare dintr-un singur clic.
  • Pagini precum „Despre” sau „Contact”, care pot apărea în meniu, în ordinea pe care o alegi.
  • Ciorne și programare: o dată în viitor publică automat articolul la momentul respectiv.
  • Tipuri de articole: muzică, film, carte, foto și video. Muzica, filmele și cărțile au artist sau autor, an și stare (de exemplu „Citesc acum”, „Văzut”, „Vreau să ascult”); muzica și filmele primesc și stele. Fiecare tip are pagina lui: /carti, /filme, /muzica, /galerie.
  • Imagini: încărcare din editor (buton, drag & drop, Ctrl+V), plus o bibliotecă de imagini. Orice imagine (JPG, PNG, GIF, WebP, AVIF) e convertită automat în WebP la calitate 70, iar originalul e șters. Fotografiile de pe telefon sunt rotite corect, transparența se păstrează, iar imaginile mai mari de 2560 px sunt micșorate (configurabil în Setări). Excepție: GIF-urile animate rămân GIF, pentru că GD nu poate păstra animația în WebP.
  • Comentarii cu răspunsuri (numele, e-mailul și site-ul sunt opționale; fără nume apare „Anonim”), moderare (implicit activă), notificare pe e-mail și protecție anti-spam (câmp capcană, jeton semnat, limită de frecvență). Se pot închide per articol.
  • Mențiuni (webmention): blogul primește mențiuni de la alte site-uri (la /webmention; le vezi și le poți șterge din panou, la Comentarii) și le trimite site-urilor spre care au linkuri articolele noi sau modificate. Se pot opri din Setări.
  • Abonare prin e-mail: cititorii se abonează de pe site (cu confirmare pe e-mail) și primesc fiecare articol nou, cu link de dezabonare. Se poate opri din Setări.
  • Căutare după cuvinte cheie în titlu și text (fără diacritice: „toamna” găsește „toamnă”), cu evidențierea rezultatelor.
  • Editor Markdown cu bară de formatare și previzualizare live: textul și rezultatul formatat stau unul lângă altul și se actualizează pe măsură ce scrii (sau doar textul / doar rezultatul). Scurtături: Ctrl+B/I/K/S; listele continuă automat la Enter.
  • Marcajul <!--more--> împarte articolul: pe prima pagină apare doar partea de deasupra.
  • Casete: blocuri cu titlu, descriere și imagine, dintre care e nevoie de cel puțin unul, cu link opțional și etichetă mică opțională. Se pot afișa între articole (la fiecare N articole, pe rând), la sfârșitul articolelor, în subsol și în coloanele din stânga/dreapta (doar pe ecranele late, unde există spațiu liber). Codul public nu folosește denumiri pe care le blochează extensiile de tip ad-blocker, iar imaginile casetelor primesc nume neutre.
  • Galerii: două sau mai multe imagini puse pe rânduri consecutive devin o galerie; butonul „Galerie” din editor încarcă mai multe imagini deodată.
  • Paginare numerotată pe site (prima pagină, căutare) și în listele din panou.
  • Mărirea imaginilor (fiecare imagine are o iconiță de lupă, ca vizitatorii să știe că se poate mări): clic pe orice imagine din articol sau de pe prima pagină o deschide pe tot ecranul; încă un clic arată dimensiunea reală, săgețile trec la imaginea următoare, Esc închide.
  • Setări: nume, motto, descriere, subsol editabil (Markdown, cu previzualizare), favicon (încarci o imagine, se generează automat iconițele pentru browser și telefon), imaginea implicită pentru distribuire, articole pe pagină, fus orar, comentarii, mențiuni, abonare, adresa pentru notificări, schimbarea parolei.
  • Automat: arhiva (/arhiva), un articol la întâmplare (/random), fluxuri RSS (/feed.xml), Atom (/atom) și JSON Feed (/feed.json), sitemap (/sitemap.xml), temă luminoasă/întunecată.

În textul subsolului merg {an} (anul de acum), {blog} (numele blogului), {autor} (autorul) și {zile:2026-01-01} (câte zile au trecut de la o dată). Semnul 🄯 (sau ©) apare ca semnul copyleft.

Markdown suportat

Tot ce e în CommonMark și GitHub Flavored Markdown, plus extensii uzuale: titluri (și cu {#ancora}), paragrafe, citate imbricate, liste imbricate, liste de sarcini - [x], cod în blocuri ( ```, ~~~ sau indentat) și inline, tabele cu aliniere, linkuri și imagini inline sau cu referință ([text][ref]), linkuri automate, note de subsol [^1], liste de definiții, ~~tăiat~~, ==marcat==, caractere escapate și HTML brut.

Fluxuri

Articolele apar complete în cititoarele RSS (content:encoded), cu URL-uri absolute pentru imagini și linkuri și cu imaginile limitate la lățimea cititorului. Notele fără titlu primesc în RSS ca titlu începutul textului, pentru ca toate cititoarele să le afișeze corect. În JSON Feed rămân fără titlu, cum prevede formatul.

Mențiunile trimise

Foaie verifică cel mult o dată la 5 minute (după vizitele de pe site) sau imediat după o salvare din panou ce articole sunt noi ori modificate, apoi trimite mențiuni tuturor site-urilor spre care au linkuri. Un articol „modificat” e unul al cărui fișier e mai nou decât ultima verificare.

Atenție la articolele urcate în bloc. Dacă urci prin FTP multe articole vechi (de exemplu, de pe alt blog), la prima vizită Foaie le-ar socoti noi și ar trimite mențiuni pentru toate linkurile din ele. Ca să nu se întâmple, oprește înainte mențiunile din Setări și pornește-le după ce ai deschis o dată site-ul, sau pune în data/webmention_sent.php momentul de acum ('checked' => urmat de ora curentă, ca timestamp Unix). Importul din Calamus (mai jos) face asta singur.

Import din Calamus

Articolele, paginile, comentariile și imaginile unui blog Calamus se aduc din terminal:

php -d extension=pdo_sqlite tools/import-calamus.php /cale/catre/Calamus/data [--clean]
  • Adresele rămân aceleași: /titlu pentru articole și pagini, /media/fișier pentru imagini (servite din uploads/media/, convertite în WebP).
  • Cărțile, filmele, muzica, fotografiile și videoclipurile din Calamus devin articolele de tipul lor; notele rămân fără titlu.
  • Paginile care există deja în Foaie nu se suprascriu.
  • --clean șterge înainte tot conținutul din Foaie (articole, pagini, comentarii, imagini).
  • Importul se poate rula din nou; după el, articolele importate sunt socotite deja anunțate (nu pleacă mențiuni).

Siguranță și întreținere

  • Salvare automată. Editorul păstrează în browser tot ce scrii. Dacă sesiunea expiră sau pică internetul, la redeschiderea articolului primești opțiunea de a restaura textul. Cât timp editorul e deschis, sesiunea rămâne activă.
  • Copie de siguranță. Din Setări descarci o arhivă cu content/, uploads/ și data/: articolele, paginile, imaginile, comentariile, casetele, statisticile, setările și contul (fără memoria temporară). Ca să refaci blogul, urci prin FTP folderele din arhivă peste cele existente. Arhiva conține contul, deci păstreaz-o în siguranță.
  • Parolă uitată. Pe pagina de autentificare, „Ai uitat parola?” trimite un link valabil o oră pe e-mailul setat în contul tău. Dacă serverul nu trimite e-mailuri, ștergi prin FTP fișierul data/auth.php și creezi din nou contul; conținutul rămâne neatins. După schimbarea parolei, celelalte sesiuni deschise se închid.
  • Statistici fără cookie-uri. Afișările de pagini, vizitatorii unici pe zi, cele mai citite articole, sursele vizitelor și tipul dispozitivelor, pe 7, 30, 90 de zile sau un an. Roboții și vizitele tale cât ești autentificat nu se numără, iar datele mai vechi de un an se șterg automat.
  • Viteză. Lista articolelor se păstrează într-o memorie (data/cache) care se reînnoiește singură când un fișier se schimbă. Fiecare imagine primește la încărcare și variante de 480, 960 și 1600 px, din care telefoanele și galeriile o descarcă pe cea potrivită.
  • Distribuire pe rețele. Fiecare pagină are etichete Open Graph și date structurate pentru Google. La distribuire apare prima imagine din articol; pentru restul paginilor poți alege din Setări o imagine implicită.

Structura fișierelor

  • content/posts/ conține articolele, câte un fișier .md pentru fiecare
  • content/pages/ conține paginile
  • uploads/ conține imaginile încărcate, pe ani și luni (uploads/media/ pe cele importate din Calamus, uploads/site/ faviconul și imaginea de distribuire)
  • data/ păstrează contul de admin, setările, casetele, comentariile, abonații, mențiunile și statisticile (fișiere PHP, inaccesibile din web); apar la prima folosire
  • templates/ are șabloanele site-ului public, pe care le poți modifica
  • assets/style.css e stilul site-ului public
  • admin/ e panoul de administrare
  • tools/import-calamus.php e importul din Calamus
  • LICENSE e licența MIT

Un articol arată așa (titlul poate lipsi sau fi gol):

---
title: Titlul articolului
date: 2026-10-11 14:30
status: published
---
Textul în **Markdown**. Imaginile: ![descriere](uploads/2026/10/poza.webp)

Un film, o carte sau o melodie au în plus kind (movie, book, music, photo, video), creator, year, rating (1-5, doar la muzică și filme) și progress (now, done, want). comments: no închide comentariile. O pagină are în loc de tip menu: yes sau menu: no și order (locul în meniu).

Poți crea sau edita fișierele și direct prin FTP. Numele fișierului devine adresa (fișierul o-zi-buna.md devine /o-zi-buna). status: draft ascunde articolul.

Securitate

  • Parola e stocată cu password_hash; după 5 încercări greșite autentificarea e blocată 15 minute.
  • Toate formularele sunt protejate cu token CSRF; sesiunea folosește cookie HttpOnly/SameSite.
  • Imaginile sunt verificate după conținut (nu după extensie), redenumite, iar în uploads/ execuția scripturilor este dezactivată.
  • content/, data/, lib/, templates/, tools/ sunt blocate din web prin .htaccess.
  • Conținutul scris în Markdown poate include HTML, pentru că doar administratorul poate publica.

Licența

Codul platformei e sub licența MIT (vezi LICENSE), © 2026 ThinkRoot.