Bulma Shortcodes

Description

This plugin adds a collection of WordPress shortcodes for Bulma components as well as a simple TinyMCE dropdown to add them.

Usage

The easiest way to add shortcodes is through the Bulma dropdown in the WordPress editor. Alternatively, you can manually type out the shortcodes.

Columns

Columns are used to create a responsive grid:

[bulma-columns]
[bulma-column]
Your content...
[/bulma-column]
[bulma-column]
Your content...
[/bulma-column]
[/bulma-columns]

The [bulma-column] shortcode accepts a type argument:

[bulma-column type="is-8"][/bulma-column]

Due to limitations within the WordPress shortcode system, nesting identical shortcodes will break. To work around this, there are additional shortcodes you can use that will also produce columns:

// Will break
[bulma-columns]
    [bulma-column]
        [bulma-columns]
            [bulma-column][/bulma-column]
            [bulma-column][/bulma-column]
        [/bulma-columns]
    [/bulma-column]
    [bulma-column]
        [bulma-columns]
            [bulma-column][/bulma-column]
            [bulma-column][/bulma-column]
        [/bulma-columns]
    [/bulma-column]
[/bulma-columns]

// Will Work
[bulma-columns]
    [bulma-column]
        [bulma-columns-1]
            [bulma-column-1][/bulma-column-1]
            [bulma-column-1][/bulma-column-1]
        [/bulma-columns-1]
    [/bulma-column]
    [bulma-column]
        [bulma-columns-1]
            [bulma-column-1][/bulma-column-1]
            [bulma-column-1][/bulma-column-1]
        [/bulma-columns-1]
    [/bulma-column]
[/bulma-columns]

You can nest up to five levels deep with this system (column, column-1, column-2, column-3, column-4).

Button

Creates the tag <a href="#" class="button">Your Content</a>.

Accepts three arguments:

  • type – Accepts class names – defaults to ‘is-primary’
  • link – Accepts strings – defaults to ‘#’
  • icon – Accepts valid font-awesome icon names

Ex: [bulma-button type="is-primary" link="www.example.com" icon="github"]Star on GitHub[/bulma-button].

Icon

Creates the tag <span class="icon"><i class="fa fa-<icon name>></i></span>".

Accepts two arguments:

  • type – Accepts class names – defaults to ‘is-primary’
  • icon – Accepts valid font-awesome icon names

Box

Adds a Bulma box element.

Accepts one argument, type. Defaults to NOT full-width box as this element in WordPress is mostly helpful for adding emphasis to an item like a photo. If type is set to full-width, it’ll behave like a normal Bulma box.

Ex:

// NOT full-width
[bulma-box]Your content...[/bulma-box]

// Full-width
[bulma-box type="full-width"]Your Content...[/bulma-box]

Notification

Adds a Bulma notification element.

Accepts one argument, type.

Ex: [bulma-notification type="is-primary"]Alert[/bulma-notification]

Card

Creates a Bulma Card element. This shortcode has several child codes:

[bulma-card]
[bulma-card-header][/culma-card-header]
[bulma-card-content][/bulma-card-content]
[bulma-card-footer][/bulma-card-footer]
[/bulma-card]

None of the shortcodes accept arguments.

[bulma-card-footer] can be given multiple footer items:


[bulma-card-footer]Item1|Item2|Item3[/bulma-card-footer]

// Will generate:

<footer class="card-footer">
    <div class="card-footer-item">
        Item1
    </div>
    <div class="card-footer-item">
        Item2
    </div>
    <div class="card-footer-item">
        Item3
    </div>
</footer>

Menu

Creates a Bulma menu.

Ex:

[bulma-menu]
[bulma-menu-label]Label[/bulma-menu-label]
[bulma-menu-list]<a href="#">Item1</a>|<a href="#">Item2</a>[/bulma-menu-list]
[/bulma-menu]

Screenshots

  • The Bulma shortcode dropdown in the editor.

  • Example of an inserted shortcode.

Installation

  1. Ensure that you have the most recent version of Bulma CSS added to your theme.
  2. Upload the plugin files to /wp-content/plugins/plugin-name or install directly through WordPress.
  3. Activate the plugin!

FAQ

Installation Instructions
  1. Ensure that you have the most recent version of Bulma CSS added to your theme.
  2. Upload the plugin files to /wp-content/plugins/plugin-name or install directly through WordPress.
  3. Activate the plugin!

Reviews

Read all 1 review

Contributors & Developers

“Bulma Shortcodes” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Bulma Shortcodes” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0

  • Initial release