Knowledge Base

Social poster

Last Modified:
11 Dec 2018
User Level:
Administrator

Description

21 Sep 2018 – Owing to API updates by Facebook, LinkedIn and Twitter, this functionality is currently not working.
Documentation will be updated when there is a resolution.

Social poster lets you post short messages from content to:

  • Facebook
  • LinkedIn
  • Twitter

Posts usually contain a short description and a link to the page containing the content.

To ensure the full use of this feature, check that the server running TERMINALFOUR has web access. Social poster needs to be able to access the live content (to check the link is live) and it needs access to Twitter and Facebook for authentication (see below) and to send the post.

NOTE: Ensure you have an accurate time source on this server as access tokens are time sensitive.

After you create an app, the Social poster needs to be updated with the relevant API keys and API secrets for each network. The individual social network documentation outlines how to obtain these values.

How to work with the Social poster

When you want to create a social message to be published on Facebook, Twitter, or LinkedIn, go to System Administration > Set up sites & channels > Social poster. This opens the start page shown below:

This start page is populated with items for example purposes. With a new system, there are no historical accounts. As you create and authorize a social post then your list grows.

To familiarize yourself with this page - here are the notable items:

  • There are two tabs - Accounts and Setup
    • From the Accounts tab you can manage accounts, review status, and click to create new accounts
    • From the Setup tab you can assign posting parameters and social media networks
  • In the upper right corner is the +Create new account button (green). This opens a new page that is discussed below.
  • There is a Posts button (blue). This opens a new page that allows you to view all posts made to accounts.
  • There is a Search box to search accounts, and you can choose to display up to 100 records using the Display list.

Setup

1. Run social poster: This dropdown allows you to set how often posts and picked up and sent to the specified social network. The options are:

  • Never, the social poster will never automatically send posts to any network.
  • On Publish, the post will be sent as soon as the content is published.
  • Every 1 minute, the social poster will run every minute and send pending posts to the specified social network.
  • Every 10 minutes, the social poster will run every ten minutes and send pending posts to the specified social network.
  • Every 20 minutes, the social poster will run every twenty minutes and send pending posts to the specified social network.
  • Every 30 minutes, the social poster will run every thirty minutes and send pending posts to the specified social network.
  • Every 1 hour, the social poster will run every one hour and send pending posts to the specified social network.

2. Remove sent posts: This dropdown allows you to set when sent posts are removed from the system completely. The options are:

  • Never, always keep sent posts.
  • Every day, sent posts over one day old will be removed.
  • Every 3 days, sent posts over three days old will be removed.
  • Every week, sent posts over a week old will be removed.

3. Add the account key and secret:

For each network you need an account to get developer information to create an app for sending posts. Here are the necessary links for each social posting:

Enter these into the setup

  • Twitter API key, the API key provided by Twitter when the app is created.
  • Twitter API secret, the API secret provided by Twitter when the app is created.
  • Facebook API key, the API key provided by Facebook when the app is created.
  • Facebook API secret, the API secret provided by Facebook when the app is created.
  • LinkedIn API key, the API key provided by LinkedIn when the app is created.
  • LinkedIn API secret, the API secret provided by LinkedIn when the app is created.

4. When all entries are complete, click Save changes.

Accounts

In the first column of the list is Accounts. The contents of this column are the Name of the account. A brief description can be included if an entry was made. Use the arrow button in the head row to change the list displayed from an A to Z list to Z to A list. There is also an ID number. The ID is assigned when you create a new account.

Network

This is a list of associated networks used with the name of the account - they are listed as Facebook, Twitter, or LinkedIn. Each box shows the network name and the status of the post. The status can be: 

  • Not authorized - the post has been created but not authorized.
  • Authorized - the post has been created and is authorized to release.
  • Pending - post created

Use the arrow button in the head row to change the list displayed from an A to Z list to Z to A list.

Actions

In the column with Actions buttons, you can use the drop-down list to choose actions to take with the Account in the row.

  • You can Authorize the release of a message from that account.
  • If you click Edit, this takes you to the corresponding Account page where you can confirm or edit the fields on that page.
  • You can Delete an account. If you choose to delete an Account, you are challenged with a confirmation box - see below. Confirm your selection to Cancel or Delete.

 

Caution: If you Delete the data it is not recoverable.

‌‌

+ Create new account‌‌

 

1. To create a new account, from the start page, click the green + Create new account button > General account information

2. Enter the Name of the account - each account must have a name - this is a mandatory step.

3. Enter a Description - you can choose to enter a description, or wait till a later date when you can add or edit a description.

4. Choose from the drop-down list for a Social media platform - you can choose None, Facebook, LinkedIn or Twitter.

5. If you are satisfied with your entries, click Save changes. If you click Save Changes, this returns you to the start page.

6. After the account is added, select the Authorize option from the Actions dropdown to authorize the account. This will open a prompt to login to the social media account to authorize the app created above for the account. For Facebook, you will need to log in as a user who has access to post as the page that is posting the content i.e. a user who is able to post content as the page.

The t4 Social tag

Insert the t4 Social tag into the content layouts for the content type(s) that will automatically post to social media.

Post information ‌

Once posts have been sent to the Social poster, they are listed when clicking on the +Posts button (blue). The post information, is shown by choosing Actions > View details or click directly on the post.

1. This page displays:

  • Post ID
  • Full post text
  • Account type
  • Content ID (from where the post was generated)
  • Created on date
  • Posted on date (if the post has been sent)
  • Status (pending, error or sent).

2. There is a link to the post, whether the link is live or not and you can view any errors that could be associated with the sending of this post.

3. Click OK or close when finished.

Example uses

A. News content type

1. Create a new content type called News, go to Assets > Content Types > Create New.

2. Create two elements, Post text and Full article and click Add content type.

3. For the text/html layout enter the following code: (NOTE: with Twitter you have 140 characters only, so setting the length of the template to 120 would be advised.)

<p><a href="<t4 type="content" name="Post Text" output="fulltext" modifiers="" />"><t4 type="content" name="Post Text" output="normal" modifiers="" /></a></p>

4. This is a link to the fulltext layout.

5. Create a new layout called text/fulltext and enter the following code:

<t4 type="social" post_element="Post Text" account_identifier="Account" base_url="http://www.baseurl.com" resource="" post_type="post" expires="1" />

<h1><t4 type="content" name="Post Text" output="normal" modifiers="" /></h1>

<t4 type="content" name="Full Article" output="normal" modifiers="" />

6. This outputs the Post text as a heading and the full version of the article underneath.

7. Update the account_identifier to match one of the added accounts.

8. Enable this Content type on a section, add some content using it and publish.

9. You should see a new post has been added as Pending.


Special Notice content type

1. Create a new content type called News, go to Assets > Content Types > Create New.

2. Create two elements, Post text and Full article and click Add content type.

3. For the text/html layout enter the following code:

<p><a href="<t4 type="content" name="Post Text" output="fulltext" modifiers="" />"><t4 type="content" name="Post Text" output="normal" modifiers="" /></a></p>

4. This is a link to the fulltext layout.

5. Create a new layout called text/fulltext and enter the following code:

<t4 type="social" post_element="Post Text" account_identifier="Twitter Account" base_url="http://www.baseurl.com" resource="" post_type="post" expires="1" />
<t4 type="social" post_element="Post Text" account_identifier="Facebook Account" base_url="http://www.baseurl.com" resource="https://graph.facebook.com/321844344589231/feed" post_type="post" expires="1" />
<h1><t4 type="content" name="Post Text" output="normal" modifiers="" /></h1>
<t4 type="content" name="Full Article" output="normal" modifiers="" />

6. This outputs the Post text as a heading and the full version of the article underneath.

7. Update the identifier to match one of the added accounts.

8. This will post to 2 accounts, you could have many accounts in one layout.

9. Enable this Content type on a section, add some content using it and publish.

10. You should see a new post has been added as Pending.