History: PluginButton
Source of version: 20 (current)
Copy to clipboard
! Plugin Button Use this ((wiki plugin)), introduced in ((Tiki6|Tiki6.1)), to show links as buttons, while allowing ((Wiki Argument Variables)) (e.g. -+~np~{{itemId}}~/np~+- ) 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 {pluginmanager plugin="button"} !! Example !!! Use a url parameter, icon and danger type ''This code:'' {CODE(colors="tiki")} {button href="Home?itemId={{itemId}}" _text="Go there" _type="danger" _icon_name="wrench"} {CODE} ''Would produce on this site:'' A button with the "Go there" as label, and the wiki argument variable ~np~{{itemId}}~/np~ replaced by the itemId passed in the url of the page where this plugin button is located: {button href="Home?itemId={{itemId}}" _text="Go there" _type="danger" _icon_name="wrench"} !!! Link to a pop-up ''This code:'' {CODE(colors="tiki")} {button href="HomePage" _rel="box" _text="Go there"} {CODE} ''Will create a button that opens the HomePage in a colorbox'': {button href="HomePage" _rel="box" _text="Go there"} !!! Button bar without text ''Since Tiki 19, this code:'' {CODE(colors="tiki")} {button href="HomePage" _icon_name="home" _type="primary"} {button href="Edit" _icon_name="pencil" _type="primary"} {button href="Delete" _icon_name="trash" _type="danger"} {CODE} ''Will create a set of buttons with icons only'': {button href="HomePage" _icon_name="home" _type="info"}{button href="Edit" _icon_name="pencil" _type="primary"}{button href="Delete" _icon_name="trash" _type="danger"} !!! Button that opens the href URL content in a modal with custom redirect once submitted ''Since Tiki 20.2, this code:'' {CODE(colors="tiki")} {button href="HomePage" _class="click-modal" data="modal-submit-redirect-url=/success-page"} {CODE} ''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 {CODE(caption="no style applied")} {button href="#thispage" _text="This is a button from type : none" _type=" "} {CODE} Will display this (a button without any style) {button href="#thispage" _text="This is a button from type : none" _type=" "} !!! Test {CODE()}{button href="((HomePage))" _text="Go there"}{CODE} {button href="((HomePage))" _text="Go there"} !! Related pages * ((PluginSmarty)) * ((PrettyTrackers))