=== Floating Social Media Links === Contributors: celloexpressions Tags: social media, facebook, youtube, twitter, floating frame, links, icons, dynamic width Requires at least: 3.3.0 Tested up to: 3.4.1 Stable tag: 1.3.1 License: GPL2 Add a clean and simple floating frame with social media and custom links to your website/blog. Fully customizable with a robust array of options! == Description == Floating Social Media Links is a Wordpress Plugin designed to allow anyone to add a simple floating frame to their wordpress website/blog, which contains icons and links to their social media and partners' websites. Although similar Wordpress plugins do exist, the purpose of this plugin is to give highly customizable options and move away from "like" "share" and "subscribe" buttons in favor of simple, stylish linked icons (although these "action buttons" can still be optionally included). Instead of simply asking visitors to acknowledge their appreciation of your work, this encourages them to also check out your social media in addition to those acknowledgements, therefore increasing overall social interaction (more so than simply using "likes" to indicate interaction). My favorite feature amongst the robust array of options is the ability to add up to seven (7) custom links with custom uploadable thumbnails. This allows you to link to your other projects, your blog, or anything else you want right next to your social links. And never a single advertisement, link to my site, or donate button on the admin screens! For web designers and developers, a new option as of version 1.3.0 allows you to customize which pages the frame appears on by When updating from 1.2.1 or below to version 1.3.0 or above, please go to the settings page and click "save options", even if you don't change any options. This will automattically set the defaults for all new options and remove any error messages that come up. When upgrading from version 1.0.0 or 1.0.1 to version 1.1.0, 1.2.0 or higher, PLEASE be sure to visit your setting page and ensure that all of the new features are set to your liking. Please feel free to offer any feature suggestions you might have and I WILL consider them for future releases. == Installation == 1. Take the easy route and install through the wordpress plugin adder :) OR 1. Download the .zip file and upload the unzipped folder to the `/wp-content/plugins/` directory 1. Activate the plugin through the 'Plugins' menu in WordPress 1. Ensure that the `` and `` action hooks are in your theme's header.php and footer.php files templates 1. Enter your links, choose appearance settings, and set the first general option to YES to activate the frame on your site == Frequently Asked Questions == = The frame doesn't show up on my site! = First, make sure that the first general option is set to show the frame on every page, or that you have placed the necessary code in the correct template files if you are showing it on customized pages. Next, check your theme's header.php and footer.php files for the necessary action hooks (more instructions on the general options settings page). Check your vertical position setting AND UNITS in the appearance settings tab (15px is much different from 15in) - it's possible that your frame is too far down the page to see. If the problems persist, try the support forums. = How do I use the display on custom pages option? = To use the option to display the frame on customized pages, instead of on every page on your site, you need to be comfortable with editing you're theme's template files (html/php). If you are, siply copy this code: `` and paste it into each template file that is used for the pages that you want (for example, index.php for the main blog page, page.php for the default page template, search.php for the search results page, archives.php for archive pages, etc.). See wordpress' documentation on theme files. Once you find the template files that correspond to the pages you want the frame to appear on, paste the code into the file immediately before the line that says ``. Please be aware that in some themes, the frame may end up positioned relative to a content/container html element instead of the entire page. = Where's the settings page? = It's under settings: Settings -> Floating Social Media Links. And on a side note, the tabs on the settings page are showing different parts of the same page, not refreshing the browser, so you can switch between tabs without needing to save (and you are always returned to the general options tab when saving). = What about other social media sites? = I realize that there are countless other social media sites which aren't included in this plugin. In order to avoid an extensively bloated plugin and settings page, I have only included the three most popular sites (Facebook, Twitter, and Youtube). But... one of the reasons I've included space for up to 7 custom links is so that you may include links to any additional social media sites that you wish to. Simply find a version of the site's logo that you like and upload it as the icon, then enter the entire url (including, for example, facebook.com/), and it functions just like any of the built-in links. = Why default to customized pages showing the links? = This allows users to enter their links before the frame is actually show on your site. This option replaces an old option to activate the frame output; which would be redundant as this option does essentially the same thing. I try to minimize the number of unuseful options so that I can maximize the useful ones without bloating the plugin and making it take hours to set up. = When I updated to version 1.1.0 (or higher from earlier versions), all of the links disapeared from the site. Why, and how do I fix it? = Version 1.1.0 reworked the user interface of the plugin and the one change that impacts users is that instead of having a checkbox to disable each link, there is a checkbox to enable each link. As a result, plase go to the "Links/Icons" settings tab and select the checkbox next to each link that you want to show up on your site. Additionally, links are automatically disabled if the link extension is left blank (ie if the facebook links is left as simply http://facebook.com/). = My settings for a custom link disapeared when I said to hide it. Can I get them back or do I need to start over? = Any custom links that are hidden from your site will also be hidden from your settings page, by default. All of your settings, however, are saved. Simply click "Add Another Custom Link" and your previous settings will be pre-populated in the form. Note: If you have custom url 2 set, but not custom url 1 (for example), the options for custom url 2 will be hidden and url 1 shown on the options page (not on your site). Please use the custom urls sequentially to avoid this scenario. = How can I include a facebook like / twitter follow / youtube subscribe button in the frame? = Simply go to the "action buttons" tab on the settings page and check the boxes for the buttons that you would like to show. Facebook like buttons do have the potential to increase your page load time though. This is an issue with the facebook SDK, not this plugin, and I am working on an option to switch to a basic like button which doesn't have as many features but loads almost instantly. = Where are the custom color scheme settings? = Once you click on the "custom" color scheme option, all of the associated settings will appear. In general, options that are dependent on other options are hidden when they aren't available so that you don't need to scroll past them. = When I switched to a dynamic site width I lost my border settings and can't find them... = Because CSS borders can't be a percentage width, they will add a certain number of pixels to the width of the frame even if the frame has a percentage width. To avoid this senario, borders are disabled in dynamic width mode, but frame shadows are still allowed to separate the frame from the page background. == Screenshots == 1. Sample view on a blog using default appearance settings and some custom links 2. Admin Screens 3. Admin Screens 4. Admin Screens 5. Admin Screens == Changelog == = 1.3.1 = * Custom link default/placeholder icons replaced with one universal default icon to reduce plugin filesize and remove unnecessary unique placeholders. * Support for compatibility with Internet Explorer 7 and below can be enabled with a checkbox in the general options admin tab. * Improved process of updating from older versions (1.2.0 and below) * Up to three (3) custom links can be dynamically generated with php. Simply set the display option to custom pages, and call the floating_social_media_links() function, which accepts up to three parameters. Each parameter will override the custom link 1-3 url options, although you still need to set the icon image, link title, and click the enable checkbox in the settings page. If you only want one dynamic link but want it after two other custom links, you can call floating_social_media_links(null,null,$dynamically-generated-variable);. = 1.3.0 = * MAJOR Update, with new features, bugfixes, enhancements, greater customization, and a streamlined options page (that didn't get much longer!) * NEW FEATURES: * Frame can start hidden (in show/hide options) * Choice of show/hide animations * Changed plugin output activation to allow option for automatic sitewide display (with the wp_footer hook) or template-specific display with the new floating_social_media_links() hook * To use the custom hook, paste this code into the bottom of each page template you want the links to show up on, right before ``: ``. * A title can be set for the show frame icon (when in the hidden position) * BUG FIXES: * Border displaying in dynamic width when set during fixed width mode * Max-width set on dynamic widths, so dynamic width frames are never too big (more than 100px wide) on large screens * When website is printed, frame is not displayed at all now (previously printed covering up the middle of the website) * Enqueued admin script instead of embeding (should fix isssues where the page tabs, color pickers, and dynamically showing/hiding options didn't work) * ENHANCEMENTS: * Auto-dection/inclusion of leading /, http://, https://, mailto:, or sms: on custom links * Twitter follow button dynamically resizes (never overflows), and uses NO javascript for instant loading * Removed option to hide from the homepage, because of new, more customizable template tag for customizing pages to display frame on = 1.2.1 = * Minor update addressing a couple of minor bugfixes * Ability to hide the floating from from the homepage/blog page (whichever is set as the front page) = 1.2.0 = * Several feature upgrades and additions including: ** Ability to disable frame shadow independently of a custom colorscheme ** Wide, medium, slight, no, or custom rounded corners on the frame (css border radius) ** More extensive options for vertical positioning including support for different units and auto-detection if a custom value has been set * Custom Link icons are no longer restricted to squares, only the width is resized and the height is adjusted accordingly * Support for dynamic width websites has been added, with separate size options for fixed width and dynamic width sites (reduces frequency of frame covering site content) * Completely restructured CSS for greater efficiency, and way fewer external files * /user/ and /!#/ have been removed from youtube and twitter URLs by default, as they are now optional for youtube and twitter (you may add them in with your url extension if desired) * Other minor adjustments, bugfixes, better protection from bad options inputs, and clearer, more intuitive instructions and settings labels = 1.1.0 = * Major upgrades to the user interface, some new options, clearer instructions, a new YouTube subscribe button, and minor bugfixes. * VERY IMPORTANT: ONCE THE UPDATE IS COMPLETE, YOU MUST GO TO THE "LINKS/ICONS" TAB AND CHECK THE "ENABLE LINK" CHECKBOX NEXT TO EACH LINK YOU WANT TO ENABLE. THIS IS A NEW OPTION REPLACING THE DISABLE THIS LINK OPTION (MORE INTUITIVE THIS WAY), AND YOUR DISABLE SETTINGS CANNOT BE TRANSFERED. ALL OTHER SETTINGS ARE PRESERVED. = 1.0.1 = * Fixed margin/spacing errors between links and especially social sharing buttons * Confirmed compatibility with Wordpress 3.4.1 = 1.0.0 = * First publically available version of the plugin. * Compatible with Wordpress 3.3.0 through 3.4.0 = 0.8 = * This and all previous versions are initial development versions == Upgrade Notice == = 1.3.1 = Minor update with support for dynamic php links, streamlined placeholder images, and ability to add support for internet explorer 7 and below. If upgrading from version 1.2.1 or below PLEASE go to the settings page and click "save options" to add the defaults for the new options available in version 1.3.0.