Documentation – WordPress

Get the benefits of the conversations on facebook!

This fancy slider offer an opportunity for the users to leave comments about your website (or any subpages) when they reach the bottom of the page. The comments will show up for the friends of the users and they will connect in. You can lock the screen and set up a timer or you can allow for the users to close the slider. The plugin also display a like and share buttons.

More comments, more visibility on facebook, much more traffic.

– fully responsive

– ability to lock the screen until the user leave a comment

– fixed slider position

– automatic slide-in when the visitor reach the bottom of the page

– you can enable or disable the user can close the slider

– ability to set up timer to fadeout the slider

– you can specify your own notice

– viral spreading, much more traffic

– fully localizable comment box, choose from more than 70 languages

– selectable direction of the slider

– you can set up to open the slider automatically just once per user

– set the number of comments to display

– link to the moderation tools for facebook with your appid

– fancy jquery animation with fadeout and slide effect

– automatic url recognition (users can comment on the specific page of the website and the homepage as well)

– detailed documentation

– transparent background when the screen locked

– unlock screen with click on the background (if you allow to close the slider for the users)

– users can leave comments with 4 service providers (Facebook, Yahoo, AOL, Hotmail)

– full customizable separated CSS file

– you can hide or show the facebook icon

– adjustable transparency

– three different icon size

– auto open the slider if you want, when the users reach the bottom of the page

– mobile-friendly slider

First, log in to the Administration area of your WordPress website and select Plugins.

install_guide1

Click Add New on the top of the page

install_guide2

 

Select Upload on the top of the page again

install_guide3

 

Browse the plugin zip file from your computer and click Install Now.

install_guide4

Click on the Activate Plugin link and the plugin will be active.

install_guide5

After successful plugin activation, you will be redirected to the plugins’ list page.

You can find the Facebook Comment Slider plugin in the list:

install_guide6

Firstly, you need to set up the plugin settings now. Read about this in the Settings section.

 

Before you use the plugin, you have to set up the Application ID.

First, visit the following page and create a new application:

https://developers.facebook.com/apps

You don’t need to specify anything else except the name of the app. This can be anything you like.

create_app_id

 

You will see the App ID on the top of the screen. You have to save this ID to the settings of the plugin.

The facebook works with cache, so wait some time and you will reach the moderation tools:

http://developers.facebook.com/tools/comments

After this, don’t forget to disable Sandbox mode.

The pugin has a simple, but powerful options.

You can reach the settings by clicking on the Settings on the left side and choose the Facebook Comment Slider. Or you can also visit the settings page if you choose the Plugins, Installed Plugins and select the Settings under the Facebook Comment Slider in the Plugin list page.

facebook_comment_slider_settings1

Facebook App ID is required to get a normal visibility for the comments, but Admin User ID is optional. If you set this values, you can reach the moderation tools on the following link: http://developers.facebook.com/tools/comments

If you would like to use the Like Box and the Facebook Fan Page Wall feature, you have to fill the Facebook Page Name field. Pay attention to use only the name, not the full URL of your Facebook Page.

You can set to invisible the Facebook icon if you choose the ON option Hide icon setting. By default, this value is on, but you can combine with the auto open setting on the different tabs.

The Comment Slider can appear automatically when the user almost reach the bottom of the page. If you want this, please check the ON option under the Auto open at bottom of the page

(See images below)
With lock screen option, you can enable a transparent background, that is lock the screen and the users can’t click on anything, except the comment slider.

If you would like to allow to close the slider, you can do it with User can close the slider option. The slider closeable by several ways:

  • user click on the x button at the bottom of the slider
  • user click on the facebook icon
  • user click on the transparent background

You can specify an exact transparency value of the faded-in background in percentage. If you set 100, the background will be fully black.

The slider will disappear autimatically, when you set a valid number to the timer and the time is up. If you set zero, the slider will disapper only if the user leave a comment or close the slider.

You can specify the message on the different type of Sliders (Like Box, Comment Box, Fan Page Wall), this will displayed on the slider’s top area.

By default, the slider come on the left side of the screen, but you can choose the another side, if you want with the direction option.

The plugin can track the users, who already saw the slider. If you enable display once per user, the slider will appear automatically only once for every users. (except they delete cookies)

In the slider, you can also specify the number of the displayed comments from 1 to 6. (See the image below about the Comments Box Tab)

The comment box fully localizable by the language of comment slider. You can choose from exactly 77 languages, these are the full list of optinal facebook’s languages.

Style of the Facebook Comment Slider is available in dark or light color variations. You can change it easily with the Style attribute.

UPDATE: With Disable on mobile option you can disable globally the entire plugin on devices below 800×600 resolution.

You can disable / set time to the shake effect (choose from 5 sec to 5 min.) or select the HeartBeat effect.

Hide Likebox for already Liked option disable the LikeBox for users who already liked your website. This settings using Cookies, if the visitor delete the cookies from the browser, the LikeBox will be visible again. (cookies are expired after 999 days)

Skin options allows to select templates for all sliders from the inbuilt skins of the plugin.

The plugin containing four shortcodes. When you include

to the content, it won’t be displayed on this page. If you would like to display it only a specified page of your website, set Display only on allowed pages to ON and include the shortcode on that page, where you would like to see the slider.
You can also use the to display the Facebook Like Box or to display the Facebook Fan Page Wall.

It is possible to open or close any of the slider with a simple link. You need to only add a specific class to do that. Let see the full list:

  • classname: .fcs_open_likebox, method: open the LikeBox Slider, example: <a href=”#” class=”fcs_open_likebox”>link text</a>
  • classname: .fcs_open_commentbox, method: open the Comment Box Slider, example: <a href=”#” class=”fcs_open_commentbox”>link text</a>
  • classname: .fcs_open_postbox, method: open the Wall Posts Slider, example: <a href=”#” class=”fcs_open_postbox”>link text</a>
  • classname: .fcs_close_likebox, method: close the LikeBox Slider, example: <a href=”#” class=”fcs_close_likebox”>link text</a>
  • classname: .fcs_close_commentbox, method: close the Comment Box Slider, example: <a href=”#” class=”fcs_close_commentbox”>link text</a>
  • classname: .fcs_close_postbox, method: close the Wall Posts Slider, example: <a href=”#” class=”fcs_close_postbox”>link text</a>
  • classname: .fcs_close, method: close the last opened slider, example: <a href=”#” class=”fcs_close”>link text</a>
  • classname: .fcs_hide, method: hide all sliders, example: <a href=”#” class=”fcs_hide”>link text</a>
  • classname: .fcs_show, method: show all hidden sliders, example: <a href=”#” class=”fcs_show”>link text</a>

facebook_comment_slider_settings2

 

facebook_comment_slider_settings3

facebook_comment_slider_settings4

The plugin has some unique methods, therefore you can use the plugin with many of other purposes.
Possible to use the following methods:

  • initialize the plugin with default params: jQuery(‘body’).fbcslider();
  • initialize the plugin with custom params (see the full list of params below): jQuery(‘body’).fbcslider({‘appid’:’000000000000000′});
  • destroy (not possible to init again after destroy, you can use hide and show): jQuery(‘body’).fbcslider(‘destroy’);
  • hide all sliders: jQuery(‘body’).fbcslider(‘hide’);
  • show all hidden sliders: jQuery(‘body’).fbcslider(‘show’);
  • open the Like Box: jQuery(‘body’).fbcslider(‘openlikebox’);
  • open the Comment Box: jQuery(‘body’).fbcslider(‘opencommentbox’);
  • open the Wall Post Box: jQuery(‘body’).fbcslider(‘openpostbox’);
  • close the Like Box: jQuery(‘body’).fbcslider(‘closelikebox’);
  • close the Comment Box: jQuery(‘body’).fbcslider(‘closecommentbox’);
  • close last opened slider: jQuery(‘body’).fbcslider(‘close’);
  • detect mobile (results true below 800x600px resolution): jQuery(‘body’).fbcslider(‘detectmob’);
  • resize all sliders to original state: jQuery(‘body’).fbcslider(‘resize’);
  • check users liked the page or not (return 1 if already liked): jQuery(‘body’).fbcslider(‘getCookie’,’fbcsslider_liked’);