The Speech Bubble Plugin is for Grav CMS. Easily display a dialogue style speech bubble.
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets
shortcodes
templates/partials
.gitignore
CHANGELOG.md
LICENSE
README.md
blueprints.yaml
speech-bubble.php
speech-bubble.yaml

README.md

Speech Bubble Plugin

The Speech Bubble Plugin is for Grav CMS. Easily display a dialogue style speech bubble.

Installation

Installing the Speech Bubble plugin can be done in one of two ways. The GPM (Grav Package Manager) installation method enables you to quickly and easily install the plugin with a simple terminal command, while the manual method enables you to do so via a zip file.

GPM Installation (Preferred)

The simplest way to install this plugin is via the Grav Package Manager (GPM) through your system's terminal (also called the command line). From the root of your Grav install type:

bin/gpm install speech-bubble

This will install the Speech Bubble plugin into your /user/plugins directory within Grav. Its files can be found under /your/site/grav/user/plugins/speech-bubble.

Manual Installation

To install this plugin, just download the zip version of this repository and unzip it under /your/site/grav/user/plugins. Then, rename the folder to speech-bubble. You can find these files on GitHub or via GetGrav.org.

You should now have all the plugin files under

/your/site/grav/user/plugins/speech-bubble

NOTE: This plugin is a modular component for Grav which requires Grav and the Error and Problems to operate.

Configuration

Before configuring this plugin, you should copy the user/plugins/speech-bubble/speech-bubble.yaml to user/config/plugins/speech-bubble.yaml and only edit that copy.

Here is the default configuration and an explanation of available options:

enabled: true
bubble:
  type: std
icon:
  type: square
  image:
    left: foo.jpeg
    right: bar.jpeg
  • bubble.type: Set bubble type.std, pop, think or flat.
  • icon.type: Set icon frame type.square, circle or hidden.
  • icon.image.{left|right}: Set image file name. Image files need to be placed in user/plugins/speech-bubble/assets/icon/.

Usage

[bubble side=left type=std]How are you?[/bubble]
[bubble side=right icon=page_upload_image.jpg]I’m doing great.[/bubble]

  • options
    • side: Set bubble side right or left. If option is not set, left.
    • type: Set bubble type.std, pop, think or flat. If option is not set, use the value of config.
    • icon: Set icon path. If option is not set, use the value of config.
    • label: Set icon label. It is not displayed when icon.type is hidden.