PHPackages                             numencode/wn-widgets-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. numencode/wn-widgets-plugin

ActiveWinter-plugin[Utility &amp; Helpers](/categories/utility)

numencode/wn-widgets-plugin
===========================

NumenCode Widgets plugin for Winter CMS

v1.2.0(1y ago)015MITPHPPHP ^8.0.2CI passing

Since Jan 16Pushed 1y ago1 watchersCompare

[ Source](https://github.com/numencode/wn-widgets-plugin)[ Packagist](https://packagist.org/packages/numencode/wn-widgets-plugin)[ Docs](https://www.numencode.com)[ RSS](/packages/numencode-wn-widgets-plugin/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (1)Versions (5)Used By (0)

Widgets Plugin
==============

[](#widgets-plugin)

The **NumenCode Widgets** plugin for Winter CMS provides a flexible and easy-to-use solution for managing reusable widgets in Winter CMS. This plugin simplifies adding dynamic, visually engaging components to your themes and templates, enhancing the overall user experience.

[![Version](https://camo.githubusercontent.com/fe04d77c13449ea66a6b288ee0de1fec8eae0b9421fe166370f37679167ff33b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6e756d656e636f64652f776e2d776964676574732d706c7567696e3f7374796c653d666c61742d73717561726526636f6c6f723d303039394646)](https://github.com/numencode/wn-widgets-plugin/releases)[![Packagist PHP Version Support](https://camo.githubusercontent.com/26756aa8049b8a0f622f771811923c4973be00a8951dd80ce57734d39748405b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6e756d656e636f64652f776e2d776964676574732d706c7567696e3f7374796c653d666c61742d73717561726526636f6c6f723d303039394646)](https://packagist.org/packages/numencode/wn-widgets-plugin)[![Checks](https://camo.githubusercontent.com/28da5b2a42957071bbe616f13b33cd5249e6517dfaa87411277d67286c6cb5da/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636865636b2d72756e732f6e756d656e636f64652f776e2d776964676574732d706c7567696e2f6d61696e3f7374796c653d666c61742d737175617265)](https://github.com/numencode/wn-widgets-plugin/actions)[![Tests](https://camo.githubusercontent.com/8c0a125140e4354b1db3411e5c8b9ae5593908d7af8d46205be600ef3105b75d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6e756d656e636f64652f776e2d776964676574732d706c7567696e2f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/numencode/wn-widgets-plugin/actions)[![License](https://camo.githubusercontent.com/aa5a41020ac10716b70760d0cb607635e2de5d4b967d7ec1e5ce2baa62463ddb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6e756d656e636f64652f776e2d776964676574732d706c7567696e3f6c6162656c3d6f70656e253230736f75726365267374796c653d666c61742d73717561726526636f6c6f723d303039394646)](https://github.com/numencode/wn-widgets-plugin/blob/main/LICENSE.md)

---

Target Audience
---------------

[](#target-audience)

The target audience for this plugin includes developers and designers who want to enhance their Winter CMS projects by incorporating reusable, visually appealing widgets. The provided widgets, such as counters, promotions, features, highlights, and galleries, are commonly used in modern web design and are often found in templates and themes available on various marketplaces. This plugin bridges the gap between static designs and dynamic functionality.

Installation
------------

[](#installation)

This plugin is available for installation via [Composer](http://getcomposer.org/).

```
composer require numencode/wn-widgets-plugin
```

After installing the plugin you will need to run the migrations.

```
php artisan winter:up
```

Requirements
------------

[](#requirements)

- [NumenCode Fundamentals Plugin](https://github.com/numencode/wn-fundamentals-plugin) version ^1.1 or higher.
- [Winter CMS](https://wintercms.com/) 1.2.7 or higher.
- PHP version 8.0 or higher.

---

Features Overview
-----------------

[](#features-overview)

This plugin provides an intuitive interface to create and manage a variety of widgets, enabling end users to customize their websites with ease. With multilingual support via the `Winter.Translate` plugin, it ensures global usability.

### Component Rendering System

[](#component-rendering-system)

All widget components in this plugin leverage the `ComponentRenderer` trait from the **NumenCode.Fundamentals** plugin. This provides several key benefits:

- **Automatic Alias Resolution**: Each component’s alias is automatically set based on its class name.
- **Customizable Rendering**: Users can override default component templates via theme partials.
- **Layout Selection**: Components support multiple layout options, allowing greater flexibility in presentation.

#### Overriding a Component’s Layout

[](#overriding-a-components-layout)

To override a component’s layout, follow these steps:

1. Create a folder inside your theme's `partials` directory that matches the component's alias (e.g., `/themes/custom/partials/mycomponent`) and add layout files such as `default.htm`, `special.htm`, etc.
2. In your custom plugin's `Plugin.php` file, enable layout overrides in the `boot()` method by setting the static property `$overrideLayout` to `true`. Example:

    ```
    class Plugin extends PluginBase
    {
        public function boot()
        {
            \NumenCode\Widgets\Components\Promotions::$overrideLayout = true;
        }
    }
    ```

---

Available Widgets
-----------------

[](#available-widgets)

### Counters

[](#counters)

Showcase statistics or numeric information on your website using dynamic and engaging animated counters. Enter the desired number, provide explanatory text, and optionally include an icon class for added flair. Counters can be easily configured through component properties.

### Promotions

[](#promotions)

Create attention-grabbing promotional content such as sliders and carousels that seamlessly integrate into your website's aesthetic. Perfect for highlighting creative content within a compact space. Promotions are managed via the `Promotions` tab in the Widgets plugin.

### Features

[](#features)

Display multiple items in an organized list or an eye-catching slider/carousel format. This is ideal for showcasing services, products, or other grouped content. Manage features directly from the `Features` tab.

### Highlights

[](#highlights)

Create visually striking content cards with accompanying descriptions to emphasize key aspects of your website. Highlights are perfect for promoting unique selling points or key features and are managed through the `Highlights` tab.

### Gallery

[](#gallery)

Easily create and manage multiple image galleries with a flexible and intuitive interface. Upload, reorder, and showcase images using the dedicated Gallery component, which seamlessly integrates into any page. Manage galleries via the `Gallery` tab in the Widgets plugin.

---

Changelog
---------

[](#changelog)

All notable changes are documented in the [CHANGELOG](CHANGELOG.md).

---

Contributing
------------

[](#contributing)

Please refer to the [CONTRIBUTING](CONTRIBUTING.md) guide for details on contributing to this project.

---

Security
--------

[](#security)

If you identify any security issues, email  rather than using the issue tracker.

---

Author
------

[](#author)

The **NumenCode.Widgets** plugin is created and maintained by [Blaz Orazem](https://orazem.si/).

For inquiries, contact:

---

License
-------

[](#license)

This project is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

[![License](https://camo.githubusercontent.com/2f93f31ad063a454f85c2a70fd07e8395b1d941a9ed91e646c43eab50c205ba9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6e756d656e636f64652f776e2d776964676574732d706c7567696e3f7374796c653d666c61742d73717561726526636f6c6f723d303039394646)](https://github.com/numencode/wn-widgets-plugin/blob/main/LICENSE.md)

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance45

Moderate activity, may be stable

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~21 days

Total

4

Last Release

424d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/975dd5a96021f39a82e0708c39da6be28b68a78bb80566fb1cbc91dc64edf8d0?d=identicon)[blazorazem](/maintainers/blazorazem)

---

Top Contributors

[![BlazOrazem](https://avatars.githubusercontent.com/u/5699173?v=4)](https://github.com/BlazOrazem "BlazOrazem (39 commits)")

---

Tags

laravelnumencodephppluginwinterwintercmswintercms-pluginpluginlaravelwinterwinter cmsnumencode

### Embed Badge

![Health badge](/badges/numencode-wn-widgets-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/numencode-wn-widgets-plugin/health.svg)](https://phpackages.com/packages/numencode-wn-widgets-plugin)
```

###  Alternatives

[awcodes/filament-table-repeater

A modified version of the Filament Forms Repeater to display it as a table.

262815.1k5](/packages/awcodes-filament-table-repeater)[winter/wn-blog-plugin

Blog plugin for Winter CMS

2042.1k3](/packages/winter-wn-blog-plugin)[winter/wn-sitemap-plugin

Sitemap plugin for Winter CMS

1042.6k1](/packages/winter-wn-sitemap-plugin)[awcodes/recently

Easily track and access recently viewed records in your filament panels.

4224.3k](/packages/awcodes-recently)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
