README

👁 Latest Version

Button Box

Button Box for Statamic 3.

Create beautiful choices for your clients.

👁 Screenshot

License

Button Box requires a license to be used while on a production site.
You can purchase one at https://statamic.com/marketplace/addons/button-box.

You may use Button Box without a license while Statamic is in Trial mode.

Installation

Require it using Composer.

composer require rias/statamic-button-box

Publish the assets and configuration:

php artisan vendor:publish --provider="Rias\ButtonBox\ServiceProvider"

Using Button Box

Add the fieldtype to your fieldset.

Each option contains the following fields:

• label - This is show when neither an icon or an image is present
• value - The value that you'll use in your templates
• image - An image
• icon - A FontAwesome Free icon

sections:
 main:
 display: Main
 fields:
 -
 handle: choice
 field:
 type: button_box
 display: Choice
 options:
 -
 label: Left
 value: left
 image: left.svg
 icon: null
 -
 label: Center
 value: center
 image: center.svg
 icon: null
 -
 label: Right
 value: right
 image: right.svg
 icon: null

Using Button Box

{{ choice }} # will contain either "left", "center" or "right" from the example above

Using a different Asset container

Button Box comes with a configuration file that you can change after publishing, it will live at config/statamic/button-box.php, here you can define the handle of the Asset Container that has to be used for the images.

return [
 /**
 * If you want Button Box to use a different container
 * you can define the container handle to be used.
 */
 'container' => null,
];

Brought to you by Rias