rias/statamic-button-box

There is no license information available for the latest version (3.1.0) of this package.

Installs: 14 527

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 1

Forks: 2

Open Issues: 0

Type:statamic-addon

3.1.0 2024-05-04 13:21 UTC

This package is auto-updated.

Last update: 2024-12-04 14:33:36 UTC


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