Smiley management

From Kunena Wiki
Jump to: navigation, search

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.

Contents

Basics

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 feature

Edit Smiley Button
Go to the Kunena Backend and select Edit Smilies.

Smiley menu

Edit Smiley Menu
On this menu we can see we have four rows with info about our smileys, and a checkbox before them. The checkboxes are used for mass deletion, or selection (single) for editing.
  • 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 1.0

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.

New Smiley Button
New Smiley function

New Smiley Menu
Using the “New Smiley” button, we can add smiley associations to our forums. On the resultant screen (see image at right) we can add a new ranking.

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.

Kunena 1.0

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 allow you to display the smiley in the left side of the “write message” form. If this is unchecked, the smiley will be listed there, although it will perform the image substitution and it will be listed if the users presses More smilies

Kunena 1.5

when they're composing/editing their messages.

The changes become effective by pressing the Save button located at the top right of the page.

Edit button
Edit Smiley function

Edit Smiley menu
Using the Edit button, we can edit existing smiley associations of our forum (see image at right). The operation is identical to using the New Smiley function discussed above.

Delete Smiley association
Delete Smiley function

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.

Back
Back function

The back button returns you to the Kunena Control Panel.

Personal tools
Namespaces

Variants
Actions
NAVIGATION
Toolbox
Interface Language