function_smartlink
Smarty plugin {smartlink}
Created by: Lester Caine, Last modification: 16 Jan 2007 (13:43 UTC) by hiran
Outputs any kind of link. Especially useful when it comes to links used to sort a table, due to the simplified syntax and loss of cumbersome if clauses also useful if the you want to display an icon as link since smartlink takes biticon parameters.
Output: any kind of link. Especially useful when it comes to links used to sort a table, due to the simplified syntax and loss of cumbersome if clauses. Also useful if the you want to display an icon as link since smartlink takes biticon parameters
This sample also takes care of the current position within the list (offset):
setting iorder and idefault here, makes this link sort in a descending order by default (iorder) and it is highlighted when $isort_mode ( or $_REQUESTsort_mode>'sort_mode' ) is not set (idefault)
Output: any kind of link. Especially useful when it comes to links used to sort a table, due to the simplified syntax and loss of cumbersome if clauses. Also useful if the you want to display an icon as link since smartlink takes biticon parameters
Note Don't use this plugin if ititle is generated dynamically since it is passed through tra()
Parameters
| ititle | words that are displayed | required |
| ianchor | set the anchor where the link should point to | optional |
| isort | name of the sort column without the orientation (e.g.: title) | optional |
| isort_mode | this can be used to manually pass the sort mode to smartlink. overrides the value given in $_REQUEST['sort_mode']], which is the default | optional |
| iorder | if set to asc or desc, it sets the default sorting order of this particular column. 'asc' is default | optional |
| idefault | if set, it will highlight this link if no $isort_mode is given. this should only be set once per sorting group since it represents the default sorting column | optional |
| itype | can be set to 'url', which will output only the url, or 'li', which will output <li><a ... ></li> | optional |
| ionclick | pass in any actions that should occur onclick | optional |
| ibiticon | if you want to display an icon instead of text use ibiticon. format is: '<ipackage>/<iname>[/iexplain]]' e.g.: 'liberty/edit'. This will be resolved by biticon, so you might want to know about that function as well. | optional |
| iurl | pass in a full url | optional |
| ifile | set the file where the link should point (default is the current file) | optional |
| ipackage | set the package the link should point to (default is the current package) | optional |
| ihash | you can pass in all the above as an array called ihash or secondary * items common to all links | optional |
| * | anything else that gets added to the pile of items is appended using &$key=$val | optional |
Sample
This sample creates a simple link with sorting functionality:
<?php
{smartlink ititle="Page Name" isort="title"}
?>
This sample also takes care of the current position within the list (offset):
<?php
{smartlink ititle="Title" isort=title offset=$control.offset}
?>
setting iorder and idefault here, makes this link sort in a descending order by default (iorder) and it is highlighted when $isort_mode ( or $_REQUESTsort_mode>'sort_mode' ) is not set (idefault)
<?php
{smartlink ititle="Page Name" isort="title" iorder="desc" idefault=1}
?>
See also
- function_biticon
- Smarty Functions</iname></ipackage>
Comments
Customizing Icon Sizes