Laravel Unsplash

https://github.com/marksitko/laravel-unsplash
Admin
Provides a fluent API to integrate Unsplash into Laravel applications, allowing users to access...
Tokens:35,492
Snippets:439
Trust Score:6.4
License:MIT
Update:2 months ago
Show doc for...
Tokens:
Raw
### Usage Examples for showTopicPhotos

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/topic-endpoints.md

Examples demonstrating how to fetch and paginate photos within a topic, including sorting options.

```php
// Get all photos in topic
$photos = Unsplash::showTopicPhotos('nature')->toJson();

// Get paginated topic photos
$photos = Unsplash::showTopicPhotos('nature')
    ->page(1)
    ->perPage(25)
    ->toArray();

// Get sorted topic photos
$photos = Unsplash::showTopicPhotos('technology')
    ->orderBy('latest')
    ->toCollection();

// Browse topic photos with different sort orders
$popular = Unsplash::showTopicPhotos('travel')
    ->orderBy('popular')
    ->perPage(10)
    ->toArray();

$latest = Unsplash::showTopicPhotos('travel')
    ->orderBy('latest')
    ->perPage(10)
    ->toArray();
```

--------------------------------

### Usage Examples for showTopic

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/topic-endpoints.md

Examples demonstrating how to retrieve a topic by ID or slug and access the response.

```php
// Get topic by ID
$topic = Unsplash::showTopic('bjNq-L3cgkg')->toJson();
echo $topic->title;
echo $topic->description;

// Get topic by slug
$topic = Unsplash::showTopic('nature')->toArray();

// Get response object
$response = Unsplash::showTopic('technology')->get();
```

--------------------------------

### Usage Examples for topicsList

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/topic-endpoints.md

Examples demonstrating how to fetch topics and format the output as JSON, array, or Laravel Collection.

```php
// Get first page of topics
$topics = Unsplash::topicsList()->toJson();

// Get specific page with custom count
$topics = Unsplash::topicsList()
    ->page(2)
    ->perPage(20)
    ->toArray();

// Get as Laravel Collection
$topicsData = Unsplash::topicsList()
    ->page(1)
    ->perPage(15)
    ->toCollection();
```

--------------------------------

### Database Migration Setup

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/has-unsplashables-trait.md

Commands to publish and run the necessary database migrations.

```bash
php artisan vendor:publish --tag=migrations
php artisan migrate
```

--------------------------------

### Pagination Usage Examples

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/query-builder.md

Examples of chaining pagination methods to API requests.

```php
$photos = Unsplash::photos()->page(2)->toArray();
$users = Unsplash::searchUsers()->query('john')->page(3)->toArray();
```

```php
$photos = Unsplash::photos()->perPage(20)->toArray();
$collections = Unsplash::collectionsList()->page(1)->perPage(15)->toArray();
```

--------------------------------

### Sorting Usage Examples

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/query-builder.md

Examples of applying sort orders to photo requests.

```php
$photos = Unsplash::photos()->orderBy('popular')->toArray();
$userPhotos = Unsplash::userPhotos('john_doe')->orderBy('latest')->toArray();
```

--------------------------------

### User Search Examples

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/search-endpoints.md

Demonstrates basic and paginated user searches, as well as retrieving specific user records.

```php
// Basic user search
$results = Unsplash::searchUsers()
    ->query('john')
    ->toJson();

// Paginated user search
$results = Unsplash::searchUsers()
    ->query('photographer')
    ->page(1)
    ->perPage(10)
    ->toArray();

// Access user list
$results = Unsplash::searchUsers()
    ->query('designer')
    ->toCollection();

// Find specific user
$users = Unsplash::searchUsers()
    ->query('john_doe')
    ->toArray();
if (!empty($users['results'])) {
    $user = $users['results'][0];
}
```

--------------------------------

### Complete Unsplash Asset Implementation

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-asset-model.md

A full example demonstrating storing, associating, and retrieving asset metadata and attribution links.

```php
class PhotoGallery {
    /**
     * Store a random photo and associate with user
     */
    public function storeRandomForUser($userId) {
        // Get and store random photo
        $asset = Unsplash::randomPhoto()
            ->orientation('landscape')
            ->store(null, 'regular');
        
        // Associate with user
        User::find($userId)->unsplash()->attach($asset);
        
        return $asset;
    }
    
    /**
     * Get user's stored photos with copyright info
     */
    public function getUserPhotos($userId) {
        $user = User::with('unsplash')->find($userId);
        
        return $user->unsplash()->get()->map(function($asset) {
            return [
                'id' => $asset->id,
                'filename' => $asset->name,
                'author' => $asset->author,
                'copyright' => $asset->getFullCopyrightLink(),
                'unsplash_id' => $asset->unsplash_id,
                'created_at' => $asset->created_at,
            ];
        });
    }
    
    /**
     * Display photo with attribution
     */
    public function displayPhoto($assetId) {
        $asset = UnsplashAsset::find($assetId);
        
        return [
            'image_path' => asset('storage/' . $asset->name),
            'attribution' => $asset->getFullCopyrightLink(),
            'author' => $asset->author,
        ];
    }
}
```

--------------------------------

### Usage of assets() Method

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-asset-model.md

Example of retrieving associated models for a specific UnsplashAsset instance.

```php
$asset = UnsplashAsset::find(1);
$userAssets = $asset->assets(User::class);
```

--------------------------------

### Usage of api() Method

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-asset-model.md

Examples of using the static api() method to interact with the Unsplash service.

```php
// Get random photo and store it
$asset = UnsplashAsset::api()
    ->randomPhoto()
    ->store();

// Search and store
$asset = UnsplashAsset::api()
    ->search()
    ->query('nature')
    ->perPage(1)
    ->toArray();

// Get specific photo
$photo = UnsplashAsset::api()
    ->photo('photo-id')
    ->toJson();
```

--------------------------------

### Install Laravel-Unsplash via Composer

Source: https://github.com/marksitko/laravel-unsplash/blob/master/README.md

Run this command in your terminal to add the package to your project.

```bash
$ composer require marksitko/laravel-unsplash
```

--------------------------------

### Collection Search Examples

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/search-endpoints.md

Demonstrates basic and paginated collection searches, including accessing total result counts.

```php
// Basic collection search
$results = Unsplash::searchCollections()
    ->query('travel')
    ->toJson();

// Paginated collection search
$results = Unsplash::searchCollections()
    ->query('events')
    ->page(1)
    ->perPage(15)
    ->toArray();

// Access total results
$results = Unsplash::searchCollections()
    ->query('architecture')
    ->toArray();
echo $results['total']; // Total matching collections
```

--------------------------------

### Complete Error Handling Implementation

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/errors.md

A comprehensive example demonstrating how to handle specific exceptions, network errors, and status codes within a service class.

```php
class PhotoService {
    public function getRandomPhoto() {
        try {
            // Attempt to fetch and store
            return Unsplash::randomPhoto()
                ->orientation('landscape')
                ->store();
                
        } catch (Exception $e) {
            // Log the error
            logger()->error('Failed to fetch photo: ' . $e->getMessage());
            
            // Handle specific errors
            if (strpos($e->getMessage(), 'urls') !== false) {
                logger()->error('Invalid response format');
            } else if (strpos($e->getMessage(), 'access key') !== false) {
                logger()->error('Configuration error - API key missing');
            }
            
            // Return null or fallback
            return null;
        }
    }
    
    public function getPhotos($query) {
        try {
            return Unsplash::search()
                ->query($query)
                ->toArray();
                
        } catch (\GuzzleHttp\Exception\ClientException $e) {
            if ($e->getResponse()->getStatusCode() === 404) {
                logger()->info('No results found for query: ' . $query);
                return ['results' => []];
            }
            throw $e;
            
        } catch (\GuzzleHttp\Exception\ConnectException $e) {
            logger()->error('Network error - Unsplash unreachable');
            return [];
        }
    }
}
```

--------------------------------

### Portfolio Object JSON Response

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/user-endpoints.md

Example structure of a portfolio object.

```json
{
  "url": "https://example.com"
}
```

--------------------------------

### Using Unsplash Facade in Controllers

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/facade.md

Examples of using the Unsplash facade for searching, fetching featured collections, and storing photos within controller methods.

```php
use MarkSitko"]: "LaravelUnsplash\\Facades\\Unsplash;

class PhotoController extends Controller {
    public function search(Request $request) {
        $query = $request->input('q');
        
        $results = Unsplash::search()
            ->query($query)
            ->page($request->input('page', 1))
            ->perPage(20)
            ->toArray();
        
        return view('photos.search', ['results' => $results]);
    }
    
    public function getFeatured() {
        $featured = Unsplash::featuredCollection()
            ->perPage(12)
            ->toArray();
        
        return view('photos.featured', ['photos' => $featured]);
    }
    
    public function storePhoto($photoId) {
        $asset = Unsplash::photo($photoId)->store();
        
        return response()->json(['success' => true, 'asset_id' => $asset->id]);
    }
}
```

--------------------------------

### Photo Search Examples

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/search-endpoints.md

Demonstrates basic, filtered, and paginated photo searches, as well as accessing result metadata.

```php
// Basic photo search
$results = Unsplash::search()
    ->query('nature')
    ->toJson();

// Search with filters
$results = Unsplash::search()
    ->query('buildings')
    ->color('black_and_white')
    ->orientation('squarish')
    ->toArray();

// Paginated search results
$results = Unsplash::search()
    ->query('mountains')
    ->page(2)
    ->perPage(20)
    ->toCollection();

// Access total count
$results = Unsplash::search()
    ->query('landscape')
    ->toArray();
echo $results['total']; // Total number of matching photos
echo count($results['results']); // Photos in current page
```

--------------------------------

### get()

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-client.md

Executes the built API call and returns the full Guzzle HTTP response object.

```APIDOC
## get()

### Description
Executes the built API call and returns the full HTTP response object.

### Method
public function get(): \GuzzleHttp\Psr7\Response

### Return Type
\GuzzleHttp\Psr7\Response - Guzzle HTTP response object

### Example
```php
$response = Unsplash::randomPhoto()->get();
$statusCode = $response->getStatusCode();
```
```

--------------------------------

### Get Photos from Collection and Store

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/collection-endpoints.md

Fetches photos from a specific collection and stores them locally.

```php
$collection = Unsplash::showCollection('collection-123')->toArray();
echo "Collection: " . $collection['title'];

$photos = Unsplash::showCollectionPhotos('collection-123')
    ->perPage(5)
    ->toArray();

foreach ($photos as $photo) {
    $filename = Unsplash::photo($photo['id'])
        ->store($photo['user']['username'] . '-' . $photo['id']);
    echo "Stored: " . $filename;
}
```

--------------------------------

### Perform HTTP GET Request

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/http-client.md

Execute a GET request to the Unsplash API using the client.

```php
$response = $this->client->get('photos?page=1&per_page=10');
```

--------------------------------

### Get Platform Statistics

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/README.md

Retrieve total or monthly statistics for the Unsplash platform.

```php
$total = Unsplash::totalStats()->toArray();
$monthly = Unsplash::monthlyStats()->toJson();
```

--------------------------------

### Track Photo Download Examples

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/photo-endpoints.md

Demonstrates various ways to invoke the trackPhotoDownload method, including chaining to JSON, array, or response object formats.

```php
// Track photo download
$result = Unsplash::trackPhotoDownload('photo-id')->toJson();

// Track download and log result
$tracking = Unsplash::trackPhotoDownload('photo-id')->toArray();
if (isset($tracking['url'])) {
    // Download tracked successfully
}

// In an application context - track when user downloads
Unsplash::trackPhotoDownload($photoId)->get();
// Then proceed with your download logic

// Get response status
$response = Unsplash::trackPhotoDownload('photo-id')->get();
$statusCode = $response->getStatusCode();
```

--------------------------------

### Usage of getFullCopyrightLink() Method

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-asset-model.md

Examples of using the copyright link generator in PHP and Blade templates.

```php
$asset = UnsplashAsset::find(1);
$copyright = $asset->getFullCopyrightLink();
echo $copyright;
// Output: Photo by <a target='_blank' href='https://unsplash.com/@john_doe'>John Doe</a> on <a target='_blank' href='https://unsplash.com/'>Unsplash</a>

// In a Blade template
<div class="photo-credits">
    {!! $asset->getFullCopyrightLink() !!}
</div>
```

--------------------------------

### Handle Invalid Photo Size Keys

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/errors.md

Examples of invalid and valid keys passed to the store() method.

```php
// WRONG - Invalid key
$file = Unsplash::randomPhoto()->store(null, 'medium'); // Exception!
$file = Unsplash::randomPhoto()->store(null, 'large'); // Exception!

// CORRECT - Valid key
$file = Unsplash::randomPhoto()->store(null, 'small'); // OK
$file = Unsplash::randomPhoto()->store(null, 'full'); // OK
```

--------------------------------

### User Profile JSON Response

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/user-endpoints.md

Example structure of a user profile object returned by the API.

```json
{
  "id": "user-id",
  "username": "john_doe",
  "name": "John Doe",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john@example.com",
  "portfolio_url": "https://example.com",
  "bio": "Photography enthusiast",
  "location": "San Francisco, CA",
  "total_likes": 500,
  "total_photos": 50,
  "total_collections": 5,
  "links": {
    "html": "https://unsplash.com/@john_doe"
  }
}
```

--------------------------------

### Get Latest Photos from a Topic

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/topic-endpoints.md

Fetches the latest photos for a specific topic slug with pagination.

```php
$photos = Unsplash::showTopicPhotos('nature')
    ->orderBy('latest')
    ->page(1)
    ->perPage(10)
    ->toArray();

foreach ($photos as $photo) {
    echo $photo['user']['name'] . " - " . $photo['likes'] . " likes";
}
```

--------------------------------

### Find Users and Get Their Profiles

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/search-endpoints.md

Search for users by query and iterate through results to fetch individual user profiles.

```php
$userResults = Unsplash::searchUsers()
    ->query('photographer')
    ->toArray();

foreach ($userResults['results'] as $user) {
    $profile = Unsplash::user($user['username'])->toArray();
    echo $profile['name'] . " - " . $profile['bio'];
}
```

--------------------------------

### Comparing Facade, Direct, and Container Usage

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/facade.md

Shows the three equivalent ways to instantiate and use the Unsplash service.

```php
use MarkSitko"]: "LaravelUnsplash\\Facades\\Unsplash;

$photos = Unsplash::photos()->toArray();
```

```php
use MarkSitko"]: "LaravelUnsplash\\Unsplash;

$unsplash = new Unsplash();
$photos = $unsplash->photos()->toArray();
```

```php
use MarkSitko"]: "LaravelUnsplash\\Unsplash;

$unsplash = app(Unsplash::class);
$photos = $unsplash->photos()->toArray();
```

--------------------------------

### Publish and Run Migrations

Source: https://github.com/marksitko/laravel-unsplash/blob/master/README.md

Commands to prepare the database for storing Unsplash image metadata.

```bash
$ php artisan vendor:publish --tag=migrations
```

```bash
$ php artisan migrate
```

--------------------------------

### Random Photo Filter Usage Examples

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/query-builder.md

Examples of filtering random photo requests by collection, feature status, or username.

```php
$photo = Unsplash::randomPhoto()
    ->collections('abc123,def456')
    ->toJson();
```

```php
$photo = Unsplash::randomPhoto()->featured(true)->toJson();
$featuredPhotos = Unsplash::randomPhoto()->featured('true')->count(5)->toArray();
```

```php
$photo = Unsplash::randomPhoto()->username('john_doe')->toJson();
```

--------------------------------

### Publish and Run Migrations

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/configuration.md

Commands to prepare the database for storing photo metadata and relationships.

```bash
# Publish migrations
php artisan vendor:publish --tag=migrations

# Run migrations
php artisan migrate
```

--------------------------------

### Publishing Configuration and Migrations

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/service-provider.md

Commands to publish the package configuration and migration files to the application directory.

```bash
php artisan vendor:publish --tag=config
```

```bash
php artisan vendor:publish --tag=migrations
```

--------------------------------

### Initialize HttpClient

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/http-client.md

Instantiate the HttpClient to prepare for API requests.

```php
$client = new HttpClient();
// Ready to make API requests
```

--------------------------------

### Using the Fluent Interface

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-client.md

Shows how to chain query methods to build requests for the Unsplash API.

```php
$result = Unsplash::randomPhoto()
    ->orientation('portrait')
    ->term('nature')
    ->count(5)
    ->toJson();
```

--------------------------------

### Initialize Unsplash Client

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-client.md

Instantiate the client to begin making API requests.

```php
$unsplash = new Unsplash();
```

--------------------------------

### Configure Environment Variable

Source: https://github.com/marksitko/laravel-unsplash/blob/master/README.md

Enable database storage for Unsplash assets in the .env file.

```text
UNSPLASH_STORE_IN_DATABASE=true
```

--------------------------------

### Publishing Configuration

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/errors.md

Use the artisan command to publish the configuration file if default settings are insufficient.

```bash
// Without publishing, uses defaults:
// access_key: from env('UNSPLASH_ACCESS_KEY')
// store_in_database: false
// disk: 'local'

// Publish to customize:
php artisan vendor:publish --tag=config
```

--------------------------------

### Configure Optional Unsplash Settings

Source: https://github.com/marksitko/laravel-unsplash/blob/master/README.md

Define database storage and disk settings in the .env file.

```text
# default is false
UNSPLASH_STORE_IN_DATABASE=BOOLEAN

# default is local
UNSPLASH_STORAGE_DISK=YOUR_STORAGE_DISC
```

--------------------------------

### Accessing the Unsplash Client

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-client.md

Demonstrates how to resolve the Unsplash client from the service container or use the provided facade.

```php
// Accessing via service container
$unsplash = app(Unsplash::class);

// Accessing via facade
$unsplash = Unsplash::randomPhoto()->toJson();
```

--------------------------------

### Import Unsplash Facade

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/facade.md

Directly import the Unsplash facade class in your files.

```php
use MarkSitko\\\LaravelUnsplash\\\Facades\\\Unsplash;
```

--------------------------------

### Statistics Object JSON Response

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/user-endpoints.md

Example structure of a statistics object containing download, view, and like data.

```json
{
  "username": "john_doe",
  "downloads": {
    "total": 10000,
    "historical": {
      "change": 500,
      "average": 16.67
    }
  },
  "views": {
    "total": 100000,
    "historical": {
      "change": 5000,
      "average": 166.67
    }
  },
  "likes": {
    "total": 2000,
    "historical": {
      "change": 100,
      "average": 3.33
    }
  }
}
```

--------------------------------

### Running Database Migrations

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/service-provider.md

Executes the published migrations to create the necessary tables for database-backed asset storage.

```bash
php artisan migrate
```

--------------------------------

### Execute API Call and Get Response

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-client.md

Retrieve the raw Guzzle HTTP response object from an API call.

```php
$response = Unsplash::randomPhoto()->get();
$statusCode = $response->getStatusCode();
```

--------------------------------

### Configure Environment Variables

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/README.md

Add these keys to your .env file to authenticate and configure the Unsplash client.

```env
UNSPLASH_ACCESS_KEY=your_api_key_here
UNSPLASH_STORE_IN_DATABASE=false    # Optional, default: false
UNSPLASH_STORAGE_DISK=local          # Optional, default: local
```

--------------------------------

### Publish Configuration File

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/configuration.md

Command to publish the package configuration file to the application's config directory.

```bash
php artisan vendor:publish --tag=config
```

--------------------------------

### Configuring Unsplash Facade

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/facade.md

Define API credentials and storage settings in the config/unsplash.php file.

```php
// config/unsplash.php
return [
    'access_key' => env('UNSPLASH_ACCESS_KEY'),
    'store_in_database' => env('UNSPLASH_STORE_IN_DATABASE', false),
    'disk' => env('UNSPLASH_STORAGE_DISK', 'local'),
];
```

--------------------------------

### Register Facade

Source: https://github.com/marksitko/laravel-unsplash/blob/master/README.md

Add the facade alias to the aliases array in config/app.php if package discovery is not used.

```php
'aliases' => [
    //...
    'Unsplash' => MarkSitko\LaravelUnsplash\Facades\Unsplash::class,
];
```

--------------------------------

### Interact with UnsplashAsset Model

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/README.md

Demonstrates retrieving stored assets, generating copyright links, and fetching new photos via the API client.

```php
use MarkSitko\LaravelUnsplash\Models\UnsplashAsset;

// Find stored photos
$assets = UnsplashAsset::all();
$asset = UnsplashAsset::find(1);

// Get copyright HTML
echo $asset->getFullCopyrightLink();

// Create new Unsplash API client
$unsplash = UnsplashAsset::api();
$photo = $unsplash->randomPhoto()->store();
```

--------------------------------

### Creating UnsplashAsset Records

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-asset-model.md

Demonstrates different methods for creating and storing UnsplashAsset instances.

```php
// Store a random photo in database
$asset = Unsplash::randomPhoto()->store();

// $asset is a UnsplashAsset instance with:
// - id: 1
// - unsplash_id: 'unsplash-photo-id'
// - name: 'random-filename.jpg'
// - author: 'John Doe'
// - author_link: 'https://unsplash.com/@john_doe'
```

```php
$asset = UnsplashAsset::create([
    'unsplash_id' => 'photo-id',
    'name' => 'stored-photo.jpg',
    'author' => 'John Doe',
    'author_link' => 'https://unsplash.com/@john_doe',
]);
```

```php
$asset = new UnsplashAsset();
$asset->unsplash_id = 'photo-id';
$asset->name = 'stored-photo.jpg';
$asset->author = 'John Doe';
$asset->author_link = 'https://unsplash.com/@john_doe';
$asset->save();
```

--------------------------------

### Publish Migrations

Source: https://github.com/marksitko/laravel-unsplash/blob/master/README.md

Publish the migration files if you intend to use the database connector.

```bash
$ php artisan vendor:publish --tag=migrations
```

--------------------------------

### Define api() Static Method

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-asset-model.md

Method signature for initializing the Unsplash API client.

```php
public static function api(): Unsplash
```

--------------------------------

### Configure Environment Variables

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/configuration.md

Environment variable definitions for different deployment stages.

```env
# Required
UNSPLASH_ACCESS_KEY=your_api_key_from_unsplash

# Optional (defaults shown)
UNSPLASH_STORE_IN_DATABASE=false
UNSPLASH_STORAGE_DISK=local
```

```env
# .env.local
UNSPLASH_ACCESS_KEY=dev_api_key
UNSPLASH_STORE_IN_DATABASE=true
UNSPLASH_STORAGE_DISK=local
```

```env
# .env.production
UNSPLASH_ACCESS_KEY=prod_api_key_with_higher_limits
UNSPLASH_STORE_IN_DATABASE=true
UNSPLASH_STORAGE_DISK=s3
```

```env
# .env.testing
UNSPLASH_ACCESS_KEY=test_api_key
UNSPLASH_STORE_IN_DATABASE=false
UNSPLASH_STORAGE_DISK=testing
```

--------------------------------

### Configuring Database Storage

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/service-provider.md

Environment variables to toggle database storage functionality for Unsplash assets.

```php
// Without database - just use the file storage
UNSPLASH_STORE_IN_DATABASE=false

// With database - store metadata and relationships
UNSPLASH_STORE_IN_DATABASE=true
```

--------------------------------

### Project File Structure

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/MANIFEST.md

Displays the directory layout of the documentation workspace.

```text
/workspace/home/output/
├── README.md                          (Master index)
├── MANIFEST.md                        (This file)
├── unsplash-client.md                 (Main client)
├── http-client.md                     (HTTP layer)
├── facade.md                          (Static interface)
├── photo-endpoints.md                 (Photo methods)
├── user-endpoints.md                  (User methods)
├── search-endpoints.md                (Search methods)
├── collection-endpoints.md            (Collection methods)
├── topic-endpoints.md                 (Topic methods)
├── stats-endpoints.md                 (Stats methods)
├── query-builder.md                   (Query parameters)
├── unsplash-asset-model.md            (Database model)
├── has-unsplashables-trait.md         (Relationships)
├── service-provider.md                (Package setup)
├── configuration.md                   (Config reference)
└── errors.md                          (Exception reference)
```

--------------------------------

### Handle Photo Storage Exceptions

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/errors.md

Demonstrates incorrect and correct usage of the store() method to avoid exceptions when retrieving multiple photos or invalid endpoints.

```php
// WRONG - Multiple photos returned
$photos = Unsplash::photos()->store(); // Exception!

// WRONG - Wrong endpoint
$stats = Unsplash::totalStats()->store(); // Exception!

// CORRECT - Single photo
$photo = Unsplash::photo('id')->store(); // OK

// CORRECT - Random single photo
$photo = Unsplash::randomPhoto()->store(); // OK
```

--------------------------------

### Access Configuration at Runtime

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/configuration.md

Methods for retrieving configuration values within the application.

```php
$accessKey = config('unsplash.access_key');
$storeInDb = config('unsplash.store_in_database');
$disk = config('unsplash.disk');
```

```php
class PhotoService {
    public function store() {
        $shouldStoreInDb = config('unsplash.store_in_database');
        
        if ($shouldStoreInDb) {
            // Database storage logic
        }
    }
}
```

```blade
@if(config('unsplash.store_in_database'))
    <p>Photos are stored with metadata</p>
@endif
```

--------------------------------

### Publish package assets via Artisan

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/service-provider.md

Commands to publish configuration and migration files to the Laravel application.

```bash
// Publish configuration
php artisan vendor:publish --tag=config

// Publish migrations
php artisan vendor:publish --tag=migrations

// Publish everything
php artisan vendor:publish --provider="MarkSitko\LaravelUnsplash\UnsplashServiceProvider"
```

--------------------------------

### Display File Organization

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/README.md

Visual representation of the package directory structure.

```text
src/
├── Unsplash.php                  # Main client class
├── UnsplashServiceProvider.php    # Service registration
├── API/
│   └── UnsplashAPI.php          # Endpoint trait collection
├── Endpoints/
│   ├── Photos.php               # Photo endpoints
│   ├── Users.php                # User endpoints
│   ├── Search.php               # Search endpoints
│   ├── Collections.php          # Collection endpoints
│   ├── Topics.php               # Topic endpoints
│   └── Stats.php                # Statistics endpoints
├── Facades/
│   └── Unsplash.php             # Static facade
├── Http/
│   └── HttpClient.php           # HTTP client
├── Models/
│   └── UnsplashAsset.php        # Database model
├── Queries/
│   └── QueryBuilder.php         # Query builder
└── Traits/
    └── HasUnsplashables.php     # Model relationship trait

config/
└── unsplash.php                 # Configuration file
```

--------------------------------

### Configure Package Discovery in composer.json

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/service-provider.md

Add the service provider and facade alias to the extra section of composer.json for automatic discovery.

```json
{
    "extra": {
        "laravel": {
            "providers": [
                "MarkSitko\\LaravelUnsplash\\UnsplashServiceProvider"
            ],
            "aliases": {
                "Unsplash": "MarkSitko\\LaravelUnsplash\\Facades\\Unsplash"
            }
        }
    }
}
```

--------------------------------

### Register Service Provider

Source: https://github.com/marksitko/laravel-unsplash/blob/master/README.md

Add the service provider to the providers array in config/app.php if package discovery is not used.

```php
'providers' => [
    //...
    MarkSitko\LaravelUnsplash\UnsplashServiceProvider::class,
];
```

--------------------------------

### Handle Invalid Photo Size Exception

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/README.md

Indicates an unsupported photo size key was requested.

```text
Exception: Your provided key "xyz" is an undefined accessor.
```

--------------------------------

### Accessing Endpoints via Magic Methods

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-client.md

Demonstrates how to access endpoint methods as properties to retrieve responses directly.

```php
// These are equivalent:
$response1 = Unsplash::photos()->get();
$response2 = Unsplash::photos;

// Return type is \GuzzleHttp\Psr7\Response
$status = Unsplash::photos->getStatusCode();
```

--------------------------------

### SDK Method Reference

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/README.md

Overview of available SDK methods for interacting with the Unsplash API.

```APIDOC
## SDK Methods

### Photos
- `photos()` - List all photos
- `photo($id)` - Get single photo
- `randomPhoto()` - Get random photo
- `photosStatistics($id)` - Get photo stats
- `trackPhotoDownload($id)` - Track download

### Users
- `user($username)` - Get user profile
- `userPortfolio($username)` - Get portfolio link
- `userPhotos($username)` - Get user's photos
- `userLikes($username)` - Get liked photos
- `userCollections($username)` - Get collections
- `userStatistics($username)` - Get user stats

### Search
- `search()` - Search photos
- `searchCollections()` - Search collections
- `searchUsers()` - Search users

### Collections
- `collectionsList()` - List all collections
- `featuredCollection()` - List featured
- `showCollection($id)` - Get collection
- `showCollectionPhotos($id)` - Get photos
- `showCollectionRelatedCollections($id)` - Related collections

### Topics
- `topicsList()` - List topics
- `showTopic($id)` - Get topic
- `showTopicPhotos($id)` - Get topic photos

### Stats
- `totalStats()` - Total platform stats
- `monthlyStats()` - Last 30 days stats
```

--------------------------------

### Configure Unsplash API Credentials

Source: https://github.com/marksitko/laravel-unsplash/blob/master/README.md

Set the required access key in the .env file.

```text
UNSPLASH_ACCESS_KEY=YOUR_GENERATED_API_KEY_FROM_UNSPLASH
```

--------------------------------

### Use UnsplashAsset Model

Source: https://github.com/marksitko/laravel-unsplash/blob/master/README.md

Interact with stored assets using the UnsplashAsset model.

```php
// Returns the created unsplash asset record
$databaseRecord = UnsplashAsset::api()->randomPhoto()->store();

// Get an stored unsplash asset
$unsplashAsset = UnsplashAsset::find($id);
```

--------------------------------

### View Class Hierarchy

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/http-client.md

Visual representation of the HttpClient inheritance structure.

```text
HttpClient (base HTTP functionality)
    ↓
Unsplash (adds API endpoints and response formatting)
    ↓ (uses traits)
UnsplashAPI (endpoint methods)
QueryBuilder (query parameter methods)
```

--------------------------------

### Retrieve User Portfolio Link

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/user-endpoints.md

Fetch the portfolio URL for a user and verify its existence.

```php
// Get user's portfolio link
$portfolio = Unsplash::userPortfolio('john_doe')->toJson();
echo $portfolio->url; // https://example.com

// Check if user has portfolio
$portfolioData = Unsplash::userPortfolio('john_doe')->toArray();
if (isset($portfolioData['url']) && !empty($portfolioData['url'])) {
    echo "User has a portfolio: " . $portfolioData['url'];
}
```

--------------------------------

### Debug Service Registration

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/service-provider.md

Commands to verify the service provider is registered and configuration is loaded correctly.

```bash
php artisan provider:list | grep Unsplash
```

```bash
php artisan tinker
>>> config('unsplash')
```

--------------------------------

### Store and Attach Photo to User

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/has-unsplashables-trait.md

Demonstrates fetching a random photo, storing it, and attaching it to the authenticated user.

```php
// Get random photo and store in database
$asset = Unsplash::randomPhoto()
    ->orientation('portrait')
    ->store();

// Attach to user
$user = Auth::user();
$user->unsplash()->attach($asset);
```

--------------------------------

### Explore Topics

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/README.md

List available topics or retrieve photos associated with a specific topic.

```php
$topics = Unsplash::topicsList()->toArray();
$topic = Unsplash::showTopic('nature')->toJson();
$photos = Unsplash::showTopicPhotos('nature')->orderBy('popular')->toArray();
```

--------------------------------

### HttpClient Constructor Signature

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/http-client.md

The constructor signature for initializing the HttpClient.

```php
public function __construct()
```

--------------------------------

### Define getFullCopyrightLink() Method

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-asset-model.md

Method signature for generating the copyright attribution string.

```php
public function getFullCopyrightLink(): string
```

--------------------------------

### __get()

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/unsplash-client.md

Allows accessing endpoint methods as properties, automatically invoking the method and returning the response.

```APIDOC
## __get($param)

### Description
Allows accessing endpoint methods as properties. Automatically calls the method and returns the complete response without needing to call `->get()`.

### Parameters
- **$param** (string) - Required - Method name to invoke

### Example
```php
// These are equivalent:
$response1 = Unsplash::photos()->get();
$response2 = Unsplash::photos;

// Return type is \GuzzleHttp\Psr7\Response
$status = Unsplash::photos->getStatusCode();
```
```

--------------------------------

### Create Collection Browser Class

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/collection-endpoints.md

Encapsulates collection retrieval logic within a custom class.

```php
class CollectionBrowser {
    public function browse($perPage = 10) {
        return Unsplash::collectionsList()
            ->perPage($perPage)
            ->toCollection();
    }
    
    public function getFeatured($page = 1) {
        return Unsplash::featuredCollection()
            ->page($page)
            ->toCollection();
    }
    
    public function getPhotos($collectionId, $perPage = 20) {
        return Unsplash::showCollectionPhotos($collectionId)
            ->perPage($perPage)
            ->toCollection();
    }
}

$browser = new CollectionBrowser();
$featured = $browser->getFeatured(1);
```

--------------------------------

### Cache Configuration

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/configuration.md

Commands to cache or clear the package configuration for production environments.

```bash
php artisan config:cache
```

```bash
php artisan config:clear
```

--------------------------------

### Accessing Unsplash via Service Container

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/facade.md

Demonstrates retrieving the Unsplash instance using the app helper, service container, or dependency injection in controllers.

```php
// Using app() helper
$unsplash = app(Unsplash::class);
$photos = $unsplash->photos()->toJson();

// Using service container
$unsplash = app()->make(Unsplash::class);

// In controllers, use dependency injection
class PhotoController extends Controller {
    public function index(Unsplash $unsplash) {
        $photos = $unsplash->photos()->toArray();
        return view('photos.index', compact('photos'));
    }
}
```

--------------------------------

### Topic Photo Gallery Class

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/topic-endpoints.md

Encapsulates topic and photo retrieval logic within a class for reusable gallery management.

```php
class TopicGallery {
    public function getAvailableTopics($perPage = 20) {
        return Unsplash::topicsList()
            ->perPage($perPage)
            ->toCollection();
    }
    
    public function getTopicInfo($topicId) {
        return Unsplash::showTopic($topicId)->toArray();
    }
    
    public function getPopularPhotos($topicId, $limit = 10) {
        return Unsplash::showTopicPhotos($topicId)
            ->orderBy('popular')
            ->perPage($limit)
            ->toCollection();
    }
    
    public function getLatestPhotos($topicId, $limit = 10) {
        return Unsplash::showTopicPhotos($topicId)
            ->orderBy('latest')
            ->perPage($limit)
            ->toCollection();
    }
    
    public function getOldestPhotos($topicId, $limit = 10) {
        return Unsplash::showTopicPhotos($topicId)
            ->orderBy('oldest')
            ->perPage($limit)
            ->toCollection();
    }
}

// Usage
$gallery = new TopicGallery();
$topics = $gallery->getAvailableTopics();
$nature = $gallery->getTopicInfo('nature');
$popular = $gallery->getPopularPhotos('nature', 5);
```

--------------------------------

### Define boot method signature

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/service-provider.md

The boot method signature used for bootstrapping application services.

```php
public function boot(): void
```

--------------------------------

### Retrieve Topics

Source: https://github.com/marksitko/laravel-unsplash/blob/master/README.md

Access lists of topics or specific topic details and associated photos.

```php
$topicsList = Unsplash::topicsList()
    ->page($pageNumber)
    ->perPage($itemsPerPage)
    ->toJson();

$showTopic = Unsplash::showTopic()
    ->id($topicIdOrSlug)
    ->toJson();

$showTopicPhotos = Unsplash::showTopicPhotos()
    ->id($topicIdOrSlug)
    ->toJson();
```

--------------------------------

### Register Unsplash Facade Alias

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/facade.md

Add the Unsplash facade to the aliases array in config/app.php for global access.

```php
'aliases' => [
    'Unsplash' => MarkSitko\\\LaravelUnsplash\\\Facades\\\Unsplash::class,
],
```

--------------------------------

### Pagination Method Signatures

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/query-builder.md

Method signatures for setting page and per-page parameters.

```php
public function page($param = null): self
```

```php
public function perPage($param = null): self
```

--------------------------------

### Configure Storage Disk

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/configuration.md

Settings for defining the Laravel filesystem disk used to store downloaded images.

```php
'disk' => env('UNSPLASH_STORAGE_DISK', 'local'),
```

```env
# Use local filesystem (default)
UNSPLASH_STORAGE_DISK=local

# Use public disk (web-accessible)
UNSPLASH_STORAGE_DISK=public

# Use S3 (requires S3 configuration)
UNSPLASH_STORAGE_DISK=s3
```

```php
'disks' => [
    'local' => [
        'driver' => 'local',
        'root' => storage_path('app'),
        'url' => env('APP_URL').'/storage',
        'visibility' => 'private',
    ],
    
    'public' => [
        'driver' => 'local',
        'root' => storage_path('app/public'),
        'url' => env('APP_URL').'/storage',
        'visibility' => 'public',
    ],
    
    's3' => [
        'driver' => 's3',
        'key' => env('AWS_ACCESS_KEY_ID'),
        'secret' => env('AWS_SECRET_ACCESS_KEY'),
        'region' => env('AWS_DEFAULT_REGION'),
        'bucket' => env('AWS_BUCKET'),
    ],
],
```

```php
// Store to configured disk
$filename = Unsplash::randomPhoto()->store();

// Photo is stored at:
// - local: storage/app/{filename}.jpg
// - public: storage/app/public/{filename}.jpg
// - s3: s3://bucket/{filename}.jpg
```

--------------------------------

### Configure Unsplash API Access Key

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/errors.md

Set the required API access key in the environment file or configuration file.

```php
// Add to .env file
UNSPLASH_ACCESS_KEY=your_api_key_here

// Or configure in config/unsplash.php
'access_key' => 'your_api_key_here',
```

--------------------------------

### Manually Register Service Provider

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/service-provider.md

Register the provider and alias in config/app.php if auto-discovery is disabled.

```php
'providers' => [
    // ...
    MarkSitko\LaravelUnsplash\UnsplashServiceProvider::class,
],

'aliases' => [
    // ...
    'Unsplash' => MarkSitko\LaravelUnsplash\Facades\Unsplash::class,
],
```

--------------------------------

### Define Configuration File

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/configuration.md

The primary configuration file structure for the Unsplash package, typically located in config/unsplash.php.

```php
<?php

return [
    // API Authentication (Required)
    'access_key' => env('UNSPLASH_ACCESS_KEY'),
    
    // Database storage of photo metadata (Optional)
    'store_in_database' => env('UNSPLASH_STORE_IN_DATABASE', false),
    
    // Storage disk for photo files (Optional)
    'disk' => env('UNSPLASH_STORAGE_DISK', 'local'),
];
```

--------------------------------

### Calculate Growth Metrics

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/stats-endpoints.md

Computes daily averages and current growth rates based on retrieved statistics.

```php
$totalStats = Unsplash::totalStats()->toArray();
$monthlyStats = Unsplash::monthlyStats()->toArray();

// Calculate daily average for the month
$dailyDownloads = $monthlyStats['downloads'] / 30;
$dailyViews = $monthlyStats['views'] / 30;
$dailyLikes = $monthlyStats['likes'] / 30;

echo "Average Daily Downloads: " . number_format($dailyDownloads);
echo "Average Daily Views: " . number_format($dailyViews);
echo "Average Daily Likes: " . number_format($dailyLikes);

// Calculate platform growth rate
$downloadsPerSecond = $totalStats['downloads_per_second'];
$downloadsPerDay = $downloadsPerSecond * 86400;

echo "Downloads per day (current rate): " . number_format($downloadsPerDay);
```

--------------------------------

### Retrieve Related Collections

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/collection-endpoints.md

Demonstrates various ways to fetch and process related collections using the Unsplash facade.

```php
// Get related collections
$related = Unsplash::showCollectionRelatedCollections('collection-123')->toJson();

// Get paginated related collections
$related = Unsplash::showCollectionRelatedCollections('collection-123')
    ->page(1)
    ->perPage(10)
    ->toArray();

// Discover similar collections
$relatedCollections = Unsplash::showCollectionRelatedCollections('collection-123')
    ->toCollection();

foreach ($relatedCollections as $col) {
    echo $col['title'] . ": " . $col['description'];
}
```

--------------------------------

### Access Platform Statistics

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/facade.md

Retrieve total platform statistics or monthly activity data.

```php
// Get total stats
$stats = Unsplash::totalStats()->toJson();
echo $stats->total_photos;
echo $stats->total_downloads;

// Get monthly activity
$monthly = Unsplash::monthlyStats()->toArray();
echo $monthly['downloads'];
echo $monthly['new_photos'];
```

--------------------------------

### Browse Topics and Their Photos

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/topic-endpoints.md

Retrieves a paginated list of available topics and iterates through them to display details.

```php
// Get available topics
$topics = Unsplash::topicsList()
    ->page(1)
    ->perPage(20)
    ->toArray();

foreach ($topics as $topic) {
    echo $topic['title'];
    echo "Photos: " . $topic['total_photos'];
    echo $topic['description'];
}
```

--------------------------------

### totalStats()

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/stats-endpoints.md

Retrieves total statistics for the entire Unsplash platform, including counts of photos, downloads, views, and likes.

```APIDOC
## totalStats()

### Description
Retrieves total statistics for the entire Unsplash platform, including counts of photos, downloads, views, and likes.

### Method
public function totalStats(): self

### Parameters
None

### Return Type
self - Returns the Unsplash instance for method chaining

### Example
```php
$stats = Unsplash::totalStats()->toJson();
echo $stats->photos;
```
```

--------------------------------

### Retrieve List of Topics

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/topic-endpoints.md

Method signature for fetching a paginated list of topics.

```php
public function topicsList(): self
```

--------------------------------

### Store Photo to Disk

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/README.md

Download a random photo and store it on the configured disk.

```php
$filename = Unsplash::randomPhoto()
    ->orientation('portrait')
    ->store();
// Returns: "abc123def456ghi789jkl012.jpg"
```

--------------------------------

### Show Collection Method

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/collection-endpoints.md

Retrieves detailed information about a specific collection by its ID.

```php
public function showCollection($id): self
```

```php
// Get collection details
$collection = Unsplash::showCollection('collection-123')->toJson();
echo $collection->title;
echo $collection->description;
echo $collection->photo_count;

// Get as array
$collectionData = Unsplash::showCollection('collection-123')->toArray();

// Get response object
$response = Unsplash::showCollection('collection-123')->get();
```

--------------------------------

### Default Unsplash Configuration File

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/service-provider.md

The default configuration file located at config/unsplash.php defines environment-based settings for access keys and storage preferences.

```php
return [
    'access_key' => env('UNSPLASH_ACCESS_KEY'),
    'store_in_database' => env('UNSPLASH_STORE_IN_DATABASE', false),
    'disk' => env('UNSPLASH_STORAGE_DISK', 'local'),
];
```

--------------------------------

### Unsplash::stats()

Source: https://github.com/marksitko/laravel-unsplash/blob/master/README.md

Methods for retrieving platform statistics.

```APIDOC
## Unsplash::stats()

### Description
Methods to retrieve total and monthly platform statistics.

### Usage
```php
$total = Unsplash::totalStats()->toJson();
$monthly = Unsplash::monthlyStats()->toJson();
```
```

--------------------------------

### Interacting with Unsplash Assets

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/has-unsplashables-trait.md

Common operations for retrieving, checking, and paginating associated Unsplash assets.

```php
$user = User::find(1);

// Get all unsplash assets
$assets = $user->unsplash()->get();

// Get first asset
$asset = $user->unsplash()->first();

// Check if has assets
if ($user->unsplash()->exists()) {
    // User has unsplash assets
}

// Count assets
$count = $user->unsplash()->count();

// Get with pagination
$assets = $user->unsplash()->paginate(15);
```

--------------------------------

### Retrieve User Information

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/facade.md

Fetch user profiles, photos, and statistics using the Unsplash facade.

```php
// Get user profile
$profile = Unsplash::user('john_doe')->toJson();

// Get user's photos with pagination
$photos = Unsplash::userPhotos('john_doe')
    ->page(1)
    ->perPage(20)
    ->toArray();

// Get user statistics
$stats = Unsplash::userStatistics('john_doe')->toCollection();
```

--------------------------------

### Unsplash::topics()

Source: https://github.com/marksitko/laravel-unsplash/blob/master/README.md

Methods for retrieving topics and topic-specific photos.

```APIDOC
## Unsplash::topics()

### Description
Methods to list topics and retrieve photos associated with a specific topic.

### Usage
```php
$topics = Unsplash::topicsList()->toJson();
$topic = Unsplash::showTopic()->id($id)->toJson();
$photos = Unsplash::showTopicPhotos()->id($id)->toJson();
```
```

--------------------------------

### Execute Fluent Query Chaining

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/facade.md

Build complex search queries by chaining methods before executing the request.

```php
// Complex query with multiple parameters
$results = Unsplash::search()
    ->query('nature')
    ->color('green')
    ->orientation('landscape')
    ->page(1)
    ->perPage(30)
    ->toArray();
```

--------------------------------

### Store Unsplash Asset via Client

Source: https://github.com/marksitko/laravel-unsplash/blob/master/README.md

Persist a random photo to the database using the Unsplash client.

```php
// Returns the created unsplash asset record
$databaseRecord = Unsplash::randomPhoto()->store();
```

--------------------------------

### Query Models by Associated Assets

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/has-unsplashables-trait.md

Demonstrates Eloquent queries to filter or count models based on their Unsplash asset associations.

```php
// Find all users that have a specific photo
$users = User::whereHas('unsplash', function($query) {
    $query->where('unsplash_asset_id', 123);
})->get();

// Find users with most photos
$users = User::withCount('unsplash')
    ->orderByDesc('unsplash_count')
    ->get();

// Find users with specific photo count
$users = User::has('unsplash', '>=', 5)->get();
```

--------------------------------

### Set Environment Variables

Source: https://github.com/marksitko/laravel-unsplash/blob/master/_autodocs/service-provider.md

Required environment variables for the Unsplash package.

```env
UNSPLASH_ACCESS_KEY=your_api_key_here
UNSPLASH_STORE_IN_DATABASE=true
UNSPLASH_STORAGE_DISK=public
```
Tokens:
Raw