Το αποθετήριο widgets του CMS: 43 widgets και πώς να τα προσθέσετε

Το totaljs/cms-widgets περιέχει τα επίσημα widgets του CMS του Total.js. Στην αναθεώρηση που τεκμηριώνεται εδώ (dc92cb7) έχει 43 widgets στο widgets/, ένα αρχείο HTML το καθένα, όλα με την ομάδα Content, και το σενάριο που δημιουργεί τον κατάλογο (db.js). Η μορφή κάθε αρχείου περιγράφεται στο widgets.

Τι καλύπτουν

Το αποθετήριο βάζει όλα τα widgets σε μία ομάδα· ο παρακάτω πίνακας τα ταξινομεί μόνο με βάση όσα υποδηλώνουν τα ονόματά τους, για να τα βρίσκετε πιο εύκολα.

Εννέα από αυτά χρησιμοποιούν το exports.render για να χτίσουν το HTML τους στον διακομιστή (bufferwall, code, codehighlighter, images, imagelinks, importer, picture, partners και uibuilder)· τα υπόλοιπα είναι στατικά μπλοκ που ρυθμίζει ο επεξεργαστής και σερβίρει το CMS όπως είναι.

Προσθήκη ενός widget στο CMS σας

Κάθε αρχείο είναι ένα πλήρες widget. Στη διαχείριση, ανοίξτε το πρόσθετο Widgets και εισαγάγετε το αρχείο ή στείλτε το με το API:

Στείλτε το με POST στο /admin/ με το cookie συνεδρίας ή την κεφαλίδα x-token (το API διαχείρισης).

Ο κατάλογος: db.json

Ο επεξεργαστής μπορεί να απαριθμήσει τα widgets ενός καταλόγου. Το db.js τον δημιουργεί: διαβάζει κάθε αρχείο του widgets/, παίρνει τα name, author και preview από τα exports του, χτίζει τη διεύθυνση https://cdn.totaljs.com/cms/<file> και γράφει το db.json ταξινομημένο κατά όνομα, με μία εγγραφή ανά widget (id, name, url, author, preview). Το db.js ξεκινά με require('total4'), οπότε χρειάζεται Total.js 4 για να τρέξει, όπως στο αποθετήριο των συνιστωσών του Flow (το αποθετήριο συνιστωσών).

Τα δικά σας widgets

Αντιγράψτε το πιο κοντινό widget, αλλάξτε τα exports.id και exports.name και προσαρμόστε το στυλ, τον σχεδιασμό και τις ρυθμίσεις. Αν το widget χρειάζεται μια βιβλιοθήκη, καταχωρίστε την στο exports.dependencies και το CMS την προσθέτει στο head των σελίδων που το χρησιμοποιούν.