{"id":34867078,"url":"https://github.com/numencode/wn-widgets-plugin","last_synced_at":"2026-04-27T02:31:53.495Z","repository":{"id":236312623,"uuid":"264022977","full_name":"numencode/wn-widgets-plugin","owner":"numencode","description":"NumenCode Widgets plugin for Winter CMS","archived":false,"fork":false,"pushed_at":"2025-03-30T16:39:34.000Z","size":69,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-20T14:39:19.946Z","etag":null,"topics":["laravel","numencode","php","plugin","winter","wintercms","wintercms-plugin"],"latest_commit_sha":null,"homepage":"https://www.numencode.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/numencode.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-14T20:54:46.000Z","updated_at":"2025-07-09T10:15:52.000Z","dependencies_parsed_at":"2024-04-26T15:26:57.471Z","dependency_job_id":"9fb10e80-e65b-4d2c-b5b5-c634a507864f","html_url":"https://github.com/numencode/wn-widgets-plugin","commit_stats":null,"previous_names":["numencode/wn-widgets-plugin"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/numencode/wn-widgets-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numencode%2Fwn-widgets-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numencode%2Fwn-widgets-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numencode%2Fwn-widgets-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numencode%2Fwn-widgets-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/numencode","download_url":"https://codeload.github.com/numencode/wn-widgets-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numencode%2Fwn-widgets-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28039254,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-25T02:00:05.988Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["laravel","numencode","php","plugin","winter","wintercms","wintercms-plugin"],"created_at":"2025-12-25T22:38:56.546Z","updated_at":"2025-12-25T22:38:57.027Z","avatar_url":"https://github.com/numencode.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Widgets Plugin\n\nThe **NumenCode Widgets** plugin for Winter CMS provides a flexible and easy-to-use solution for managing reusable\nwidgets in Winter CMS. This plugin simplifies adding dynamic, visually engaging components to your themes and\ntemplates, enhancing the overall user experience.\n\n[![Version](https://img.shields.io/github/v/release/numencode/wn-widgets-plugin?style=flat-square\u0026color=0099FF)](https://github.com/numencode/wn-widgets-plugin/releases)\n[![Packagist PHP Version Support](https://img.shields.io/packagist/php-v/numencode/wn-widgets-plugin?style=flat-square\u0026color=0099FF)](https://packagist.org/packages/numencode/wn-widgets-plugin)\n[![Checks](https://img.shields.io/github/check-runs/numencode/wn-widgets-plugin/main?style=flat-square)](https://github.com/numencode/wn-widgets-plugin/actions)\n[![Tests](https://img.shields.io/github/actions/workflow/status/numencode/wn-widgets-plugin/tests.yml?branch=main\u0026label=tests\u0026style=flat-square)](https://github.com/numencode/wn-widgets-plugin/actions)\n[![License](https://img.shields.io/github/license/numencode/wn-widgets-plugin?label=open%20source\u0026style=flat-square\u0026color=0099FF)](https://github.com/numencode/wn-widgets-plugin/blob/main/LICENSE.md)\n\n---\n\n## Target Audience\n\nThe target audience for this plugin includes developers and designers who want to enhance their Winter CMS projects\nby incorporating reusable, visually appealing widgets. The provided widgets, such as counters, promotions, features,\nhighlights, and galleries, are commonly used in modern web design and are often found in templates and themes\navailable on various marketplaces. This plugin bridges the gap between static designs and dynamic functionality.\n\n## Installation\n\nThis plugin is available for installation via [Composer](http://getcomposer.org/).\n\n```bash\ncomposer require numencode/wn-widgets-plugin\n```\n\nAfter installing the plugin you will need to run the migrations.\n\n```bash\nphp artisan winter:up\n```\n\n## Requirements\n\n* [NumenCode Fundamentals Plugin](https://github.com/numencode/wn-fundamentals-plugin) version ^1.1 or higher.\n* [Winter CMS](https://wintercms.com/) 1.2.7 or higher.\n* PHP version 8.0 or higher.\n\n---\n\n## Features Overview\n\nThis plugin provides an intuitive interface to create and manage a variety of widgets, enabling end users\nto customize their websites with ease. With multilingual support via the `Winter.Translate` plugin,\nit ensures global usability.\n\n### Component Rendering System\n\nAll widget components in this plugin leverage the `ComponentRenderer` trait from the **NumenCode.Fundamentals** plugin.\nThis provides several key benefits:\n\n- **Automatic Alias Resolution**: Each component’s alias is automatically set based on its class name.\n- **Customizable Rendering**: Users can override default component templates via theme partials.\n- **Layout Selection**: Components support multiple layout options, allowing greater flexibility in presentation.\n\n#### Overriding a Component’s Layout\n\nTo override a component’s layout, follow these steps:\n\n1. Create a folder inside your theme's `partials` directory that matches the component's alias\n   (e.g., `/themes/custom/partials/mycomponent`) and add layout files such as `default.htm`, `special.htm`, etc.\n2. In your custom plugin's `Plugin.php` file, enable layout overrides in the `boot()` method by setting the\n   static property `$overrideLayout` to `true`. Example:\n\n   ```php\n   class Plugin extends PluginBase\n   {\n       public function boot()\n       {\n           \\NumenCode\\Widgets\\Components\\Promotions::$overrideLayout = true;\n       }\n   }\n   ```\n\n---\n\n## Available Widgets\n\n### Counters\n\nShowcase statistics or numeric information on your website using dynamic and engaging animated counters.\nEnter the desired number, provide explanatory text, and optionally include an icon class for added flair.\nCounters can be easily configured through component properties.\n\n### Promotions\n\nCreate attention-grabbing promotional content such as sliders and carousels that seamlessly integrate\ninto your website's aesthetic. Perfect for highlighting creative content within a compact space.\nPromotions are managed via the `Promotions` tab in the Widgets plugin.\n\n### Features\n\nDisplay multiple items in an organized list or an eye-catching slider/carousel format. This is ideal\nfor showcasing services, products, or other grouped content. Manage features directly from the `Features` tab.\n\n### Highlights\n\nCreate visually striking content cards with accompanying descriptions to emphasize key aspects of your website.\nHighlights are perfect for promoting unique selling points or key features and are managed through the `Highlights` tab.\n\n### Gallery\n\nEasily create and manage multiple image galleries with a flexible and intuitive interface. Upload, reorder,\nand showcase images using the dedicated Gallery component, which seamlessly integrates into any page.\nManage galleries via the `Gallery` tab in the Widgets plugin.\n\n---\n\n## Changelog\n\nAll notable changes are documented in the [CHANGELOG](CHANGELOG.md).\n\n---\n\n## Contributing\n\nPlease refer to the [CONTRIBUTING](CONTRIBUTING.md) guide for details on contributing to this project.\n\n---\n\n## Security\n\nIf you identify any security issues, email info@numencode.com rather than using the issue tracker.\n\n---\n\n## Author\n\nThe **NumenCode.Widgets** plugin is created and maintained by [Blaz Orazem](https://orazem.si/).\n\nFor inquiries, contact: info@numencode.com\n\n---\n\n## License\n\nThis project is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).\n\n[![License](https://img.shields.io/github/license/numencode/wn-widgets-plugin?style=flat-square\u0026color=0099FF)](https://github.com/numencode/wn-widgets-plugin/blob/main/LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnumencode%2Fwn-widgets-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnumencode%2Fwn-widgets-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnumencode%2Fwn-widgets-plugin/lists"}