yogigr/wpthemeapi

一个用于通过 Envato API 浏览 WordPress 主题的包。此包允许您轻松搜索、过滤并获取 Envato 上 WordPress 主题的信息,简化了寻找适合您网站的完美主题的过程。

1.0.0 2024-07-06 17:41 UTC

This package is auto-updated.

Last update: 2024-09-06 18:06:57 UTC


README

一个用于通过 Envato API 浏览 WordPress 主题的 Laravel 包。此包允许您轻松搜索、过滤并获取 Envato 上 WordPress 主题的信息,简化了寻找适合您网站的完美主题的过程。

安装

要安装 WpThemeApi 包,请按照以下步骤操作

  1. 通过 Composer 需求包

    在您的 Laravel 项目目录中运行以下命令

    composer require yogigr/wpthemeapi
  2. 发布配置文件

    使用以下命令发布配置文件

    php artisan vendor:publish --provider="yogigr\WpThemeApi\Providers\WpThemeApiServiceProvider"
  3. 设置环境变量

    将您的 Envato API 令牌添加到 .env 文件中

     ENVATO_TOKEN=your-envato-api-token

用法

安装后,您可以通过提供的 Facade 使用此包。以下是获取类别和项目的示例。

获取类别

获取 WordPress 主题类别

use yogigr\WpThemeApi\Facades\WpThemeApi;

$categories = WpThemeApi::categories();

foreach ($categories as $category) {
    echo $category['name'] . ' - ' . $category['path'] . PHP_EOL;
}

`categories` 参数

  • `string $path` : 类别的路径过滤器。默认为 "wordpress/"。只有包含此路径的类别会被返回。

获取项目

获取项目

use yogigr\WpThemeApi\Facades\WpThemeApi;

$items = WpThemeApi::items();

foreach ($items['themes'] as $item) {
    echo $item['name'] . ' - ' . $item['price_cents'] / 100 . ' USD' . PHP_EOL;
}

`items` 参数

  • `string $category` : 要获取的项目类别。默认为 "wordpress"。
  • `string $sortBy` : 对项目进行排序的属性。按以下之一排序:"relevance","rating","sales","price","date","updated","category","name","trending","featured_until"。默认为 "sales"。
  • `string $sortDir` : 排序方向("asc" 为升序,"desc" 为降序)。默认为 "desc"。
  • `int $perPage` : 每页获取的项目数。默认为 10。
  • `int $page` : 要获取的页面数。默认为 1。