|This article may require cleanup to improve the usability, relevance and understanding of the topic. The specific problem is: article would benefit by tailoring it more towards K 3.0 and the changes that have been made since this was written. Please improve this article if you can. (October 2014)|
Smileys (sometimes called emoticons) are a must for any forum software, and they are not missing in Kunena. There you will find a very simple interface using the standard Joomla buttons to control the smileys used on our forums, and the BBCode used for the replacements.
This article describes how to change the default Kunena smileys and images.
Enabling/disabling forum smileys
If you decide to use forum smileys, please ensure that you have adjusted the [Frontend:Disable emoticon] setting to your preference.
Accessing the Smiley Management featureKunena Backend and select Edit Smilies.
- ID The ID of the smiley association in our database, invariable and unique, assigned on smiley creation and that cannot be reused for any other one even if it's deleted, it's not shown anywhere in our forums, and is for system use only.
- Smiley: Preview of the smiley used on that association, in case the image cannot be found (usual problem when language file is not found), it will show image name (e.g. Smiley.gif)
- Code: This is the text string Kunena looks for in your posts to perform the image substitution. If you require a one smiley image for several different associations (e.g. "tongue" smiley for: :P, :-P, :tongue:, :p, :-p) you will have to create an association for each of these text strings.
- URL: Image filename(e.g. :birthday: for an image of a birthday cake with the filename "birthday.gif"). You can have different smiley sets for different languages, but to have clean layouts - it's possible otherwise, but they will have "ghosted smileys" in your users menus - they must share same filenames and associations. This can be useful, for example, to have rent smileys with localised signs for every language, all having associated with the same filename (e.g. "birthday.gif").
Smiley images folder
There is no default smiley directory. If you don't have smileys stored in a language-specific folder, it will not default to /smileys in the English folder.
Kunena smiley images are stored in the folder ../components/com_kunena/template/<current template>/images/language/emoticons/ where <current template> is the folder name of the Kunena forum template, (e.g. default_ex) and language is (literally) the language (e.g. english). You can upload any image file to this folder to be used with however you would like to use smileys. If you want to use your own customised images, upload them before making adding or changing the existing smiley assignments.
Smiley Management Functions
New forum smileys can be added, changed or delete using one of the functions corresponding to the icons seen on the Smiley Management screen.
On this menu, we will be presented with Code, URL and Emotion Bar inputs, as well as the preview image of the image we have selected on the URL dropdown box.
- Code: When viewed in the frontend, this text string the forum uses to substitute a smiley image in place of the text entered by your users. Although any text can be substituted, it's a good idea to place a colon (:) before and after the text you will be substituting (e.g. :yuck:, :lol:, :dry:)
- URL: From dropdown list, choose an image from the smiley images folder that you want to use for this smiley.
The image folder is dependent on the forum template and language selected when the user logged-in. Although it doesn't affect the assignment, if there's a smiley that is only available in one language-specific image folder, other languages will make the "association" but will render an image placeholder instead. This this will affect all posts, as neither the original text string (e.g. :yuck:) nor the image will be rendered. If you use a multi-language forum you should consider having a copy of each smiley image stored in each of the language folders.
- EmoticonBar:: This checkbox means that the smiley image will be displayed at the top of the “write message” form. If this is unchecked, the smiley will not be displayed although the "smiley code" will be substituted with an image when the post is submitted.
The changes become effective by pressing the Save button located at the top right of the page.
By using this button, in combination with checkboxes, to delete the smiley association; this will not delete the smiley image, so you may also to want delete the file from your smiley images folder if you don't plan to use it again.
The back button returns you to the Kunena Control Panel.