=== Social Crowd === Contributors: bdoga, tdawg2 Plugin URI: http://www.macnative.com/development/socialCrowd Author URI: http://www.macnative.com Donate link: http://www.macnative.com/development/donate Tags: social, network, networks, count, friends, crowd, clan, contacts, display, show, vanity, stats, statistics, followers, readers, facebook, google+, google plus, linkedin, linked in, twitter, feedburner, youtube, vimeo, number, raw Requires at least: 3.0 Tested up to: 3.3.1 Stable tag: 0.7.2 Social Crowd retrieves the count/number of Friends/Followers from your favorite social networks and displays them throughout your blog == Description == The Social Crowd Plugin grabs the latest counts of your Friends/Fans/Followers etc from your Favorite Social Networks and then displays them on your Blog. The counts that are reported come raw and without styling, so you can make them look and feel like your website. It is the perfect solution to encourage more users to join your network. **Important:** This plugin **REQUIRES** the PHP Curl Module in order to function. Please make sure it is installed. #### Supported Networks: * Facebook * Google+ (Beta Support) * Twitter * Linked In (Beta Support) * Youtube * Vimeo * Feedburner #### Plugin Usage **Feedburner Instructions** If you wish to use the Feedburner stats you must enable access by logging into your Feedburner admin panel http://feedburner.google.com, selecting the feed you want Social Crowd to access, Click on the "Publicize" tab, Select "Awareness API" from the Sidebar, and then click the "Activate" button. This will allow Social Crowd to correctly acquire your Feedburner stats and display them for you. **Basic Usage** After setting up the options on the 'Social Crowd Options' page in the wordpress administrator (setting the Social Networks that you want to collect stats from), you can go to the Widgets manager and enable the 'Social Crowd' widget. This widget will automatically display the networks that you have selected on the options page, with some limited customizability, and you are good to go. **Intermediate Usage** After configuring the options as indicated in the 'basic usage' above, you can enable the 'Social Crowd Advanced' widget in the widget administrator. This widget gives you the ability to specifically select the networks that you want to display in the widget area, and also allows you to customize the text that is displayed with the stats. Additionally there is a shortcode that allows you to access the stats and output them throughout your posts and pages. The shortcode is used as follows: [SC_Stats type=network] where network is the social network that you want to display stats for ie: 'facebook', 'twitter', etc... or any of the available stats listed in the 'Available Stats' list below. If you do not include a 'type' of network in the shortcode it will return your facebook stat count by default. **Advanced (Designer/Developer) Usage** The Social Crowd Plugin provides function calls that you can use throughout your theme files to better promote your or your clients social networks. The function documentation is as follows. The Social Crowd function you will call is: SocialCrowd_Stats(); You have two options: * Calling the function with a specific network: 1. Place the function wherever you want the data to be displayed. 1. Call the function with a specific network name (all lowercase): * SocialCrowd_Stats('facebook') * SocialCrowd_Stats('twitter') * SocialCrowd_Stats('youtube') * etc... 1. Function will echo out the requested Network Stats. * Calling the function without a specific network: 1. Place the function anywhere you want. 1. Call the function with no options. $stats = SocialCrowd_Stats() 1. The function will return an array with the stats for all your networks. 1. the array is an associative array that you can you can access like so: * $stats['facebook'] * $stats['twitter'] * $stats['youtube'] * etc... #### Available Stats The available stats are listed in the following order: Type of statistic ('keyword'), use the keyowrd in the Social Crowd function to retrieve the desired content. * Feedburner subscriber count (' **feedburner** ') *Number of subscribers to your feed.* * Facebook Friend/Like Count (' **facebook** ') *Number of friends or page likes.* * Twitter Follower Count (' **twitter** ') *Number of followers.* * Twitter Friend Count (' **twitterFriends** ') *Number of Friends you have.* * Twitter Statuses Count (' **twitterStatuses** ') *Number of status updates you have sent.* * Twitter Listed Count (' **twitterListed** ') *Number of lists you have been added to.* * Youtube Friend Count (' **youtube** ') *Number of friends on Youtube.* * Youtube Subscriber Count (' **youtubeSubscribers** ') *Number of Youtube subscribers.* * Youtube Viewed Count (' **youtubeViews** ') *Number of videos you have viewed.* * Youtube Uploaded Views Count (' **youtubeUploadViews** ') *Number of views your uploaded videos have had on Youtube.* * Vimeo Friend Count (' **vimeo** ') *Number of friends you have on Vimeo.* * Vimeo Uploads Count (' **vimeoUploads** ') *Number of videos you have uploaded to Vimeo.* * Vimeo Appears In Count (' **vimeoAppearsIn** ') *Number of videos you appear in on Vimeo.* * Vimeo Likes Count (' **vimeoLikes** ') *Number of videos that you have liked on Vimeo.* * Google+ Your Circles Count (' **gplusCircles** ') *Number of people that you have in your circles.* * Google+ Others Circles Count (' **gplusInCircles** ') *Number of people that have you in their circles.* * Linked In Connections (' **linkedIn** ') *Number of Connections.* I hope to expand this list to include your favorites ( just leave me some comments on the [plugin homepage][1] ). [1]: http://www.macnative.com/development/social-crowd/ A big thanks to DeviantArt's jwloh for creating the Social.me and Aquaticus Icon Sets that is used in the plugin's Administrator and Widgets, You can check out [his work][2]. [2]: http://jwloh.deviantart.com/ Other icons used with the Widget are: [Elegant Media Icon Set][4] [4]: http://www.elegantthemes.com [Picons Icon Set][5] [5]: http://www.picons.me [Social Balloon Icon Set][6] [6]: http://www.doublejdesign.co.uk/ [Socialize Sticker Icon Set][7] [7]: http://dryicons.com/free-icons/ == Installation == 1. Unzip and upload the Social Crowd plugin folder to wp-content/plugins/ 1. Activate the plugin from your WordPress admin panel. 1. Installation finished. == Frequently Asked Questions == = How do I customize the appearance of the widget? = In the widget options there is a checkbox titled 'Default Styling' if you uncheck that box, you can include the following CSS in your own css file with any required changes to apply your custom look and feel to the widget. = How do I call the function = The function that you will call is: SocialCrowd_Stats(); You have two options: * Calling the function with a specific network: 1. Place the function wherever you want the data to be displayed. 1. Call the function with a specific network name (all lowercase): * `` * `` * `` * etc... 1. Function will echo out the requested Network Stats. * Calling the function without a specific network: 1. Place the function anywhere you want. 1. Call the function with no options. $stats = SocialCrowd_Stats() 1. The function will return an array with the stats for all your networks. 1. the array is an associative array that you can you can access like so: * `` * `` * `` * etc... = What stats can I grab? = #### Available Stats The available stats are listed in the following order: Type of statistic ('keyword'), use the keyowrd in the Social Crowd function to retrieve the desired content. * Feedburner subscriber count (' **feedburner** ') *Number of subscribers to your feed.* * Facebook Friend/Like Count (' **facebook** ') *Number of friends or page likes.* * Twitter Follower Count (' **twitter** ') *Number of followers.* * Twitter Friend Count (' **twitterFriends** ') *Number of Friends you have.* * Twitter Statuses Count (' **twitterStatuses** ') *Number of status updates you have sent.* * Twitter Listed Count (' **twitterListed** ') *Number of lists you have been added to.* * Youtube Friend Count (' **youtube** ') *Number of friends on Youtube.* * Youtube Subscriber Count (' **youtubeSubscribers** ') *Number of Youtube subscribers.* * Youtube Viewed Count (' **youtubeViews** ') *Number of videos you have viewed.* * Youtube Uploaded Views Count (' **youtubeUploadViews** ') *Number of views your uploaded videos have had on Youtube.* * Vimeo Friend Count (' **vimeo** ') *Number of friends you have on Vimeo.* * Vimeo Uploads Count (' **vimeoUploads** ') *Number of videos you have uploaded to Vimeo.* * Vimeo Appears In Count (' **vimeoAppearsIn** ') *Number of videos you appear in on Vimeo.* * Vimeo Likes Count (' **vimeoLikes** ') *Number of videos that you have liked on Vimeo.* * Google+ Your Circles Count (' **gplusCircles** ') *Number of people that you have in your circles.* * Google+ Others Circles Count (' **gplusInCircles** ') *Number of people that have you in their circles.* * Linked In Connections (' **linkedIn** ') *Number of Connections.* I hope to expand this list to include your favorites ( just leave me some comments on the [plugin homepage][1] ). = What if my favorite network isn't supported? = [Drop me a line][3] and I will work on getting it added. [3]: http://www.macnative.com/contact-me/ == Screenshots == 1. Admin Interface 2. Example Widget Output 3. Simple Widget Interface 4. Example Designer Custom Usage == Changelog == = 0.7.2 [2012-02-17] = * Added new instructions on how to fix the issue many have had with Feedburner = 0.7.1 [2012-02-2] = * Bugfix for Linked-In Profiles - Now adding full url in admin to retrieve correct profile data * Added Check for CURL module and indicator to show wether it is loaded = 0.7 [2012-01-30] = * Fix Minor UI issue in the plugin Admin. * Added capacity to insert full url in the profile ID fields of the Admin panel, for ease of use for some users (based on feedback) = 0.6 [2012-01-25] = * Added Settings link on the Plugin Administration Panel for easy access * Added (Beta) Linked In Support = 0.5 [2012-01-19] = * Added Shortcode to access stats more easily in posts and pages * Added Widget to make it very easy to share your stats with others * Added Widget with Advanced Options * Added (Beta) Google+ support = 0.2 [2011-06-08] = * Added additional statistics gathering for Twitter, Youtube, and Vimeo. * Added additional detail and information in the Readme file. * Small UI tweaks to the Admin. = 0.1 [2011-05-17] = * Initial Release == Upgrade Notice == = 0.7.2 = Added instructions on how to correct the feedburner issue some have experienced.