README

此插件为您在Craft安装中创建端点，以便您可以使用Instagram基本显示API以及oEmbed API。它还提供了一些辅助方法来处理您的访问令牌和获取刷新令牌。

要求

此插件需要Craft CMS 3.0.0-beta.23或更高版本。

安装

要安装插件，请按照以下说明操作。

打开您的终端并转到您的Craft项目
```
 cd /path/to/project
```

然后告诉Composer加载插件

 composer require melvilleco/instagram-basic-display

从Instagram获取长期访问令牌（请参阅下面的示例视频）并将其插入到您的数据库中。

如何获取Instagram基本显示API的初始访问令牌 - 观看视频

68747470733a2f2f63646e2e6c6f6f6d2e636f6d2f73657373696f6e732f7468756d626e61696c732f36383763633435363735396434666238393737323037356237376366363465312d776974682d706c61792e676966

Instagram基本显示概述

此插件提供了一些辅助方法和端点，用于处理Instagram基本显示API和Instagram OEmbed服务。

插件提供了一些有用的控制台命令和控制器操作，以帮助您访问您的Instagram内容。

配置

配置通过src/config.php配置文件完成。应将其重命名为instagram-basic-display.php并复制到您的config/目录以生效。

您可能想要更改的最有可能的选项是cache_duration和fields。fields仅确定请求返回的数据。

插入您的访问令牌

默认情况下，Instagram用户访问令牌是短期的，有效期为1小时。然而，短期令牌可以交换为长期令牌。

长期令牌有效期为60天，只要它们至少24小时但尚未过期，并且应用程序用户已授予您的应用程序instagram_graph_user_profile权限，就可以刷新。

获取您的长期令牌后，运行以下命令将其插入到您的数据库中

  ./craft instagram-basic-display/token/insert [YOUR_TOKEN_HERE]

刷新您的令牌

由于长期令牌仅有效期为60天，您需要定期请求刷新令牌。您可以通过设置一个调用插件刷新方法的cron任务轻松做到这一点

  ./craft instagram-basic-display/token/refresh

您的旧令牌将用于获取新令牌，并将新令牌插入到数据库中。

命令和端点

控制台命令

以下可用的控制台命令：

获取当前令牌的过期日期/时间

  ./craft instagram-basic-display/token/exp

输出当前访问令牌

  ./craft instagram-basic-display/token/get

手动将访问令牌插入数据库

  ./craft instagram-basic-display/token/insert

刷新当前令牌

  ./craft instagram-basic-display/token/refresh

以JSON格式访问您的Instagram动态

如果您从Vue或React组件内部访问您的动态，您可以点击以下端点以获取JSON响应

  /actions/instagram-basic-display/feed/get

在Twig中获取您的动态

您也可以使用{% for %}循环在您的Twig模板中输出您的动态

<ul>
   {% for media in craft.instagram.getFeed() %}
      {% if media.media_type == 'IMAGE' %}
         <li>
            <a href="{{ media.permalink }}">
               <img src="{{ media.media_url }}" alt="">
            </a>
         </li>
      {% endif %}
   {% endfor %}
</ul>

Instagram基本显示路线图

一些要做的事情和潜在功能的想法

添加OEmbed文档。
创建如何获取初始令牌的更好的文档。
解决图像缩放的解决方案。

由Jonathan Melville提供

melvilleco / instagram-basic-display

维护者

详细信息