Loading...
 
Skip to main content
Add a link formatted as a button

Plugin Button

Use this wiki plugin, introduced in Tiki6.1, to show links as buttons, while allowing Wiki Argument Variables (e.g. ) 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 button
Introduced 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 in it 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:

Copy to clipboard
{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 replaced by the itemId passed in the url of the page where this plugin button is located:

Go there

This code:

Copy to clipboard
{button href="HomePage" _rel="box" _text="Go there"}

Will create a button that opens the HomePage in a colorbox:

Go there

Button bar without text

Since Tiki 19, this code:

Copy to clipboard
{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:

Copy to clipboard
{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)
Using this code

no style applied
Copy to clipboard
{button href="#thispage" _text="This is a button from type : none" _type=" "}

Will display this (a button without any style)
This is a button from type : none

Test

Copy to clipboard
{button href="((HomePage))" _text="Go there"}

Go there

Show PHP error messages