{"id":54693,"date":"2017-02-27T22:45:05","date_gmt":"2017-02-27T22:45:05","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/soulbuttons\/"},"modified":"2017-08-05T22:15:02","modified_gmt":"2017-08-05T22:15:02","slug":"soulbuttons","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/soulbuttons\/","author":12146518,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.1.8","stable_tag":"trunk","tested":"4.8.28","requires":"4.6","requires_php":"","requires_plugins":"","header_name":"SoulButtons","header_author":"Dave Bloom","header_description":"","assets_banners_color":"2f221b","last_updated":"2017-08-05 22:15:02","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/gingersoulrecords.com\/","header_plugin_uri":"https:\/\/gingersoulrecords.com","header_author_uri":"https:\/\/gingersoulrecords.com","rating":0,"author_block_rating":0,"active_installs":10,"downloads":816,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"0.1.0":"

Initial version<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":{"icon-128x128.jpg":{"filename":"icon-128x128.jpg","revision":"1606536","resolution":"128x128","location":"assets"},"icon-256x256.jpg":{"filename":"icon-256x256.jpg","revision":"1606536","resolution":"256x256","location":"assets"}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":"1606536","resolution":"1544x500","location":"assets"},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":"1606538","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.0","0.1.1","0.1.2","0.1.3","0.1.4","0.1.5","0.1.6","0.1.7","0.1.8"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1624255","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1624255","resolution":"2","location":"assets"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"1624255","resolution":"3","location":"assets"}},"screenshots":{"1":"SoulButtons in action on Twenty Seventeen theme","2":"Shortcode builder","3":"Settings page"}},"plugin_section":[],"plugin_tags":[485,24365,1602,80],"plugin_category":[43],"plugin_contributors":[132573,84398],"plugin_business_model":[],"class_list":["post-54693","plugin","type-plugin","status-closed","hentry","plugin_tags-button","plugin_tags-button-shortcode","plugin_tags-call-to-action","plugin_tags-shortcode","plugin_category-customization","plugin_contributors-gingersoulrecords","plugin_contributors-ideag","plugin_committers-gingersoulrecords"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/soulbuttons_2f221b.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/soulbuttons\/assets\/screenshot-1.png?rev=1624255","caption":"SoulButtons in action on Twenty Seventeen theme"},{"src":"https:\/\/ps.w.org\/soulbuttons\/assets\/screenshot-2.png?rev=1624255","caption":"Shortcode builder"},{"src":"https:\/\/ps.w.org\/soulbuttons\/assets\/screenshot-3.png?rev=1624255","caption":"Settings page"}],"raw_content":"\n

SoulButtons was designed to give WordPress developers a simple, consistent, effective approach to using buttons (and other actionable links) in their layouts.<\/p>\n\n

SoulButtons was conceived by a designer who found it difficult to maintain the balance between priority (e.g. how to make more important buttons\/links stand out from others), consistency (limiting button styles and their behaviors so that site visitors understand how to find the right information\/conversion paths), and ease of use (so non-CSSers and non-UXers could join the party) with respect to custom-coding button styles and behaviors.<\/p>\n\n

SoulButtons also makes important (yet complex) button functions available just by assigning a shortcode attribute. Got Google Analytics installed? Add the track attribute and you'll see what buttons your users are clicking on more than others in your Analytics 'events' area. Need to show an element inside a dialog\/modal window when a button is clicked? Assign target and targetEvent attributes to a SoulButton and you're all set.<\/p>\n\n

For videos and examples, visit https:\/\/gingersoulrecords.com\/soulbuttons.<\/p>\n\n\n

    \n
  1. Upload the plugin files to the \/wp-content\/plugins\/soulbuttons<\/code> directory, or install the plugin through the WordPress plugins screen directly.<\/li>\n
  2. Activate the plugin through the 'Plugins' screen in WordPress<\/li>\n
  3. Use the Settings -> SoulButtons<\/code> screen to configure the plugin<\/li>\n
  4. Insert buttons into your posts\/pages via [soulbutton]<\/code> shortcode<\/li>\n<\/ol>\n\n\n
    \n
    Installation Instructions<\/dt>\n
      \n
    1. Upload the plugin files to the \/wp-content\/plugins\/soulbuttons<\/code> directory, or install the plugin through the WordPress plugins screen directly.<\/li>\n
    2. Activate the plugin through the 'Plugins' screen in WordPress<\/li>\n
    3. Use the Settings -> SoulButtons<\/code> screen to configure the plugin<\/li>\n
    4. Insert buttons into your posts\/pages via [soulbutton]<\/code> shortcode<\/li>\n<\/ol><\/dd>\n
      How do I create a button?<\/dt>\n

      Use [soulbutton]<\/code> shortcode or a button in WP Editor to generate it.<\/p><\/dd>\n

      How do I use the shortcode?<\/dt>\n

      The same way you use other WordPress shortcodes. Just wrap your button text with [soulbutton]<\/code> and [\/soulbutton]<\/code> tags. You can use several different attributes to customize appearance and functionality of the button. See them in the next question.\nSample usage: [soulbutton link=\"http:\/\/google.com\"]Go to Google[\/soulbutton]<\/code><\/p><\/dd>\n

      What attributes does `[soulbutton]` shortcode have?<\/dt>\n

      Here is the list of available attributes:<\/p>\n\n

        \n
      • style<\/code> - allows to choose button appearance. Available styles currently include solid<\/code> (default), rounded<\/code>, border<\/code> and transparent<\/code>.<\/li>\n
      • link<\/code> - where button link should point to. Defaults to #<\/code>.<\/li>\n
      • href<\/code> - an alias of link<\/code>.<\/li>\n
      • css<\/code> - custom inline CSS styles.<\/li>\n
      • class<\/code> - to add a custom class to the button.<\/li>\n
      • id<\/code> - to add a custom id attribute to the button.<\/li>\n
      • color<\/code> - the color of the button (to override global setting).<\/li>\n
      • text<\/code> - the color of the text in the button (to override global setting).<\/li>\n
      • border<\/code> - the color of the border of the button (to override global setting).<\/li>\n
      • track<\/code> - should button click be recorded on Google Analytics. true<\/code>\/false<\/code> to override global setting, custom string to set custom button name.<\/li>\n
      • icon<\/code> - allows to insert a Dashicons \/ Font Awesome icon to be inserted into the button. Define using full name of the icon, i.e. dahsicons-arrow-left<\/code> or fa-shopping-cart<\/code>.<\/li>\n
      • icon-position<\/code> - set the icon position within the button. before<\/code> (default) - icon is inserted before button content. after<\/code> - icon is inserted after button content.<\/li>\n
      • hover<\/code> - defines additional hover effects. Space-separated list. Available effects include icon-left<\/code>, icon-right<\/code>, icon-top<\/code>, icon-bottom<\/code>.<\/li>\n
      • align<\/code> - changes text alignment in the button. Available options - center<\/code> (default), left<\/code>, right<\/code>.<\/li>\n
      • padding<\/code> - changes button padding.<\/li>\n
      • border-width<\/code> - changes button border-width.<\/li>\n
      • width<\/code> - changes button minimal width.<\/li>\n
      • scrollto<\/code> - adds a visual \"Scroll To\" effect for anchor links (true\/false).<\/li>\n
      • scrollto-speed<\/code> - set scrollto effect speed (default 0.5).<\/li>\n
      • scrollto-offset<\/code> - add a vertical offset for scrollto effect (default 0).<\/li>\n
      • offcanvas-target<\/code> - define an element (via CSS selector) to take out of DOM and animate as off-canvas item.<\/li>\n
      • offcanvas-effect<\/code> - define which effect should be used the off-canvas target. Available effect include fadeInFromCenter<\/code>, slideOverFromRight<\/code> (default), pushOverFromRight<\/code><\/li>\n
      • offcanvas-open<\/code> - determine if offcanvas element should initially be in open or closed state (default - false).<\/li>\n
      • prevent-default<\/code> - allows to disable default action of the link (i.e. appending hash values to url) (default -false).<\/li>\n<\/ul><\/dd>\n\n<\/dl>\n\n\n

        0.1.6<\/h4>\n\n
          \n
        • add prevent-default<\/code> attribute (#27);<\/li>\n
        • add offcanvas-open<\/code> attribute (#29) to allow initializing off-canvas element in open state;<\/li>\n
        • rename target<\/code>\/target-effect<\/code> attributes to offcanvas-target<\/code>\/offcanvas-effect<\/code> (#31);<\/li>\n
        • fix css<\/code> attribute values not being applied correctly (#32);<\/li>\n
        • restructe the shortcode generation modal, separating options into Content and Behaviour tabs (#34);<\/li>\n
        • resizing Dashicons to 80% by default; <\/li>\n<\/ul>\n\n

          0.1.5<\/h4>\n\n
            \n
          • moved screenshots to assets<\/li>\n
          • added target<\/code>\/target-effect<\/code> attributes<\/li>\n
          • added a Settings link in plugins list<\/li>\n
          • added shortcode builder tag to Beaver Builder WP Editor fields<\/li>\n<\/ul>\n\n

            0.1.4<\/h4>\n\n
              \n
            • added a scrollto-speed<\/code> attribute<\/li>\n
            • fix missing bracket in JS<\/li>\n
            • cleanup code, add docblock comments<\/li>\n<\/ul>\n\n

              0.1.3<\/h4>\n\n
                \n
              • added a scrollto-offset<\/code> attribute<\/li>\n<\/ul>\n\n

                0.1.2<\/h4>\n\n
                  \n
                • added a scrollto<\/code> attribute<\/li>\n<\/ul>\n\n

                  0.1.1<\/h4>\n\n
                    \n
                  • updated plugin description<\/li>\n
                  • fixed colorpicker bug in settings<\/li>\n
                  • added font-size:inherit<\/code> for Dashicons<\/li>\n
                  • added target\/target-effect attributes to the shortcode<\/li>\n<\/ul>\n\n

                    0.1.0<\/h4>\n\n
                      \n
                    • first version to be submitted to wordpress.org<\/li>\n<\/ul>","raw_excerpt":"License: GPLv2 or later\nLicense URI: https:\/\/www.gnu.org\/licenses\/gpl-2.0.html\n\nShortcodes for simple, minimal buttons. Includes options for hover ani …","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/54693","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=54693"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/gingersoulrecords"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=54693"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=54693"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=54693"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=54693"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=54693"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=54693"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}