Nastavenia, príspevky, súbory a návštevníci CMS Total.js a kde je všetko uložené

Nastavenia

Plugin Settings (settings_read, settings_save; oprávnenie settings) upravuje konfiguráciu, ktorú CMS drží v metadátach webu a pri každom štarte ju načíta do CONF:

Kľúč	Význam
name	názov webu, používa sa v <title> každej stránky okrem / a v názve súboru zálohy
url	verejná adresa webu; CMS ju aktualizuje aj z hostu požiadaviek administrácie
smtp	nastavenia SMTP ako text JSON (server, from, user, password, port); settings_test ich vyskúša
icon	ikona webu
$tms, secret_tms	publikuje udalosti cez TMS a tajomstvo tohto spojenia
op_reqtoken, op_restoken	tokeny aplikácie OpenPlatform; keď sú nastavené oba, prihlásenie do administrácie nahradí prihlásenie cez OpenPlatform
totalapi	kľúč pre služby Total.js API

Pluginy môžu pridať ďalšie kľúče, ktoré sa zobrazia v tom istom formulári. Hodnoty zo súboru config ($api, cdn, salt a, ak ho pridáte, token) sa tu neupravujú.

Príspevky

Plugin Posts je malý správca článkov uložených vo vlastnom súbore NoSQL v úložisku. Príspevok má name, category, picture, summary, body, reference, icon, color, hidden a date; administrácia ich vypíše od najnovších (100 na stránku) a posts_categories vráti používané kategórie. Príspevky sú dáta pre váš vlastný kód: verejný renderer CMS (controllers/default.js) ich nevypisuje, takže ich musí prečítať a vykresliť váš widget alebo cesta.

Súbory

Plugin Files ukladá nahrané súbory do úložiska súborov a označuje ich ako verejné. GET /download/<id>.<ext> obslúži verejný súbor (iba verejné; ostatné odpovedia 404). Pri obrázkoch ?s=<percent> vráti menší JPEG (hodnota musí byť od 10 do 80, s kvalitou 80) a ?download=1 vynúti stiahnutie. Cesty nahrávania a ich limity sú v API administrácie.

Návštevníci a dashboard

Modul modules/visitors.js počíta návštevy verejných stránok cez skript /visitors.js, ktorý obsahuje každá stránka: unikátni návštevníci, zobrazenia, prehliadače, referrery, vyhľadávanie, sociálne siete a priamy prístup, mobil a desktop, hodiny dňa a ľudia online (návštevník je online 20 minút bez aktivity). Plugin Dashboard kreslí tieto čísla z dashboard_stats, dashboard_online, dashboard_browsers, dashboard_referers a dashboard_pages.

OpenPlatform

Keď sú nastavené op_reqtoken a op_restoken, CMS prihlasuje ľudí cez OpenPlatform (modul modules/openplatform.js) a každý plugin pridá svoje oprávnenie do zoznamu, ktorý OpenPlatform ukazuje pri priraďovaní skupín: pages, layouts, widgets, navigation, posts, files, redirects, variables, settings a admin. Pamätajte na pravidlo OpenPlatform: aplikácia je viditeľná iba pre skupiny, ktoré jej priradíte.

Dátový model

MAIN.db drží metadáta webu (pages, layouts, widgets, redirects, vars, nav, config a storage) a ukladá sa ako jeden dokument JSON s názvom meta v úložisku súborov. HTML každej stránky a layoutu je súbor v tomto úložisku, ktorého názov je id stránky alebo layoutu. FUNC.load() načíta metadáta pri štarte, skompiluje widgety (spustí ich funkciu install) a znovu postaví cache; FUNC.save() ich zapíše späť. Preto je záloha úložiska zálohou webu.