Share module

  • Created: September 25, 2016
  • Last Updated: September 25, 2016

The share module allows you to customize the sharing experience for your users. You can choose which social methods you want to show to your users and customize the way shared entries are displayed on some social networks.

Share options

Under the share options segment, you will be able to choose which sharing options are visible to your users when they try to share an entry. Most of these are pretty self-explanatory, like Facebook and Twitter. But you can find an overview of the options below. The numbers correspond with the image below the list, showing you what will be shown to your users when you enable them.

  1. Facebook
  2. Twitter
  3. Google+
  4. Pinterest
  5. LinkedIn
  6. Direct link: this is the link that is actually used when your users share through for example Facebook, this option just displays that link so your users can copy it and share it manually in any way they like. For example in their chat application or on a forum.
  7. Embed: a more advanced option, the embed is a snippet of HTML code that can be pasted into any website’s code to display the user’s entry.
  8. Email: Shows a link users can click to open their email client and start writing a new email. This email can be pre-written by you using one of the settings explained below.

Forms module configuration

Note: While you can hide the Facebook, Twitter, … share options to your users, there is nothing we can do to prevent them from taking the direct link to their entry and sharing it across those hidden social networks themselves.

Title and message

Below the general options discussed in the previous settins, you will find a few segments containing title, subject or message fields. They can be used to customize how the user’s shares will be displayed on the social networks. Take for example Facebook in the image below.

Forms module configuration

Here, “Help me win a BBQ” is your title, while “Brand X is currently …” will be the text you enter into the message field. The text above, “Hey guys, please…” is something you do not have control over, Facebook allows only the user him- or herself to enter this text. For the other social networks, the behavior is similar. For email, the email subject and content will be pre-filled with the text you enter in those boxes, but your user will have the opportunity to change that text however they want.

Variables

Besides just plain text, there are also some variables you can use in your share title, subject or message. A variable is something dynamic that can be different for every entry. For example, say you want to include the direct link to the entry in the content of the email share, which you should absolutely do, since unlike Facebook-shares which can just be clicked to go to your campaign page, recipients of an email need a link to click on. You can do this with a variable!

To add a variable to your text, just click the Personalize tab (next to the language tabs above the input box,) and select the variable you want from the dropdown. It will then be automatically inserted into your text and look like this: {{ entry_link }}

Watch out when using the “user name” and “user email” variables. They are only available when you enable the Forms module and use one of our pre-defined forms. To make it work when you use the form builder, check out the section on custom variables below.

Advanced

When someone opens a shared link by default the entry will open on your campaign page or Facebook tab if you have published the campaign to Facebook. You can change that behaviour in the Advanced section of the settings.

Use entry location

This is only useful when you use the embed code to create custom campaigns. When you use the embed code, it’s possible to put one challenge on multiple websites. When you check this option, we will keep track of the website where an entry was initially uploaded or recorded and send users who click on the share link back to that website.

Redirect location URL

Allows you to manually choose the website where users who click on a shared link will be sent.

Advanced tips and tricks

In this section you will find some more advanced tips and tricks to use with the share module.

Caching

When you share an entry on Facebook, Facebook will remember the title and text you have entered, this is called caching. When you change the title or text in our administration panel after you have already shared an entry, Facebook will not show the new text if you share that entry again. Entries that have not been shared before or new entries will have your updated text when shared. If you absolutely need to update the text for an entry that has already been shared, you can use Facebook’s debugger tool which will force it to fetch the text again instead of remembering it.

You can find the tool here: Facebook URL debugger

Paste the direct link to the entry you want to refresh (you can find it under Public link in the entry overview of the administation panel) in the box on that website and click the Debug button. Sometimes it doesn’t work from the first time, then you’ll have to click the Fetch new scrape information button on the resulting page.

Custom variables

If you use the form builder to create your own form or make use of the custom HTML forms functionality, it is stil possible to leverage the information that was filled out in these forms in your share texts. You’ll just have to do it manually instead of with the hashtag button. If you add the user name variable with the hashtag-button, you’ll see the following variable gets added to your text: {{ entry_meta_name }}

Now, you just need to replace the name part with the name of your form field and presto, you can use any data from the Forms module in the Share module. The name of your form field is the value you enter in the ID/name input box of the Form builder or in case of custom HTML forms the value of the name attribute of the form element.