Konfigurace

Volba Typ Povinná Popis
bootstrapui_css string nebo string[] ano Adresa Bootstrap CSS pro náhledy v dialozích. Pole umožní přidat vlastní motiv za Bootstrap. Bez ní plugin běží, ale chybějící volbu hlásí v editoru, v konzoli a v každém náhledu.
bootstrapui_js string nebo string[] ne Adresa bootstrap.bundle.min.js, nebo pole adres; skripty se do náhledu vkládají v zadaném pořadí. Potřeba jen pro Přehrát / otevřít u interaktivních komponent. U Bootstrapu 4 patří před bundle jQuery, viz níže.
bootstrapui_image_picker (callback, editor) => void ne Váš správce souborů. Volá se z dialogů Karta a Obrázek; vybraný obrázek předejte callback(url).
bootstrapui_version '5' nebo '4' ne Řada Bootstrapu na vašem webu. Výchozí 5. S 4 dialogy používají názvy tříd a datové atributy Bootstrapu 4 (data-toggle místo data-bs-toggle) a skryjí, co ta řada nemá, viz Bootstrap 4. Neznámou hodnotu plugin ohlásí.
bootstrapui_grid_defaults objekt ne Třídy sloupců, které návrhář mřížky dá pro daný počet sloupců, např. { 4: 'col-12 col-sm-6 col-xl-3' }. Neuvedené počty berou vestavěnou sadu (třeba 4 → col-12 col-md-6 col-lg-3).
bootstrapui_styles logická hodnota nebo objekt ne Třídy Bootstrapu v nabídce TinyMCE Styly a v tlačítku bootstrapuistyles. Výchozí true; false vypne; objekt { groups, breakpoints, title } ji zúží, viz Nabídka Styly.
language string ne Standardní volba TinyMCE. Angličtina a čeština (cs) jsou v pluginu; slovenština, němčina, španělština, francouzština, brazilská portugalština, italština a polština (sk, de, es, fr, pt_BR, it, pl) se načtou z langs/. Viz Překlady.

Volby TinyMCE, na které plugin spoléhá

Volba Proč
content_css Dejte sem i Bootstrap CSS, jinak plocha editoru vypadá jinak než náhled.
plugins: 'table' Dialog tabulky přenechává řádky, sloupce a slučování liště TinyMCE.
table_toolbar Přidejte bootstrapuieditui bootstrapuitablecell bootstrapuitablemenu, ať je nastavení tabulky dostupné z její plovoucí lišty.
table_resize_bars: false Úchopy zapisují inline width/height, které mohou omezit responzivní chování tabulky.
toolbar s styles Nabídka TinyMCE Styly ukáže skupinu Bootstrap (nebo přidejte tlačítko bootstrapuistyles).
plugins: 'quickbars' + quickbars_selection_toolbar Přidejte bootstrapuitypography, ať je nastavení textu jedno kliknutí od výběru.

Bootstrap 4 a jQuery v náhledu

Náhled v dialogu běží v izolovaném iframe, takže jQuery z vaší stránky v něm není. JavaScript Bootstrapu 4 přitom jQuery potřebuje a jeho bootstrap.bundle obsahuje Popper, ale ne jQuery. Do bootstrapui_js proto dejte jQuery jako první:

bootstrapui_version: '4',
bootstrapui_css: '/assets/bootstrap-4.6.2.min.css',
bootstrapui_js: ['/assets/jquery.min.js', '/assets/bootstrap-4.6.2.bundle.min.js'],

Použijte verzi jQuery, kterou podporuje váš Bootstrap 4: ten 4.6 vyžaduje jQuery od 1.9.1 do verze 3.x (včetně). Adresy určujete vy, plugin nic z CDN netahá. Nespustí-li se Bootstrap JavaScript v náhledu, náhled to napíše do horní části (u čtyřky s odkazem na jQuery) a Přehrát / otevřít nefunguje.

Volba se týká jen náhledů v dialozích. Na publikované stránce si Bootstrap JavaScript (u čtyřky i jQuery) zajišťuje váš web sám; plugin je tam nevkládá.

Kontrola verze

Po inicializaci plugin přečte začátek bootstrapui_css a porovná nalezenou verzi Bootstrapu s bootstrapui_version. Nesoulad hlásí jako varování v editoru. Na file:// nebo při blokovaném CORS se kontrola neprovede.