nirvana-msu/yii2-instafeed

This package is abandoned and no longer maintained. No replacement package was suggested.

Yii2 extension for instafeed Instagram javascript plugin

Installs: 1 248

Dependents: 0

Suggesters: 0

Security: 0

Stars: 7

Watchers: 2

Forks: 3

Open Issues: 2

Type:yii2-extension

dev-master / 1.0.x-dev 2016-07-29 22:22 UTC

This package is not auto-updated.

Last update: 2021-11-27 03:52:29 UTC


README

Yii2 extension for instafeed Instagram javascript plugin, providing a simple way to add Instagram photos to your website.

This widget publishes assets and registers necessary code to run plugin. It also optionally renders a div container that plugin would automatically look for, to fill with thumbnails. You can control the name of a created javascript plugin variable by configuring widget id.

Resources

Installation

Composer

Add extension to your composer.json and update your dependencies as usual, e.g. by running composer update

{
    "require": {
        "nirvana-msu/yii2-instafeed": "1.0.*@dev"
    }
}

##Widget Configuration

  • $renderThumbnailDiv boolean whether to render <div id="instafeed"></div> container that plugin would look for by default
  • $pluginOptions array instafeed javascript plugin options. For more information refer to instafeed documentation

##Sample Usage

The only thing you have to configure are plugin option. For example, to fetch images from your account, set the get, userId and accessToken options:

echo Instafeed::widget([
    'pluginOptions' => [
        'get' => 'user',
        'userId' => 'YOUR_USER_ID',     // your Instagram account id, not username!
        'accessToken' => 'YOUR_ACCESS_TOKEN',
    ],
]);

If, for convenience, you prefer to store application-wide configuration such as access token(s), client id(s) and user id(s) in an application component, you may find InstafeedConfig class useful, for example:

In an application config:

'components' => [
    'instafeedConfig' => [
        'class' => InstafeedConfig::className(),
        'userId' => 'YOUR_USER_ID',
        'accessToken' => 'YOUR_ACCESS_TOKEN',
    ],
],

In a view:

$config = Yii::$app->instafeedConfig;
echo Instafeed::widget([
    'pluginOptions' => [
        'get' => 'user',
        'userId' => $config->userId,
        'accessToken' => $config->accessToken,
    ],
]);

##License

Extension is released under MIT license.