README

WACK Cloudinary 是一个WordPress插件，用于将媒体文件上传到Cloudinary。

它通过WordPress的 wp_handle_upload 钩子，当上传媒体文件时，它也会将文件上传到Cloudinary。

它旨在与WACK Stack一起使用，但也可用于其他WordPress安装。

重要

此插件不会替换内容中的媒体URL或媒体库中的URL。这意味着您必须手动替换URL以将媒体显示给用户。

安装

需要PHP 8.1或更高版本
需要WordPress 6.0或更高版本
需要Composer

使用Composer

composer require kodansha/wack-cloudinary

注意

此插件在WordPress.org插件库中不可用。目前，唯一安装方法是使用Composer。

如何使用

先决条件

您需要设置Cloudinary账户并在环境变量中设置凭据设置环境变量。

export CLOUDINARY_URL=cloudinary://<api_key>:<api_secret>@<cloud_name>

提示

强烈建议使用 .env 文件来设置环境变量，尤其是在本地开发环境中。

配置

您可能想通过 WACK_CLOUDINARY_SETTINGS 常量定义设置

define('WACK_CLOUDINARY_SETTINGS', [
    // Optional: The type of the Cloudinary media access. Possible values are 'authenticated', 'upload', 'private'
    // Default: 'upload'
    'type' => 'private',

    // Optional: The Cloudinary root folder to upload the media files.
    // Default: none
    'root_folder' => 'my-root-folder',

    // Optional: The notification URL endpoint to receive the Cloudinary notifications.
    // Default: none
    'notification_url' => 'https://example.com/cloudinary-notification',

    // Optional: The username and password for the basic authentication.
    // If your WordPress is behind the basic authentication, you need to set this to work the async requests.
    // Default: none
    'basic_auth' => [
        'username' => 'example-user',
        'password' => 'example-password',
    ]
]);

上传媒体文件

在设置上述先决条件和配置之后，当您将媒体文件上传到WordPress时，该文件也会被上传到Cloudinary。

待办事项

支持视频上传
支持急切转换
支持上传预设

kodansha / wack-cloudinary

维护者

详细信息