Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column
width70%

Twitter Reader is an agent that runs in the background on the data server, such as TweetOut or Super Ticker. The Twitter Reader agent connects directly to the database. It reaches out to Twitter and returns valid content based on your enabled topic searches created in Flow.

Twitter topics are set up and managed in Flow for the Twitter Reader agent to populate using the Flow Configuration > Twitter Topic Control.

In TweetOut, see

See the topic Twitter Topic Control for details.

In Super Ticker, see the topic Twitter Topic Control for details.


Image Added

Expand
titleClick here to see an example of the screen.

Image Removed 


Note

Important: The Twitter Reader agent must be running in order to receive new content. If you are troubleshooting a lack of new content, ensure that the Twitter Reader agent is running and functional using the Agent Status.

  • In Super Ticker, see the topic Agent Status for details.
  • In TweetOut, see

    the

    topic

    Agent Status

    for details

    .

    Cloud Instance or Local Instance?

    Customers using a cloud instance of TweetOut or Super Ticker do not need to manage the Twitter Reader themselves; Bannister Lake manages it for you. For assistance with your instance of Twitter Reader, contact Bannister Lake Support. 

    Customers using a local instance can access and manage their own instance of Twitter Reader.

    • In a standard installation, Twitter Reader is available on the server, also known as the Flow Server or database server.
    • In a custom installation, Twitter Reader may be located elsewhere. See your local system administrator for details.

    Access Twitter Reader

    To access the Twitter Reader agent, run the agent from its desktop icon on the server.

    Run Twitter Reader for the First Time

    The first time you run the Twitter Reader, you are prompted to create a new server connection instance. Enter an Instance Name and click OK.

    Expand
    titleClick here for more details on setting up Twitter Reader for the first time.

    Setup Tab - Connect to a Database

    The Twitter Reader agent must be configured to connect to a database. Use the Setup tab to configure the connection.

    Setup Tab - Manage Database Connections

    Connection and user authentication values would have been correctly configured by your system administrator initially during installation; however, you can modify the values at any time using the Setup tab.

    Note

    Note: Use caution when modifying these values. 

    Image RemovedImage Added

     

    Info

    Administrators: In an environment where you are securing network ports, you need make sure that the FTP port 21 can still access the internet as the Twitter Reader accesses Twitter credentials from a rotating pool available from the Bannister Lake server.


    Setup Tab - Feed Settings

    Using the Setup tab, you can also configure the following feed settings:

    OptionDescription
    Remove Links From TweetsBy default, the Twitter Reader removes hypertext links from Tweets. You can re-enable links by enabling this optionIgnore Tweets with Link?

    This checkbox will determine whether tweets that contain links are ignored or kept.

    Filter on Black List words?

    By default, the Twitter Reader automatically removes Tweets that contain words found in the Black List. You can turn off Black List content validation by disabling this option, though it is not recommended.

    For more information on Black List filtering:

  • In TweetOut, see the topic Black List Control Module for details.
  • In Super Ticker

    , see the topic Black List Control Module for details.

    Store Images?You can choose to store images attached to Tweets in the database to use in a broadcast by enabling this option. By default, images are not stored in the database.
    Read Tweets Every X Seconds

    You can configure how often Tweets are read using this option. This value must be a minimum of 60 seconds (1 minute).

    Run Tab Details

    Image Added

    The Run tab displays the following details:

    OptionDescription
    Countdown

    By default, the Twitter Reader attempts to retrieve data every two (2) minutes. You can adjust this frequency on the Setup tab; however, the minimum frequency must be one (1) minute or more.

    Click Read Now to manually retrieve data on demand and bypass the countdown clock.

    Rate Limit

    Twitter only allows data clients like Twitter Reader to make a limited number of calls for new data in a given hour to control abuse. If the rate limit reaches zero (0) no new tweets will be retrieved.

    In Super Ticker, see

    To avoid exceeding Twitter’s limits, disable any unnecessary TweetOut Twitter topics in Flow.

  • In TweetOut, see the topic Twitter Topic Control Module for details.
  • See the topic Twitter Topic Control Module for details.

    New TweetsThe number of new Tweets added during the last data retrieval.
    Status, Database Connection, & Enabled
    • Data retrieval status and time stamp
    • Database connection status
    • Agent status

    Topics Tab Details

    The Topics tab shows you all of the Twitter topics configured and enabled in Flow.

    Expand
    titleClick here to see an example of the screen.

    Image RemovedImage Added

    Check for Updates

    When you open Twitter Reader, it automatically checks for updates and prompts you if a newer reader version becomes available.

    You can manually check for updates at any time by selecting Help > Check for Updates.

    Multiple Server Instance Support

    You can create and manage multiple server instances for the Twitter Reader.

    1. To create another instance, select File > New Instance.
    2. Assign the instance a name and configure that instance for a specific database.
    Column
    width30%
    Panel
    borderColor#0070b1
    bgColor#FFFFFF
    borderWidth1

    In this section:

    Table of Contents
    indent15px

    Include Page
    DAS:Promos Top
    DAS:Promos Top

    ...