DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:linkbonus

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
plugin:linkbonus [2015-09-13 18:58] Aleksandrplugin:linkbonus [2023-12-21 15:38] (current) – new download url Aleksandr
Line 7: Line 7:
 type       : Syntax type       : Syntax
 lastupdate : 2010-11-12 lastupdate : 2010-11-12
-compatible : Weatherwax+compatible : 2013-05-10a "Weatherwax", !Igor
 depends    :  depends    : 
 conflicts  : baselink conflicts  : baselink
Line 13: Line 13:
 tags       : links, !experimental tags       : links, !experimental
  
-downloadurl: http://ryan.gulix.cl/tests/weatherwax/lib/exe/fetch.php/dw-linkbonus-004.zip +downloadurl: https://trello.com/1/cards/5afdcb2ac4407c4f906b3038/attachments/5afdcb48bc5592f59426234c/download/dw-linkbonus-004.zip 
-bugtracker : # eg. http://github.com/ryan.chappelle/dokuwiki-plugin-linkbonus/issues +bugtracker :  
-sourcerepo : # eg. http://github.com/ryan.chappelle/dokuwiki-plugin-linkbonus/+sourcerepo : 
 donationurl:  donationurl: 
 +
 +screenshot_img: 
 ---- ----
  
-**LinkBonus**((tentative name)) is an experimental plugin undergoing development right now (as of //2010/11/12//) that extends the standard DokuWiki syntax for links in order to include some extra features. Namely, it implements at least the features indicated in the **[[http://forum.dokuwiki.org/thread/5026|linkbonus Introduction Thread]]** at the forums: +**LinkBonus**((tentative name)) is an experimental plugin undergoing development right now (as of //2010/11/12//) that extends the standard DokuWiki syntax for links in order to include some extra features. Namely, it implements at least the features indicated in the [[https://forum.dokuwiki.org/d/5026|linkbonus Introduction thread]] at the forums: 
  
   - ability to set both the link name and tooltip   - ability to set both the link name and tooltip
Line 29: Line 31:
 It also implements some other minor features which are explained below. It also implements some other minor features which are explained below.
  
-:!: **TAKE WARNING**: This plugin is experimental and is not considered stable -- it doesn't even have a definitive name. Using this extended syntax will slow page loading as data fetch must be performed, and will incur also in an overhead of outgoing connections. Use under your own risk. +:!: **TAKE WARNING**: This plugin is experimental and is not considered stable -- it doesn't even have a definitive name. Using this extended syntax will slow page loading as data fetch must be performed, and will incur also in an overhead of outgoing connections. Use under your own risk. 
  
-Once the major release is out __this page will be deleted and you will be advised to remove this plugin before installing the definitive version__.+Once the major release is out **this page will be deleted and you will be advised to remove this plugin before installing the definitive version.**
  
-A courtesy of your friendly DokuWiki plugin developer <del>Peter Parker</del> <del>Spiderman</del>  //[[user>ryan.chappelle|Luis Machuca Bezzaza]]  ---2010/11/12//+A courtesy of your friendly DokuWiki plugin developer <del>Peter Parker</del> <del>Spiderman</del>  //[[user>ryan.chappelle|Luis Machuca Bezzaza]] --- 2010/11/12//
  
 ===== Download and Installation ===== ===== Download and Installation =====
  
-Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the URL given above. Refer to [[:Plugins]] on how to install plugins manually.+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
  
 It is recommended to **clean your DokuWiki cache** right after installing or updating this plugin. It is recommended to **clean your DokuWiki cache** right after installing or updating this plugin.
Line 43: Line 45:
 ===== Syntax and Usage ===== ===== Syntax and Usage =====
  
-To use this plugin simply extend the normal DokuWiki syntax for __links__ with extra parameters:+To use this plugin simply extend the normal DokuWiki syntax for **links** with extra parameters:
  
-**External Link Syntax**:+=== External Link Syntax ===
  
 An external link is like a [[:link|standard link]] pointing to somewhere in the Web and accepts the HTTP and HTTPS protocols. An external link is like a [[:link|standard link]] pointing to somewhere in the Web and accepts the HTTP and HTTPS protocols.
Line 51: Line 53:
   [[http://some.domain.tld/my/page | Link Name | <Link Tooltip> | <extra parameters>]]   [[http://some.domain.tld/my/page | Link Name | <Link Tooltip> | <extra parameters>]]
  
-**Server Link Syntax**:+=== Server Link Syntax ===
  
 A server link is a link that resolves relative to the root of the webserver where DokuWiki is installed, in a manner similar to that of the [[plugin:baselink]] plugin. A server link is a link that resolves relative to the root of the webserver where DokuWiki is installed, in a manner similar to that of the [[plugin:baselink]] plugin.
Line 57: Line 59:
   [[@/my/page | Link Name | <Link Tooltip> | <extra parameters>]]   [[@/my/page | Link Name | <Link Tooltip> | <extra parameters>]]
  
 +=====  =====
  
 The extended link syntax has the following components: The extended link syntax has the following components:
Line 71: Line 74:
  
 === fetchname === === fetchname ===
-<code> + 
-fetchname +  fetchname="[tooltip|title]"
-fetchname="[tooltip|title]" +
-</code>+
  
 If the "''fetchname''" parameter is present, the plugin will automatically **fetch the title** of the external page (as specified in the ''<TITLE>'' tag and displayed in the browser's title bar). If the operation fails (eg.: the external link is not a HTML page or the link is not available, or maybe internet connection is down), the normal Link Name is used instead. If the "''fetchname''" parameter is present, the plugin will automatically **fetch the title** of the external page (as specified in the ''<TITLE>'' tag and displayed in the browser's title bar). If the operation fails (eg.: the external link is not a HTML page or the link is not available, or maybe internet connection is down), the normal Link Name is used instead.
Line 81: Line 82:
  
 === Dead or Alive === === Dead or Alive ===
-<code> + 
-doa +  doa
-</code>+
  
 "Dead or Alive"((yes, like the videogame saga)) request when the "''doa''" parameter is present. In this mode, DokuWiki will try to fetch the external web page and store information about the operation. If the process fails (because eg.: a DNS resolution error or the page no longer exists, or requires authorization) a visual indication consisting of red underlining/border will be used to show the page is not available. Future versions of this plugin will display different warnings for different problem causes. "Dead or Alive"((yes, like the videogame saga)) request when the "''doa''" parameter is present. In this mode, DokuWiki will try to fetch the external web page and store information about the operation. If the process fails (because eg.: a DNS resolution error or the page no longer exists, or requires authorization) a visual indication consisting of red underlining/border will be used to show the page is not available. Future versions of this plugin will display different warnings for different problem causes.
  
 === Favicon === === Favicon ===
-<code> + 
-favicon +  favicon
-</code>+
  
 If the "''favicon''" parameter is present and the feature is enabled, DokuWiki will link to and present the favicon of the remote site's domain as the icon for the link, instead of the standard link icon in DokuWiki. This feature does not work in SSL-mode wikis, since doing so would cause a link or fetching of external content. If the "''favicon''" parameter is present and the feature is enabled, DokuWiki will link to and present the favicon of the remote site's domain as the icon for the link, instead of the standard link icon in DokuWiki. This feature does not work in SSL-mode wikis, since doing so would cause a link or fetching of external content.
Line 98: Line 97:
 === Other Parameters === === Other Parameters ===
  
-**''class="some_class"''**: sets the CSS class of the link. This class is applied as well as the standard (DokuWiki's) ''urlextern'' class.+**''%%class="some_class"%%''**: sets the CSS class of the link. This class is applied as well as the standard (DokuWiki's) ''urlextern'' class.
  
-**''rel="value"''**: implements //rel// attributes, like for example "nofollow".+**''%%rel="value"%%''**: implements //rel// attributes, like for example ''%%"nofollow"%%''.
  
  
 === Reserved for Future Use === === Reserved for Future Use ===
  
-__The following parameters do not work in this version, but can be used and will work as indicated in future versions:__+**The following parameters do not work in this version, but can be used and will work as indicated in future versions:**
  
-**''page="blank|self"''**: makes the link open in a new window/tab (''blank'') or in the same (''self''). Defaults to the Configuration value for [[config:target|link targets]]. +**''%%page="blank|self"%%''**: makes the link open in a new window/tab (''blank'') or in the same (''self''). Defaults to the Configuration value for [[config:target|link targets]]. 
  
 ===== Demo ===== ===== Demo =====
  
-:!: [[http://ryan.gulix.cl/tests/doku.php/linkbonus]] <= Demo Site. +:!: [[http://ryan.gulix.cl/tests/doku.php/linkbonus]] <= Demo Site. FIXME
  
-There is another (unofficial) demo site which is my [[http://informatica.temuco.udelmar.cl/~lmachuca/dokuwiki-lucho/inicio|personal wiki]], but the version of the plugin there incorporates some features not available in the public versions.+There is another (unofficial) demo site which is my [[http://informatica.temuco.udelmar.cl/~lmachuca/dokuwiki-lucho/inicio|personal wiki]] FIXME, but the version of the plugin there incorporates some features not available in the public versions.
  
-=====Development Information =====+===== Development Information =====
  
 ==== Tweaking ==== ==== Tweaking ====
  
 Some features are disabled or controlled. To modify their behaviour, add the required lines to your master configuration file (''$DOKU_CONF/local.php''): Some features are disabled or controlled. To modify their behaviour, add the required lines to your master configuration file (''$DOKU_CONF/local.php''):
 +
 <code> <code>
 $conf['plugin']['linkbonus']['option_name'] = option_value; $conf['plugin']['linkbonus']['option_name'] = option_value;
Line 142: Line 142:
 **Note**: This plugin will increase page load time and cause a slight overhead on outgoing connections from your server. **Note**: This plugin will increase page load time and cause a slight overhead on outgoing connections from your server.
  
-====Future Development====+==== Future Development ====
  
   * better handling of links with no title (eg.: images?)   * better handling of links with no title (eg.: images?)
Line 150: Line 150:
   * interwiki syntax?   * interwiki syntax?
   * extended scheme syntax? (eg.: FTP, local file)   * extended scheme syntax? (eg.: FTP, local file)
-  * __a better name__ (if you have ideas, //please// fire away! ^_^ ) +  * **a better name** (if you have ideas, //please// fire away! ^_^ )
- +
- +
-==== Other Developments ==== +
- +
-^ Other Plugins by\\ Luis Machuca B.:   | [[plugin:progrecss]]\\ [[plugin:tooltip]]\\ [[plugin:clock]]\\ [[plugin:divalign2]]\\ [[plugin:countdown]]\\ [[plugin:gil]]\\ [[plugin:hide]]\\ [[plugin:noiewarning]]   |+
  
 ===== Discussion ===== ===== Discussion =====
  
 Feel free to discuss here; just remember that this plugin is experimental and that it will be eventually superseded by another, much improved and "official"((as a plugin can be)) version. Feel free to discuss here; just remember that this plugin is experimental and that it will be eventually superseded by another, much improved and "official"((as a plugin can be)) version.
- 
  
plugin/linkbonus.1442163512.txt.gz · Last modified: 2015-09-13 18:58 by Aleksandr

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki