PluginProbe
MaxButtons – Create buttons / 6.23
MaxButtons – Create buttons v6.23
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 6.23, at readme.txt

533 lines 21.1 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 buttons, wordpress button plugin, social icons, css3 button generator, responsive buttons, css wordpress button
4 Requires at least: 4.0
5 Tested up to: 4.8.2
6 Requires PHP: 5.3
7 Stable tag: 6.23
8
9 WordPress button plugin so powerful and easy to use anyone can create beautiful buttons and social share icons.
10
11 == Description ==
12 [MaxButtons](https://maxbuttons.com/?utm_source=repowp1&utm_medium=mbrepo&utm_content=mbr_maxbuttons&utm_campaign=mbr_maxbuttons) is one of the most used WordPress button, social share and social icon plugins. Use it to create great-looking CSS3 WordPress buttons on any post or page on your site. Our 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.
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 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 500 5 star reviews and over 1.2 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 > “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
21
22 Max Foundry also makes the WordPress Gallery plugin [MaxGalleria](https://wordpress.org/plugins/maxgalleria/) and [WordPress Media Folders](https://wordpress.org/plugins/media-library-folders-pro/) plugin for real WordPress Media Library folders.
23
24 = Requirements =
25
26 * Wordpress installed
27 * PHP 5.3
28
29 = WordPress Buttons =
30
31 * [Create WordPress Buttons](https://www.maxbuttons.com/#CSS3/?utm_source=repocreate&utm_medium=mbrepo&utm_content=how-to-create&utm_campaign=repocreate)
32 * Getting [Social Icons](https://maxbuttons.com/?utm_source=repoicons1&utm_medium=mbrepo&utm_content=social_sharing&utm_campaign=repoicons1) on your WordPress site.
33 * [Social Share](https://maxbuttons.com/?utm_source=reposhare&utm_medium=mbrepo&utm_content=social_sharing&utm_campaign=reposhare) on your WordPress site.
34 * What is a [CSS3 Button Generator](https://maxbuttons.com/?utm_source=repocss3&utm_medium=mbrepo&utm_content=what-is-generator&utm_campaign=repocss3)?
35 * [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.
36
37 = MaxButtons =
38
39 * No coding, the plugin takes care of everything
40 * Includes 5 beautiful, configurable Social Share sets
41 * Button shortcodes for ease of use
42 * Create unlimited number of buttons
43 * Live preview window instantly updated as you customize your buttons
44 * Color picker for unlimited color combinations
45 * Works with all modern browsers, degrades gracefully for others
46 * Fully CSS3 compliant with text shadowing, box shadowing, gradients, etc.
47 * Copy an existing button to use as starting point for others
48 * See your buttons on different color backgrounds
49 * Predefined defaults make getting started super easy
50 * SiteOrigin Page Builder integration through the SiteOrigin Widget Bundle
51 * Supports Shortcake plugin to see your buttons in your editor!
52
53
54 = Social Share =
55
56 MaxButtons 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:
57
58 * Facebook
59 * Twitter
60 * Pinterest
61 * Linkedin
62 * Google+
63 * Pinterest
64 * VKontakte
65 * StumbleUpon
66 * Reddit
67 * Digg
68 * Bloglovin
69
70 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.
71
72 = Social Icons =
73
74 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!
75
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, 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!
82
83 * **Icon Support** - Add icons 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. 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 * **Button Search** - for easier management of large button sets.
90 * **Font Awesome** - easiest WordPress integration
91 * **Visual Composer** - Integrated with Visual Composer
92 * **Contact Form 7** Integration
93 * **Beaver Builder** Integration
94 * **Easy Digital Downloads** Purchase and Checkout Button Integration
95
96 MaxButtons Pro includes 17 beautifully designed social share sets plus you can use the advanced functions to design and configure social buttons and icons.
97
98 = WordPress Button Sets =
99
100 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 5,000 buttons. It is the largest WordPress button library in the known universe.
101
102 [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.
103
104 = Free Icons =
105
106 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.
107
108 = Button Shortcode =
109
110 1. Click the MaxButtons page from the admin menu.
111 1. Click the Add New button.
112 1. Create and customize your button using the button editor.
113 1. Fill out and select the options needed to build your button.
114 1. Once you're ready, click Save.
115 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"]).
116 1. Use the shortcode anywhere in your content and the button will appear.
117
118 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:
119
120 [maxbutton id="17" text="Search Google" url="http://google.com"]
121
122 [maxbutton name="MaxButtons Button Name" text="Search Yahoo" url="http://yahoo.com"]
123
124 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.
125
126 [maxbutton id="17" window="new"]
127
128 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):
129
130 [maxbutton id="17" nofollow="true"]
131
132 NOTE: Passing parameters to the shortcode overrides those settings saved as part of the button.
133
134 = Support =
135
136 We work hard to give timely support during the week. And we give support when we're on during the weekend.
137
138 **MaxButtons. Bringing the #buttonlove!**
139
140
141 == Installation ==
142
143 For automatic installation:
144
145 1. Login to your website and go to the Plugins section of your admin panel.
146 1. Click the Add New button.
147 1. Under Install Plugins, click the Upload link.
148 1. Select the plugin zip file from your computer then click the Install Now button.
149 1. You should see a message stating that the plugin was installed successfully.
150 1. Click the Activate Plugin link.
151
152 For manual installation:
153
154 1. You should have access to the server where WordPress is installed. If you don't, see your system administrator.
155 1. Copy the plugin zip file up to your server and unzip it somewhere on the file system.
156 1. Copy the "maxbuttons" folder into the /wp-content/plugins directory of your WordPress installation.
157 1. Login to your website and go to the Plugins section of your admin panel.
158 1. Look for "MaxButtons" and click Activate.
159
160 == Screenshots ==
161
162 1. Button overview - Everything in one view
163 2. Button editor - Your own look and feel
164 3. Amazing color options
165 4. Social sharing - Unleash the power of the social networks
166 5. Simple but powerful options
167 6. Clear and fast output.
168
169
170 == Frequently Asked Questions ==
171
172 = Do I have to copy a button if I want to have a different text or link? =
173
174 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.
175
176 To change text and link :
177 [maxbutton id="1" text="yourtext" url="http://yoururl"]
178
179 If you only want to change one of the two, just leave the not needed option out.
180
181 All possible options:
182
183 [maxbutton id="1" text="yourtext" url="http://yoururl" window="new" nofollow="true"]
184
185 You should *never* copy buttons if you only have a different line of text and / or link on any button.
186
187 = How do I use the shortcode in a sidebar/widget? =
188
189 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.
190
191 = How can I add the shortcode to my post/page template? =
192
193 Simply add this code snippet to any of your theme template files:
194 `<?php echo do_shortcode('[maxbutton id="17"]'); ?>`
195
196 = Can't see styling on the frontpage =
197
198 Sometimes the button styling doesn't load on the frontpage. There are usually two major reasons:
199
200 * Theme doesn't have proper footer, check if wp_footer() is called in the theme
201 * Using MaxButtons with sliders, dynamic page loaders (such a parallax and one-page themes ) or caching mechanisms.
202 other
203 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 ).
204
205
206 = TablePress and MaxButtons =
207
208 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).
209
210 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.
211
212 = Part of my button is cutoff, how do I fix that? =
213
214 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:
215
216 `<div style="margin: 10px 10px 10px 10px;">
217 <?php echo do_shortcode('[maxbutton id="17"]'); ?>
218 <?php echo do_shortcode('[maxbutton name="MaxButtons Button Name"]'); ?>
219 </div>`
220
221 Then adjust the margin values as needed (the order is: top, right, bottom, left).
222
223 = How do I center the button on a page? =
224
225 Enable the "Wrap with Center Div" option in the Container settings.
226
227 = How do I align multiple buttons next to each other? =
228
229 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:
230
231 `<table>
232 <tr>
233 <td>[maxbutton id="1"]</td>
234 <td>[maxbutton id="2"]</td>
235 <td>[maxbutton id="3"]</td>
236 </tr>
237 </table>`
238
239 = How do I display a MaxButton in a WordPress menu? =
240
241 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
242
243 = How do I display a MaxButton in a slider? =
244
245 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.
246
247 == Changelog ==
248
249 = 6.23 =
250
251 * Fixed font-size in color picker styling
252 * Adapted to changes on color picker layout ( WP 4.9 Alpha )
253
254 = 6.22 =
255
256 * Fixed bug in External CSS function and is now working again
257 * Enhanced visibility of 'show shortcode examples' option
258
259 = 6.21 =
260
261 * Feature - Add simple link title to buttons plus shortcode attribute linktitle
262 * Updated Font Awesome override to work only where needed
263 * Removed PHP 5.2 check for being not functional
264
265 = 6.20.2 =
266
267 * Fixed issue with window resizes in post / page editor
268 * Fixed issue with Shortcake integration
269
270 = 6.20.1 =
271
272 * Fix - warnings when using Origins Sitebuilder
273
274 = 6.20 =
275
276 * Big technical update and clean up of code
277 * Moved plugin to proper use of namespaces
278 * File:// now allowed for URL's
279 * Moved color class to mbcolor due to frequent issues with offending plugins.
280 * Tested for WP 4.8
281
282
283 = 6.19.1 =
284
285 * Button overview loading in editor screen (fixed)
286
287 = 6.19 =
288
289 * Fixed minor security issue regarding cross-site scripting (JVN#70411623). Thanks to JPCert for responsible disclosure.
290 * Fixed fatal error in settings function 'reset cache'
291
292 = 6.18 =
293
294 * Fixed bug where scrollbar didn't show in Add Button dialog
295 * Extra check for multi-byte string support
296
297 = 6.17 =
298
299 * Button load data hook added
300 * Fixed - Add button dialog showing scrollbars without need in certain cases
301 * Fixed - Minor notice in Social share when buttons are not in database
302
303 = 6.16 =
304
305 * New option for better accuracy of preview if site theme runs 'border-box'
306 * Fixed Install class to check and create Social share transient table
307 * Added check for SimpleXML module
308
309 = 6.15 =
310
311 * New setting to solve FontAwesome conflict
312 * Updated settings page
313
314 = 6.14 =
315
316 * Fixed small layout issue in responsive section
317 * Updated copy warning to be even more clear
318 * Added shortcode options to FAQ
319
320 = 6.13.1 =
321
322 * Fixed error message on action buttons.
323
324 = 6.13 =
325
326 * Enter on text fields now moves to the next field
327 * Fixed bug that could trigger action buttons in editor when using enter button
328
329 = 6.12 =
330
331 * Updated Copy / Trash / Delete interfaces
332 * Fixed issue with refresh page warning when removing buttons
333 * Fixed Social Share Facebook count
334 * Fixed lower save button not working in social share
335 * Fixed layout issue in Social Share
336
337 = 6.11.1 =
338
339 * Removed holiday sale
340
341 = 6.11 =
342
343 * Shortcode options in add button dialog
344 * Fixed crash when running PHP 7.1.0
345
346 = 6.10 =
347
348 * Fixed color issue with preview color running one click behind
349 * Fixed issue with hover gradients, when gradients are off
350 * Fixed text shadow issue in CSS output
351
352 = 6.9 =
353
354 * Tested for WP 4.7
355 * Improved copy colors
356
357 = 6.8 =
358
359 * Fixed several smaller bugs in responsive
360 * Fixed smaller layout issues ( consistency )
361 * Upgraded SCSSPHP parser to 0.40
362 * Fixed 'undefined variable' in responsive
363
364 = 6.7 =
365
366 * Button height in responsive settings
367 * Fixed responsive bug regarding hiding option
368 * Responsive settings updated
369 * Add Button Dialog updated (more clear)
370 * Colorpicker slightly bigger
371
372 = 6.6 =
373
374 * Improved tab index on button editor.
375 * Fixed Copy Color button position in Chrome
376 * Fixed minor CSS issues
377
378 = 6.5 =
379
380 * Gradient background color option can be switched on and off
381 * New material switches to replace the checkboxes
382
383 = 6.4 =
384
385 * Copy colors feature added
386 * Fixed several small issues with the color picker
387
388 = 6.3 =
389
390 * Updated Features page
391
392
393 = 6.2 =
394
395 * Improved visibility of the color picker
396 * Fixed possible rendering issue with Box Shadow
397 * Fixed: in rare case the button could overlay the action buttons in the overview
398
399 = 6.1 =
400
401 * Several updates to the Color Picker
402 * Box Shadow spread option added
403 * Fixed conflict with important and box shadow setting
404
405 = 6.0 =
406
407 * Version 6 milestone
408 * Fixed small styling issue in header
409 * Updated link in plugin
410
411 = 5.13 =
412
413 * Fixed several notices when creating new buttons
414 * Buttons will now always have 'pointer' cursor
415
416 = 5.12 =
417
418 * Replaced color picker with WordPress default color picker
419 * Border radius can be locked to change all sides at onces.
420 * Cleanup of JS functions.
421
422 = 5.11 =
423
424 * Improvements to layout for small and mobile views
425 * Optimizations to modal on resizing
426 * Social icons for Eyeem added
427
428 = 5.10 =
429
430 * Fixed issue with background when using gradients
431 * Collection name is shown in button overview when button is in collection
432 * Database checks and failovers improved
433 * Several small updates to styling and layout
434 * Fixed display issue showing pack name / description when empty
435
436 = 5.9 =
437
438 * Greatly improved modal layouts
439 * Fixed - Social Share : non-existing buttons will not show.
440 * Child-spans now inherit background settings from parent anchor
441
442 = 5.8 =
443
444 * Fixed - Social Share remove button visible again
445 * Fixed - Social Share button without attached network no longer open as popup by default.
446 * Fixed - Custom Media Queries disabled after saving
447 * Description field can now be hidden via settings
448 * Various layout optimizations
449 * Tested for version 4.6
450
451 = 5.7 =
452
453 * Fixed omission in button clear function causing not to clear fully
454 * Fixed typo in Social Share shortcode
455 * Fixed social share bug, not correctly removing counts in certain situations
456 * Fixed social share icons not having cursor pointer
457 * Fixed Text Shadow bug with buttons having only shadow top set.
458 * Inline loading of social share collections
459
460 = 5.6 =
461
462 * Updated Social Share welcome message
463 * Updated Readme text
464 * Tested for WP 4.5.3
465
466 = 5.5 =
467
468 * Fixed CSS in review notice
469 * Fixed title issue with support topic titles
470 * Fixed small outlining issues in button editor
471
472 = 5.4 =
473
474 * Colorpicker code enhanced
475 * Updated container options interface
476
477 = 5.3 =
478
479 * Increased performance for shortcode when having an URL in shortcode.
480 * Fixed bug Border Shadow not showing when blur is zero.
481 * Fixed bug Text Shadow not showing when blur is zero.
482 * Fixed issue Text not displaying in preview when button was saved without text
483 * Minified all Javascript in plugin for faster performance.
484
485
486 = 5.2 =
487
488 * Fixed version check to enhance database upgrades
489 * Fixed Add buttons dialog in Beaver Builder
490 * Extra check for social sharing not to load on WP login pages
491
492 = 5.1 =
493
494 * Better pagination and display on Add Button dialog
495 * Fixed certain Social Share default values .
496 * Made number fields slightly larger
497 * Tested up to 4.5.2
498
499 = 5.0 =
500
501 * New button editor interface
502 * Removed maximum length of text fields
503 * Performance: Javascript loading streamlined
504 * Fixed: Removal of social sharing collections
505 * Improved social share picker
506 * Fixed Window resize bug in popups
507 * Fixed Array Bug in Social block
508
509
510 == Upgrade Notice ==
511
512 = 3.19 =
513
514 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.
515
516 = 4.0 =
517
518 This major update includes new Social sharing features. If you run into issues please let us know via support. Experiences are also welcome!
519
520 = 3.0 =
521 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,
522 please try to deactivate and activate the plugin again
523
524 = 1.24.2 =
525 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.
526
527
528
529
530
531
532
533