=== Sociable for WordPress 3.0 === Contributors: tompokress Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=H3YD2QYUJH8TY Tags: sociable,sexy bookmarks,sexy,social,bookmark,social bookmarks,social bookmark,bookmarks,bookmarking,social bookmarking,sharing,sociable,share,sharethis,Add to favorites,BarraPunto,Bitacoras.com,BlinkList,blogmarks,Blogosphere,blogtercimlap,Faves,connotea,Current,del.icio.us,Design Float,Digg,Diigo,DotNetKicks,DZone,eKudos,email,Facebook,Fark,Fleck,FriendFeed,FSDaily,Global Grind,Google,Google Buzz,Gwar,HackerNews,Haohao,HealthRanker,HelloTxt,Hemidemi,Hyves,Identi.ca,IndianPad,Internetmedia,Kirtsy,laaik.it,LaTafanera,LinkArena,LinkaGoGo,LinkedIn,Linkter,Live,Meneame,MisterWong,MisterWong.DE,Mixx,MOB,muti,MyShare,MySpace,MSNReporter,N4G,Netvibes,NewsVine,Netvouz,NuJIJ,Orkut,Ping.fm,Posterous,PDF,Plurk,Print,Propeller,Ratimarks,Rec6,Reddit,RSS,Scoopeo,Segnalo,SheToldMe,Simpy,Slashdot,Socialogs,SphereIt,Sphinn,StumbleUpon,Techmeme,Technorati,ThisNext,Tipd,Tumblr,Twitter,Upnews,viadeo FR,Webnews.de,Webride,Wikio,Wikio FR,Wikio IT,Wykop,Xerpi,YahooBuzz,Yahoo! Bookmarks,Yigg, XHTML, facebook, facebook like, like button, facebook button, facebook like button, bit.ly, bitly, bebo Requires at least: 2.9 Tested up to: 3.0 Stable tag: 5.08 == Description == The famous Sociable plugin now updated and compatible with WordPress 3.0. Add social bookmarks to posts, pages and RSS feeds. Choose from more than 100 different social bookmarking sites like Digg, Facebook, and del.icio.us, or add your own sites! = NEW = * I'd like to hear from you! Please don't be shy about writing with your suggestions and enhancements. * Fixed issue with icon backgrounds in some themes * Added option for facebook 'like' button and text color scheme to [pro version](http://wpplugins.com/plugin/155/sociable-pro) * Added option for facebook faces to [pro version](http://wpplugins.com/plugin/155/sociable-pro) = FEATURES = * Social bookmarking for WordPress 3.0 and multisite * 99 social bookmarking services included * Add your own services * Icons are automatically added to posts, pages or RSS feeds * Template tag and shortcode are provided for precise control * Fully XHTML compliant = GET PRO = * Get the [Pro version](http://wpplugins.com/plugin/155/sociable-pro) for even more functionality! * Bit.ly URL shortening for twitter * Facebook 'like' button * Custom, themeable CSS tooltips * 10 new icon sets in different sizes (icons are included only for popular services; see the wpplugins.com description for a list) * Easily add your own custom icon sets == Installation == 1. Deactivate any old Sociable versions 2. Unzip the sociable plugin zip file 3. Upload the sociable plugin files to your sociable folder /wp-contents/plugins/sociable-30 4. Activate the sociable plugin from the WordPress 'plugins' screen 5. Use the sociable settings page to activate your bookmarks (only a few are active by default) == Advanced Users == A [sociable] shortcode is available so you can place the Sociable bookmarks anywhere you like in a post or page. Just place the shortcode anywhere in your post or page (if the shortcode is present the default icon output will be disabled). If you include the 'tagline' attribute you can set the tag line as well. For example: `This is my post. [sociable tagline='Share it:']` Just be sure to put the [sociable] tag on its own line - it's not allowed inside a paragraph. Another option is to turn off the automatic bookmarks display in the Sociable options screen and add calls directly to your theme. With this approach you can also specify which sites to display: ` // Show all active sites get_links(); ?> // Show only these two sites if they are active // Careful: the site names are case-sensitive! They must // exactly match the name in the services.php file. get_links(Array('Facebook', 'Twitter')); ?> ` == Frequently Asked Questions == = How can I use my own icons? = Make sure you're using [Sociable Pro](http://wpplugins.com/plugin/155/sociable-pro). Custom icons aren't supported in the free version. Pro includes 10 icon sets. You can find more at the links below or at many other sites: [http://www.online-blogger.net/2010/02/02/100-social-media-icon-sets/](http://www.online-blogger.net/2010/02/02/100-social-media-icon-sets/) [http://coderplus.com/blog/2009/11/social-bookmarking-icon-packs/](http://coderplus.com/blog/2009/11/social-bookmarking-icon-packs/) [http://www.komodomedia.com/download/](http://www.komodomedia.com/download/) Just put your icons in the directory `/images/custom/size` (where 'size' is the icon size). For example put your 16x16 icons in `images/custom/size/16` Your icons will then be available right from the settings screen. If you have multiple sets of icons and you want to switch between them you can also edit the file 'pro.php' to specify the icon set names and directories. = How can I add a new site? = The easiest way is to send it to me for inclusion in the next version of the plugin. But you can also do it yourself by editing the sites.php file and adding the icon to the images directory. = How can I change the CSS? = You can add a 'sociable_custom.css' to the plugin directory and it will be included (along with the original) when the plugin is loaded. Override the settings you need changed. = How has Sociable been updated? = The plugin has been rewritten to fix bugs in past versions and make it WordPress 3.0 and multisite compatible. It now includes multiple icon sets, shortcodes, theme tags, CSS tooltips and more. = Which sites are supported? = The complete list is: sociable,sexy bookmarks,sexy,social,bookmark,social bookmarks,social bookmark,bookmarks,bookmarking,social bookmarking,sharing,sociable,share,sharethis,Add to favorites,BarraPunto,Bitacoras.com,BlinkList,blogmarks,Blogosphere,blogtercimlap,Faves,connotea,Current,del.icio.us,Design Float,Digg,Diigo,DotNetKicks,DZone,eKudos,email,Facebook,Fark,Fleck,FriendFeed,FSDaily,Global Grind,Google,Google Buzz,Gwar,HackerNews,Haohao,HealthRanker,HelloTxt,Hemidemi,Hyves,Identi.ca,IndianPad,Internetmedia,Kirtsy,laaik.it,LaTafanera,LinkArena,LinkaGoGo,LinkedIn,Linkter,Live,Meneame,MisterWong,MisterWong.DE,Mixx,MOB,muti,MyShare,MySpace,MSNReporter,N4G,Netvibes,NewsVine,Netvouz,NuJIJ,Orkut,Ping.fm,Posterous,PDF,Plurk,Print,Propeller,Ratimarks,Rec6,Reddit,RSS,Scoopeo,Segnalo,SheToldMe,Simpy,Slashdot,Socialogs,SphereIt,Sphinn,StumbleUpon,Techmeme,Technorati,ThisNext,Tipd,Tumblr,Twitter,Upnews,viadeo FR,Webnews.de,Webride,Wikio,Wikio FR,Wikio IT,Wykop,Xerpi,YahooBuzz,Yahoo! Bookmarks,Yigg == Changelog == = 5.08 = * Added !important modifier to CSS for images to prevent overrides by some themes * Added option to choose Facebook like button/text colors * Added option to show Facebook faces. Note that currently this inserts too much space before the icons; in a future release I'll use the javascript libraries which allow a 'drop down' effect instead. = 5.07 = * Added code to block PRO version from wordpress repository updates (which will downgrade to regular version) = 5.06 = * Added "display-inline" to ".sociable img" CSS class for themes that may cause vertical icons * Fixed a bug causing "sociable_custom.css" to not load * Fixed a bug preventing tooltips from displaying = 5.05 = * The 5.04 fix only worked for IE. This one should fix Firefox as well. * The problem was caused by using 'white-space:nowrap' to attempt to keep the image captions with the icons during line wraps = 5.04 = * Fix for CSS issue some folks had with icons not wrapping * Fix for bug where no content returned when sociable disabled for individual post (thanks, Marian!) = 5.03 = * Bit.ly support added to Pro version. Uses V3 API. Short URLs are saved to the post to speed up fetching. * Facebook 'like' button added to Pro version. Note that you can adjust the CSS for the iframe in sociable.css. * Tweaks to CSS to make icons closer (as they were originally) when the captions aren't displayed. Check your site after upgrading. * Rewrote URL generation to be faster and only require one database read per post * Bebo service added * "Follow" icon set added to Pro = 5.02 = * Icon captions added. Set checkbox on the Sociable settings screen to display the site name next to each icon. * Captions are enclosed in a tag, e.g. caption. Style captions with class 'socable_caption'. * Moved Sociable filter for other plugins that may activate after Sociable = 5.01 = * Fixed bug in target=blank, should now work correctly * Fixed directory for 'tydlinka' icons in Pro * Added links to other icon sets in Pro = 5.00 = * Update to Buzz link, bug fixes in shortcode and template tags * Corrected an XHTML validation error * Custom images are now only available in the [Sociable Pro](http://wpplugins.com/plugin/155/sociable-pro) version. See the Frequently Asked Questions section for instructions. = 4.0.9 = * Added Orkut, Google Buzz services * New code for icon paths and urls * Admin screen bug fix, site order field removed = 4.0.8 = * Added [sociable] shortcode = 4.0.7 = * Fixed bug in RSS output = 4.0.6 = * i18n fixed * Options are now (I think) WPMU/multisite compatible * "Use CSS" option removed - for custom CSS create a file "sociable_custom.css" in the sociable directory * usetextlinks and disablesprites removed * awe.sm options removed = 4.0.3 - 4.0.5 = * Various array type bugs fixed = 4.0.2 = * Fixed bug that prevented meta box from displaying in post edit screen = 4.0.1 = * Fixed error in original code for wp_insert_post hook = 4.0.0 = * Woo-hoo Sociable for WordPress 3.0 released and working! Sociable is now WordPress 3.0 compatible and many more enhancements to come. * Sociable core code re-written to object-oriented PHP and WP 3.0 == Screenshots == 1. Sociable icons 2. Sociable in a blog 3. [Sociable Pro](http://wpplugins.com/plugin/155/sociable-pro) Facebook 'like' button with comments 4. [Sociable Pro](http://wpplugins.com/plugin/155/sociable-pro) twitter icons 5. [Sociable Pro](http://wpplugins.com/plugin/155/sociable-pro) tooltips 6. A few of the [Sociable Pro](http://wpplugins.com/plugin/155/sociable-pro) icon sets 7. Sociable options screen. Just drag and drop the bookmarks to change their display order.