Repozytorium widżetów CMS: 43 widżety i jak je dodać
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źć.
| Rodzaj | Widżety |
|---|---|
| Tekst | headline, paragraph, paragraph2, article, alert, list, keyvalue, properties, summary, tags, code, codehighlighter |
| Układ | container, vcontainer, columns100, columnshalfs, columnsthirds, panelsthirds, box, emptyspace, line, gradient |
| Tekst z obrazem | textimageleft, textimageright, textimagecenter, textimageflex, features2, features3, insight, team, partners, expansionlist |
| Obrazy i media | picture, images, imagelinks, gallery, video, bufferwall |
| Odnośniki i przyciski | linkbutton, buttonsgroup, socialnetworks |
| Integracja | importer, 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ą.