Add a smiley set: Difference between revisions From Online Manual

Jump to: navigation, search
(Adding the warning box. Just using an ambox for now, but long term it might be better to create a separate template for this. Is the ambox meant to be reserved for admin messages?)
 
(48 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Extra smiley sets can be added by using the Package Manager, or you can add them manually.
{{WIP}}
{{TOCright}}


{{ambox | type = content | text = '''Multiple Smiley Sets: Avoiding Problems''' <br />
===Installing New Smiley Sets===
If you install more than one smiley set, it is advisable to make sure that each set contains graphics files with exactly the same names.  This is because if some of your members are using different sets of smileys, they will not see each other's smileys if the files do not have the same names. Alternatively, if one image appears in one set, but not the other, they will encounter broken smileys.}}


===Adding a Smiley Set Using the Package Manager===
There are two ways to install new smiley sets. Administrators can either use the Package Manager, or upload it directly to their server.


The [[SMF2.0:Package manager|Package Manager]] can be used to add smiley sets to your forum. This works in the same way as when you add [[Modification|mods]].
====Install a Smiley Set Using the Package Manager====


If you want to add smileys to a set, edit their code, placement order, or the places where they are displayed, for example on the [[post]] screen, as a pop-up, or hidden you need to check ''Enable customized smileys'' on the ''Settings'' page of the smiley section.
The [[SMF2.1:Package manager|Package Manager]] can be used to install new smiley sets to the forum. This is the best way to install smiley sets which have been downloaded from the SMF Customization site, or other SMF sites. It works the same way as installing new [[Modification|modifications]].


===Adding a Smiley Set by Creating a Directory===
Smiley packages from SMF sites usually already meet the multiple set rules described in the [https://wiki.simplemachines.org/smf/SMF2.1:Smileys_and_Message_Icons#Smiley_Sets Multiple Smiley Sets] section, but not always. Administrators should double-check this after installing them. See the Enter Smiley Data section below, to learn how.


The other way to add a smiley set is to create a directory inside your forum's "Smileys" directory. First, give it the name that you want it to have, then upload all the actual graphic files for your smileys into that directory.
====Upload a Smiley Set Directly to the Server====


Next, go to ''Admin > Smileys and Message Icons > Smiley Sets'' and click on ''New Smiley Set''. Select a name for this smiley set, the logical choice being to give it the same name as the directory you created. Click ''New smiley set'' and you will see "URL:" and, to the right of that, a requester. Use this to select the set's name.
The other way to add a smiley set is to create a new directory inside the "Smileys" server directory. First, give it an appropriate name, like "blue_smiley_set", for example. Then upload all the actual graphic files (primarily PNG and/or GIF files, probably) into that directory.
 
Next, go to ''Admin Center > Smileys and Message Icons > Smiley Sets'' and click on the ''New Smiley Set'' button in the bottom right corner.
*'''Name''' - Type a name for the set, which would likely be the same name that was given to the server directory, "blue_smiley_set" in this case.
*'''URL''' - Click the dropdown menu and choose "blue_smiley_set".
*'''Default Smiley Set''' - Check this box if this set is going to be the forum's default set.
Be sure to click the '''''Save Changes''''' button in the bottom right corner, when you finish.
 
This is the best way to install a custom set of smileys, which administrators may have compiled themselves. However, this technique may result in sets which do not meet the multiple sets rules, explained in the [https://wiki.simplemachines.org/smf/SMF2.1:Smileys_and_Message_Icons#Smiley_Sets Multiple Smiley Sets] section. Please see the next section, Enter Smiley Data, to learn how to configure them.
 
=====Enter Smiley Data=====
 
No matter which way the new smiley set has been installed, administrators should go next to ''Admin Center > Forum > Smileys and Message Icons > Edit Smileys'' and make sure all the individual data for each smiley is correct. The ''Admin Center'' is set up to configure smileys for the multiple sets rules, but you should always double-check. In any case, any of the smiley data can be edited here. Please see the [https://wiki.simplemachines.org/smf/SMF2.1:Smileys_and_Message_Icons#Edit_Smileys Edit Smileys] section for details.
 
On this page is a table containing all the individual smileys, and their unique data as described below. In the top right corner, be sure to select the newly installed set, or whichever set you need to edit. There are seven columns in this table.
* The far left column has no title, but obviously is displaying the actual smiley graphics. You can edit any of the smiley's data by clicking on them, or by clicking ''Modify'', five columns to the right.
*'''Code''' - This column shows the combination of characters which will display the smiley when entered in the message editor.
*'''Filename''' - This column gives the name of the smiley's file.
*'''Location''' - This shows the location of the smiley. It can either be displayed in the message editor, or ''post form'', ''More'', or ''hidden''. ''More'' is a small button in the row of smileys where they are displayed above the message editor. If all the smileys you have installed do not fit above the editor, you can put them in a popup window, which is activated by clicking the ''More'' button. ''Hidden'' means the smiley is installed, but cannot be used or even seen anywhere.
*'''Tooltip or Description''' - This is the name of the smiley, which should match the equivalent smileys in all the other sets that are installed.
*'''Modify''' - Click this text link if you want to edit any of the previous smiley data.
*The last column on the right does not have a title, but contains checkboxes. This will allow you to edit the same data as the ''Modify'' text button, except you can edit more than one smiley at a time. In the bottom right corner is a dropdown menu titled '''''With Selected'''''. If you click on that, there are four choices for whichever smileys are checked:
**'''Make Hidden''' - This option hides the selected smileys but does not remove them.
**'''Show on Post Form''' - This option displays the selected smileys above the message editor.
**'''Show on Popup''' - This is the ''More'' button which is described above under Location. The selected smileys are displayed on the popup window.
**'''Remove''' - This removes the selected smileys from the forum.
 
=====Organize Smileys=====
At this point, administrators may also wish to set the order in which the smileys appear, in whichever place they have chosen for them to appear. On the ''Admin Center > Forum > Smileys and Message Icons > Set Smiley Order'' page, it is simple and intuitive to set the order. Please see [https://wiki.simplemachines.org/smf/SMF2.1:Smileys_and_Message_Icons#Set_Smiley_Order Set Smiley Order] for details.


Check the box labelled ''Import smileys already in this directory:'' and, if you want to make this set your forum's default set, check the box labelled ''Default smiley set:''.


When you click ''Save changes'', your new smiley set should be recognised and installed.


[[Category:FAQ]]
[[Category:FAQ]]

Latest revision as of 01:40, 1 January 2024

Under construction-48.png Work in progress, expect frequent changes. Under construction-48.png

Installing New Smiley Sets

There are two ways to install new smiley sets. Administrators can either use the Package Manager, or upload it directly to their server.

Install a Smiley Set Using the Package Manager

The Package Manager can be used to install new smiley sets to the forum. This is the best way to install smiley sets which have been downloaded from the SMF Customization site, or other SMF sites. It works the same way as installing new modifications.

Smiley packages from SMF sites usually already meet the multiple set rules described in the Multiple Smiley Sets section, but not always. Administrators should double-check this after installing them. See the Enter Smiley Data section below, to learn how.

Upload a Smiley Set Directly to the Server

The other way to add a smiley set is to create a new directory inside the "Smileys" server directory. First, give it an appropriate name, like "blue_smiley_set", for example. Then upload all the actual graphic files (primarily PNG and/or GIF files, probably) into that directory.

Next, go to Admin Center > Smileys and Message Icons > Smiley Sets and click on the New Smiley Set button in the bottom right corner.

  • Name - Type a name for the set, which would likely be the same name that was given to the server directory, "blue_smiley_set" in this case.
  • URL - Click the dropdown menu and choose "blue_smiley_set".
  • Default Smiley Set - Check this box if this set is going to be the forum's default set.

Be sure to click the Save Changes button in the bottom right corner, when you finish.

This is the best way to install a custom set of smileys, which administrators may have compiled themselves. However, this technique may result in sets which do not meet the multiple sets rules, explained in the Multiple Smiley Sets section. Please see the next section, Enter Smiley Data, to learn how to configure them.

Enter Smiley Data

No matter which way the new smiley set has been installed, administrators should go next to Admin Center > Forum > Smileys and Message Icons > Edit Smileys and make sure all the individual data for each smiley is correct. The Admin Center is set up to configure smileys for the multiple sets rules, but you should always double-check. In any case, any of the smiley data can be edited here. Please see the Edit Smileys section for details.

On this page is a table containing all the individual smileys, and their unique data as described below. In the top right corner, be sure to select the newly installed set, or whichever set you need to edit. There are seven columns in this table.

  • The far left column has no title, but obviously is displaying the actual smiley graphics. You can edit any of the smiley's data by clicking on them, or by clicking Modify, five columns to the right.
  • Code - This column shows the combination of characters which will display the smiley when entered in the message editor.
  • Filename - This column gives the name of the smiley's file.
  • Location - This shows the location of the smiley. It can either be displayed in the message editor, or post form, More, or hidden. More is a small button in the row of smileys where they are displayed above the message editor. If all the smileys you have installed do not fit above the editor, you can put them in a popup window, which is activated by clicking the More button. Hidden means the smiley is installed, but cannot be used or even seen anywhere.
  • Tooltip or Description - This is the name of the smiley, which should match the equivalent smileys in all the other sets that are installed.
  • Modify - Click this text link if you want to edit any of the previous smiley data.
  • The last column on the right does not have a title, but contains checkboxes. This will allow you to edit the same data as the Modify text button, except you can edit more than one smiley at a time. In the bottom right corner is a dropdown menu titled With Selected. If you click on that, there are four choices for whichever smileys are checked:
    • Make Hidden - This option hides the selected smileys but does not remove them.
    • Show on Post Form - This option displays the selected smileys above the message editor.
    • Show on Popup - This is the More button which is described above under Location. The selected smileys are displayed on the popup window.
    • Remove - This removes the selected smileys from the forum.
Organize Smileys

At this point, administrators may also wish to set the order in which the smileys appear, in whichever place they have chosen for them to appear. On the Admin Center > Forum > Smileys and Message Icons > Set Smiley Order page, it is simple and intuitive to set the order. Please see Set Smiley Order for details.



Advertisement: