https://github.com/codemonauts/craft-customizable-radio-buttons-field

Radio buttons field for Craft CMS, customizable with CSS classes, icons, images and text
https://github.com/codemonauts/craft-customizable-radio-buttons-field

cms craft craft-plugin craftcms field fontawesome radio-buttons

Last synced: about 5 hours ago
JSON representation

Radio buttons field for Craft CMS, customizable with CSS classes, icons, images and text

• Host: GitHub
• URL: https://github.com/codemonauts/craft-customizable-radio-buttons-field
• Owner: codemonauts
• License: mit
• Created: 2019-04-06T07:00:00.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-07-24T15:28:39.000Z (4 months ago)
• Last Synced: 2024-10-29T00:45:29.530Z (20 days ago)
• Topics: cms, craft, craft-plugin, craftcms, field, fontawesome, radio-buttons
• Language: PHP
• Size: 119 KB
• Stars: 6
• Watchers: 3
• Forks: 5
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Customizable Radio Buttons Field for Craft CMS

![Icon](resources/buttons.png)

A field type that add customizable radio buttons to Craft CMS.

## Background

Pictures say more than many words. With this plugin you can add radio buttons as fields, which can be images, icons, CSS classes, texts or a combination of them.

## Requirements

 * Craft CMS >= 4.0.0

## Installation

Open your terminal and go to your Craft project:

``` shell

cd /path/to/project

composer require codemonauts/craft-customizable-radio-buttons-field

```

In the control panel, go to Settings → Plugins and click the “install” button for *Customizable radio buttons field*.

## Configuration

Copy the ```config.php``` to your config folder as ```buttons.php```. Then add button groups like this:

``` php

 '@config/path/to/my.css', // optional path to a local CSS file. This will be automatically published.

  'cssUrl' => 'https://example.com/awesome.css' // Optional URL to an external CSS.

  'buttonGroups' => [

    'myhandle' => [

      'name' => 'My awesome buttons', // The name in the field's configuration dialog.

      'buttons' => [

        'handle-button-1' => [

          'image' => '@buttonsAssets/myimage.jpg', // Optional Image, overwrites 'label'.

          'title' => 'My button 1', // Title and Alt Attributes.

          'value' => 'myvalue', // The value to store (string)

          'class' => 'myclass', // Optional class(es) to add to the button.

          'label' => 'abc', // The button's text, will be overwritten when an image is set.

        ],

        'handle-button-2' => [

          // ...

        ],

        // ...

      ],

      // ...

    ],

  ],

];

``` 

You can have multiple button groups. They all share the same CSS file or CSS URL you can configure. See the [examples](examples/README.md).

With ❤ by [codemonauts](https://codemonauts.com)