Description
Tagline: Advanced blocks. Reusable styling.
Motto Blocks gives you advanced blocks and a reusable, responsive styling system for modern WordPress sites, making it easier to build consistent layouts, manage shared styles, and keep design decisions scalable.
Development
The human-readable source used to build this plugin’s compiled/minified assets (build/motto-blocks.js and the CSS under assets/css/) is publicly available at github.com/mottoblocks/motto-blocks.
Third-Party Libraries
Motto Blocks bundles Swiper (MIT license) for the Motto Slider block, distributed as a minified build; the unminified source is available from the Swiper GitHub repository. It also bundles the Lucide icon set (ISC license) as local SVG files for the Motto Maps block’s pin icon picker, from the lucide-static package. See THIRD_PARTY_LICENSES.txt in the plugin package for full license texts.
External services
This plugin connects to the Google Maps Platform to display maps in the Motto Maps block.
It only loads when a page contains a Motto Maps block, and only after you configure a Google Maps API key in Settings → Motto Blocks → API. The plugin sends the site administrator’s own API key to Google to load the Maps JavaScript API in the visitor’s browser; no visitor-provided personal data is sent by the plugin itself, though loading any third-party script exposes the visitor’s IP address and browser details to that service, as is standard for any embedded map.
This service is provided by Google: Google Maps Platform Terms of Service, Google Privacy Policy.
Installation
- Upload the plugin files to the
/wp-content/plugins/motto-blocksdirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the “Plugins” screen in WordPress.
- Use the block inserter to add blocks, or open block settings where the Styler integrates with supported blocks.
FAQ
What WordPress version do I need?
Motto Blocks requires WordPress 6.5 or higher and PHP 7.4 or higher.
Where can I get help or documentation?
Visit mottoblocks.com for product information and support channels.
Is there a Pro version?
Motto Blocks Pro is currently in development and is not publicly available yet. The free plugin is fully usable on its own. Follow mottoblocks.com for updates.
Screenshots
Changelog
0.1.17
- Smaller download, trimmed icon library: the Lucide picker now offers 300 hand-picked icons instead of the full set, which makes the plugin about 390 KB lighter in the editor and shrinks the package by more than 1 MB. An icon outside the list that was chosen in an earlier version keeps showing on the site. In Motto SVG it stays editable as an inline SVG. In other blocks (Button, List item and similar) the editor may ask to recover the block; the front end of the page does not change. For any other icon, use the Inline SVG option.
0.1.16
- Icons for every role: Lucide icons now keep working when a post is saved by an Author, a Contributor, any user on a multisite, or on a site that disables unfiltered HTML. WordPress strips
<svg>markup from content those users save, so the icon of Motto SVG, Button, List item, the Accordion indicator and the Slider arrows used to turn up blank. These blocks now save only the icon name and the server draws the icon when the page renders. Content saved by earlier versions keeps working. - Inline SVG: the Inline SVG option (and Convert to inline) is hidden for users whose role cannot save raw SVG markup. A block that already uses it stays visible, read-only.
- Fix (Slider): the Lucide navigation arrows were blank on the frontend; they now show.
- Accessibility (Tabs): the tab list follows the WAI-ARIA tabs pattern. Screen readers get the tab and tab panel roles, arrow keys (Up and Down in a vertical list), Home and End move between tabs, and only the selected tab is a tab stop.
- Editor: the Image block’s dynamic source now sits inside the Image Source panel, and link panels (Container, Button, SVG) group their fields consistently.
- Editor: tidier panel spacing and input sizes, a clearer sticky device bar, and long text no longer overflows the CSS rule field.
0.1.15
- Editor: inspector panels now show a dot after the title when one of their settings differs from the block default. Settings that only apply while a toggle is on (for example the overlay color) are ignored once the toggle is off.
- Fix: the style collector no longer runs out of memory on a
Post Contentblock placed inside the page itself, for example inside a Query Template. - Fix: the flex direction icons rotate again, and they follow the effective flex direction, including attached classes and breakpoints.
- Container: the Dynamic Link settings now live inside the Container Link panel. With a dynamic source active, the new-tab and no-follow toggles sit below it.
- Performance (images): container background images now carry their real width and height, so WordPress can lazy-load them or mark the first one as high priority. Slider and Gallery slider images get a
sizesvalue based on the slide width. - Performance (frontend): the parallax animation loop pauses when nothing is moving, Google Maps loads only when a map is close to the viewport, the frontend loads a smaller custom build of Swiper, and WordPress can inline the small block stylesheets.
0.1.14
- Accordion and Tabs: developers can now react to interaction with new DOM events:
motto:accordion:open,motto:accordion:closeandmotto:tabs:change. They fire on the element that changed and bubble up, they never cancel the default behavior, and they do not fire on page load. - Images:
Motto Imageand container background images now render a responsivesrcsetandsizes. The size picked in the editor is the largest one used. - Styler: visual controls for single-corner border radius and for other single-value properties such as logical inset and size.
- Editor: the Desktop, Tablet and Mobile buttons now set the canvas to the real breakpoint width, so the canvas paints the same media queries as the frontend. Resizing the window or dragging the canvas no longer switches the active view.
- Editor: the add-class and attached-classes popups open above their field, and the editor does much less work on selection, hover and popover changes.
0.1.13
- Fix (Classic Menu): a parent item with no link, or a link of only
#, now also closes its submenu when you click it again in rollover mode. Before, the submenu stayed open while the pointer was over it. On touch screens the first tap opens the submenu and the next one closes it.
0.1.12
- Classic Menu: a parent item whose link has no URL, or only
#, now works as a submenu trigger. In click mode, clicking the link opens and closes the submenu like the chevron; in rollover mode it no longer jumps to the top of the page. - Slider: the slider in the block editor no longer restarts every time the block re-renders, and
motto.initSliders(scope)lets other scripts start sliders in markup added after the page loaded. - Fix: the Link control now shows the dynamic source above the link toggles.
- Fix: the base border-radius rule no longer sets
isolation, which could affect stacking inside rounded blocks.
0.1.11
- Security: the style of an inline SVG can no longer load an external file through a CSS escape (such as
u\72l(...)) or throughimage-set()and similar functions. SVG styles that contain a backslash are now dropped. - Fix: elements that render nothing, such as a
<style>,<script>,<noscript>or hidden element that a plugin or theme places between blocks, no longer add an extra gap or swallow the gap before the next block in a flow layout. - Performance: the block editor loads about 320 KB less JavaScript. The editor script no longer bundles unused parts of the Swiper slider library or a repeated license notice for every icon.
- Performance: pages that contain no Motto block no longer load the small shared utilities script.
- Performance: saving a template, template part, reusable block or CSS class that nothing uses yet is faster on sites with many posts.
0.1.10
- Security: the Styler’s block selectors are now always scoped to their own block. Before, a user without the
unfiltered_htmlcapability (a contributor) could write a selector list such asa, bodyand restyle or hide the rest of the page. - Security: an unterminated CSS comment in a Styler value or selector no longer comments out the styles that follow it.
- Security: the link of a Button or Container set from a dynamic source is now checked for a safe protocol, so it cannot become a
javascript:link on WordPress 6.5.0 to 6.5.4. - Fix: selectors that use the
&{BLOCK}token now work for contributors too, not only for administrators. - Block styles (Pro): Button now ships three bundled styles, Normal, Ghost and Outline. They are created once, automatically; a style you edit or delete is never changed or brought back. A “Manage styles” switch under the style pills removes a style from the block.
- Editor: the interface classes of the editor are now prefixed
motto-ui-, so they no longer collide with themes and other plugins. Classes on the frontend are unchanged.
0.1.9
- CSS classes: the class editor has a new Settings panel with the slug, above the Styler. Its sidebar panel is now called “Motto Styler” and its tab “Motto CSS Class”.
- CSS classes: the slug of a class is its CSS class name, so two classes can no longer share one. The editor blocks saving and explains why, and the server rejects the write too.
- CSS classes: the class preview puts the class on a single main block, like a real page, so rules and selectors written for sliders, accordions or tabs read correctly. Classes saved earlier get their main block when opened, and it is kept the next time you save the class.
- CSS classes: classes in draft no longer style the editor or appear in the class suggestions, matching the frontend.
- Block styles (Pro): a class is marked as a style of specific blocks from its own editor, and the style name is the class title. Names set in 0.1.8 are moved to the title once, automatically.
- Fix: in WordPress 7.1 the Block tab of the class editor is hidden again and the sidebar stays on the class settings when you click a block.
0.1.8
- Security: block spacing values are now validated like every other Styler value. Before, a user without the
unfiltered_htmlcapability could add page-wide CSS rules through them. Cached CSS is rebuilt once on each page’s next visit. - Slider: breakpoint ranges follow the current breakpoint widths, so changing a width in the settings reaches existing sliders without saving them again.
- Slider: responsive settings inherit from the next larger view (phone, landscape phone, tablet, desktop), a view can be reset to inherit again, and the editor preview shows the active view’s values.
- Accordion: choose the open/close indicator: chevron, plus/minus or a custom pair of icons, on the left or the right.
- Styler: the block sidebar panel is now called “Styler”.
- Uninstall: deleting the plugin removes its settings and caches. CSS classes and CSS variables are kept, so reinstalling restores every style.
0.1.7
- Security: the derived frontend CSS is no longer an editable post meta. It was computed by the editor and could be written through the REST API by anyone able to edit the post; the server now builds it alone.
- Wildcards: a token that names another post (
${POST_META:key@123},@parent) only resolves if that post is viewable by the person looking at the page, so drafts, private posts and password-protected posts no longer leak. Protected meta keys (starting with an underscore) are refused when read from another post and keep working on the current one. New filters:motto_blocks_wildcard_source_post_viewableandmotto_blocks_wildcard_allowed_protected_meta. - Blocks tab: a disabled block is now hidden from the editor inserter instead of being unregistered. Content that already uses it keeps working.
- Styler: editing a reusable class updates the frontend right away instead of one save later, and a user who cannot read the class registry no longer has class references rewritten when selecting a block. Draft and private classes no longer affect a published block’s layout.
- Performance: pages without Styler CSS are cached instead of being rebuilt on every view.
- Accordion: the trigger and panel blocks are registered on the server like the rest of the family.
- Translations: the editor interface strings can now be translated.
0.1.6
- Classic Menu: menu item titles now render the HTML that other plugins add to them, such as the language switcher flags and labels from Polylang, instead of showing the markup as literal text. The
nav_menu_item_titlefilter is now applied too. - Styler: a block’s default styles now follow the resolved defaults attribute, and the class editor reacts to resizing more reliably.
0.1.5
- Image: Motto Image now renders inside a
<figure>and supports an optional caption. - Slider: shared slider pipeline (navigation, selected-slide handling and server-rendered Swiper settings) and fixes for effect shadows, slide state classes and single-slide effects. Hosts can declare a custom slide class with
data-slide-class. - Styler: the width control no longer forces
!importantin the editor, Block Spacing controls refresh correctly when switching breakpoints, and the Styles panel code was reorganized. - CSS variables: block variables now use the
--motto-{block}-{property}naming (List, Button, Classic Menu, Tabs). The previous names, such as--bullet-sizeor--menu-gap, keep working in saved content and Custom CSS. - Directory listing: Slide, Tab Container and Tab Panels no longer appear in the Plugin Directory block list.
0.1.4
- Developer API: new
motto_blocks_enqueue_scripts_for_content()andmotto_blocks_enqueue_scripts_for_template_part()let themes and plugins load a block’s frontend scripts when they render blocks outside the post content (the JavaScript counterpart of the Styler CSS helpers). Fixes Classic Menu submenus not opening on mobile in such setups.
0.1.3
- Directory listing: show each block’s own icon on the WordPress.org plugin page and list only top-level blocks and their direct building blocks, not every internal child block.
0.1.2
- Directory listing: declare the editor script handle in each block’s
block.jsonso the WordPress.org Plugin Directory can index all blocks.
0.1.1
- Styler: responsive styling workflow in the block editor for supported surfaces (classes, design tokens, and related controls).
- Layout: Motto Container.
- Actions: Motto Button, Motto Buttons.
- Media: Motto Image, Motto SVG.
- Lists: Motto List and Motto List Item.
- Carousel: Motto Slider and Motto Slide.
- Tabs: Motto Tabs, Tab Container, Tab Panels, Tab Panel, and Tab Button.
- Accordion: Motto Accordion and Motto Accordion Item.
- Navigation: Motto Classic Menu.
- Maps: Motto Maps.
- Utility: Motto Counter.
- First release packaged for the WordPress.org plugin directory.




