- PHP 76%
- CSS 14.3%
- JavaScript 9.7%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Public copy of the project, without personal or sensitive data. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
| admin | ||
| assets | ||
| content | ||
| data | ||
| lib | ||
| templates | ||
| tools | ||
| uploads | ||
| .gitignore | ||
| .htaccess | ||
| index.php | ||
| LICENSE | ||
| README.md | ||
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
- Urcă tot conținutul folderului pe server (prin FTP sau managerul de fișiere), în
public_html/sau într-un subfolder (de exemplupublic_html/blog/), inclusiv fișierele ascunse.htaccess. - Asigură-te că serverul poate scrie în:
content/posts,content/pages,data,uploads(permisiuni 755; dacă nu merge, 775). - 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.
- În Setări, completează numele blogului, motto-ul, autorul, subsolul și adresa pentru notificări.
- 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:
/titlupentru articole și pagini,/media/fișierpentru imagini (servite dinuploads/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/șidata/: 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.mdpentru fiecarecontent/pages/conține paginileuploads/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 folosiretemplates/are șabloanele site-ului public, pe care le poți modificaassets/style.csse stilul site-ului publicadmin/e panoul de administraretools/import-calamus.phpe importul din CalamusLICENSEe 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: 
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.