# Emoticons

## Emoticons Themes Manager

### Introduction

Screenshot of the Emoticons Theme Manager The Emoticons Theme Manager

Emoticons can be used in several &kde; applications: &kopete;, &konversation;, &kmail;... This module offers you to easily manage your emoticons sets. You can:

- add emoticons themes

- remove emoticons themes

- install an existing theme

- add, remove or edit emoticons within a theme

Please note that you will set emoticons themes per application.

The module is separated in two parts: on the left you can manage your themes and on the right you can manage emoticons within themes.

An emoticon consists in two parts: an icon (typically a `.png`, `.mng` or `.gif` picture) and a text describing the emoticon. The text can be some ASCII symbols like `]:->` or the emoticon short description enclosed within `*` like `*FRIEND*`. The user types the symbol or the text and the emoticon icon replaces it.

The emoticons themes will be saved locally in your home in `$KDEHOME/share/emoticons`.

### Emoticons Themes

This section allows you to manage emoticons themes.

Require spaces around emoticons

- When this option is checked, you need to separate the emoticon with a white space before and after it so it is changed to an icon. If you type "Hello:-)" then this string will stay as it is while if you type "Hello :-)" you will get "Hello" followed by the :-) emoticon.

  When this option is not checked (default), each emoticon string will be replaced by its icon.

New Theme...

- You can create your own new theme from scratch. Clicking on this button brings a dialog asking for the name of the new theme. You can then use the Add... button on the right to create new emoticons and their associated text.

Get New Icon Themes...

- You need to be connected to the Internet to use this action. A dialog displays a list of emoticons themes from http://www.kde-look.org and you can install one by clicking the Install button on the right side of the theme description in the list.

Install Theme File...

- This action allows you to install a theme you downloaded yourself. A theme file is an archive file, usually a `.tar.gz` or a `.zip` file or any other archive files. A dialog asks you for the location of this local archive file and after you entered or dragged the URL and clicked OK, the theme is installed and will appear in the themes list.

Remove Theme

- This action will remove the selected theme from your disk. Select the theme you want to remove in the list. Click the Remove Theme button. This theme will be removed from the disk if you click Apply.

### Emoticons Management

This section allows you to manage emoticons within the selected theme. The list on the right displays all emoticons of the selected theme. You can add, edit or remove any emoticon. Select a theme in the list on the left and then select the action you want to perform.

Add...

- This button allows you to add an emoticon to the selected theme. The dialog asks you to choose an icon for your emoticon and to enter the corresponding ASCII symbol or text attached to it. After that, clicking OK will add your new emoticon in the emoticon list, you will see the icon and the corresponding text displayed. If you want to modify either the icon or the text, you can use the Edit... button described below.

Edit...

- The Edit... button allows you to change either the icon or the text of the selected emoticon. You need to click the OK button to validate this action.

Remove

- This will remove the selected emoticon from the selected theme. You need to click the Yes button to validate this action.