Below, you’ll find a detailed guide on how to add the Custom Add to Cart Button Label and Link Shortcode to your WordPress website, including its parameters, examples, and PHP function code. Additionally, we’ll assist you with common issues that might cause the Custom Add to Cart Button Label and Link Plugin shortcode not to show or not to work correctly.
Before starting, here is an overview of the Custom Add to Cart Button Label and Link Plugin and the shortcodes it provides:
"Custom Add to Cart Button Label and Link is a unique WordPress plugin that enables you to personalize and redefine your WooCommerce cart button labels and links for an enhanced shopping experience."
- [catcbll]
Custom Add to Cart Button Label and Link [catcbll] Shortcode
The Woo-Custom-Cart-Button (WCATCBLL) shortcode is designed to enhance the customization of the ‘Add to Cart’ button on your WooCommerce site. This shortcode allows you to specify product IDs (pid), and it can handle multiple products. It provides button styling options, including background, font size, font color, border color and size, icon position, and image. The WCATCBLL shortcode also controls button display settings, such as the ability to open the link in a new tab. It even provides options for button margin adjustments. In addition, it has a built-in style section for further customization. If no product ID is passed, it defaults to showing the latest product. Please note, this shortcode requires the Woo-Custom-Cart-Button plugin to function.
Shortcode: [catcbll]
Parameters
Here is a list of all possible catcbll shortcode parameters and attributes:
pid– Specifies the product ID for the button to be associated with.background– Sets the background color of the button.font_size– Defines the size of the font used in the button.font_color– Determines the color of the font used in the button.font_awesome– Allows for the use of Font Awesome icons in the button.border_color– Sets the color of the button’s border.border_size– Determines the size of the button’s border.icon_position– Specifies the position of the icon within the button.image– Enables or disables the display of the product image.
Examples and Usage
Basic example – A simple usage of the shortcode to display a product button by referencing the product ID.
[catcbll pid=101 /]Advanced examples
Using the shortcode to display a product button with custom background and font color. The button will have a red background and white font color.
[catcbll pid=101 background="red" font_color="white" /]Using the shortcode to display a product button with custom font size and border color. The button will have a font size of 14px and a blue border.
[catcbll pid=101 font_size=14 border_color="blue" /]Using the shortcode to display a product button with a custom icon. The button will display a Font Awesome ‘shopping-cart’ icon.
[catcbll pid=101 font_awesome="fa-shopping-cart" /]Using the shortcode to display multiple product buttons by referencing multiple product IDs. The buttons will display for each product ID specified.
[catcbll pid="101,102,103" /]PHP Function Code
In case you have difficulties debugging what causing issues with [catcbll] shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode('catcbll', 'wcatcbll_shortcode');Shortcode PHP function:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 | function wcatcbll_shortcode($atts = array()) { $astra_active_or_not = get_option('template'); // latest product showing when no product id pass if (!empty($atts["pid"]) && isset($atts["pid"])) { $pid = $atts['pid']; // get parameter value in the shortcode $pids = explode(",", $pid); $pid_count = count($pids); } else { $pid_count = 0; } /* ** Button styling using shortcode perameters ** @General setting values isset($ccbtn_setting) */ $catcbll_settings = get_option('_woo_catcbll_all_settings'); extract($catcbll_settings); $shortcode_attr = array('background', 'font_size', 'font_color', 'font_awesome', 'border_color', 'border_size', 'icon_position', 'image'); $option_key_vals = array(); foreach ($shortcode_attr as $key) { if (isset($atts[$key])) { $option_key_vals[$key] = $atts[$key]; if (empty($option_key_vals[$key])) { switch ($key) { case 'background': $option_key_vals[$key] = $catcbll_btn_bg; break; case 'font_size': $option_key_vals[$key] = $catcbll_btn_fsize; break; case 'font_color': $option_key_vals[$key] = $catcbll_btn_fclr; break; case 'font_awesome': $option_key_vals[$key] = $catcbll_btn_icon_cls; break; case 'border_color': $option_key_vals[$key] = $catcbll_btn_border_clr; break; case 'border_size': $option_key_vals[$key] = $catcbll_border_size; break; case 'icon_position': $option_key_vals[$key] = $catcbll_btn_icon_psn; break; default: $option_key_vals[$key] = ''; } } } else { $background = $catcbll_btn_bg; $font_size = $catcbll_btn_fsize; $font_color = $catcbll_btn_fclr; $font_awesome = $catcbll_btn_icon_cls; $border_color = $catcbll_btn_border_clr; $border_size = $catcbll_border_size; $icon_position = $catcbll_btn_icon_psn; $image = ''; } } extract($option_key_vals); //button display setting if (isset($catcbll_both_btn)) { $both = $catcbll_both_btn; } else { $both = ''; } if (isset($catcbll_add2_cart)) { $add2cart = $catcbll_add2_cart; } else { $add2cart = ''; } if (isset($catcbll_custom)) { $custom = $catcbll_custom; } else { $custom = ''; } // open new tab if (isset($catcbll_btn_open_new_tab)) { $btn_opnt_new_tab = $catcbll_btn_open_new_tab; } else { $btn_opnt_new_tab = ''; } /*Button Margin*/ $btn_margin = $catcbll_margin_top . 'px ' . $catcbll_margin_right . 'px ' . $catcbll_margin_bottom . 'px ' . $catcbll_margin_left . 'px'; // shortcode setting end ?> <style> <?php if ($catcbll_custom_btn_position == 'left' || $catcbll_custom_btn_position == 'right') { $display = 'display:inline-flex'; } else { $display = 'display:block'; } if (isset($catcbll_hide_btn_bghvr) && !empty($catcbll_hide_btn_bghvr) || isset($catcbll_btn_hvrclr) && !empty($catcbll_btn_hvrclr)) { $btn_class = 'btn'; $imp = ''; } else { $btn_class = 'button'; $imp = '!important'; } if (isset($astra_active_or_not) && $astra_active_or_not == 'Avada') { $avada_style = 'display: inline-block;float: none !important;'; } else { $avada_style = ''; } echo 'form.cart{display:inline-block}'; echo '.catcbll_preview_button{text-align:' . $catcbll_custom_btn_alignment . ';margin:' . $btn_margin . ';display:' . $display . '}'; echo '.catcbll_preview_button .fa{font-family:FontAwesome ' . $imp . '}'; echo '.' . $catcbll_hide_btn_bghvr . ':before{border-radius:' . $catcbll_btn_radius . 'px ' . $imp . ';background:' . $catcbll_btn_hvrclr . ' ' . $imp . ';color:#fff ' . $imp . ';}'; echo '.catcbll_preview_button .catcbll{' . $avada_style . 'color:' . $catcbll_btn_fclr . ' ' . $imp . ';font-size:' . $catcbll_btn_fsize . 'px ' . $imp . ';padding:' . $catcbll_padding_top_bottom . 'px ' . $catcbll_padding_left_right . 'px ' . $imp . ';border:' . $catcbll_border_size . 'px solid ' . $catcbll_btn_border_clr . ' ' . $imp . ';border-radius:' . $catcbll_btn_radius . 'px ' . $imp . ';background-color:' . $catcbll_btn_bg . ' ' . $imp . ';}'; echo '.catcbll_preview_button a{text-decoration: none ' . $imp . ';}'; if (empty($catcbll_hide_btn_bghvr)) { echo '.catcbll:hover{border-radius:' . $catcbll_btn_radius . ' ' . $imp . ';background-color:' . $catcbll_btn_hvrclr . ' ' . $imp . ';color:#fff ' . $imp . ';}'; } ?>.quantity, .buttons_added { display: inline-block; } .stock { display: none } </style><?php if ($pid_count > 0) { for ($x = 0; $x < $pid_count; $x++) { // get featured image url in the database if (get_post_type($pids[$x]) == 'product') { $pimg_id = get_post_meta($pids[$x], '_thumbnail_id', false); $pimg_url = get_post($pimg_id[0]); $pimg_url = $pimg_url->guid; // Get button label, URL and open-new-tab-checkbox value in the database $prd_lbl = get_post_meta($pids[$x], '_catcbll_btn_label', true); $prd_url = get_post_meta($pids[$x], '_catcbll_btn_link', true); if ($btn_opnt_new_tab == "1") { $trgtblnk = "target='_blank'"; } else { $trgtblnk = ""; } //count button values if (is_array($prd_lbl)) { $atxtcnt = count($prd_lbl); } else { $atxtcnt = ''; } if (($custom == "custom") || ($add2cart == "add2cart")) { if (!empty($prd_lbl[0]) && ($custom == "custom")) { if ($image == 'false' || $image == '') { $html = ''; } else { $html = '<img src="' . $pimg_url . '" class="prd_img_shrtcd">'; } echo "<div class='shortcode_" . $x . "'>" . $html; if ($catcbll_custom_btn_position == 'down' || $catcbll_custom_btn_position == 'right') { $product = new WC_Product($pids[$x]); $add_to_cart = do_shortcode('[add_to_cart_url id="' . $pids[$x] . '"]'); if ($both == "both" && $add2cart == "add2cart") { if ($product->is_type('variable')) { woocommerce_template_loop_add_to_cart($pids[$x], $product); } else { woocommerce_template_single_add_to_cart($pids[$x], $product); } } } //Show multiple button using loop for ($y = 0; $y < $atxtcnt; $y++) { $prd_btn = ''; if ($icon_position == 'right') { if (!empty($prd_lbl[$y])) { $prd_btn = '<div class="catcbll_preview_button"><a href="' . $prd_url[$y] . '" class="' . $btn_class . ' btn-lg catcbll ' . $catcbll_hide_btn_bghvr . ' ' . $catcbll_hide_2d_trans . '" ' . $trgtblnk . '>' . $prd_lbl[$y] . ' <i class="fa ' . $font_awesome . '"></i></a></div>'; } } else { //Checking label field .It is empty or not if (!empty($prd_lbl[$y])) { $prd_btn = '<div class="catcbll_preview_button"><a href="' . $prd_url[$y] . '" class="' . $btn_class . ' btn-lg catcbll ' . $catcbll_hide_btn_bghvr . ' ' . $catcbll_hide_2d_trans . ' " ' . $trgtblnk . '><i class="fa ' . $font_awesome . '"></i> ' . $prd_lbl[$y] . ' </a></div>'; } } echo $prd_btn; } // end for loop if ($catcbll_custom_btn_position == 'up' || $catcbll_custom_btn_position == 'left') { $product = new WC_Product($pids[$x]); $add_to_cart = do_shortcode('[add_to_cart_url id="' . $pids[$x] . '"]'); if ($both == "both" && $add2cart == "add2cart") { if ($product->is_type('variable')) { woocommerce_template_loop_add_to_cart($pids[$x], $product); } else { woocommerce_template_single_add_to_cart($pids[$x], $product); } } } echo "</div>"; } else { $product = new WC_Product($pids[$x]); $add_to_cart = do_shortcode('[add_to_cart_url id="' . $pids[$x] . '"]'); if ($both == "both" || $add2cart == "add2cart") { if ($image == 'false' || $image == '') { $html = ''; } else { $html = '<img src="' . $pimg_url . '" class="prd_img_shrtcd">'; } echo "<div class='shortcode_" . $x . "'>" . $html; if ($product->is_type('variable')) { woocommerce_template_loop_add_to_cart($pids[$x], $product); } else { woocommerce_template_single_add_to_cart($pids[$x], $product); } echo "</div>"; } } } else { $html = ''; $html .= '<img src="' . $pimg_url . '" class="prd_img_shrtcd">'; // Product featured image echo $html; $args = array( 'post_type' => array('product'), 'post_status' => 'publish', 'posts_per_page' => '-1', 'meta_key' => array( '_catcbll_btn_label' ), ); $loop = new WP_Query($args); while ($loop->have_posts()) : $loop->the_post(); $prd_id = $loop->post->ID; if ($pid[$x] == $prd_id) { // woocommerce_template_single_add_to_cart( $prd_id, $product ); if ($product->is_type('variable')) { woocommerce_template_loop_add_to_cart($prd_id, $product); } else { woocommerce_template_single_add_to_cart($prd_id, $product); } } endwhile; echo '<br><br>'; } // end else } // end if(post_type='product') else { echo "Please use correct product Id"; } } // end main for loop } // end if pid count > 0 else { echo __('Please Write Us PID Perameter In Shortcode', '') . " ([catcbll pid='Please change it to your product ID'])"; } } |
Code file location:
woo-custom-cart-button/woo-custom-cart-button/include/wcatcbll_shortcode.phpConclusion
Now that you’ve learned how to embed the Custom Add to Cart Button Label and Link Plugin shortcode, understood the parameters, and seen code examples, it’s easy to use and debug any issue that might cause it to ‘not work’. If you still have difficulties with it, don’t hesitate to leave a comment below.
Leave a Reply