---json
{
    "name": "Follow Buttons",
    "page_id": "nc63fbino7rer61s2bi6w"
}
---
====== Follow Button ======



===== About =====
The ''Follow'' button is a button displayed on your websites to help users easily follow you.



===== Example =====

====  With a follow request ====

With a social handle name, social channel supports a follow request.
You need to give your handle, ie your name identifier.


<webcode name="Default" frameborder="0">
  * For instance, for twitter:
<code dw>
<follow twitter handle="combostrapweb"/>
</code>
  * The output would be:
</webcode>


If the user clicks on the link, it will be presented with a ''follow'' request choice.

{{:docs:social:social_channel_follow_request.png|}}



==== With an URL ====

You can also give your URL directly.
<webcode name="Default" frameborder="0">
  * For example, for twitter:
<code dw>
<follow twitter url="https://twitter.com/combostrapweb"/>
</code>
  * The output would be:
</webcode>

===== Map =====

Below, you can see a map of the share component with the parameters:
  * ''widget'': button (default) or link
  * ''icon'': Solid, Solid Circle, Outline, Outline Circle
for all supported channel.


^ Widget  -> ^  Button  ^^^^  Link  ^^^^
^ Icon -> ^ Solid ^ Solid \\ Circle ^ Outline ^ Outline \\ Circle ^ Solid ^ Solid \\ Circle ^ Outline ^ Outline \\ Circle ^
| [[facebook|Facebook]] |  <follow facebook handle="combostrap"/>  |  <follow facebook icon="solid-circle" handle="combostrap"/>  |  <follow facebook icon="outline" handle="combostrap"/>  |  <follow facebook icon="outline-circle" handle="combostrap"/>  | <follow facebook widget="link" handle="combostrap"/> |  <follow facebook widget="link" icon="solid-circle" handle="combostrap"/>  | <follow facebook widget="link" icon="outline" handle="combostrap"/> | <follow facebook widget="link" icon="outline-circle" handle="combostrap"/> |
| [[twitter|Twitter]] |   <follow twitter handle="combostrapweb" />   |  <follow twitter icon="solid-circle" handle="combostrapweb"/>  |  <follow twitter icon="outline" handle="combostrapweb"/>  |  <follow twitter icon="outline-circle" handle="combostrapweb"/>  | <follow twitter widget="link" handle="combostrapweb"/> |  <follow twitter widget="link" icon="solid-circle" handle="combostrapweb"/>  |  <follow twitter widget="link" icon="outline" handle="combostrapweb"/>  |  <follow twitter widget="link" icon="outline-circle" handle="combostrapweb"/>  |

===== Syntax =====


<code dw>
<follow 
    channel 
    url="url"
    handle="userEntityName"
    icon="solid|solid-circle|outline|outline-circle|none"
    widget="button|link"
    width="integer"
    />
</code>
where:
  * the mandatory attributes are:
      * ''channel'' is one of the [[#map|supported channel]]
      * and a identifier:
          * ''handle'': the entity name on the social channel
          * or an ''url'': the url where the user should go
  * the styling attributes are:
      * ''widget'' permits to choose the type of output:
          * ''button'' (default): a button
          * ''link'': a link
  * ''icon'' is the type of icon or no icon with ''none''
  * ''width'' is the width of the [[docs:content:icon|icon]].

<note>
We support also [[share|share buttons]]
</note>