cybercog/yii2-twittable

The twittable extension for the Yii2 framework

v0.3 2015-02-16 21:40 UTC

Requires

• abraham/twitteroauth: dev-master
• yiisoft/yii2: *

BSD-3-Clause

• Anton Komarev

• twitter
• yii2
• twittable

README

This extension provides behavior functions for tweeting.

Installation

The preferred way to install this extension is through composer.

Either run

$ php composer.phar require cybercog/yii2-twittable "*"

or add

"cybercog/yii2-twittable": "*"

to the require section of your composer.json file.

Migrations

If you want to auto-post News to twitter, run the following command

$ yii migrate/create news_tweet_link

Open the /path/to/migrations/m_xxxxxx_xxxxxx_news_tweet_link.php file,

inside the up() method add the following

$sql = "ALTER TABLE news
        ADD COLUMN tweet_id BIGINT(64) NULL DEFAULT NULL";
$this->execute($sql);

inside the down() method add the following

$sql = "ALTER TABLE news
        DROP COLUMN tweet_id";
$this->execute($sql);

Configuring

use cybercog\yii\twittable\behaviors\TwittableBehavior;

/**
 * ...
 * @property string $tagNames
 */
class Post extends \yii\db\ActiveRecord
{
    public function behaviors()
    {
        return [
            [
                'class' => TwittableBehavior::className(),
                'consumerKey' => 'TWITTER_CONSUMER_KEY',
                'consumerSecret' => 'TWITTER_SECRET_KEY',
                'accessToken' => 'TWITTER_ACCESS_TOKEN',
                'accessTokenSecret' => 'TWITTER_SECRET_TOKEN',
                'autoPosting' => true,
            ],
        ];
    }
}

Usage

Everything is working automatically right now. When you are creating new model - it's instantly adding a tweet.

Todo

• Limit tags count (recomended max 3 tags per tweet)
• Configurable autoposting feature
• Configuring what to post: message, tags, url
• Handle twitter errors
• Manual posting of tweets if tweet isn't exist
• Tweets deletion
• Support Twitter cards