README

WordPress 插件，用于获取 Instagram 用户动态的最新图片。

基本上，此插件从 Instagram 获取图片，将其保存到临时文件中，后续请求将从那里提供。临时文件过期并删除后，将再次从 Instagram 获取新内容并保存到临时文件中。这实现了非常简单的缓存。

在芬兰创意数字机构 Digitoimisto Dude Oy 的精心打造下，该公司位于约维斯库市中心。

注意！

已弃用！Instagram 加强了 API 使用后，此插件的效果不佳。更好的选择是 Jake Peterson 的插件 ig-graph-feed 或我们自己的 image-user-feed，后者绕过了官方 API。

使用前请注意

此插件并非针对所有人，要将其添加到您的网站并使其看起来美观，您至少需要具备一些基本的 php 和 css 知识。

这是一个处于开发阶段的插件，因此它可能会非常频繁地更新。

许可证

Dude insta feed 在 GNU GPL 2 或更高版本下发布。

法律

请阅读 Instagram 的 TOC，以确定您是否可以使用图片以及可能存在的限制。

用法

此插件没有设置页面或在前端提供任何可见内容。因此，如果您不使用以下列表中列出的任何过滤器，它基本上是一个无用的插件。

必须使用的唯一过滤器是 dude-insta-feed/access_token/user=$userid。

通过调用函数 dude_insta_feed()->get_user_images() 获取图片，将用户 ID 作为唯一参数传递。用户 ID 可以使用此工具获取。

显示用户动态的用法示例

前往 instagram.com/developer 并为您的 WordPress 网站注册一个应用程序。 请注意，应用程序必须使用您想要提取图片的精确用户账户进行注册！
禁用隐式 OAuth2，以便进行下一步操作。
通过访问此 URL 并将您的 CLIENT ID 和 REDIRECT URIs 添加到相应的位置并点击授权来生成访问令牌。
重新启用隐式 OAuth2。
在以下URL中获取#access_token=后的代码，并将其片段添加到functions.php文件中。您的用户ID位于访问令牌的开始处，就在点号之前。

/**
 * Dude Instagram hashtag feed.
 */
add_filter( 'dude-insta-feed/access_token/user=USERID_HERE', function() { return 'ACCESS_TOKEN_HERE'; } );

将此循环添加到您想要显示图像的位置。

<?php
$instagram_feed = dude_insta_feed()->get_user_images( 'USERID_HERE' );
foreach ($instagram_feed['data'] as $item) : ?>
    <img src="<?php echo $item['images']['standard_resolution']['url']; ?>" alt="" />
<?php endforeach; ?>

限制动态内容条目

/**
 * Limit Instagram feed items
 */
add_filter( 'dude-insta-feed/user_images_parameters', function( $parameters ) {
  $parameters['count'] = '6';
  return $parameters;
} );

钩子

所有设置都通过过滤器进行设置，还有一些过滤器可以更改基本功能并在缓存之前操作数据。

`dude-insta-feed/access_token/user=$userid`

由于Instagram API的限制，每个用户都需要自己的访问令牌。访问令牌可以按照此说明生成。

为特定用户设置访问令牌。传递的参数是默认访问令牌和用户ID。

默认为空字符串。

`dude-insta-feed/user_images_transient`

更改用户图像的短暂名称，对于每个用户必须是唯一的。传递的参数是默认名称和用户ID。

默认为dude-insta-user-$userid。

`dude-insta-feed/user_images_parameters`

修改API调用参数，例如图像数量。仅传递默认参数的数组。

默认为为用户定义的访问令牌和五个图像数量。

`dude-insta-feed/user_images`

在将其缓存到短暂存储之前操作或使用数据。仅传递图像的数组。

`dude-insta-feed/user_images_lifetime`

更改图像缓存生存期。仅传递默认生存期（以秒为单位）。

默认为600（=十分钟）。

Composer

要使用Composer，请在项目目录中运行composer require digitoimistodude/dude-insta-feed dev-master或将其添加到composer.json的require部分："digitoimistodude/dude-insta-feed":"dev-master"。

贡献

如果您对插件有任何想法或发现任何问题，请告诉我们。在贡献想法或报告有关“缺失”功能或该问题性质的问题之前，请阅读请注意部分。非常感谢。

digitoimistodude / dude-insta-feed

维护者

详细信息