plugin:button
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:button [2016-08-15 13:38] – Added elenor compatibility 89.93.6.143 | plugin:button [2024-01-18 12:58] (current) – Aleksandr | ||
---|---|---|---|
Line 6: | Line 6: | ||
email : remi+dokuwiki@via.ecp.fr | email : remi+dokuwiki@via.ecp.fr | ||
type : syntax | type : syntax | ||
- | lastupdate : 2016-02-07 | + | lastupdate : 2023-08-18 |
- | compatible : Adora Belle, Weatherwax, Binky, Ponder Stibbons, Hrun, Detritus, Elenor Of Tsort | + | compatible : Adora Belle, Weatherwax, Binky, Ponder Stibbons, Hrun, Detritus, Elenor Of Tsort, Frusterick Manners, Greebo, Hogfather, Igor, Jack Jackrum |
depends | depends | ||
conflicts | conflicts | ||
- | similar | + | similar |
tags : button, links | tags : button, links | ||
downloadurl: | downloadurl: | ||
+ | bugtracker : https:// | ||
sourcerepo : https:// | sourcerepo : https:// | ||
- | screenshot_img : http://people.via.ecp.fr/ | + | screenshot_img : http://rpeyron.github.io/plugin-button/ |
---- | ---- | ||
===== Installation ===== | ===== Installation ===== | ||
- | Install | + | Search and install |
===== Examples/ | ===== Examples/ | ||
- | See the plugin in action [[http:// | + | Below is a screenshot of a basic resulting button: |
- | {{http://people.via.ecp.fr/ | + | {{http://rpeyron.github.io/plugin-button/ |
===== Syntax ===== | ===== Syntax ===== | ||
- | The full syntax is : | + | The full syntax is: |
< | < | ||
[[{namespace: | [[{namespace: | ||
</ | </ | ||
- | Where : | + | Where: |
* '' | * '' | ||
* '' | * '' | ||
- | * '' | + | * '' |
- | * '' | + | * targets with %%://%% or %%mailto:%% are treated as external URI; |
+ | * you may also use '' | ||
+ | * protocol has to be allowed in dokuwiki, check [[: | ||
+ | * '' | ||
- | All fields are optional, so the minimal syntax is : | + | All fields are optional, so the minimal syntax is: |
< | < | ||
[[{}Simple button without image]] | [[{}Simple button without image]] | ||
</ | </ | ||
- | You may also configure the target of the link with the use of conf.target : | + | You may configure some styles to use in your buttons without repeating all the css: |
+ | < | ||
+ | [[{conf.styles}style|css]] | ||
+ | </ | ||
+ | |||
+ | Where: | ||
+ | * '' | ||
+ | * '' | ||
+ | * if ‘default’, | ||
+ | * '' | ||
+ | |||
+ | You may then use the '' | ||
+ | |||
+ | < | ||
+ | Style declaration: | ||
+ | [[{conf.styles}default|font-family: | ||
+ | [[{conf.styles}mystyle|color: | ||
+ | |||
+ | Style use: | ||
+ | [[{|mystyle}Button in times new roman]] | ||
+ | [[{}Button in green and in times new roman]] | ||
+ | </ | ||
+ | |||
+ | You may also add styles that will be available for all pages in the plugin section of the configuration page. You will have to add one line per style: | ||
+ | < | ||
+ | default|font-family: | ||
+ | mystyle|color: | ||
+ | </ | ||
+ | |||
+ | Note that the CSS part is a bit tricky due to the selectors used in the template CSS and the layout needed for the button. By default, the style of the links is not repeated (just external links icon). See comments in style.css file for more information. | ||
+ | |||
+ | You may also configure the target of the link with the use of conf.target: | ||
< | < | ||
[[{conf.target}style|target]] | [[{conf.target}style|target]] | ||
Line 56: | Line 91: | ||
</ | </ | ||
- | Please go [[http:// | + | A button is added to the toolbar to add the template button. |
+ | Compatible with move plugin. | ||
===== Troubleshooting ===== | ===== Troubleshooting ===== | ||
- | * If you experience display problems with Internet Explorer, please check the " | + | * If you experience display problems with Internet Explorer, please check the " |
===== Contributions ===== | ===== Contributions ===== | ||
- | Feel free to contribute to this plugin: source on GitHub: [[https:// | + | Feel free to contribute to this plugin source on GitHub: [[https:// |
+ | |||
+ | Thank you to: | ||
+ | * Xavier Decuyper (toolbar button) | ||
+ | * lisps (global config, internal media link support, escaping of userinput) | ||
+ | * ThisNameIsNotAllowed (support for [[move]] plugin) | ||
===== Changelog ===== | ===== Changelog ===== | ||
- | * 19/05/2013: Initial release | + | * 19/05/2013 : Initial release |
- | * 20/04/2014: Added target support (feature request from Andrew St Hilaire) | + | * 20/04/2014 : Added target support (feature request from Andrew St Hilaire) |
- | * 07/06/2014: Added formatting support in description link text (but not in page link section) (feature request from Willi Lethert) | + | * 07/06/2014 : Added formatting support in description link text (but not in page link section) (feature request from Willi Lethert) |
- | * 30/08/2014: Added toolbar button (contribution from [[http:// | + | * 30/08/2014 : Added toolbar button (contribution from [[http:// |
- | * 06/09/2014: Refactored to add backlinks support (feature request from Schümmer Hans-Jürgen); | + | * 06/09/2014 : Refactored to add backlinks support (feature request from Schümmer Hans-Jürgen); |
- | * 28/04/2015: Refactored global config handling, add internal media link support, add escaping of userinput (contribution from lisps [[https:// | + | * 28/04/2015 : Refactored global config handling, add internal media link support, add escaping of userinput (contribution from lisps [[https:// |
- | * 05/08/2015: Merged lisps default style option and added french translation | + | * 05/08/2015 : Merged lisps default style option and added french translation |
* 12/09/2015 : Fixed PHP error with some versions | * 12/09/2015 : Fixed PHP error with some versions | ||
* 07/02/2016 : Applied PHP7 patch | * 07/02/2016 : Applied PHP7 patch | ||
+ | * 19/11/2016 : Merged pull request from ThisNameIsNotAllowed adding support for move plugin | ||
+ | * 05/03/2017 : Merged PR form lisps fixing some move plugin bugs | ||
+ | * 28/07/2018 : Fixed bug with move plugin (Issue #5) | ||
+ | * 10/01/2019 : Documentation update (Issue #6) | ||
+ | * 07/03/2020 : Fixed PHP warning (Issue #9) | ||
+ | * 11/05/2020 : Improved CSS configurability & regex (Issue #10 and #12) | ||
+ | * 09/07/2020 : Added ' | ||
+ | * 04/08/2020 : Hack to fix issue with Hogfather (see Issue #13 for details) | ||
+ | * 07/02/2022 : Added Português do Brasil translation (PR by mac-sousa) | ||
+ | * 26/11/2022 : Fixed some warnings for PHP8.1 and fix filename of br translation | ||
+ | * 13/12/2022 : Fixed PHP7 with str_contains polyfill | ||
+ | * 29/05/2023 : Fixed require deprecated warning (thanks to #28) | ||
+ | * 18/08/2023 : Fixed more deprecation warnings (thanks to nerun with #33) | ||
+ | |||
+ | ===== Request ===== | ||
+ | |||
+ | If you have any request, please add an issue to [[https:// | ||
+ | Older requests: | ||
+ | * For the plugin to recognize white space so buttons can all be the same size \\ -> //The best way to do that is to add a ' | ||
+ | * Button Color can be changed with a hex code \\ -> //This can already be done by specifying the color in the style section : %%[[{buttons: |
plugin/button.1471261083.txt.gz · Last modified: 2016-08-15 13:38 by 89.93.6.143