Getting Started with WP Social Pro


Read below for instructions on how to configure our advanced options and display feeds, photos, and events.

Pro Options

How To Output The Feed

How To Output a Photo Gallery

How To Output an Event Feed


Pro Custom HTML Options

These are the Custom HTML Options.  These options give power users the ability to customize the markup that is being output by the plugin.  This is great for upfitting the plugin to drop into your highly custom WordPress theme.
These are the Custom HTML Options. These options give power users the ability to customize the markup that is being output by the plugin. This is great for upfitting the plugin to drop into your highly custom WordPress theme.
  1. Use Custom HTML: If checked, this will disable the Style Options in the first tab and will instead use the Custom HTML
  2. Custom Feed Item HTML: Input any Custom HTML you want used here, following this example: <li class="ik_fb_feed_item">{ikfb:feed_item}</li>
  3. Custom Feed Message HTML: Input any Custom HTML you want used here, following this example: <p>{ikfb:feed_item:message}</p>
  4. Custom Feed Image HTML: Input any Custom HTML you want used here, following this example: <p>{ikfb:feed_item:image}</p>
  5. Custom Feed Description HTML: Input any Custom HTML you want used here, following this example: <p>{ikfb:feed_item:description}</p>
  6. Custom Feed Caption HTML: Input any Custom HTML you want used here, following this example: <p>{ikfb:feed_item:link}</p>
  7. Custom Feed Wrapper HTML: Input any Custom HTML you want used here, following this example: <div id="ik_fb_widget"><div>{ikfb:image}{ikfb:link}</div>{ikfb:like_button}<ul>{ikfb:feed}</ul></div>

Pro Branding Options

These are the Branding Options included in WP Social Pro. These options allow you to hide our branding from your admin and also allow you to hide 3rd party posters from showing up in the feed.
These are the Branding Options included in WP Social Pro. These options allow you to hide our branding from your admin and also allow you to hide 3rd party posters from showing up in the feed.
  1. Only Show Page Owner’s Posts: If checked, the only posts shown will be those made by the Page Owner. This is a good way to prevent random users from posting things to your FB Wall that will then show up on your website
  2. Hide Branding: If checked, our branding will be hidden from the WordPress admin

How to Output the Sidebar Widget

The widget can be found on the Appearance -> Widgets screen.
  1. Navigate to Appearance -> Widgets
  2. Drag the WP Social Widget to the widget area you want it to appear
  3. That’s it!

How to Output the Feed in a Page or Post

  1. Go to the Edit Screen of the desired Page or Post
  2. Input the shortcode [ik_fb_feed] where you want it to appear. There are several optional attributes you can set on the shortcode, to override the global settings: colorscheme="light or dark" use_thumb="true or false" width="250" num_posts="5" id="123456789". If ‘use_thumb’ is set to true, the value of ‘width’ will be ignored. If ‘use_thumb’ or ‘width’ are not set, the values from the Options page will be used. If id is not set, the shortcode will use the Page ID from your Settings page. All of the options on the widget will use the defaults, drawn from the Settings page, if they aren’t passed via the widget
  3. That’s it!

How to Output the Feed in a Theme file

  1. Open up the file you want to output the feed in
  2. Use the PHP function ik_fb_display_feed($colorscheme,$use_thumb,$width); where you want the feed to appear
  3. That’s it!

How to Add the Like Button to a Page or Post

  1. Go to the Edit Screen of the desired Page or Post
  2. Input the shortcode [ik_fb_like_button] where you want it to appear. There are several attributes you can set, including: url="https://some_url" height"desired_iframe_height" colorscheme="light or dark". If you don’t set a URL, the button will like the current page being viewed. Values for height must be integers.
  3. That’s it!

Click here to see an example Facebook feed.

How to Add the Like Button to a Theme file

  1. Open up the file you want to output the Like Button in
  2. Use the PHP function ik_fb_display_like_button($url_to_like,$height_of_iframe,$colorscheme); where you want the Like Button to appear
  3. That’s it!
  1. Go to the Edit Screen of the desired Page or Post
  2. Input the shortcode [ik_fb_gallery id="539627829386059" num_photos="25" size="130x73" title="Hello World!"] in the body of a post.
  3. Change “Hello World!” in the example above to whatever text you want to appear above your gallery.
  4. If no size is passed, it will default to 320 x 180. Size options are “2048×1152”, “960×540”, “720×405”, “600×337”, “480×270”, “320×180”, and “130×73”.
  5. If num_photos is not set, the Gallery will default to the amount set on the Dashboard – if no amount is set there, it will display up to 25 photos.
  6. The ID number is found by looking at the URL of the link to the Album on Facebook. For example, when looking at the following URL, you want to grab the number that appears directly after “set=a.” and before the next period – facebook.com/media/set/?set=a.539627829386059.148135.322657451083099&type=3

    In this case, the Facebook Album ID is ‘539627829386059’.

Click here to see an example photo gallery.

How to Output a Facebook Event Feed

  1. Outputting an event feed is the same as outputting a Page Feed. The difference is the ID that you pass to the shortcode – you will want to use the ID of the event (found by looking at the number in the URL of the event on Facebook.) Our software will automatically detect that you are displaying an event and will take care of the rest!

Click here to see an example Facebook event feed.