README

描述

为开发者启用Instagram基本显示API。

插件的想法是使用Instagram基本显示PHP API，并通过WordPress管理面板获取访问令牌。

安装

• 推荐使用Composer

  composer require innocode-digital/wp-instagram
  

• 另一种方法是克隆此仓库到wp-content/plugins/

  cd wp-content/plugins/
  git clone git@github.com:innocode-digital/wp-instagram.git
  cd wp-instagram/
  composer install
  

使用WP-CLI wp plugin activate wp-instagram或在“插件”页面激活WordPress Instagram基本显示集成。

使用方法

1. 查看Facebook手册了解如何创建应用程序。

2. 添加所需的常量（通常添加到wp-config.php）

   define( 'INSTAGRAM_CLIENT_ID', '' );
   define( 'INSTAGRAM_CLIENT_SECRET', '' );
   

3. 将站点认证URL https://site.com/instagram/auth/ 添加到“基本显示”中的“有效的OAuth重定向URI”。

4. 在WordPress管理面板的设置页面中打开设置页 设置 -> Instagram /wp-admin/options-general.php?page=innocode-instagram

5. 点击“登录”按钮或在需要更改账户时点击“以其他用户登录”。

6. 通过innocode_instagram();函数开始使用Instagram基本显示PHP API，例如innocode_instagram()->getUserProfile();。

7. (可选) 在“基本显示”中的“注销回调URL”中设置站点注销REST API端点https://site.com/wp-json/innocode/v1/instagram/deauth。

注意

如果站点是多站点的一部分，则主站点的认证URL应添加到“有效的OAuth重定向URI”。因此，插件应在所有网络或至少在主站点上额外激活。

插件在授权后添加每日定时任务。请确保定时任务功能正常工作。令牌会在过期前3天尝试更新，用户资料数据每日更新。

文档

默认情况下，端点认证URL使用“instagram”作为端点，但可以通过常量进行更改

define( 'INNOCODE_INSTAGRAM_ENDPOINT', 'insta' );

应用站点

如果您想为所有使用Instagram集成的站点使用一个应用程序，并且正确处理注销过程，则可以在将存储用户ID和这些ID所使用的站点URL的站点（例如，可以是您的公司网站）上安装此插件作为附加插件。然后需要在所有激活了插件的站点上设置一个额外的常量。

define( 'INNOCODE_INSTAGRAM_APP_SITE', 'https://app-site.com' );

可以更改完整的认证URL

add_filter( 'innocode_instagram_redirect_uri', function ( string $url ) {
    return $url;
} );

可以更改Instagram权限

add_filter( 'innocode_instagram_scope', function ( array $scope ) {
    return $scope; // Default is array containing 'user_profile' and 'user_media'.
} );

可以更改与认证请求一起发送的状态参数

add_filter( 'innocode_instagram_state', function ( string $state ) {
    return $scope; // Default is string in format '$blog_id:$nonce'.
} );

可以更改端点应添加的位置

add_filter( 'innocode_instagram_endpoint_mask', function ( $mask, $endpoint ) {
    return $mask; // Default is EP_ROOT constant.
}, 10, 2 );