Title: Balloon Widget plug-in
This plug-in provides the "balloon" widget that decorates a sentence like a "cartoon balloon" so that it should be eye-catching.
When you put a summary into your TeamPage entry (article, task, event, etc.), you may use a dot-list or a number-list. Something like;
- John says something...
- Lisa says something...
- Mark says something...
However, this kind of summary list could be impacted among the other text because it is just a text description.
On the other hand, the balloon-decorated description is eye-catching. If you put the conversation above between John, Lisa, and Mark into balloons, the "who says what" will be easy to understand at a glance.
Here is two options. Which do you think is better?
I prefer the A. It's really nice.
Definitely B. This must be what we've been looking for.
* Icons made by Freepik from www.flaticon.com is licensed by CC 3.0 BY
* The example face images are from by 16snow at sozaijiten-busine....
Click the link below to download the .zip file of this plug-in.
This zip file contains the "main unit" of the plug-in. It let you put a balloon by writing something like
[[ /balloon name="john" say="My name is John." ]]
in your entry body content.
If you want to use the widget for the balloon (the setting dialog to embed a balloon into the body text) instead of writing the command (a.k.a. rapid selector) above, please install the following zip file as well.
How to install
Log in to your TeamPage server and open Server Settings > Plugins. Select the .zip file(s) and upload it.
After upload, you will see the I18N error, but don't worry. This error means just the language files (locale files) have not loaded yet.
Open Server Settings > General > Manage Server page and click the "Restart TeamPage" button so that TeamPage server loads the language files.
If your TeamPage is hosted in Traction's cloud environment, you will need to restart twice.
Then open Server Settings > Plugins page again to find "Balloon Widget" plug-in is available.
How to use
For Server Admins
Please click the [configure] link in the plug-in's slot in Server Settings > Plugins page.
And modify the names of the characters and the paths of the image files.
Please note that the folder where the images are stored should be readable by everyone. If you upload the images into the Sales space's share folder, for example, the images will not show up when a user who doesn't have the "read share folder" permission open the entry with the balloon.
/speech in the double brackets with the following options.
[[ /balloon name="john" align="right" color="red" say="My name is John Smith. Nice to meet you." ]]
The benefit of not using the widget is that you can tell what the character says when you take just a glance at the
name= or char=
The names of the characters. The defaults are John, Lisa, Mark, Karen, Will, and Olivia. Please select one of these characters by using the
char= option. Case insensitive. You can also select one of them by
faceN or just
N. (N is the number of the character, currently from 1 to 6.)
Server admins can change the names and the images of the characters in the plug-in's configuration view. If the server admin changes the name of the 1st character from John to Dave, you can display the 1st character by name="dave", name="face1", name="1", char="dave", char="face1", or char="1".
words= or say=
The sentence shows up in the balloon.
align=[left] or pos=
Indicates the align of the character and the balloon. The default is left.
You can select the color of the border of the image and the balloon and the background color of the balloon. The available colors are black, red, orange, yellow, green, blue, indigo, purple, gray, and bluegray.
Indicates the max width of the character + balloon. The default is 600 pixels. The available widths are 400, 500, 600, 700, 800, 900, and 1000 pixels.
Indicates the width of the character image. The default is 60 pixels. The available widths are 60, 70, 80, 90, 100, 110, 120, 130, 140, and 150 pixels.
Indicates the font size of the balloon text. The number means the percentage. If you select "110" here, the font-size will be 110% larger than the normal one. The default is 100. The available percentages are 100, 110, 120, 130, 140, and 150.
The benefit of using the widget is that it's easy to insert it and select options on the dialog.
To insert the widget, select [Insert/Edit Widget] > [More] > [Balloon] menu.
Fill-in the "words", select the options, and click "OK".
You will see that the widget is inserted into the body text.
When you post the entry, you will see the widget is rendered as a character picture + a balloon.
Character John), default size (60px), default width (600px), default align (left), default color (gray)
[[ /balloon name="john" words="Hello. I'm John." ]]
Character No.3, size 80px, width 600, align right, color = red.
[[ /balloon name="3" words="Here comes a soul train. Let's dance!" picsize="80" align="right" color="red" ]]
Here comes a soul train. Let's dance!
Character No.5, size 100px, width 700px, align left, color = black.
[[ /balloon char="face5" say="It's hot and humid. Jump, splash, into the water! " color="black" picsize="100" width="700" align="left" ]]
It's hot and humid. Jump, splash, into the water!