ForgeCMS
sv

CMS

Widgetförrådet för CMS: 43 widgetar och hur du lägger till dem

CMS · cms@8071e48 cmswidgetscataloguedb.json

totaljs/cms-widgets innehåller de officiella widgetarna för Total.js CMS. I revisionen som dokumenteras här (dc92cb7) har det 43 widgetar i widgets/, en HTML-fil vardera, alla med gruppen Content, plus skriptet som genererar katalogen (db.js). Formatet på varje fil beskrivs i widgetar.

Vad de täcker

Förrådet lägger alla widgetar i en grupp; tabellen nedan ordnar dem bara efter vad deras namn antyder, för att hjälpa dig hitta dem.

SlagWidgetar
Textheadline, paragraph, paragraph2, article, alert, list, keyvalue, properties, summary, tags, code, codehighlighter
Layoutcontainer, vcontainer, columns100, columnshalfs, columnsthirds, panelsthirds, box, emptyspace, line, gradient
Text med bildtextimageleft, textimageright, textimagecenter, textimageflex, features2, features3, insight, team, partners, expansionlist
Bilder och mediapicture, images, imagelinks, gallery, video, bufferwall
Länkar och knapparlinkbutton, buttonsgroup, socialnetworks
Integrationimporter, uibuilder (se UI Builder)

Nio av dem använder exports.render för att bygga sin HTML på servern (bufferwall, code, codehighlighter, images, imagelinks, importer, picture, partners och uibuilder); de övriga är statiska block som editorn konfigurerar och CMS serverar som de är.

Lägg till en widget i ditt CMS

Varje fil är en komplett widget. Öppna pluginet Widgets i administrationen och importera filen, eller skicka den med API:et:

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

Skicka den med POST till /admin/ med sessionscookien eller headern x-token (administrations-API:et).

Katalogen: db.json

Editorn kan lista widgetarna i en katalog. db.js skapar den: den läser varje fil i widgets/, hämtar name, author och preview från dess exports, bygger adressen https://cdn.totaljs.com/cms/<file> och skriver db.json sorterad efter namn, med en post per widget (id, name, url, author, preview). db.js börjar med require('total4'), så den behöver Total.js 4 för att köras, som i förrådet för Flows komponenter (komponentförrådet).

Dina egna widgetar

Kopiera den närmaste widgeten, ändra exports.id och exports.name och anpassa stil, design och inställningar. Om widgeten behöver ett bibliotek, ange det i exports.dependencies så lägger CMS till det i head på sidorna som använder den.