ForgeCMS
cs

CMS

Repozitář widgetů CMS: 43 widgetů a jak je přidat

CMS · cms@8071e48 cmswidgetscataloguedb.json

totaljs/cms-widgets obsahuje oficiální widgety CMS Total.js. V zde dokumentované revizi (dc92cb7) má 43 widgetů ve widgets/, každý je jeden soubor HTML, všechny ve skupině Content, plus skript, který generuje katalog (db.js). Formát každého souboru je popsán v widgety.

Co pokrývají

Repozitář dává všechny widgety do jedné skupiny; tabulka níže je jen řadí podle toho, co naznačují jejich názvy, aby se vám snáze hledaly.

DruhWidgety
Textheadline, paragraph, paragraph2, article, alert, list, keyvalue, properties, summary, tags, code, codehighlighter
Rozvrženícontainer, vcontainer, columns100, columnshalfs, columnsthirds, panelsthirds, box, emptyspace, line, gradient
Text s obrázkemtextimageleft, textimageright, textimagecenter, textimageflex, features2, features3, insight, team, partners, expansionlist
Obrázky a médiapicture, images, imagelinks, gallery, video, bufferwall
Odkazy a tlačítkalinkbutton, buttonsgroup, socialnetworks
Integraceimporter, uibuilder (viz UI Builder)

Devět z nich používá exports.render k sestavení HTML na serveru (bufferwall, code, codehighlighter, images, imagelinks, importer, picture, partners a uibuilder); ostatní jsou statické bloky, které editor nastavuje a CMS je obsluhuje tak, jak jsou.

Přidání widgetu do vašeho CMS

Každý soubor je kompletní widget. V administraci otevřete plugin Widgets a soubor importujte, nebo jej pošlete přes API:

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

Pošlete jej přes POST na /admin/ s cookie relace nebo hlavičkou x-token (API administrace).

Katalog: db.json

Editor může vypsat widgety z katalogu. db.js jej vytvoří: přečte každý soubor ve widgets/, z jeho exports vezme name, author a preview, sestaví adresu https://cdn.totaljs.com/cms/<file> a zapíše db.json seřazený podle názvu s jedním záznamem na widget (id, name, url, author, preview). db.js začíná require('total4'), takže ke spuštění potřebuje Total.js 4, jako v repozitáři komponent Flow (repozitář komponent).

Vaše vlastní widgety

Zkopírujte nejbližší widget, změňte exports.id a exports.name a upravte styl, návrh a nastavení. Pokud widget potřebuje knihovnu, uveďte ji v exports.dependencies a CMS ji přidá do hlavičky stránek, které jej používají.