=== WordPress Button Plugin MaxButtons ===
Contributors: maxfoundry, basszje, arcware, johnbhartley
Tags: wordpress button plugin, best wordpress button plugin, wordpress button, wordpress buttons, wordpress buttons plugin, social share, wp button creator, button generator, css3 button plugin, css3 button generator, css wordpress button, css3 wordpress button, create button icon, button shortcode, social icon, button, buttons, sharing, sharing buttons, widget, sidebar, Visual Composer, siteorigin, Contact Form 7, Beaver Builder, Easy Digital Download, contact form, page builder, wordpress button generator, css3 button plugin, css3 button generator, css wordpress button, css3 wordpress button, simple social buttons, wp button plugin, button generator, create button icon, font awesome, fontawesome, responsive, responsive buttons, google, google event tracking, google analytics, facebook, facebook icon, facebook like, floating social media, icon, icons,like, linkedin, linkedin icon, social media, css button generator, social icons, social media icons, social media plugin, social profiles, tweet, twitter, tweet button, gradient
Requires at least: 4.0
Tested up to: 4.6.1
Stable tag: 6.2


WordPress button plugin so powerful and easy to use anyone can create beautiful buttons and social share icons. 

== Description ==
MaxButtons is a [WordPress button](https://maxbuttons.com/?utm_source=repowp1&utm_medium=mbrepo&utm_content=mbr_wpbuttons&utm_campaign=mbr_wpbuttons), social share and social icon plugin.  Use it to create great-looking CSS3 WordPress buttons which can be used on any post or page on your site. The easy to use button editor makes it a snap to generate awesome responsive buttons in very little time. The social share and social icon features allow you to use or modify prebuilt social share and social icons to your delight.  

MaxButtons [WordPress button plugin](https://www.maxbuttons.com/#CSS3/?utm_source=repowbp&utm_medium=mbrepo&utm_content=wordpress_button_plugin&utm_campaign=repowbp) has been going strong for over 4 years and was the first button plugin for WordPress.  We regularly update and upgrade MaxButtons and [MaxButtons Pro](https://maxbuttons.com/?utm_source=repomb1&utm_medium=mbrepo&utm_content=mbr_mbpro2&utm_campaign=mbr_mbpro2) plus give terrific, timely support. We take pride in MaxButtons having earned over 300 5 star reviews and over 1 million downloads.  Here are couple of our favorites.

> “The best plugin of its kind” - by celito

> “This plugin makes creating buttons sooooo easy.” - by ncrocker202

> “Easy, clear, and robust. I'm a programmer and can write CSS till the cows come home, but why? Just get it, install it and use it. Then, when you're impressed, buy the pro version” - by jleahy

Max Foundry also makes the WordPress Gallery plugin [MaxGalleria](https://wordpress.org/plugins/maxgalleria/) and [Media Library Plus](https://wordpress.org/plugins/media-library-plus/) for better organization of your WordPress Media Library. 

= Requirements = 

* Wordpress installed
* PHP 5.3 

= WordPress Buttons = 

* [Create WordPress Buttons](https://www.maxbuttons.com/#CSS3/?utm_source=repocreate&utm_medium=mbrepo&utm_content=how-to-create&utm_campaign=repocreate)  
* Getting [Social Icons](https://maxbuttons.com/?utm_source=repoicons1&utm_medium=mbrepo&utm_content=social_sharing&utm_campaign=repoicons1) on your WordPress site.
* [Social Share](https://maxbuttons.com/?utm_source=reposhare&utm_medium=mbrepo&utm_content=social_sharing&utm_campaign=reposhare) on your WordPress site.
* What is a [CSS3 Button Generator](https://maxbuttons.com/?utm_source=repocss3&utm_medium=mbrepo&utm_content=what-is-generator&utm_campaign=repocss3)?
* [WordPress button](https://maxbuttons.com/product-category/button-packs/?utm_source=repolibs&utm_medium=mbrepo&utm_content=button_pack&utm_campaign=repolibs) library and button sets can make my designers and developers more productive.

= MaxButtons =

* No coding, the plugin takes care of everything
* Includes 5 beautiful, configurable Social Share sets
* Button shortcodes for ease of use
* Create unlimited number of buttons
* Live preview window instantly updated as you customize your buttons
* Color picker for unlimited color combinations
* Works with all modern browsers, degrades gracefully for others
* Fully CSS3 compliant with text shadowing, box shadowing, gradients, etc.
* Copy an existing button to use as starting point for others
* See your buttons on different color backgrounds
* Predefined defaults make getting started super easy
* SiteOrigin Page Builder integration through the SiteOrigin Widget Bundle
* Supports Shortcake plugin to see your buttons in your editor!


= Social Share =

MaxButtons now includes [WordPress Social Share](https://maxbuttons.com/?utm_source=repobestss&utm_medium=mbrepo&utm_content=best_social_share&utm_campaign=repobestss) capabilities to let your users show their appreciation for your great content by promoting it through their social networks. MaxButtons ships with a starter set total of 5 beautifully designed social share sets for the following social networks: 

* Facebook 
* Twitter
* Pinterest
* Linkedin
* Google+
* Pinterest
* VKontakte
* StumbleUpon
* Reddit 
* Digg
* Bloglovin

Use our sets as is or modify them as you would like with our button editor to get just the look and feel you want. 

= Social Icons =

In addition to promoting your content through MaxButtons social share functions.  You can also use or modify our social share icons to promote your social network profiles.  Simply select a social icon or make a button, include the link to your profile and post the button shortcode on your page. Social icons are easy with MaxButtons! 


= MaxButtons Pro =

Take your buttons to the next level with [MaxButtons Pro](https://www.maxbuttons.com/pricing/?utm_source=repombp&utm_medium=mbrepo&utm_content=MBPro&utm_campaign=repombp) ! 

Our premium WordPress plugin for buttons, social share and social icons brings you the [best WordPress button plugin](https://maxbuttons.com/?utm_source=mprepo&utm_medium=mbrepo&utm_content=best_css3_button&utm_campaign=repobestcss3) through continuous feature updating. Upgrading to the Pro version allows you to add icons and images to your custom WordPress buttons. The Pro features allow you to do so much more!

* **Icon Support** - Add icons to your buttons and customize placement and size.
* **Multi-line text** - Add a second line of text and stylize with font, size and placement.
* **Google Fonts** - We have included the entire set to help your buttons stand out with beautiful typography.
* **Button Packs** - Ready to use, value priced button sets that make any site good great.
* **Google Analytics** Event Tracking for WordPress Buttons. The best way to see you users’ interactions with buttons in Google Analytics. No coding needed.
* **Import/Export** - Useful for backing up and/or moving your buttons. Also, use any of the great free icons listed on our site.
* **Button Search** - for easier management of large button sets.
* **Font Awesome** - easiest WordPress integration 
* **Visual Composer** - Integrated with Visual Composer
* **Contact Form 7** Integration
* **Beaver Builder** Integration
* **Easy Digital Downloads** Purchase and Checkout Button Integration

MaxButtons Pro includes 17 beautifully designed social share sets plus you can use the advanced functions to design and configure social buttons and icons.

= WordPress Button Sets =

In addition to the free button packs included with MaxButtons Pro you can also purchase additional professionally designed, production ready button packs from the largest [WordPress button](http://maxbuttons.com/product-category/button-packs/?utm_source=reposets1&utm_medium=mbrepo&utm_content=buttonsets1&utm_campaign=reposets1) library in existence.  The library features more than 5,000 buttons.  It is the largest WordPress button library in the known universe.

[Wordpress button sets](https://maxbuttons.com/product-category/button-packs/?utm_source=reposets&utm_medium=mbrepo&utm_content=button_pack&utm_campaign=reposets) make designers and developers much more productive.

= Free Icons =

You can add free icons when you create your buttons with MaxButtons Pro so we’ve built one of the largest libraries to inspire you and make your buttons really stand out. 

= Button Shortcode =

1. Click the MaxButtons page from the admin menu.
1. Click the Add New button.
1. Create and customize your button using the button editor.
1. Fill out and select the options needed to build your button.
1. Once you're ready, click Save.
1. A [button shortcode](http://maxbuttons.com/button-shortcode/?utm_source=reposhort&utm_medium=mbrepo&utm_content=reposhort&utm_campaign=reposhort) will be generated (ex: [maxbutton id="17"] or [maxbutton name="My Button Name"]).
1. Use the shortcode anywhere in your content and the button will appear.

You can also pass the button text and URL as parameters in the [button shortcode](http://maxbuttons.com/button-shortcode/?utm_source=reposhort2&utm_medium=mbrepo&utm_content=reposhort2&utm_campaign=reposhort2), giving you even greater flexibility. For example, if you want to create a set of buttons that look exactly the same, except for the text and URL, you could do something like this:

[maxbutton id="17" text="Search Google" url="http://google.com"]

[maxbutton name="MaxButtons Button Name" text="Search Yahoo" url="http://yahoo.com"]

Another parameter you can give the shortcode is window, which tells the button whether or not to open the URL in a new window (by default the button opens the URL in the current window). To do so you always give the window parameter the value "new", shown below. Anything else will open the button URL in the current window.

[maxbutton id="17" window="new"]

You can also use the nofollow parameter, which will add a rel="nofollow" attribute to the button when set to true, as shown below (the default is false):

[maxbutton id="17" nofollow="true"]

NOTE: Passing parameters to the shortcode overrides those settings saved as part of the button.

= Support = 

We work hard to give timely support during the week.  And we give support when we're on during the weekend.

**MaxButtons.  Bringing the #buttonlove!**


== Installation ==

For automatic installation:

1. Login to your website and go to the Plugins section of your admin panel.
1. Click the Add New button.
1. Under Install Plugins, click the Upload link.
1. Select the plugin zip file from your computer then click the Install Now button.
1. You should see a message stating that the plugin was installed successfully.
1. Click the Activate Plugin link.

For manual installation:

1. You should have access to the server where WordPress is installed. If you don't, see your system administrator.
1. Copy the plugin zip file up to your server and unzip it somewhere on the file system.
1. Copy the "maxbuttons" folder into the /wp-content/plugins directory of your WordPress installation.
1. Login to your website and go to the Plugins section of your admin panel.
1. Look for "MaxButtons" and click Activate.

== Screenshots ==

1. Button overview - Everything in one view
2. Button editor - Your own look and feel
3. Social sharing - Unleash the power of the social networks
4. Simple but powerful options
5. Clear and fast output.

== Frequently Asked Questions ==

= How do I use the shortcode in a sidebar/widget? =

Simply add the button shortcode to your widget (ex: [maxbutton id="17"] or [maxbutton name="MaxButtons Button Name"]). If the styling is missing on the widget,  try to check the 'use important' checkbox under 'advanced' settings. 

= How can I add the shortcode to my post/page template? =

Simply add this code snippet to any of your theme template files:
`<?php echo do_shortcode('[maxbutton id="17"]'); ?>`

= Can't see styling on the frontpage = 

Sometimes the button styling doesn't load on the frontpage. There are usually two major reasons: 

* Theme doesn't have proper footer, check if wp_footer() is called in the theme
* Using MaxButtons with sliders, dynamic page loaders (such a parallax and one-page themes ) or caching mechanisms.

First ensure you have cleared all your caches. Then you can try to add the following to your shortcode: [maxbutton id=1 style="inline"]  ( replace the ID with the number of your button ). 
 

= TablePress and MaxButtons = 

TablePress uses a caching mechanism which prevents the MaxButtons style design from functioning. To solve this problem, simply add the caching option to the shortcode like this:  `[table id=123 cache_table_output=false]`  . See this [support topic on TablePress](https://wordpress.org/support/topic/maxbuttons-css-stopped-working-in-tablepress?replies=6).

A solution which will keep the cache enabled is to use this in your shortcode: [maxbutton id=1 style="inline"] . Flush the TablePress cache after adding this. 

= Part of my button is cutoff, how do I fix that? =

Try enabling the container and setting its margin options. You could also fix this manually by surrounding your button shortcode with a div element with margins. For example:

`<div style="margin: 10px 10px 10px 10px;">
    <?php echo do_shortcode('[maxbutton id="17"]'); ?>
    <?php echo do_shortcode('[maxbutton name="MaxButtons Button Name"]'); ?>
</div>`

Then adjust the margin values as needed (the order is: top, right, bottom, left).

= How do I center the button on a page? =

Enable the "Wrap with Center Div" option in the Container settings.

= How do I align multiple buttons next to each other? =

Enable the container option and set the alignment property to either "display: inline-block" or "float: left". You might also want to add some margin values to put some spacing between your buttons. If that doesn't work, try using a simple HTML table:

`<table>
	<tr>
		<td>[maxbutton id="1"]</td>
		<td>[maxbutton id="2"]</td>
		<td>[maxbutton id="3"]</td>
	</tr>
</table>`


== Changelog ==

= 6.2 = 

* Improved visibility of the color picker
* Fixed possible rendering issue with Box Shadow
* Fixed: in rare case the button could overlay the action buttons in the overview

= 6.1 =

* Several updates to the Color Picker
* Box Shadow spread option added
* Fixed conflict with important and box shadow setting

= 6.0 = 

* Version 6 milestone
* Fixed small styling issue in header
* Updated link in plugin

= 5.13 =

* Fixed several notices when creating new buttons
* Buttons will now always have 'pointer' cursor

= 5.12 = 

* Replaced color picker with WordPress default color picker
* Border radius can be locked to change all sides at onces.
* Cleanup of JS functions. 

= 5.11 =

* Improvements to layout for small and mobile views
* Optimizations to modal on resizing
* Social icons for Eyeem added

= 5.10 = 

* Fixed issue with background when using gradients 
* Collection name is shown in button overview when button is in collection
* Database checks and failovers improved
* Several small updates to styling and layout
* Fixed display issue showing pack name / description when empty

= 5.9 = 

* Greatly improved modal layouts
* Fixed - Social Share : non-existing buttons will not show.
* Child-spans now inherit background settings from parent anchor

= 5.8 = 

* Fixed - Social Share remove button visible again
* Fixed - Social Share button without attached network no longer open as popup by default. 
* Fixed - Custom Media Queries disabled after saving
* Description field can now be hidden via settings
* Various layout optimizations
* Tested for version 4.6

= 5.7 = 

* Fixed omission in button clear function causing not to clear fully 
* Fixed typo in Social Share shortcode
* Fixed social share bug, not correctly removing counts in certain situations
* Fixed social share icons not having cursor pointer
* Fixed Text Shadow bug with buttons having only shadow top set. 
* Inline loading of social share collections

= 5.6 =

* Updated Social Share welcome message
* Updated Readme text
* Tested for WP 4.5.3 

= 5.5 =

* Fixed CSS in review notice
* Fixed title issue with support topic titles
* Fixed small outlining issues in button editor

= 5.4 = 

* Colorpicker code enhanced
* Updated container options interface

= 5.3 = 

* Increased performance for shortcode when having an URL in shortcode. 
* Fixed bug Border Shadow not showing when blur is zero. 
* Fixed bug Text Shadow not showing when blur is zero.
* Fixed issue Text not displaying in preview when button was saved without text
* Minified all Javascript in plugin for faster performance. 


= 5.2 = 

* Fixed version check to enhance database upgrades
* Fixed Add buttons dialog in Beaver Builder 
* Extra check for social sharing not to load on WP login pages

= 5.1 = 

* Better pagination and display on Add Button dialog 
* Fixed certain Social Share default values . 
* Made number fields slightly larger
* Tested up to 4.5.2

= 5.0 = 

* New button editor interface
* Removed maximum length of text fields
* Performance: Javascript loading streamlined
* Fixed: Removal of social sharing collections
* Improved social share picker
* Fixed Window resize bug in popups 
* Fixed Array Bug in Social block

= 4.22.1 = 

* Removed Splinfo getExtension call since it's not compatible with all PHP 5.3 installations 

= 4.22 = 

* Major upgrade of user interface 
* Major cleanup of styling code
* Description now handles multiple lines correctly

= 4.21 = 

* Cleaner user interface at font options
* Check if jquery function exists on front. 

= 4.20 = 

* Tested for WordPress 4.5
* Moved old error modals in social sharing to new modal
* New copy dialog 

= 4.19 = 

* Fixed: Relative URL's without starting slash no longer are prepended with default scheme 
* Tel: and sms: URL's not accepted in URL field 

= 4.18 = 

* Fixed problem responsive settings not correctly enabling / disabling options
* Button editor now warns when moving away without saving

= 4.17 = 

* Moving from leanModal to better popup code
* Fixed Modal background and CSS error on delete button / view CSS
* Put Font style options (italics) back

= 4.16 = 

* Version number added to JS scripts to prevent browser caching on updates
* Tweaks to the main CSS class statement to avoid clutter 
* Fix for Cloudflare's email obfuscation in combination with responsive buttons. 


= 4.15 = 

* Option to add custom class names
* Added changes to increase plugin page speed performance

= 4.14 = 

* Buttons in Shortcake didn't show Font Awesome buttons correctly
* Fixed bug in Shortcake rendering with ID's over 10
* Fixed error when adding button via Shortcake dialog
* Fixed paging and popup issues in button add dialog
* Made previous / next buttons in button add dialog more clear

= 4.13 = 

* New option: Custom rel (Advanced) - for targeting popups 
* Upgraded to Font Awesome 4.5.0  
* Fixed remove collection link not working

= 4.12 = 

* SO Pagebuilder : Fixed callbacks
* Shortcake : Fixed faulty callback when mixing add button functionality 
* Social Share: fixed caching problem on blog pages results in same share URL's
* Social Share: fixed no image sharing with Pinterest. 
* Editor: Fixed Javascript crash when clicking No in Delete button dialog 


= 4.11.1 = 

* Fixed possible crash due to extra return characters in the plugin causing WordPress to malfunction.

= 4.11 = 

* Fixed SiteOrigin PageBuilder error when adding button 
* Shortcake integration
* Add button dialog improvements


= 4.10 = 

* Removed Twitter share count since Twitter doesn't support this anymore. 
* Fixed issue with color picker 
* Color picker window much larger now
* Add button interface now available in SiteOrigin editor widget

= 4.09 = 

* Several issues were fixed with upgrading the plugin and database tables
* Fixed link in edit post/page screen when having no buttons
* Fixed integration crash with new version of SiteOrigin Page Builder 


= 4.08 =

* Fixed conflict with WPMU Popup Pro
* New shortcode tag style="inline" - this forces the button style to load in document. This can be useful with JS-heavy sites who don't properly
load wp_footer(); 

= 4.07 = 

* Fixed problem with URL encodings 
* Fixed issue with Siteorigin widget not selecting button 
* Changes in styling ( WP 4.4. update )

= 4.06 = 

* Default button updated 

= 4.05 = 

* Integration with SiteOrigin Page Builder

= 4.04 = 

* Updates to the color picker interface.

= 4.03 =

* Shortcode examples popup no longer expands the editor window 
* Small fixes to title bar 

= 4.02 = 

* Fixed message in button inserter incorrectly stating no buttons are found.
* Javascript hardening to prevent conflicts in rare cases
* Better Settings interface

= 4.01 = 

* Add check for function 'maybe_convert_table_to_utf8mb4' which doesn't exists before WP 4.2.0
* Several interface fixes


= 4.0.2 = 

* Fixed issue that could cause database save to fail on button edit.
* Security validation on bulk edit form added
 

= 4.0.1 = 

* Changed few PHP calls which possibly were causing crashes on older versions.
* Bug in internal social sharing block function.

= 4.0 = 

* Social sharing [BETA] 
* Fixed possible conflicts with colpick.js
* Fixed problem in URL with mailto: scheme
* Fixed issue with enconding URL's. 

= 3.19 = 

* Added possibility for bulk editing - at own risk 
* Changed URL handling in certain cases to better URL encode the non-domain part. 

= 3.18 = 

* New filter for button url 
* By default overview shows your latest buttons. 
* Overview now sortable by button id 


= 3.17 = 

* Position and size of preview window updated to be less in the way 
* Small layout and text updates


= 3.16.1 = 

* Backward compatibility of layout changes

 

= 3.16 = 

* Fixed update box running through page title
* Fixed rating screen in some cases could not be closed
* Fixed plugin crash when database table is not present or wrong
* Lot of interface updates to make plugin more in line with WordPress admin defaults.

= 3.15.1 =

* Fixed save crash in case of custom responsive settings due to debug information

= 3.15 = 

* Small validation fix on custom responsive field
* Fixed rare bug occurence in SCSS parser

= 3.14 = 

* Fixed crash on servers without character encoding module enabled
* Attempts to upgrade utf-8 table to utf-8mb4 (plugin activation)
* Groups CSS statements without repeating <style> tag. 

= 3.13.1 = 

* Fixed issue with font size not being displayed correctly in editor

= 3.13 = 

* Fixed checkbox size on Chrome 
* Fixed several layout issues
* Fixed issue with non-latin button names in the css declaration of button
* Paging buttons now disabled if there are no more pages to browse
* Updated SCSS parser to latest version 


= 3.12.1 =

* Fixed responsive bug with multiple custom settings
* Fixed checkbox interface bug with responsive settings
* Fixed CSS parse errors with multiple responsive queries
 
 
= 3.12 = 

* Moved from serialize to json_encode 
* ID on button is now unique

= 3.11 = 

* Better checking of number values in interface
* Button name is now also a class on the button ( for custom work )
* CSS output can now be compressed ( minified ) 

= 3.10 = 

* Fixed: Now possible to add javascript to button URL field
* Fixed: Several JS plugin conflicts ( notably with Sidekick )
* Fixed: Now able to add spaces to URL 

= 3.09 = 

* Responsiveness bug fixes
* Fixed - custom sizes now allow width or height to be zero or not set
* Fixed rare bug when dbDelta was not properly loaded during installation


= 3.08 = 

* Text align now defaults to empty
* New color picker fixing several bugs 
* Fixed Divi themes / sitebuilder issue with add button 
* Fixed small interface issue with paging and zero buttons
* Fixed interface issue with bulk actions notices
* Fixed various small unset variable issues


= 3.07 = 

* Added Text align option 
* Fixed interface issue with removing responsive parts
* Fixed URL Escaping issue  

= 3.06 = 

* Added German translation

= 3.05 = 

* Better detection if all needed database fields are present 
* Updates to the plugin styles 
* Fixed a bug on the support page when allow_url_fopen is off 
* Some shortcode examples in button editor
* Fixed a bug in responsive data handling 
* Responsive items now can be hidden per screen size

= 3.04.2 = 

* Reworked add button interface in the post editor

= 3.04.1 = 

* Version numbering change to allow better version management in WP 
* Improved: Wordpress style pagination
* Improved: The button editor interface now warns before permanently deleting a button
* Fixed: Layout issue in button overview disrupting interface
* Fixed: Support area not showing correctly and deprecated error on mysql info.
* Fixed: Close button didn't show in the external css dialog  

= 3.04 = 

* New : Pagination 

* Fixed : Issue in parser causing issues when saving buttons
* Fixed : Button list can now display buttons from cache
* Fixed : Big buttons in list would be too large for screen causing problems
* Several smaller issues and interface hardening
* Updated several links

= 3.03 = 

* Fixed: Text shadow and border shadow were still showing with zero width. 
* Fixed: Migrate script from old version moves button id correctly. 
* Fixed: Link to buttons missing on plugins page


= 3.02 = 

* Fixed: IK Facebook plugin jamming the colorpicker 
* Fixed: Bug where hover cursor wouldn't show up when url was added via shortcode
* Fixed: Moving table to UTF-8 in settings works again

* Option for remigration of settings from old to new table in case upgrade didn't complete
* Added PHP 5.3 requirement in readme
* Added checks for both PHP version, and if activation did run. 
* Removed default 'white-space: nowrap'.
* Tested with WP 4.2

= 3.01 = 

* Code rebuilt
* Major performance enhancements 
* Responsive module 
* Dimensions, set width and height 



== Upgrade Notice ==

= 3.19 = 

URL handling has been changed. If you use non-usual URL's in your buttons please let us know directly if you encounter any problems.

= 4.0 = 

This major update includes new Social sharing features. If you run into issues please let us know via support. Experiences are also welcome!

= 3.0 = 
Attention! This is a big upgrade from 2.x. Before installation it's adviced take a backup. In case your buttons don't appear after upgrading, 
please try to deactivate and activate the plugin again 

= 1.24.2 =
Please deactivate and then reactivate before using. If the save button does not work, be sure to clear your browser cache. Also, if the "copy and invert" button does not work, try a hard refresh of your browser or clear your cache.






