EXT: PMK News Twitter¶

Table of Contents¶

EXT: PMK News Twitter 2 1

`Introduction 3 <#__RefHeading__1076_738945734>`_

What does it do? 3

`Users manual 4 <#__RefHeading__1080_738945734>`_

`Administration 5 <#__RefHeading__1082_738945734>`_

`Configuration 6 <#__RefHeading__1084_738945734>`_

Reference (TSConfig) 6

`Frequently Asked Questions 9 <#__RefHeading__1088_738945734>`_

`Known problems 10 <#__RefHeading__1090_738945734>`_

`To-Do list 11 <#__RefHeading__1092_738945734>`_

`Reporting Bugs 12 <#__RefHeading__1094_738945734>`_

`Updates 13 <#__RefHeading__1096_738945734>`_

`ChangeLog 14 <#__RefHeading__1098_738945734>`_

Introduction¶

Users manual¶

• Once the extension is installed and the Twitter username and password have been inserted in either Page or User TSConfig, creation or editing of tt_news records will trigger post on Twitter. (Only is the field selected in the TSConfig options have been changed.)
• On the tt_news records there's now a new checkbox field named “Don't post on Twitter”. If this is checked, nothing will be posted to Twitter.

Administration¶

• The extension must be configured using Page/User TSConfig, with the username and password of the Twitter account you want the news to be posted to. And what field should be posted/trigger posting.
• See the Configuration section for an example.

Get Twitter credentials¶

Create an account on https://dev.twitter.com

Create the application that will be used to publish on Twitter.

Set “Read & Write” rights to the application

Recover consumer key, consumer secret, access token and access token secret (see configuration section)

Configuration¶

• The extension has 3 TSConfig options which must be set before Twitter posting will occur.
• If the config options is placed in User TSConfig, it's possible to have different accounts depending on the BE user creating/editing the news item.
• If placed in Page TSConfig it's possible to have different accounts depending on the page where the config options is placed.

tx_pmkttnewstwitter {

    twitterconsumerkey = XXXXXX

    twitterconsumersecret = XXXXXX

    twitteraccesstoken = XXXXXX

    twitteraccesstokensecret= XXXXXX

    # Password of Twitter account.


    #The field to post on Twitter
    postField = title

    # Insert link back to singleView page on site.
    linkBack = 1

    # If set, then the keywords field will be used as Hash tags when posting.
    useKeywordsAsHashTags = 1

    # If PagePath extension is installed, and this is set,
    # then PagePath WILL NOT be used for generating the links back to the site.
    noPagePath = 0
}

page.tx_pmkttnewstwitter {

    twitterconsumerkey = XXXXXX

    twitterconsumersecret = XXXXXX

    twitteraccesstoken = XXXXXX

    twitteraccesstokensecret= XXXXXX


    #The field to post on Twitter
    postField = bodytext

    # Insert link back to singleView page on site.
    linkBack = 1

    # If set, then the keywords field will be used as Hash tags when posting.
    useKeywordsAsHashTags = 1

    # If PagePath extension is installed, and this is set,
    # then PagePath WILL NOT be used for generating the links back to the site.
    noPagePath = 0
}

Frequently Asked Questions¶

Q: I sometimes forget to check off the “Don't post on Twitter” checkbox, and as a result I have to go to my Twitter account and delete the entry. Is there a possibility to “revert” that, so that I have to check off the checkbox if I WANT to post on Twitter?

A: Not currently, but with Page TSConfig you can use TCAdefaults to make the checkbox checked by default when you create a new tt_news record. That way you'll have to UNCHECK the checkbox before something is posted on Twitter.

Insert this in the Page TSConfig on the sysfolder with your tt_news records.

TCAdefaults.tt_news.tx_pmkttnewstwitter_notwitter = 1

Q: The links back to my site is not correct. What should I do?

A: Try removing the PagePath extension (or set the “noPagePath” in your Page TSConfig setup) This will make the extension create plain “index.php?id=” type of backlinks (This means *NO* RealURL or CoolUri translations of the URL.)

I suggest you write a bugreport at the PagePath Forge bugtracker, describing your setup. `http://forge.typo3.org/projects/extension- pagepath/issues <http://forge.typo3.org/projects/extension- pagepath/issues>`_

Q: Instead of a backlink on Twitter, I get a “Error” text. What should I do?

A: Turn off the PagePath extension (or set the “noPagePath” in your Page TSConfig setup).

Q: I have SinglePid set in the FlexForm of the plugin and not in TypoScript, what should I do?

A: Create an EXT: TypoScript template on the the sysfolder where your tt_news records are stored. Then insert this in the TypoScript setup field:

plugin.tt_news.singlePid = <ID of sysfolder>

Remember to change <ID of sysfolder> to the id of the sysfolder where the tt_news records are located.

Known problems¶

The plugin first checks if a Category is attached to the news record, with a singlePid set. If not it reads the TypoScript configuration of tt_news (plugin.tt_news.singlePid) to determine what page is used for singleView.So it WILL NOT WORK if you only set the singleView mode in the tt_news plugin FlexForm!, as it's not possible to read the FlexForm settings form a BE extension.

To-Do list¶

Nothing planned, but ideas are welcome.

Reporting Bugs¶

• If you discover a bug, please don't write the author(s) directly. Instead post a bug report at the Forge bugtracker: http://forge.typo3.org/projects/show/extension-pmkttnewstwitter
• That way others can see your bug report and maybe add additional comment. It also makes it possible for all the extension authors to see what bugs are already been fixed by one of the other authors.

Updates¶

• If you like this extension, please rate it. http://typo3.org/extensio ns/repository/view/pmkttnewstwitter/current/rating/
• As ratings are the only way I can see if there's an interest in this extension, updates depends on people rating it.
• (No ratings = No updates)

For latest version, always check the Forge repository: http://forge.typo3.org/projects/show/extension-pmkttnewstwitter

ChangeLog¶

28.02.2013 : First Release

15