Weston Ruter

Payton Swick

Important note: This project was first started before the Gutenberg feature plugin was started. As such, the JS Widgets plugin should now be considered a prototype which may inform the way that widget blocks get implemented in Gutenberg. This plugin will no longer be actively developed.
Also could be known as Widget Customizer 2.0, Widgets 3.0, or Widgets Next Generation.
Warning: The APIs provided by this plugin are still in flux. If creating new widgets that extend the <code>WP_JS_Widget</code> class, please look at the changelog and ensure compatibility with your extended widgets before deploying.
This plugin implements:
<ul>
<li><a href="https://core.trac.wordpress.org/ticket/33507" rel="nofollow ugc">WP-CORE#33507</a>: Allow widget controls to be JS-driven.</li>
<li><a href="https://core.trac.wordpress.org/ticket/35574" rel="nofollow ugc">WP-CORE#35574</a>: Add REST API JSON schema information to WP_Widget.</li>
<li><a href="https://github.com/WP-API/WP-API/issues/19" rel="nofollow ugc">WP-API#19</a>: Add widget endpoints to the WP REST API.</li>
</ul>
Features:
<ul>
<li>Integrates with <a href="https://wordpress.org/plugins/shortcode-ui/" rel="ugc">Shortcake (Shortcode UI)</a> to allow all JS widgets to be made available as Post Elements in the editor.</li>
<li>Widget instance settings in the Customizer are exported from PHP as regular JSON without any PHP-serialized base64-encoded <code>encoded_serialized_instance</code> anywhere to be seen.</li>
<li>Previewing widget changes in the customizer is faster since the <code>update-widget</code> Ajax request can be eliminated since the JS control can directly manipulate the widget instance data.</li>
<li>Widgets control forms use JS content templates instead of PHP to render the markup for each control, reducing the weight of the customizer load, especially when there are a lot of widgets in use.</li>
<li>Widgets that extend <code>WP_JS_Widget</code> will editable from both the customizer and the widgets admin page using the same <code>Form</code> JS interface. This <code>Form</code> is also able to be embedded in other contexts, like on the frontend and as a Shortcake (Shortcode UI) form. See <a href="https://github.com/xwp/wp-js-widgets/issues/11" rel="nofollow ugc">#11</a>.</li>
<li>Widgets employ the JSON Schema from the REST API to define an instance with validation and sanitization of the instance properties, beyond also providing <code>validate</code> and <code>sanitize</code> methods that work on the instance array as a whole.</li>
<li>A widget instance can be blocked from being saved by returning a <code>WP_Error</code> from its <code>validate</code> or <code>sanitize</code> method. For example, the RSS widget will show an error message if the feed URL provided is invalid and the widget will block from saving until the URL is corrected.</li>
<li>Widgets are exposed under the <code>js-widgets/v1</code> namespace, for example to list all Recent Posts widgets via the <code>/js-widgets/v1/widgets/recent-posts</code> or to get the Text widget with the “ID” (number) of 6, <code>/js-widgets/v1/widgets/text/6</code>.</li>
<li>Customizer settings for widget instances (<code>widget_{id_base}[{number}]</code>) are directly mutated via JavaScript instead of needing to do an <code>update-widget</code> Admin Ajax roundtrip; this greatly speeds up previewing.</li>
<li>Widget control forms can be extended to employ any JS framework for managing the UI, allowing Backbone, React, or any other frontend technology to be used.</li>
<li>Compatible with widgets stored in a custom post type instead of options, via the Widget Posts module in the <a href="https://github.com/xwp/wp-customize-widgets-plus" rel="nofollow ugc">Customize Widgets Plus</a> plugin.</li>
<li>Compatible with <a href="https://github.com/xwp/wp-customize-snapshots" rel="nofollow ugc">Customize Snapshots</a>, allowing changes made in the Customizer to be applied to requests for widgets via the REST API.</li>
<li>Includes adaptations of all core widgets using the new <code>WP_JS_Widget</code> API.</li>
<li>The adapted core widgets include additional raw data in their REST API item responses so that JS can render them client-side.</li>
<li>The Notifications API is utilized to display warnings when a user attempts to provide markup in a core widget title or illegal HTML in a Text widget’s content.</li>
<li>The Pages widget in Core is enhanced to make use of <a href="https://wordpress.org/plugins/customize-object-selector/" rel="ugc">Customize Object Selector</a> if available to display a Select2 UI for selecting pages to exclude instead of providing page IDs.</li>
<li>An bonus bundled plugin provides a “Post Collection” widget which, if the <a href="https://wordpress.org/plugins/customize-object-selector/" rel="ugc">Customize Object Selector</a> plugin is installed, will provide a UI for curating an arbitrary list of posts to display.</li>
</ul>
This plugin doesn’t yet implement any widgets that use JS templating for frontend rendering of the widgets. For that, please see the <a href="https://github.com/xwp/wp-next-recent-posts-widget" rel="nofollow ugc">Next Recent Posts Widget</a> plugin.
Limitations/Caveats:
<ul>
<li>Only widgets that extend <code>WP_JS_Widget</code> will be exposed via the REST API. The plugin includes a <code>WP_JS_Widget</code> adapter class which demonstrates how to adapt existing <code>WP_Widget</code> classes for the new widget functionality.</li>
</ul>

JS Widgets

A prototype of next generation of widgets in core, embracing JS for UI and powering the Widgets REST API.

Seller Themes

Introducing the eCommerce Companion Plugin, the essential tool for effortless setup of <a href="https://sellerthemes.com/" rel="nofollow ugc">Seller Themes</a> with full WooCommerce support. More than 8000+ trusted websites with Seller Themes. With our plugin, sellers can streamline their online store setup process in just a few clicks. We ensure seamless integration of all themes with WooCommerce, eliminating compatibility issues. Experience enhanced functionality tailored for sellers, from customizable product pages to smooth checkout processes. Our plugin guarantees optimal performance, delivering lightning-fast load times for an exceptional shopping experience. Responsive design ensures your store looks stunning on any device. Stay ahead with regular updates and dedicated support from our expert team. Elevate your eCommerce game with the eCommerce Companion Plugin today! See below our popular free themes listed here. <a href="https://wordpress.org/themes/mega-mart/" rel="nofollow ugc">Mega Mart</a>, <a href="https://wordpress.org/themes/storely/" rel="nofollow ugc">Storely</a>, <a href="https://wordpress.org/themes/shopient/" rel="nofollow ugc">Shopient</a>, <a href="https://wordpress.org/themes/retailsy/" rel="nofollow ugc">Retailsy</a>, <a href="https://wordpress.org/themes/express-store/" rel="nofollow ugc">Express Store</a>, <a href="https://wordpress.org/themes/flossy/" rel="nofollow ugc">Flossy</a>, <a href="https://wordpress.org/themes/pet-bazaar/" rel="nofollow ugc">Pet Bazaar</a>. See All Themes Here 
<a href="https://www.sellerthemes.com/themes/" rel="dofollow nofollow ugc">https://www.sellerthemes.com/themes/</a>, Documentation Here <a href="https://sellerthemes.ticksy.com/articles/" rel="dofollow nofollow ugc">https://sellerthemes.ticksy.com/articles/</a> and Create Ticket Here <a href="https://sellerthemes.ticksy.com/" rel="dofollow nofollow ugc">https://sellerthemes.ticksy.com/</a>
Features: 
✅ Header Section 
✅ Slider Section 
✅ Info/CTA Section 
✅ Category Section 
✅ Product Section 
✅ Blog/Post Section 
✅ Footer Section
You can check out our themes demo <a href="https://sellerthemes/themes" rel="nofollow ugc">Click Here</a> for a more detailed overview of the features.
Compatible Themes:
<ul>
<li><a href="https://wordpress.org/themes/storely/" rel="ugc">Storely</a> – <a href="https://preview.sellerthemes.com/lite/storely/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/shoply/" rel="ugc">Shoply</a> – <a href="https://preview.sellerthemes.com/lite/shoply/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/storess/" rel="ugc">Storess</a> – <a href="https://preview.sellerthemes.com/lite/storess/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/storezia/" rel="ugc">Storezia</a> – <a href="https://preview.sellerthemes.com/lite/storezia/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/aromatic/" rel="ugc">Aromatic</a> – <a href="https://preview.sellerthemes.com/lite/aromatic/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/ayroma/" rel="ugc">Ayroma</a> – <a href="https://preview.sellerthemes.com/lite/ayroma/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/shopiva/" rel="ugc">Shopiva</a> – <a href="https://preview.sellerthemes.com/lite/shopiva/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/feauty/" rel="ugc">Feauty</a> – <a href="https://preview.sellerthemes.com/lite/feauty/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/shopiva/" rel="ugc">Shopient</a> – <a href="https://preview.sellerthemes.com/lite/shopiva/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/retailsy/" rel="ugc">Retailsy</a> – <a href="https://preview.sellerthemes.com/lite/retailsy/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/express-store/" rel="ugc">Express Store</a> – <a href="https://preview.sellerthemes.com/lite/express-store/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/storefit/" rel="ugc">Storefit</a> – <a href="https://preview.sellerthemes.com/lite/storefit/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/flossy/" rel="ugc">Flossy</a> – <a href="https://preview.sellerthemes.com/lite/flossy/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/flow-store/" rel="ugc">Flow Store</a> – <a href="https://preview.sellerthemes.com/lite/flowstore/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/flexi-mart/" rel="ugc">Flexi Mart</a> – <a href="https://preview.sellerthemes.com/lite/fleximart/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/pet-bazaar/" rel="ugc">Pet Bazaar</a> – <a href="https://preview.sellerthemes.com/lite/petbazaar/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/paw-bazaar/" rel="ugc">Paw Bazaar</a> – <a href="https://preview.sellerthemes.com/lite/pawbazaar/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/pet-store/" rel="ugc">Pet Store</a> – <a href="https://preview.sellerthemes.com/lite/petstore/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/mega-mart/" rel="ugc">Mega Mart</a> – <a href="https://preview.sellerthemes.com/lite/megamart/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/super-mart/" rel="ugc">Super Mart</a> – <a href="https://preview.sellerthemes.com/lite/supermart/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/grocerly/" rel="ugc">Grocerly</a> – <a href="https://preview.sellerthemes.com/lite/grocerly/" rel="nofollow ugc">Free Demo</a></li>
<li><a href="https://wordpress.org/themes/daily-mart/" rel="ugc">Daily Mart</a> – <a href="https://preview.sellerthemes.com/lite/daily-mart/" rel="nofollow ugc">Free Demo</a></li>
</ul>
<h3>License</h3>
eCommerce Companion WordPress plugin, Copyright (C) 2026 Seller Themes 
eCommerce Companion WordPress plugin is licensed under the GPL3 (https://www.gnu.org/licenses/gpl-3.0.en.html).

eCommerce Companion

eCommerce Companion plugin only for Seller Themes. Its fully WooCommerce Compatible Themes

JS Widgets vs eCommerce Companion