Thank you Wayback Machine LOL
Category icons
Definition
Kunena 2.0
Location of Category Icons - K 1.6 Index view
Category icons have been a feature of Kunena from the very beginning[1]. These icons serve as a two-state indicator[2] on category indexes to show
(a) for a logged-in user[3], if any categories displayed on the index have unread posts;
(b) if there are categories on the index that have no new posts.
The location of the category icons is shown in the image at the right.
There are two standard[4] images installed by Kunena to indicate the above conditions:
CatFolder.png used to indication condition (a) above. The location of this file is ../components/com_kunena/template/default/images/icons/folder.png[5].
CatFolder nonew.png used to indicate condition (b) above. The location of this file is ../components/com_kunena/template/default/images/icons/folder_nonew.png.
This concept also applies to sub-category icons, too, which resemble category icons but in miniature. The two standard images used by Kunena to indicate the corresponding conditions for sub-categories are ../components/com_kunena/template/default/images/icons/folder_sm.png and ../components/com_kunena/template/default/images/icons/folder_nonew_sm.png.
Specific categories may also be distinguished by the use of custom categories icons which are discussed later in this article.
How to change category icons
Kunena 1.6
Changing category icons in K 1.6 is simply a matter of replacing any or all of the files referred to below:
../components/com_kunena/template/default/images/icons/folder.png
../components/com_kunena/template/default/images/icons/folder_nonew.png
../components/com_kunena/template/default/images/icons/folder_sm.png
../components/com_kunena/template/default/images/icons/folder_nonew_sm.png
Note: If you change these standard files for the Blue Eagle template then you will need to replace these files whenever you upgrade Kunena in future; this is because the Kunena upgrade replaces all "standard" files during the component installation procedure. If you want to preserve your changes so that they are unaffected by the Kunena upgrade procedure, then you will need to create your own Kunena template and place your modified category icons in the appropriate template folder. For further discussion about creating your own template, please see How to create a template for Kunena
Custom category icons
Kunena 2.0
As we discussed above, category icons can be customised: you can use different images for each category. As we noted earlier, these images act as a dual-state indicator[6] that show:
(a) if you are logged-in[3] and there are unread messages in the category; or
(b) if you logged-in[3] and there are no unread messages in the category.
This means that if you want to customise icons for each category, you need three separate images, one for each of the abovementioned states.
To illustrate this point, let us take three example images as follows:
36 on.gif for case (a); and
36 off.giffor case (b).
The general approach is to create two files: <catID>_on.gif and <catID>_off.gif (where <catID> is the forum category number) corresponding to the two states we've talked about. This same approach can also be extended to sub-Categories: likewise create two images <catID>_childsmall_on.gif and <catID>_childsmall_off.gif. Obviously you should design these images about half the height and width as the images for the parent category.
Let's take a more practical example. To find the <catID> for a category, use the Category Manager feature; column labelled ID is what you are looking for. Suppose you want to use a set of custom category icons for the category whose <catID> is 36. You need to create two images named 36_on.gif and 36_off.gif respectively for each of cases (a) and (b) above.
These custom images need to be uploaded to the folder ../media/kunena/category_images. Kunena 1.6
Because these are non-standard files, they will not be removed or replaced when you upgrade Kunena.
Category Images: PNG or GIF?
It is beyond the scope of this article to show users how to change the default operation of Kunena. In the current operating environment, the naming and format of images used for custom category icons must be same as we have discussed them in this article. This means that, if users want to use different filenames or file types they are free to do so but they need to make their own customised changes to PHP source code.
Some information about this matter is discussed in the forum topic K 1.6.x Category Images - PNG or GIF? and more details are given in forum topic Different Image For Each Category.
Notes
↑ A similar concept applies to K 1.0/K 1.5 but it is beyond the scope of this article to go into details. See the forum topic Options for Customizing Subforums.
↑ Prior to K 2.0, the icon acted as a tri-state indicator to show, on category indexes:
(a) for a logged-in user, if any categories displayed on the index have unread posts;
(b) for a logged-in user, those categories on the index that have no new posts; or
(c) if the user is not logged in. This third indicator was removed in K 2.0.
↑ 3.0 3.1 3.2 When users are not logged-in to a site there is no way of knowing if there are new messages posted or not. Because of this the same image is used as the "there are no new posts" image when users are not logged-into the site
↑ There are no specific rules regarding the image sizes of category icons. People should choose category icons that blend well with the overall theme of the site. The standard category images are 32 x 32 px; the standard sub-category images are 12 x 12 px.
↑ The folder name refers to the "default" Kunena template used on the target installation
↑ A third, "logged-out" state existed prior to K 2.0. This third state used a technique involving files named <catID>_notlogin.gif but this feature was removed in K 2.0
Categories: Version 2.0Version 1.6Templates
Log in / create accountPageDiscussionReadView sourceView history
Go Search
NAVIGATION
Main page
Kunena (by version)
Register
Community portal
Recent changes
Help
Toolbox
What links here
Related changes
Special pages
Printable version
Permanent link
Interface Language
English
Español
Deutsch
Français
Nederlands
This page was last modified on 23 March 2013, at 03:45. This page has been accessed 9,273 times. Content is available under GNU Free Documentation License 1.2.
