ForgeCMS
pl

CMS

Repozytorium widżetów CMS: 43 widżety i jak je dodać

CMS · cms@8071e48 cmswidgetscataloguedb.json

totaljs/cms-widgets zawiera oficjalne widżety CMS Total.js. W opisanej tu rewizji (dc92cb7) ma 43 widżety w widgets/, każdy to jeden plik HTML, wszystkie w grupie Content, oraz skrypt generujący katalog (db.js). Format każdego pliku opisano w widżety.

Co obejmują

Repozytorium umieszcza wszystkie widżety w jednej grupie; poniższa tabela porządkuje je tylko według tego, co sugerują ich nazwy, aby łatwiej było je znaleźć.

RodzajWidżety
Tekstheadline, paragraph, paragraph2, article, alert, list, keyvalue, properties, summary, tags, code, codehighlighter
Układcontainer, vcontainer, columns100, columnshalfs, columnsthirds, panelsthirds, box, emptyspace, line, gradient
Tekst z obrazemtextimageleft, textimageright, textimagecenter, textimageflex, features2, features3, insight, team, partners, expansionlist
Obrazy i mediapicture, images, imagelinks, gallery, video, bufferwall
Odnośniki i przyciskilinkbutton, buttonsgroup, socialnetworks
Integracjaimporter, uibuilder (zobacz UI Builder)

Dziewięć z nich używa exports.render do zbudowania HTML na serwerze (bufferwall, code, codehighlighter, images, imagelinks, importer, picture, partners i uibuilder); pozostałe to statyczne bloki, które edytor konfiguruje, a CMS serwuje bez zmian.

Dodanie widżetu do Twojego CMS

Każdy plik to kompletny widżet. W administracji otwórz wtyczkę Widgets i zaimportuj plik albo wyślij go przez API:

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

Wyślij go przez POST na /admin/ z ciasteczkiem sesji lub nagłówkiem x-token (API administracji).

Katalog: db.json

Edytor może wyświetlić widżety z katalogu. Tworzy go db.js: czyta każdy plik z widgets/, z jego exports bierze name, author i preview, buduje adres https://cdn.totaljs.com/cms/<file> i zapisuje db.json posortowany według nazwy, z jednym wpisem na widżet (id, name, url, author, preview). db.js zaczyna się od require('total4'), więc do uruchomienia potrzebuje Total.js 4, jak w repozytorium komponentów Flow (repozytorium komponentów).

Twoje własne widżety

Skopiuj najbliższy widżet, zmień exports.id i exports.name i dostosuj styl, projekt oraz ustawienia. Jeśli widżet potrzebuje biblioteki, wpisz ją do exports.dependencies, a CMS doda ją do head stron, które go używają.