ForgeCMS
sk

CMS

Repozitár widgetov CMS: 43 widgetov a ako ich pridať

CMS · cms@8071e48 cmswidgetscataloguedb.json

totaljs/cms-widgets obsahuje oficiálne widgety CMS Total.js. V tu dokumentovanej revízii (dc92cb7) má 43 widgetov v widgets/, každý je jeden súbor HTML, všetky v skupine Content, plus skript, ktorý generuje katalóg (db.js). Formát každého súboru je opísaný v widgety.

Čo pokrývajú

Repozitár dáva všetky widgety do jednej skupiny; tabuľka nižšie ich len zoraďuje podľa toho, čo naznačujú ich názvy, aby ste ich ľahšie našli.

DruhWidgety
Textheadline, paragraph, paragraph2, article, alert, list, keyvalue, properties, summary, tags, code, codehighlighter
Rozloženiecontainer, vcontainer, columns100, columnshalfs, columnsthirds, panelsthirds, box, emptyspace, line, gradient
Text s obrázkomtextimageleft, textimageright, textimagecenter, textimageflex, features2, features3, insight, team, partners, expansionlist
Obrázky a médiápicture, images, imagelinks, gallery, video, bufferwall
Odkazy a tlačidlálinkbutton, buttonsgroup, socialnetworks
Integráciaimporter, uibuilder (pozri UI Builder)

Deväť z nich používa exports.render na zostavenie HTML na serveri (bufferwall, code, codehighlighter, images, imagelinks, importer, picture, partners a uibuilder); ostatné sú statické bloky, ktoré editor nastavuje a CMS ich obsluhuje tak, ako sú.

Pridanie widgetu do vášho CMS

Každý súbor je kompletný widget. V administrácii otvorte plugin Widgets a súbor importujte, alebo ho pošlite cez API:

{ "schema": "widgets_save", "data": { "html": "<the content of headline.html>", "singleton": true } }

Pošlite ho cez POST na /admin/ s cookie relácie alebo hlavičkou x-token (API administrácie).

Katalóg: db.json

Editor môže vypísať widgety z katalógu. db.js ho vytvorí: prečíta každý súbor v widgets/, z jeho exports vezme name, author a preview, zostaví adresu https://cdn.totaljs.com/cms/<file> a zapíše db.json zoradený podľa názvu s jedným záznamom na widget (id, name, url, author, preview). db.js začína require('total4'), takže na spustenie potrebuje Total.js 4, ako v repozitári komponentov Flow (repozitár komponentov).

Vaše vlastné widgety

Skopírujte najbližší widget, zmeňte exports.id a exports.name a upravte štýl, dizajn a nastavenia. Ak widget potrebuje knižnicu, uveďte ju v exports.dependencies a CMS ju pridá do hlavičky stránok, ktoré ho používajú.