| 1 |
=== WordPress Button Plugin MaxButtons === |
| 2 |
Contributors: maxfoundry, basszje, arcware, johnbhartley |
| 3 |
Tags: wordpress button plugin, share button, wordpress buttons, css3 button generator, responsive buttons, css wordpress button |
| 4 |
Requires at least: 4.8 |
| 5 |
Tested up to: 4.9.5 |
| 6 |
Requires PHP: 5.3 |
| 7 |
Stable tag: 7.1.2 |
| 8 |
|
| 9 |
WordPress button plugin so powerful and easy to use anyone can create beautiful buttons, share buttons and social icons. |
| 10 |
|
| 11 |
== Description == |
| 12 |
[MaxButtons](https://maxbuttons.com/?utm_source=repowp1&utm_medium=mbrepo&utm_content=mbr_maxbuttons&utm_campaign=mbr_maxbuttons) is a powerful WordPress button, share button and social icon plugin. Create great looking CSS3 WordPress buttons in a minute. Easy to understand. Our button editor with live preview makes it a snap to generate awesome responsive buttons in very little time. The social share buttons and social icon features allow you to add social options to your website in minutes. |
| 13 |
|
| 14 |
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 6 years and was the first button plugin for WordPress. MaxButtons has earned over 600 5-star reviews and over 1.5 million downloads. Here are couple of our favorites: |
| 15 |
|
| 16 |
> “The best plugin of its kind” - by celito |
| 17 |
|
| 18 |
> “This plugin makes creating buttons sooooo easy.” - by ncrocker202 |
| 19 |
|
| 20 |
> Why aren’t all plugins like this?!? |
| 21 |
MaxButtons easily solved my problem with lots of options when creating the button and a live view of what it was going to look like. It would have done the job for me there and then but being able to adjust the text AND link with shortcodes on my page made modifications a breeze. - by discgosforth |
| 22 |
|
| 23 |
> “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 |
| 24 |
|
| 25 |
Max Foundry also makes the WordPress Gallery plugin [MaxGalleria](https://maxgalleria.com) and [WordPress Media Folders](https://maxgalleria.com/downloads/media-library-plus-pro/) plugin for real WordPress Media Library folders and [Welcome Mat Pro](https://welcomemat.io). |
| 26 |
|
| 27 |
= Requirements = |
| 28 |
|
| 29 |
* Wordpress installed |
| 30 |
* PHP 5.3 |
| 31 |
|
| 32 |
= WordPress Buttons = |
| 33 |
|
| 34 |
* [Create WordPress Buttons](https://maxbuttons.com/create-wordpress-button/?utm_source=repocreate&utm_medium=mbrepo&utm_content=how-to-create&utm_campaign=repocreate) |
| 35 |
* Getting [Social Icons](https://maxbuttons.com/wordpress-share-buttons/?utm_source=repoicons1&utm_medium=mbrepo&utm_content=social_sharing&utm_campaign=repoicons1) on your WordPress site. |
| 36 |
* [Share Buttons](http://wordpress.org/plugins/share-button/) on your WordPress site. |
| 37 |
* [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. |
| 38 |
|
| 39 |
= MaxButtons = |
| 40 |
|
| 41 |
* No coding, the plugin takes care of everything |
| 42 |
* Button shortcodes for ease of use |
| 43 |
* Create unlimited number of buttons |
| 44 |
* Live preview window instantly updates as you customize your buttons |
| 45 |
* Color picker for unlimited color combinations |
| 46 |
* Works with all modern browsers, degrades gracefully for others |
| 47 |
* Fully CSS3 compliant with text shadowing, box shadowing, gradients, etc. |
| 48 |
* Copy an existing button to use as starting point for others |
| 49 |
* See your buttons on different color backgrounds |
| 50 |
* Predefined defaults make getting started super easy |
| 51 |
* SiteOrigin Page Builder integration through the SiteOrigin Widget Bundle |
| 52 |
* Supports Shortcake plugin to see your buttons in your editor! |
| 53 |
|
| 54 |
|
| 55 |
= Share Buttons = |
| 56 |
|
| 57 |
MaxButtons has a [share buttons addon](https://maxbuttons.com/?utm_source=repobestss&utm_medium=mbrepo&utm_content=best_social_share&utm_campaign=repobestss) that includes 7 beautifully designed share button sets for the following social networks: |
| 58 |
|
| 59 |
* Facebook |
| 60 |
* Twitter |
| 61 |
* Pinterest |
| 62 |
* Linkedin |
| 63 |
* Google+ |
| 64 |
* Pinterest |
| 65 |
* VKontakte |
| 66 |
* StumbleUpon |
| 67 |
* Reddit |
| 68 |
* Whatsapp |
| 69 |
* Buffer |
| 70 |
|
| 71 |
Plus email and print icons. |
| 72 |
|
| 73 |
= Social Icons = |
| 74 |
|
| 75 |
In addition to promoting your content through MaxButtons share buttons you can also use share buttons 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! |
| 76 |
|
| 77 |
= MaxButtons Pro = |
| 78 |
|
| 79 |
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)! |
| 80 |
|
| 81 |
Our premium WordPress plugin for buttons, share buttons 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! |
| 82 |
|
| 83 |
* **Icon Support** - Add icons and images to your buttons and customize placement and size. |
| 84 |
* **Multi-line text** - Add a second line of text and stylize with font, size and placement. |
| 85 |
* **Google Fonts** - We have included the entire set to help your buttons stand out with beautiful typography. |
| 86 |
* **Button Packs** - Ready to use, value priced button sets that make any site good great. |
| 87 |
* **Google Analytics** [Event Tracking for WordPress Buttons](https://maxbuttons.com/google-analytics-event-tracking/). The best way to see you users’ interactions with buttons in Google Analytics. No coding needed. |
| 88 |
* **Import/Export** - Useful for backing up and/or moving your buttons. Also, use any of the great free icons listed on our site. |
| 89 |
* Include images in buttons. |
| 90 |
* **Button Search** - for easier management of large button sets. |
| 91 |
* **Font Awesome 5** - Largest icon collection, fastest served |
| 92 |
* **Visual Composer** - Integrated with Visual Composer |
| 93 |
* **Contact Form 7** Integration |
| 94 |
* **Beaver Builder** Integration |
| 95 |
* **Easy Digital Downloads** Purchase and Checkout Button Integration |
| 96 |
|
| 97 |
= WordPress Button Sets = |
| 98 |
|
| 99 |
In addition to the Basic Buttons and 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 6,000 buttons. It is the largest WordPress button library in the known universe. |
| 100 |
|
| 101 |
[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. |
| 102 |
|
| 103 |
= Free Icons = |
| 104 |
|
| 105 |
You can use 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. |
| 106 |
|
| 107 |
= Button Shortcode = |
| 108 |
|
| 109 |
1. Click the MaxButtons page from the admin menu. |
| 110 |
1. Click the Add New button. |
| 111 |
1. Create and customize your button using the button editor. |
| 112 |
1. Fill out and select the options needed to build your button. |
| 113 |
1. Once you're ready, click Save. |
| 114 |
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"]). |
| 115 |
1. Use the shortcode anywhere in your content and the button will appear. |
| 116 |
|
| 117 |
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: |
| 118 |
|
| 119 |
[maxbutton id="17" text="Search Google" url="http://google.com"] |
| 120 |
|
| 121 |
[maxbutton name="MaxButtons Button Name" text="Search Yahoo" url="http://yahoo.com"] |
| 122 |
|
| 123 |
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. |
| 124 |
|
| 125 |
[maxbutton id="17" window="new"] |
| 126 |
|
| 127 |
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): |
| 128 |
|
| 129 |
[maxbutton id="17" nofollow="true"] |
| 130 |
|
| 131 |
NOTE: Passing parameters to the shortcode overrides those settings saved as part of the button. |
| 132 |
|
| 133 |
= Support = |
| 134 |
|
| 135 |
We work hard to give timely support during the week. And we give support when we're on during the weekend. |
| 136 |
|
| 137 |
**MaxButtons. Bringing the #buttonlove!** |
| 138 |
|
| 139 |
|
| 140 |
== Installation == |
| 141 |
|
| 142 |
For automatic installation: |
| 143 |
|
| 144 |
1. Login to your website and go to the Plugins section of your admin panel. |
| 145 |
1. Click the Add New button. |
| 146 |
1. Under Install Plugins, click the Upload link. |
| 147 |
1. Select the plugin zip file from your computer then click the Install Now button. |
| 148 |
1. You should see a message stating that the plugin was installed successfully. |
| 149 |
1. Click the Activate Plugin link. |
| 150 |
|
| 151 |
For manual installation: |
| 152 |
|
| 153 |
1. You should have access to the server where WordPress is installed. If you don't, see your system administrator. |
| 154 |
1. Copy the plugin zip file up to your server and unzip it somewhere on the file system. |
| 155 |
1. Copy the "maxbuttons" folder into the /wp-content/plugins directory of your WordPress installation. |
| 156 |
1. Login to your website and go to the Plugins section of your admin panel. |
| 157 |
1. Look for "MaxButtons" and click Activate. |
| 158 |
|
| 159 |
== Screenshots == |
| 160 |
|
| 161 |
1. Button overview - Everything in one view |
| 162 |
2. Button editor - Your own look and feel |
| 163 |
3. Amazing color options |
| 164 |
4. Social sharing - Unleash the power of the social networks |
| 165 |
5. Simple but powerful options |
| 166 |
6. Clear and fast output. |
| 167 |
|
| 168 |
|
| 169 |
== Frequently Asked Questions == |
| 170 |
|
| 171 |
= Do I have to copy a button if I want to have a different text or link? = |
| 172 |
|
| 173 |
No. The shortcode enables you to change various items on the button including the text and link. It's better to create a single button and reuse it. |
| 174 |
|
| 175 |
To change text and link : |
| 176 |
[maxbutton id="1" text="yourtext" url="http://yoururl"] |
| 177 |
|
| 178 |
If you only want to change one of the two, just leave the not needed option out. |
| 179 |
|
| 180 |
All possible options: |
| 181 |
|
| 182 |
[maxbutton id="1" text="yourtext" url="http://yoururl" window="new" nofollow="true"] |
| 183 |
|
| 184 |
You should *never* copy buttons if you only have a different line of text and / or link on any button. |
| 185 |
|
| 186 |
= How do I use the shortcode in a sidebar/widget? = |
| 187 |
|
| 188 |
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. |
| 189 |
|
| 190 |
= How can I add the shortcode to my post/page template? = |
| 191 |
|
| 192 |
Simply add this code snippet to any of your theme template files: |
| 193 |
`<?php echo do_shortcode('[maxbutton id="17"]'); ?>` |
| 194 |
|
| 195 |
= Can't see styling on the frontpage = |
| 196 |
|
| 197 |
Sometimes the button styling doesn't load on the frontpage. There are usually two major reasons: |
| 198 |
|
| 199 |
* Theme doesn't have proper footer, check if wp_footer() is called in the theme |
| 200 |
* Using MaxButtons with sliders, dynamic page loaders (such a parallax and one-page themes ) or caching mechanisms. |
| 201 |
other |
| 202 |
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 ). |
| 203 |
|
| 204 |
|
| 205 |
= TablePress and MaxButtons = |
| 206 |
|
| 207 |
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). |
| 208 |
|
| 209 |
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. |
| 210 |
|
| 211 |
= Part of my button is cutoff, how do I fix that? = |
| 212 |
|
| 213 |
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: |
| 214 |
|
| 215 |
`<div style="margin: 10px 10px 10px 10px;"> |
| 216 |
<?php echo do_shortcode('[maxbutton id="17"]'); ?> |
| 217 |
<?php echo do_shortcode('[maxbutton name="MaxButtons Button Name"]'); ?> |
| 218 |
</div>` |
| 219 |
|
| 220 |
Then adjust the margin values as needed (the order is: top, right, bottom, left). |
| 221 |
|
| 222 |
= How do I center the button on a page? = |
| 223 |
|
| 224 |
Enable the "Wrap with Center Div" option in the Container settings. |
| 225 |
|
| 226 |
= How do I align multiple buttons next to each other? = |
| 227 |
|
| 228 |
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: |
| 229 |
|
| 230 |
`<table> |
| 231 |
<tr> |
| 232 |
<td>[maxbutton id="1"]</td> |
| 233 |
<td>[maxbutton id="2"]</td> |
| 234 |
<td>[maxbutton id="3"]</td> |
| 235 |
</tr> |
| 236 |
</table>` |
| 237 |
|
| 238 |
= How do I display a MaxButton in a WordPress menu? = |
| 239 |
|
| 240 |
By default WordPress can't display shortcodes in a menu. You can use this [plugin](https://wordpress.org/plugins/shortcode-in-menus/) to allow shortcodes in a menu. Just copy the MaxButton shortcode in the menu after installing |
| 241 |
|
| 242 |
= How do I display a MaxButton in a slider? = |
| 243 |
|
| 244 |
This depends on the slider plugin you are using. Most of the well-known ones are allowing the use of shortcodes within the slides. To find out if your plugin can handle that, please ask the slider vendor. |
| 245 |
|
| 246 |
= Non-Latin language users = |
| 247 |
|
| 248 |
The plugin works with users of non-lating languages with a few exceptions. First, the character set of the Database Table should be in UTF-8. If you see '????' characters in the plugin, go to Settings -> Advanced. There is a button to set the tabel to UTF-8 |
| 249 |
|
| 250 |
Secondly, please use latin only characters for button name ( Basic settings) and extra classes ( Advanced settings ). Not doing so might prevent the styling output from working correctly. |
| 251 |
|
| 252 |
== Changelog == |
| 253 |
|
| 254 |
= 7.1.1 / 7.1.2 = |
| 255 |
|
| 256 |
* Fixed issue when other sources call jQuery.noConfict() |
| 257 |
|
| 258 |
= 7.1 = |
| 259 |
|
| 260 |
* Vertical align now working |
| 261 |
* Fixed issue with selecting buttons via SiteOrigin Page Builder |
| 262 |
|
| 263 |
= 7.0 = |
| 264 |
|
| 265 |
* Removed old Social Share from base plugin. Use WordPress Share Buttons ( http://wordpress.org/plugins/share-button/ ) |
| 266 |
* Upgrade to Font Awesome 5 |
| 267 |
* Added vertical-align: middle as standard property |
| 268 |
* Streamlined plugin Ajax processes |
| 269 |
* Fixed - Issue with button updated warning when nothing was updated. |
| 270 |
* Fixed - Issue with shortcake integration |
| 271 |
|
| 272 |
= 6.28 = |
| 273 |
|
| 274 |
* Tested for 4.9.4 |
| 275 |
* Improved performance of editor javascript |
| 276 |
* Fixed issue with showing certain conditional fields |
| 277 |
* Fixed issue in maxmodal with double init |
| 278 |
|
| 279 |
= 6.27 = |
| 280 |
|
| 281 |
* Tested for 4.9.2 |
| 282 |
* Security - Added rel='noopener' for links opening in new window |
| 283 |
* Fixed missing values on a template |
| 284 |
|
| 285 |
= 6.26.1 = |
| 286 |
|
| 287 |
* Fixed - Advanced options |
| 288 |
|
| 289 |
= 6.26 = |
| 290 |
|
| 291 |
* Technical maintenance |
| 292 |
* Tested up to 4.9.1. |
| 293 |
* Fixed interface issue with conditional Javascript for sharing plugin |
| 294 |
|
| 295 |
= 6.25 = |
| 296 |
|
| 297 |
* New setting for extra URL Schemes |
| 298 |
* Small layout color picker fix |
| 299 |
* Renamed button title to tooltip for clarity |
| 300 |
* Rename empty font setting to 'site default' for clarity |
| 301 |
|
| 302 |
= 6.24 = |
| 303 |
|
| 304 |
* Social Share deprecated. For Social Sharing please check the new MaxButton Social Share addon |
| 305 |
* New allowed link URL schemes - ms-windows-store and steam. |
| 306 |
* Fixed Copy Color interface |
| 307 |
* Improvements how Modals handle scrolling |
| 308 |
* Change / Issue in MaxCSSParser which didn't allow to properly parse Pseudo CSS element which are a parent of the main anchor class. |
| 309 |
* Improvements in editor |
| 310 |
|
| 311 |
= 6.23 = |
| 312 |
|
| 313 |
* Fixed font-size in color picker styling |
| 314 |
* Adapted to changes on color picker layout ( WP 4.9 Alpha ) |
| 315 |
|
| 316 |
= 6.22 = |
| 317 |
|
| 318 |
* Fixed bug in External CSS function and is now working again |
| 319 |
* Enhanced visibility of 'show shortcode examples' option |
| 320 |
|
| 321 |
= 6.21 = |
| 322 |
|
| 323 |
* Feature - Add simple link title to buttons plus shortcode attribute linktitle |
| 324 |
* Updated Font Awesome override to work only where needed |
| 325 |
* Removed PHP 5.2 check for being not functional |
| 326 |
|
| 327 |
= 6.20.2 = |
| 328 |
|
| 329 |
* Fixed issue with window resizes in post / page editor |
| 330 |
* Fixed issue with Shortcake integration |
| 331 |
|
| 332 |
= 6.20.1 = |
| 333 |
|
| 334 |
* Fix - warnings when using Origins Sitebuilder |
| 335 |
|
| 336 |
= 6.20 = |
| 337 |
|
| 338 |
* Big technical update and clean up of code |
| 339 |
* Moved plugin to proper use of namespaces |
| 340 |
* File:// now allowed for URL's |
| 341 |
* Moved color class to mbcolor due to frequent issues with offending plugins. |
| 342 |
* Tested for WP 4.8 |
| 343 |
|
| 344 |
|
| 345 |
= 6.19.1 = |
| 346 |
|
| 347 |
* Button overview loading in editor screen (fixed) |
| 348 |
|
| 349 |
= 6.19 = |
| 350 |
|
| 351 |
* Fixed minor security issue regarding cross-site scripting (JVN#70411623). Thanks to JPCert for responsible disclosure. |
| 352 |
* Fixed fatal error in settings function 'reset cache' |
| 353 |
|
| 354 |
= 6.18 = |
| 355 |
|
| 356 |
* Fixed bug where scrollbar didn't show in Add Button dialog |
| 357 |
* Extra check for multi-byte string support |
| 358 |
|
| 359 |
= 6.17 = |
| 360 |
|
| 361 |
* Button load data hook added |
| 362 |
* Fixed - Add button dialog showing scrollbars without need in certain cases |
| 363 |
* Fixed - Minor notice in Social share when buttons are not in database |
| 364 |
|
| 365 |
= 6.16 = |
| 366 |
|
| 367 |
* New option for better accuracy of preview if site theme runs 'border-box' |
| 368 |
* Fixed Install class to check and create Social share transient table |
| 369 |
* Added check for SimpleXML module |
| 370 |
|
| 371 |
= 6.15 = |
| 372 |
|
| 373 |
* New setting to solve FontAwesome conflict |
| 374 |
* Updated settings page |
| 375 |
|
| 376 |
= 6.14 = |
| 377 |
|
| 378 |
* Fixed small layout issue in responsive section |
| 379 |
* Updated copy warning to be even more clear |
| 380 |
* Added shortcode options to FAQ |
| 381 |
|
| 382 |
= 6.13.1 = |
| 383 |
|
| 384 |
* Fixed error message on action buttons. |
| 385 |
|
| 386 |
= 6.13 = |
| 387 |
|
| 388 |
* Enter on text fields now moves to the next field |
| 389 |
* Fixed bug that could trigger action buttons in editor when using enter button |
| 390 |
|
| 391 |
= 6.12 = |
| 392 |
|
| 393 |
* Updated Copy / Trash / Delete interfaces |
| 394 |
* Fixed issue with refresh page warning when removing buttons |
| 395 |
* Fixed Social Share Facebook count |
| 396 |
* Fixed lower save button not working in social share |
| 397 |
* Fixed layout issue in Social Share |
| 398 |
|
| 399 |
|
| 400 |
== Upgrade Notice == |
| 401 |
|
| 402 |
= 4.0 = |
| 403 |
|
| 404 |
This major update includes new Social sharing features. If you run into issues please let us know via support. Experiences are also welcome! |
| 405 |
|
| 406 |
= 3.19 = |
| 407 |
|
| 408 |
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. |
| 409 |
|
| 410 |
= 3.0 = |
| 411 |
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, |
| 412 |
please try to deactivate and activate the plugin again |
| 413 |
|
| 414 |
= 1.24.2 = |
| 415 |
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. |
| 416 |
|
