History of function_biticon

Differences from version 10 to 17



@@ -1,41 +1,27 @@

-biticon is availible to smarty templates to support two things:
-*Icon themes - biticon allows icons to be overidden in the same way that smarty allows templates to be over ridden. This allows a site to mix and match themes with icon sets for a more customized look with less work.
-*Better support of WAI accessibility for the handicapped - biticon automatically generates any additional HTML needed to enable accessibility devices to function.
+{maketoc}
+The function biticon is used in Smarty templates. It allows icons to be overidden in the same way as templates can be over ridden. This allows a site to mix and match themes with icon sets for a more customized look with less effort. Biticon generates all (accessible) HTML needed. It replaces hard coded image tags. The image file used for the icon is selected by searching a defined set of folders: the current icon theme set by the admin, the current custom style, a default set of core icons, and more. If the file is not found in any of these locations, the src-attribute of the image is set to "broken.path/icon".
 
-biticon is used in your templates to replace the hard coded image tags that are used for icons through out Tiki, very similar to an image tag in usage.
-
-The image file used for the icon is selected by searching a defined set of folders including the current icon theme from the admin-general panel, the current site theme, and a default set of core Tiki icons. Each icon is treated seperately, so icon themes or site themes can overide only the individual icons they want to change. Tikicon will automatically fall back to the defaults if there is no override.
-
-!!Search Path
-
-This is the search path used by biticon. The 1st match found is used.
-
-##<BIT_THEME_PATH>/styles/<icon style>/icons/<ipackage>/~~silver:<ipath>/~~<iname>.*
-##<BIT_THEME_PATH>/styles/<site style>/icons/<ipackage>/~~silver:<ipath>/~~<iname>
-##<BIT_ROOT_PATH>/<ipackage>/icons/~~silver:<ipath>/~~<iname>.*
-##<BIT_THEME_PATH>/styles/default/icons/<ipackage>/~~silver:<ipath>/~~<iname>.*
-
-If the file is not found in any of these locations an image tage with a src of broken.<ipackage>/<iname> will be output.
-
-^__note:__ if ipath is not set, this setting will be ignored
-__note:__ to use variables within {biticon} you will have to 'escape' the variables with '`'.
-e.g. {biticon ipackage="users" ipath="flags/" iname="`$userPrefs.flag`" iexplain="`$userPrefs.flag`"}
-^
-
-!Parameters
+! Parameters
 ||
-ipackage|This indicates which package is home to this icon. General purpous shared icons like delete, trash, smileys, ect come from the kernel package. This also allows us to have a seperate "nextPage" icon for forums, one for image galleries, and one for wiki.|required
+ipackage|This indicates which package is home to this icon. General purpose shared icons like delete, trash, smileys, etc come from the kernel package. This also allows us to have a seperate "nextPage" icon for forums, one for image galleries, and one for wiki.|required
 iname|This is the base name of the icon that you want to use. Notice that there is no extension like .png, .gif, ect. This is intentional and biticon will allow any type of image to be used and find the correct file for you. It will also generate correctly formed HTML for that file class.|required
 iexplain|This is equivelent to the alt attribute in an img tag. This will generate the alt tag in the page, but will also be used to correctly generate HTML to allow screen readers and other accessibility devices for the physically challenged to function correctly. additionally it will add the same value to the title attribute, giving the user a hover tooltip|optional
 ipath|here you can specify a folder within the ipackage. Note: ipath requires a trailing '/' to work correctly|optional
-iforce|you can specify how the icon is displayed. options include: ;icon: This will force the use of an icon regardless of the setting in the themes manager. It can be useful in menus and the like, where showing the iexplain text can be disruptive. ;icon_text: This will force the display of the iexplain text alongside the icon. Useful in particular situations where you are too lazy to add the text next to the icon manually|optional
+iforce|you can specify how the icon is displayed. options include: [icon] This will force the use of an icon regardless of the setting in the themes manager. It can be useful in menus and the like, where showing the iexplain text can be disruptive. [icon_text] This will force the display of the iexplain text alongside the icon. Useful in particular situations where you are too lazy to add the text next to the icon manually. [text] well, you can do this, but why do you use biticon at all?|optional
 ||
 
-These are the only four attributes specific to biticon. Any other attributes, such as class above, are pased through to the HTML tag unaltered.
+^ Other attributes, such as class, are passed through to the HTML tag unaltered. To use variables within parameters, escape the variables with back ticks '`'^
 
-!Sample
+
+
+! Examples
 {code}
-{$biticon ipackage="blogs" iname="admin" iexplain="Configure blog settings" class="somecssclass"}
+{biticon ipackage="blogs" iname="admin" iexplain="Configure blog settings" class="somecssclass"}
+{/code}
+
+If you want to use variables within biticon parameters, use this notation:
+{code}
+{biticon ipackage="users" ipath="flags/" iname="`$userPrefs.flag`" iexplain="`$userPrefs.flag`"}
 {/code}
 
 If your flag icons are stored in users/icons/flags, use this:

@@ -45,20 +31,17 @@

 
 It works much like the template override system that allows themes. So the above command might generate:
 
+if the icon theme is loveandkisses and it overides that icon.
 {code}
-<img src="themes\styles\loveandkisses\icons\blogs\admin.png" alt="="Configure blog settings" class="somecssclass">
+<img src="themes/styles/loveandkisses/icons/blogs/admin.png" alt="Configure blog settings" class="somecssclass">
 {/code}
-if the icon theme is loveandkisses and it overides that icon.
 
+if the site theme is classicarcade and it overides that icon.
 {code}
-<img src="themes\styles\classicarcade\icons\blogs\admin.gif" alt="="Configure blog settings" class="somecssclass">
+<img src="themes/styles/classicarcade/icons/blogs/admin.gif" alt="Configure blog settings" class="somecssclass">
 {/code}
-if the site theme is classicarcade and it overides that icon.
 
+if neither the icon theme or site theme override the admin icons.
 {code}
-<img src="blogs\icons\admin.jpg" alt="="Configure blog settings" class="somecssclass">
+<img src="blogs/icons/admin.jpg" alt="Configure blog settings" class="somecssclass">
 {code}
-if the neithier the icon theme or site theme override the admin icons.
-
-!See also
-*((Smarty Functions))
Page History
Date/CommentUserIPVersion
05 Aug 2008 (04:25 UTC)
clean-up
laetzer85.178.11.15517
Current • Source
hiran85.233.40.19216
View • Compare • Difference • Source
hiran85.233.40.19215
View • Compare • Difference • Source
hiran85.233.40.19214
View • Compare • Difference • Source
hiran85.233.40.19213
View • Compare • Difference • Source
hiran85.233.40.19212
View • Compare • Difference • Source
hiran85.233.40.19211
View • Compare • Difference • Source
hiran85.233.40.19210
View • Compare • Difference • Source
xing194.152.164.459
View • Compare • Difference • Source
xing194.152.164.458
View • Compare • Difference • Source
spiderr66.93.240.2047
View • Compare • Difference • Source
xing83.64.18.1226
View • Compare • Difference • Source
xing62.99.189.1305
View • Compare • Difference • Source
xing62.99.189.1304
View • Compare • Difference • Source
btodoroff66.206.174.733
View • Compare • Difference • Source