Table of Contents

 

Overview

 

Twitter Integration provides the ability to pull in Twitter content (Tweets) into Article Assets.  The Twitter Integration software uses your Twitter Account and Channel as the conduit to Twitter and the content on Twitter is populated into a Twitter Interface in Editorial Assets that you can search for Tweets and place them into Articles.  The setup to do this is kind of technical. You will need a Twitter App in order to integrate with Twitter. To set one up, Click Here.

Prerequisites

The prerequisites pertain to the hosted site (connecting site) that the Twitter content is going to be pulled from.  On the hosted site, the Twitter Broadcast Channel and Account must be setup.  You also need a Job setup to run.

BLOX CMS Hosting Site

The BLOX CMS Hosting site is the "Admin" site that has the Twitter Broadcast Account set up on. Once the Twitter Account and Channel has been set up, you will then Link to this site from the BLOX Total CMS Appliance.

Twitter Broadcast Account Setup

ACCESSING APPLICATIONS

From the drop-down in the the upper left choose Settings / Broadcast...


NOTE: Not sure how to access BLOX Applications? Click here


+42 
BLOX-AccessBroadcastSettings.png

The Broadcast Settings window opens.

+42 
BLOX-BroadcastChannelsBefore.png

Under Accounts, click on Connect and select Twitter.

+42 
BLOX Total CMS-BroadcastAccountsConnect.png

The BLOX CMS - Twitter Authorize screen opens in a new browser. Fill in your account credentials and then click on Authorize App.

+42 
BLOX Total CMS-BroadcastAccountsConnectAuthorize.png

Once authorized, the Twitter Account will be added to your Broadcast Accounts. Select the Account you want to use and then click on Select Accounts (this window closes and returns you to the Channel setup window).

+42 
BLOX-BroadcastChannelsTargetAcctAdd.png

Now, under Channels, click on New.

+42 
BLOX-BroadcastChannelsBefore.png

Next, enter a Name for this Channel then, under Sections, click on Add to add sections of your BLOX CMS Hosting site (the Select Sections dialogue window opens).

+42 
BLOX-BroadcastChannelsNew.png

Select your Section(s) then click on Add Sections at the bottom (this window will then close).

+42 
BLOX-BroadcastChannelsSectionAdd.png

To add a Target Account, click Add and select the account you want and click Select Accounts. Once you've done that, you'll see the Sections and Twitter Account for this Broadcast Channel. Then click Save (this window closes).

+42 
BLOX-BroadcastChannelsNewDone.png

You'll then see the new Twitter Channel listed in your Broadcast Settings.

+42 
BLOX-BroadcastChannelsNewAfter.png

Job Setup

A job needs to be set up on the hosted site to send the Site Tags to the BLOX Total CMS Appliance. To access, go to Settings / Jobs (the drop menu on your hosted site may have different options). For more information on Jobs, Click Here.

+42 
BLOX Total CMS-JobsAccess.png

Jobs Settings will open up. Click on New to set up a new job.

+42 
BLOX Total CMS-JobsMain.png

Fill in the properties for the job as follows. See the link above for more help on setting up a job.

+42 
BLOX Total CMS-JobsMainNew.png
  • Job - Job ID = this is automatically populated by system when job is created | Job Title = what ever you enter
  • Source - Module = tncms_json | Location = feeds/appliance-name/*.json (ie: feeds/aptest/*.json)
  • Destination - Module = tncms | Location = can be left blank
  • Filters - This can be left blank

Click Save when you're done.

Link Site

On the BLOX Total CMS Appliance, go to Settings / Linked Sites to set up a link (connection) to your Hosted site.

+42 
BLOX Total CMS-LinkedSitesAccess.png

The Linked Sites settings box opens. Click on Connect.

+42 
BLOX Total CMS-LinkedSites.png

When you click on Connect, The Connect to Hosted Site dialogue box opens. Enter the Domain Name of the site you want to connect to. Click on Connect. If you get an error, see below on how to address them.

+42 
BLOX Total CMS-LinkedSitesDomain.png

This error indicates you have a Pop-up Blocker enabled on your site. Click OK and remove it. Then click on Connect again.

+42 
BLOX Total CMS-LinkedSitesDomainConnectError.png

This error indicates you have the http://www. or https://www. in the Domain Name. Click OK and remove it. Then click on Connect again.

+42 
BLOX Total CMS-LinkedSitesDomainYadisError.png

A successful connection takes you to an authorization screen where you Approve or Deny the connection request.

+42 
BLOX Total CMS-LinkedSitesConnectApprove.png

Once Approved, the site is listed in the Linked Sites. You can click on Verify to verify the connection.

+42 
BLOX Total CMS-LinkedSitesConnectApproved.png

Setting Up a Twitter Broadcast Channel

To do this, you must first have the Link SiteLinked Site set up. This provides the Twitter accounts for you to use in this process. To access the Broadcast Settings, go to Settings / Broadcast.

+42 
BLOX Total CMS-AccessBroadcastSettings.png

This loads the Broadcast settings window.

+42 
BLOX Total CMS-BroadcastMain.png

First click on Accounts and then on Update Remote Accounts (created in the Linked Sites settings). This will go through and synchronize your Twitter accounts.

+42 
BLOX Total CMS-BroadcastAccounts.png

When synchonization is complete, you'll get a list of all accounts that were synchronized. Click OK.

+42 
BLOX Total CMS-BroadcastAccountsSynchronized.png

A confirmation message will appear, click OK.

+42 
BLOX Total CMS-BroadcastAccountsUpdateRemoteAccts.png

Now, click Channels and then click on New to create a new Channel.

+42 
BLOX Total CMS-BroadcastChannels.png

The Edit Broadcast Channel window opens. Fill in the Channel Name and then under Sections, click on Add.

+42 
BLOX-BroadcastChannelsSetupNew.png

Go through and select the Sections you want to add to this channel. Click on Add Sections when done.

+42 
BLOX Total CMS-BroadcastChannelsNewSectionsAdd.png

Now under Target Accounts, click on Add.

+42 
BLOX-BroadcastChannelsSetupTargetAcct.png

Any accounts that synchronized will show up in a list.

+42 
BLOX Total CMS-BroadcastAccountsListed.png

Select the Twitter Account(s) you want to use for this channel. Click on Select Accounts when done.

+42 
BLOX Total CMS-BroadcastAccountsSelect.png

Once the Sections and the Target Accounts have been added, click on Save.

+42 
BLOX-BroadcastChannelsSetup.png

You are now returned to the Broadcast settings window with the new channel added.

+42 
BLOX Total CMS-BroadcastChannelsAfterSetup.png

Using Twitter in Article Assets

The Twitter icon is on the Toolbar. This provides the ability to connect to your Twitter account, Search for Tweets, and Select which ones you want to embed into your article. In the Article editing window, click on the Twitter icon.


Note: If the Twitter Icon is missing from the toolbar in your asset editor, your Systems Site Administrator will have to enable it by going to Superuser Tools / System / Service Keys and enter the Key and Secret from your Twitter App account. To set one up, Click Here.  If your Systems Site Administrator does not have this access, contact TownNews.com Customer Service for assistance - (800) 293-9576 or Create a Ticket.


+42 
BLOX Total CMS-ArticleMain.png

You'll be prompted to Connect to your Twitter account, click on the button.

+42 
BLOX Total CMS-ArticleTwitterConnect.png

Once you select your account, you'll be prompted to Confirm the account selection.

+42 
BLOX Total CMS-ArticleTwitterConnectConfirm.png

A Search Twitter interface opens up. Enter a Keyword to search on. You can also opt to Retweets and Replies and/or Mentions.

+42 
BLOX Total CMS-ArticleTwitterSearch.png

Go through and select the Tweets you want to use. There are Navigation controls at the bottom of the interface to advance to another list of results.


Note: If you want to select Tweets that are on different pages in the Results, you'll need to select the ones from a single results page and Insert those and then repeat the Search to pull in those from another results page.


+42 
BLOX Total CMS-ArticleTwitterSearchResults.png

Once the results are loaded into the Article, you can drag and drop them where you want them inline with story (think of each Tweet as an individual inline related asset).

+42 
BLOX Total CMS-ArticleMainWithTweets.png

Broadcast Articles to Twitter

Broadcasting an article to your Twitter account essentially sends a link (title of the article is default but can be modified) to Twitter and is linked back to the article on the hosted site. To do so, you have to have:

  • - The Twitter account set up on the hosted site
  • - The hosted site linked to from the BLOX Total CMS Appliance
  • - The Broadcast Channel set up on the BLOX Total CMS Appliance

Then, the Broadcast options are automatically populated (made available) in the Editorial Asset editor on the right under Other.

+42 
BLOX Total CMS-BroadcastOtherMain.png

To Broadcast to Twitter, check the checkbox of the corresponding Twitter account you want to send link to. Related images will not appear on Twitter.

+42 
BLOX Total CMS-BroadcastOtherBroadcast.png

Once the checkbox is checked, a box appears with the title in it. Here you can modify the text that will appear on Twitter. Once you click on Save, the Broadcast happens instaneously.

+42 
BLOX Total CMS-BroadcastOtherBroadcastCheck.png

Appears on Twitter

+42 
BLOX Total CMS-BroadcastOtherFrontTwitter.png

Appears on Hosted Site

+42 
BLOX Total CMS-BroadcastOtherFrontSite.png