History: PluginButton
Preview of version: 19
Plugin Button
Use this wiki plugin, introduced in Tiki6.1, to show links as buttons, while allowing Wiki Argument Variables (e.g. {{itemId}} ) to be used without the need of an admin to re-validate the plugin call each time (as it has to be done if you use for such task the generic PluginSmarty, each time a new itemId is passed in the url to the wiki page containing the plugin).
This is specially useful in cases of custom workflows using trackers and wiki pages with tracker plugins to insert data, edit it afterwards, etc., and showing those links as buttons.
Since Tiki18 it is possible to fully style your button using the parameter "none" for the type. The button plugin comes with default type ready to use and if not set the btn-primary style/type will be used. Setting this parameter cancel any btn- default style from bootstrap (ie:btn-primary). Once set to none you cam fully customize your button using your own style.
Since Tiki19 it is possible to display only an icon without label (text). See example below.
Parameters
Add a link formatted as a buttonIntroduced in Tiki 6.1. Required parameters are in
bold.Go to the source code
Preferences required: wikiplugin_button
| Parameters | Accepted Values | Description | Default | Since |
|---|---|---|---|---|
| (body of plugin) | Label for the button (ignored if the text is defined) | |||
href |
url | URL to be produced by the button. For Wiki page uses Page Name format. You can use wiki argument variables like
|
6.1 | |
height |
text | In pixels or percentage. (e.g. 200px or 100%) | 20 | |
width |
text | In pixels or percentage. (e.g. 200px or 100%) | 20 | |
_class |
text | CSS class for the button. Note that the btn class is always applied by default | 6.1 | |
_style |
text | CSS style attributes | 6.1 | |
_icon_name |
text | Enter an iconset name to show an icon in the button | 14.0 | |
_text |
text | Label for the button | 6.1 | |
_rel |
text | Enter box for colorbox effect (like shadowbox and lightbox) or appropriate
syntax for link relation. |
7.0 | |
_auto_args |
text | Comma-separated list of URL arguments that will be kept from _REQUEST (like
$auto_query_args) in addition to those you can specify in the href parameter.You can also use _auto_args="*" to specify that every arguments listed in the
global var $auto_query_args has to be kept from URL |
6.1 | |
_type |
(blank) danger default info link primary success warning |
Use a type to style the button. By default btn-primary will be applied. | 13.0 | |
data |
text | URL encoded list or attributes and values. | 20.2 | |
_disabled |
alpha | Set to y to disable the button |
6.1 | |
_flip_id |
alpha | HTML id attribute of the element to show/hide content | 6.1 | |
_target |
(blank) _blank _parent _top |
A target attribute specifies where to open the linked document. Set to _self by default | 21.0 | |
_escape |
(blank) y n |
If set to y, will escape the apostrophes in onclick |
6.1 | |
_flip_default_open |
(blank) y n |
If set to y, the flip is open by default (if no cookie jar) |
6.1 | |
_flip_hide_text |
(blank) y n |
If set to No (n), will not display a "(Hide)" suffix after the button label
when the content is shown |
6.1 |
Example
Use a url parameter, icon and danger type
This code:
{button href="Home?itemId=" _text="Go there" _type="danger" _icon_name="wrench"}
Would produce on this site:
A button with the "Go there" as label, and the wiki argument variable {{itemId}} replaced by the itemId passed in the url of the page where this plugin button is located:
Link to a pop-up
This code:
{button href="HomePage" _rel="box" _text="Go there"}
Will create a button that opens the HomePage in a colorbox:
Button bar without text
Since Tiki 19, this code:
{button href="HomePage" _icon_name="home" _type="primary"} {button href="Edit" _icon_name="pencil" _type="primary"} {button href="Delete" _icon_name="trash" _type="danger"}
Will create a set of buttons with icons only:
Button that opens the href URL content in a modal with custom redirect once submitted
Since Tiki 20.2, this code:
{button href="HomePage" _class="click-modal" data="modal-submit-redirect-url=/success-page"}
Will load the href URL in a modal, and redirect to the URL given in the data attribute once the form (if any) within the modal is submitted.
Create a button with your own color (style)
Setting parameter type to none allow full customization using your own style for a button. (it remove default btn-xxx style)
This is a button from type : none
Test
{button href="((HomePage))" _text="Go there"}