Modular Merchant
QuickCode™ Glossary
QuickCode Tag Glossary Home
See also:
Knowledge Base
Articles in this category:



























{GOOGLE-PLUS-ONE-BUTTON} Updated: 02/12/2013

This QuickCode Tag is used to add a Google+ "Plus One" (+1) button to any page of your online store.

The tag can be used as-is to display a +1 button in your storefront. However, it can also accept several parameters, which can be used to customize its appearance and behavior. The available parameters include:

Sets the URL to +1. Set this attribute when you have a +1 button next to an item description for another page and want the button to +1 the referenced page and not the current page. If you set this attribute by using, you should should not escape the URL.
Possible values: Any URL
Default: Current page's URL

Sets the +1 button size to render.
Possible values: small, medium, standard, tall
Default: standard

Sets the annotation to display next to the button.
Possible values: none, bubble, inline
Default: bubble

If annotation is set to "inline", this parameter sets the width in pixels to use for the button and its inline annotation. If the width is omitted, a button and its inline annotation use 450px.
Possible values: Any number

Sets the horizontal alignment of the button assets within its frame.
Possible values: left, right
Default: left

Sets the preferred positions to display hover and confirmation bubbles, which are relative to the button. Set this parameter when your page contains certain elements, such as Flash objects, that might interfere with rendering the bubbles.
Possible values: comma-separated list of top, right, bottom, left
Default: empty list

If specified, this function is called after the user clicks the +1 button. The callback function must be in the global namespace and accept a single parameter, which is a JSON object.
Possible values: function(jsonParam)

If specified, this function is called either when a hover bubble displays, which is caused by the user hovering the mouse over the +1 button, or when a confirmation bubble displays, which is caused by the user +1'ing the page. You can use this callback function to modify your page, such as pausing a video when the bubble appears.
Possible values: function(jsonParam)

If specified, this function is called when either a hover or confirmation bubble disappears. You can use this callback function to modify your page, such as resuming a video when the bubble closes.
Possible values: function(jsonParam)

To disable showing recommendations within the +1 hover bubble, set recommendations to false.
Possible values: true, false
Default: true
Requirements / Prerequisites

When using parameters within the QuickCode Tag, the different values should be separated correctly.

Colons ( : ) should be used to separate the different options; such as annotation and size.

Equal signs ( = ) should be used to distinguish what the option's value is.


An example of their separation can be viewed below:



Parameters can be passed within the QuickCode Tag in two ways.

Name/Value Pairs
The preferred method is to use name/value pairs. In this approach, both the name of the parameter and its value are included in the QuickCode Tag. This allows you to set custom values for any number of the available parameters, in any order.

For example, to set custom values for just the "annotation" and "size" options, the QuickCode Tag would look something like this when using name/value pairs:


Note that when using name/value pairs, the parameters may be included in any order, and unused parameters may be excluded.


Values Only
Optionally, just the values of the parameters may be included. This can make the QuickCode Tag shorter in some cases, however, when including only the values of each parameter they must be kept in order.

For example, to set custom values for just the "annotation" and "size" options, the QuickCode Tag would look something like this when using just values:


Note that when using only the values, all parameters from the first one through the last one you use must be present and in the correct order.
Example of Use

If you wanted a tall +1 button with the button aligned on the left side of its frame:


Source Code Source Code Updated:
When a web page using a template that contains this QuickCode Tag is viewed in the storefront, the {GOOGLE-PLUS-ONE-BUTTON} QuickCode Tag is changed into the source code below prior to the web page being displayed.
  Copyright © 2001 - 2024 Modular Merchant™. All rights reserved.
Modular Merchant | Privacy Policy | Legal Statement | Terms of Service | Contact Us | Site Map