Plugin / LMB^Box Smileys

Installation

1. Copy the folder lmbbox-smileys into your wp-content/plugins directory
2. Activate this plugin in the WordPress Admin Panel
   2.1 If upgrading from a previous version of LMB^Box Smileys, if there are any problems or errors displayed
   (PHP) after activating the plugin, deactivate the plugin and you will be asked if you want to remove
   your “LMB^Box Smileys Options Settings” and your “LMB^Box Smileys Lists and Management Settings.” You
   want to remove them both by click Ok/Yes on the confirm boxes that pops up. Then after WP’s plugins page
   loads again with plugin deactivated at the top, reactivate the LMB^Box Smileys Plugin and everything
   should work fine.
   2.2 Note: These confirm boxes are new features that will allow you to remove settings stored in your WP
   database if you wish to. These also allow you to save any info or settings that you have made by click
   Cancel/No in the confirm boxes.

Additional Steps

1. if you want LMB^Box Smileys to automatically add itself to your comments page ….
   !!!YOU MUST HAVE LMB^Box COMMENT QUICKTAGS PLUS INSTALLED AND ACTIVATED!!!
   else you have to manually put a link into your comments page like so …

   <?php echo '<a href="' . get_settings('siteurl') . '/wp-content/plugins/lmbbox-smileys/lmbbox-smileys-popup.php?action=comment" target="_blank" onClick="window.open(\'' . get_settings('siteurl') . '/wp-content/plugins/lmbbox-smileys/lmbbox-smileys-popup.php?action=comment\', \'smileys\', \'width=400,height=450,status=yes,resizable=yes,scrollbars=yes\'); return false;">Smileys</a>'; ?>
   

   and set “Add Button to Comment Quicktags Toolbar” in the LMB^Box Smileys Option Page to “No”.
   3.1 If you want to have the smileys displayed in the Comment Form Area without there being a popup page,
   you will need to add this code somewhere in your comments.php theme file …

       <?php if (function_exists('lmbbox_smileys_display')) { lmbbox_smileys_display(true); } ?>
   
   You will also need to set "Add Button to Comment Quicktags Toolbar" to "No". In order to 
   style the smileys that are displayed, follow step 5.2 below.
   

Customize Smileys Page Layout

1. To edit the layout and display of the smileys open the file lmbbox-smileys-popup.php and …

   At the bottom half of this file, there will be standard html with a php call in the body tags. You may edit
   the look and layout of this part anyway you see fit. To display the smileys, you must call:

   <?php if (function_exists('lmbbox_smileys_display')) { lmbbox_smileys_display(); } ?>
   

   where you want the smileys to be on the page.

   The function will output a div with a class of lmbbox_smileys. This is the main

   to organize the
   Smileys and the LMB^Box Smileys Title. After the div will be the javascript to add the Smileys to the post
   or comment. If you have set “Display LMB^Box Smileys {VERSION} Title” to “Yes”, then next will be a

   tag with the title. Lastly are the Smileys Titles and Smileys. If Smileys Title is set to be displayed in your
   LMB^Box Smileys Options Page, then next will be a

   tag with the Smileys Title. Finally a
   tag with class of lmbbox_smileys_span with img tags for all the Smileys. To set the styles for the page, go to
   the bottom half of this file and you will see in the head tags where the style is set (read on!).

Styling the Smileys

1. To add styles to the Smileys Popup Page, open the lmbbox-smileys-popup.php and go to the bottom half to the page.
   You will see some normal html code then a styles section. Add your styling there! To add styles to the Smiley
   Button on the Comment Quicktags toolbar, read step 5.3. To add styles to the Smiley Button on the Admin Write
   Pages Quicktags toolbar, read step 5.4. To add styles to the smiley images that are put in the posts or comments,
   read step 5.5.

****** Styling the Smileys Page ******
5.1 If you wish to style the Smileys Popup Page just add these to the lmbbox-smileys-popup.php file in the
lmbbox-smileys plugin folder:

/* Body style for Smileys Page /
body {
margin: 10px 10px;
padding: 0;
background: #F2F2F2;
color: #000000;
}
body, td {
font: 10pt Georgia, “Times New Roman”, Times, serif;
}
/ Main Div for Smileys Page /
div.lmbbox_smileys {
/ your style; /
}
/ Link Styles for Smileys Page /
div.lmbbox_smileys a {
color: #00019B;
text-decoration: none;
}
div.lmbbox_smileys a:visited {
color: #006;
}
div.lmbbox_smileys a:hover {
text-decoration: underline;
color: #069;
}
/

<

h1> style -> used for Main Page Heading /
div.lmbbox_smileys h1 {
margin: 10px 0px;
font: normal 22px serif;
color: #333333;
}
/

<

h2> style -> used for Smileys Heading /
div.lmbbox_smileys h2 {
margin: 10px 0px;
border-bottom: 2px solid #69C;
font: normal 20px serif;
color: #333333;
}
/ Main Span for Smileys Output /
div.lmbbox_smileys span.lmbbox_smileys_span {
/ your style; /
}
/ And anything in the span /
div.lmbbox_smileys span.lmbbox_smileys_span img {
/ your style; */
}

****** Styling the Smileys Page ******
5.2 If you wish to style the Smileys displayed directly to your Comment Form area just add these to your
style.css file in your theme’s folder:

/———————- Smileys —————————/
/* Main Div for Smileys Page /
div.lmbbox_smileys {
/ your style; /
}
/ Link Styles for Smileys Page /
div.lmbbox_smileys a {
color: #00019B;
text-decoration: none;
}
div.lmbbox_smileys a:visited {
color: #006;
}
div.lmbbox_smileys a:hover {
text-decoration: underline;
color: #069;
}
/

<

h1> style -> used for Main Page Heading /
div.lmbbox_smileys h1 {
margin: 10px 0px;
font: normal 22px serif;
color: #333333;
}
/

<

h2> style -> used for Smileys Heading /
div.lmbbox_smileys h2 {
margin: 10px 0px;
border-bottom: 2px solid #69C;
font: normal 20px serif;
color: #333333;
}
/ Main Span for Smileys Output /
div.lmbbox_smileys span.lmbbox_smileys_span {
/ your style; /
}
/ And anything in the span /
div.lmbbox_smileys span.lmbbox_smileys_span img {
/ your style; */
}

    Note: If you want the smileys to be displayed in lines, the only way to achive this is by setting the 
        Smileys Display to "Display Without Title" in your LMB^Box Smileys Options Page. Because the actual
        Smileys images are within a <span></span> tag, they are displayed inline and not in blocks. But if 
        you have the Smileys Display set to "Display With Title", a <h2></h2> tag is before the <span></span> 
        and the <h2></h2> tag will insert a new line after it and this does not allow the Smileys to be 
        displayed in lines.

****** Styling the Toolbar ******
5.3 If you wish to style the Smileys button created on the comment page, open your style.css stylesheet file
in your theme directory and add:

comment_quicktags #ed_smileys {

/* your style; */

}

5.4 If you wish to style the Smileys button created on the admin write pages, open wp-admin.css in 
    {root}/wp-admin/ folder, find "#ed_del" and add around it:

ed_smileys {

/* your style; */

}

****** Styling Smiley Images in Posts and Comments ******
5.5 If you wish to style the Smiley Images created in the posts and comments, open your style.css stylesheet
file in your theme directory and add:

img.lmbbox_smileys_img {
/* your style; */
}

Advanced Features

1. Adding your OWN Smileys to the Plugin! To add, edit, manage, and remove the Smileys Lists that are used, go to the
   Management section of your admin contol panel and you will see a subpage named Manage LMB^Box Smileys. Go to this
   page to do all actions of management of the Smileys Lists. To change the display settings for the Smiley List, go
   to the LMB^Box Options Page to set which Smileys Lists are displayed and how. Also you can set if to use Smileys
   in the comments of your blog, if to use the Comment Quicktags Toolbar from LMB^Box Comment Quicktags Toolbar,
   and set the min. user levels to changes settings and manage Smileys Lists.

   6.1 LMB^Box Smileys plugin comes with 3 default Smileys Lists which are WP, TB and EE. They all can be found in
   the ‘smileys’ folder within the ‘lmbbox-smileys’ plugin folder. LMB^Box Smileys adds Smileys Lists
   automatically by checking the Smileys Images Directory that is set in the LMB^Box Smileys Lists Management
   Page. On first install if there are no database settings set, than LMB^Box Smileys will sync up the Smileys
   Images Directory with the database settings. To add your own Smileys or manage/edit/remove the default Smileys,
   go to LMB^Box Smileys Lists Management Page and select your action in the displayed list. If you want to add
   your own smileys, you must upload the Smileys Images to a folder within the Smileys Images Directory and give
   that folder the Smileys List Abbr. that will be entered when adding the Smileys List (limit to 4 chars). Then
   go to the LMB^Box Smileys Lists Management Page and select “Add a Smileys List.” Then enter all the info for
   the Smileys List and Smileys.

   6.2 To create your own Smileys List that will automatically load when ever LMB^Box Smileys plugin either has no
   settings stored in the database or your select “Sync Smileys Lists” from the LMB^Box Smileys Lists Management
   Page, follow these steps:

       Create a folder like you would if you were just adding a Smileys List by naming it what the Smileys List 
       Abbr. that will be entered when adding the Smileys List (limit to 4 chars). Then add all of your Smileys 
       Images and Disabled Smileys Images to this folder. Next copy 'smiley-list-config.php' file from any of 
       the other default Smileys Lists that are in your Smileys Images Directory, and paste it in your new Smileys 
       List folder. Open this file with either text editor or PHP editer (notepad, dreamweaver). Once you have 
       the file open, edit all of the settings in the file and customize the top comment to the name of your 
       Smileys List. Last thing to do is save the file and upload the folder to your Smileys Images Directory. 
       Then go to your LMB^Box Smileys Lists Management Page and select "Sync Smileys Lists" and click the button, 
       and don't forget to update the settings after the page reloads to save all changes!
   
   Now with this new feature you can distribute your Smileys List(s) if you wish :)
   

   6.3 To use Short Smileys Tags like ‘:)’ or ‘:D’, you would have to add them to a Smileys List and make sure
   that none of the other Smileys List(s) had the same Short Smileys Tags. Now I’ve added a new abiltiy to auto-
   mate this process. Now on your LMB^Box Smileys Option page, you can set the Default Smileys List for both
   the Admin Write Pages and the Comment Form. Doing so, will activate the Short Smileys Tags that are in the
   Smileys List, so long as the Use Short Smileys Tags is enabled for the Smileys List. All Short Smileys Tags
   take priority over any other Smileys Tags in that Smileys List, meaning that if you have any Short Smileys
   Tags set and Use Short Smileys Tags is enabled, on the Smileys Popup page or the direct insert to the
   Comment Form area Smileys will use the Short Smileys Tags on click/insert. Note: If you disable Short Smileys
   Tags, then you maybe left with those Short Smileys Tags left unchanged in your posts. You can only have ONE
   Smileys List set as the Default Smileys List for either the Admin Write Pages or Comment Form and in order
   to make use of the Short Smileys Tags, the Smileys List must be displayed either with or without a title,
   along with have Use Short Smileys Tags enabled.

Uninstallation

1. If you want to uninstall LMB^Box Comment Quicktags, just deactivate the plugin in your Plugins Page.
   When you click on deactivate, you will be prompt to if to remove LMB^Box Comment Quicktags Settings.
   Click Ok/Yes to remove settings or Cancel/No to keep settings.