PluginProbe
MaxButtons – Create buttons / 7.13
MaxButtons – Create buttons v7.13
6.23 6.24 6.25 6.26 6.26.1 6.27 6.28 6.3 6.4 6.5 6.6 6.7 6.8 6.9 7.0 7.1 7.1.1 7.1.2 7.1.3 7.10 7.11 7.13 7.13.1 7.13.2 7.13.3 All 100 releases
maxbuttons / readme.txt

readme.txt in MaxButtons – Create buttons 7.13, at readme.txt

544 lines 23.0 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
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: 5.2.3
6 Requires PHP: 5.6
7 Stable tag: 7.13
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 700 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.6
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 Most often used 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. You can use the 'add button' dialog from your posts and pages to easily use this options
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 = I use Autoptimize with MaxButtons =
247
248 If you use Autoptimize plugin and see weird result, try to load the pageby adding ?ao_noptimize=1 to the URL. If the buttons load normally then the issue is with Autoptimize. You can enter an exclusion for .maxbutton in the CSS exclusions.
249
250 = Non-Latin language users =
251
252 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
253
254 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.
255
256 == Changelog ==
257
258 = 7.13 =
259
260 * Updates to code base
261 * Fixed - Small bug in Gutenberg regarding text fields
262 * Fixed - Zero-width space (Unicode Character) could disturb URL output.
263
264 = 7.12 =
265
266 * Fixed - Certain external admin notices overlapping on overview page
267 * Fixed - Notice button_id when during copy / restore on the overview page
268
269 = 7.11 =
270
271 * New - Support for transparency.
272 * New - On button save tries to flush cache for popular caching engines: WordPress, wp-super-cache, WP Engine, Total W3TC, WPFastestCache
273 * New - When using TablePress, buttons automatically load style inside the table due to caching.
274 * New - Option to remove all buttons in trash
275 * Fix - Action in button overview now keep paging in tact.
276 * Fix - PHP notice when dismissing review question.
277
278 = 7.10 =
279
280 * New - Button overview lists last date when button was updated
281 * Fix - Updated pagination in button picker popup
282 * Fix - Updated styling and exceptions on button paging ( overview )
283 * Update - Gutenberg block now can set CSS to inline
284 * Update - PHP minimum version now 5.6, matching WordPress.
285 * Fix - Help text mistake in Gutenberg
286 * New - Better support for RTL lanuages ( hopefully )
287
288 = 7.9 =
289
290 * Fix - Setting on 'border-box' now also being applied in the admin button list.
291 * Fix - Color picker sometimes jumping to top of page
292 * New - All shortcode options available in Gutenberg
293 * Tweak - Help texts and added clarification
294 * Tweak - Styling of help text
295 * Tweak - Updates to the preview scripting
296 * Tweak - Button dialog styling improvements
297 * Fix - Pseudo-elements in main button class now in correct order
298
299 = 7.8 =
300
301 * Fix - Crashes on PHP 7.3 due to simple HTML DOM library
302 * Tweak - If no Box Shadow is defined, it's not set on the MaxButton.
303 * Fix - Box shadow with only spread now works and properly removes values from stylesheet
304 * Fix - Box shadow blur minimum is now zero
305 * Fix - Gradient stop field hidden when gradient option is off
306
307 = 7.7 =
308
309 * Tweak - Warning when button name is duplicate
310 * Tweak - Removed unused action hooks in field
311 * Tweak - Small speed improvement in Javascript
312
313 = 7.6 =
314
315 * Fix - Saving buttons in Gutenberg block
316 * Fix - Extra classes could conflict with styling in certain situations
317 * Fix - Removed requirements for any user roles in adding buttons to content
318 * Fix - Icon in Gutenberg classic block
319 * Fix - Activation check could trigger notices when missing database table fields
320 * Fix - Bug when using Siteorigins in Widgets area
321 * Removed - Shortcake Font Awesome reference
322
323 = 7.5.2 =
324
325 * Fix - Further fixes for TinyMCE while being loaded out of WP-editor context.
326 * Fix - Hide 'add button' setting now also doesn't show Tinymce button
327
328 = 7.5.1 =
329
330 * Fix - Error when loading tinymce button resulted in crash for some users (PHP 5.3)
331
332 = 7.5 =
333
334 * New - Support for Gutenberg
335 * New - Button icon in TinyMCE interface
336 * Fixed - False positive compatibility notice for PHP 7.x
337 * Tweak - Prevents certain events from loading twice (performance)
338
339 = 7.4.1 =
340
341 * Fixed notice in 7.2 when button not found in Database
342 * Updated buy PRO page
343
344 = 7.4 =
345
346 * Fixed grammar
347 * Removed unused code
348
349 = 7.3.1 =
350
351 * Fix - Issue with Link Picker styling / picker not always working properly
352
353 = 7.3 =
354
355 * Link picker - Easier way of selecting links to your content
356 * Updated parser SCSSPHP to version 0.7.5
357 * Fixed - Issue with modals, causing issues on certain themes / plugins
358 * Cleanup unused scripting
359 * Fixed issue with unicode button name crashing style output
360 * Fixed issue with custom shortcode handlers
361 * Removed references to any Font Awesome scripts
362
363 = 7.2 =
364
365 * 'Add button'-Dialog improvements, plus all shortcode attributes now available in interface
366 * New shortcode attribute 'extraclass' to add extra classes
367 * Fixed issue where media script and modal script would interfere with each other
368 * Added No optimize string for Autoptimize users
369 * Updates to support page
370 * Improvements to shortcode visibility
371 * Fixed Javascript bug that could cause issues with other not-isolated plugins
372 * Tested on WordPress 4.9.6.
373
374 = 7.1.3. =
375
376 * Fixed legacy issue with social share that could crash plugin in certain cases
377
378 = 7.1.1 / 7.1.2 =
379
380 * Fixed issue when other sources call jQuery.noConfict()
381
382 = 7.1 =
383
384 * Vertical align now working
385 * Fixed issue with selecting buttons via SiteOrigin Page Builder
386
387 = 7.0 =
388
389 * Removed old Social Share from base plugin. Use WordPress Share Buttons ( http://wordpress.org/plugins/share-button/ )
390 * Upgrade to Font Awesome 5
391 * Added vertical-align: middle as standard property
392 * Streamlined plugin Ajax processes
393 * Fixed - Issue with button updated warning when nothing was updated.
394 * Fixed - Issue with shortcake integration
395
396 = 6.28 =
397
398 * Tested for 4.9.4
399 * Improved performance of editor javascript
400 * Fixed issue with showing certain conditional fields
401 * Fixed issue in maxmodal with double init
402
403 = 6.27 =
404
405 * Tested for 4.9.2
406 * Security - Added rel='noopener' for links opening in new window
407 * Fixed missing values on a template
408
409 = 6.26.1 =
410
411 * Fixed - Advanced options
412
413 = 6.26 =
414
415 * Technical maintenance
416 * Tested up to 4.9.1.
417 * Fixed interface issue with conditional Javascript for sharing plugin
418
419 = 6.25 =
420
421 * New setting for extra URL Schemes
422 * Small layout color picker fix
423 * Renamed button title to tooltip for clarity
424 * Rename empty font setting to 'site default' for clarity
425
426 = 6.24 =
427
428 * Social Share deprecated. For Social Sharing please check the new MaxButton Social Share addon
429 * New allowed link URL schemes - ms-windows-store and steam.
430 * Fixed Copy Color interface
431 * Improvements how Modals handle scrolling
432 * Change / Issue in MaxCSSParser which didn't allow to properly parse Pseudo CSS element which are a parent of the main anchor class.
433 * Improvements in editor
434
435 = 6.23 =
436
437 * Fixed font-size in color picker styling
438 * Adapted to changes on color picker layout ( WP 4.9 Alpha )
439
440 = 6.22 =
441
442 * Fixed bug in External CSS function and is now working again
443 * Enhanced visibility of 'show shortcode examples' option
444
445 = 6.21 =
446
447 * Feature - Add simple link title to buttons plus shortcode attribute linktitle
448 * Updated Font Awesome override to work only where needed
449 * Removed PHP 5.2 check for being not functional
450
451 = 6.20.2 =
452
453 * Fixed issue with window resizes in post / page editor
454 * Fixed issue with Shortcake integration
455
456 = 6.20.1 =
457
458 * Fix - warnings when using Origins Sitebuilder
459
460 = 6.20 =
461
462 * Big technical update and clean up of code
463 * Moved plugin to proper use of namespaces
464 * File:// now allowed for URL's
465 * Moved color class to mbcolor due to frequent issues with offending plugins.
466 * Tested for WP 4.8
467
468
469 = 6.19.1 =
470
471 * Button overview loading in editor screen (fixed)
472
473 = 6.19 =
474
475 * Fixed minor security issue regarding cross-site scripting (JVN#70411623). Thanks to JPCert for responsible disclosure.
476 * Fixed fatal error in settings function 'reset cache'
477
478 = 6.18 =
479
480 * Fixed bug where scrollbar didn't show in Add Button dialog
481 * Extra check for multi-byte string support
482
483 = 6.17 =
484
485 * Button load data hook added
486 * Fixed - Add button dialog showing scrollbars without need in certain cases
487 * Fixed - Minor notice in Social share when buttons are not in database
488
489 = 6.16 =
490
491 * New option for better accuracy of preview if site theme runs 'border-box'
492 * Fixed Install class to check and create Social share transient table
493 * Added check for SimpleXML module
494
495 = 6.15 =
496
497 * New setting to solve FontAwesome conflict
498 * Updated settings page
499
500 = 6.14 =
501
502 * Fixed small layout issue in responsive section
503 * Updated copy warning to be even more clear
504 * Added shortcode options to FAQ
505
506 = 6.13.1 =
507
508 * Fixed error message on action buttons.
509
510 = 6.13 =
511
512 * Enter on text fields now moves to the next field
513 * Fixed bug that could trigger action buttons in editor when using enter button
514
515 = 6.12 =
516
517 * Updated Copy / Trash / Delete interfaces
518 * Fixed issue with refresh page warning when removing buttons
519 * Fixed Social Share Facebook count
520 * Fixed lower save button not working in social share
521 * Fixed layout issue in Social Share
522
523
524 == Upgrade Notice ==
525
526 = 7. 0 =
527
528 Social Share has been split of into it's own plugin. Check your site if you are using this feature.
529
530 = 4.0 =
531
532 This major update includes new Social sharing features. If you run into issues please let us know via support. Experiences are also welcome!
533
534 = 3.19 =
535
536 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.
537
538 = 3.0 =
539 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,
540 please try to deactivate and activate the plugin again
541
542 = 1.24.2 =
543 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.
544