meriksk/fotkomotko-php-sdk

Fotkomotko PHP SDK

Fotkomotko PHP SDK

Fotkomotko Client is a SDK library that allows to fetch data from Fotkomotko Services., _(*1)

Basic Usage

Use new \Fotkomotko\Api($options) to create and initialize an API client. Option base_url is required. The minimal you'll need to have is:, _(*2)

<?php
// require the Fotkomotko autoloader
require_once '/path/to/FotkomotkoClient/src/autoload.php';
// alternatively, use composer

$options = array(
    'base_url' => 'http://url-to-fotkomotko/api',
    'username' => 'your_username',
    'password' => 'your_password',
);
$api = new \Fotkomotko\Api($options);

With Composer:, _(*3)

Add the "meriksk/fotkomotko-php-sdk": "@stable" into the require section of your composer.json. Run composer install. The example will look like, _(*4)

require_once __DIR__ . '/vendor/autoload.php';

$options = [
    'base_url' => 'http://url-to-fotkomotko/api',
    'username' => 'your_username',
    'password' => 'your_password',
];

$api = new \Fotkomotko\Api($options);

Endpoints

Albums

// Get a single album (find by Id)
$response = $api->getAlbum(1);

    if ($response->success) {
        echo '<p>Album: <strong>' . $response->data['title'] . '</strong></p>';
    } else {
        echo '<p>Error: <strong>' . $response->code . ': ' . $response->message . '</strong></p>';
    }

// Get a single album (find by album title)
$response = $api->getAlbum('album-title');

    if ($response->success) {
        echo '<p>Album: <strong>' . $response->data['title'] . '</strong></p>';
    } else {
        echo '<p>Error: <strong>' . $response->code . ': ' . $response->message . '</strong></p>';
    }

// Get list of albums
$response = $api
    ->visibility(\Fotkomotko\Api::VISIBILITY_PUBLIC)
    ->continents(\Fotkomotko\Api::EUROPE)
    ->years(2014)
    ->sort('-date')
    ->getAlbums(array(
        'tags' => 'europe'
    ));

    if ($response->success) {
        foreach($response->data['items'] as $album { ... }
    } else {
        echo '<p>Error: <strong>' . $response->code . ': ' . $response->message . '</strong></p>';
    }

Photos

// Get single photo
$response = $api->getPhoto(1);

    if ($response->success) {
        echo '<p>Photo: <strong>' . $response->data['title'] . '</strong></p>';
    } else {
        echo '<p>Error: <strong>' . $response->code . ': ' . $response->message . '</strong></p>';
    }

// Get list of photos from a single album
$response = $api->albums(1)->getAlbums($params);

    if ($response->success) {
        foreach($response->data['items'] as $photo { ... }
    } else {
        echo '<p>Error: <strong>' . $response->code . ': ' . $response->message . '</strong></p>';
    }

Collections

// Get single collection
$response = $api->getCollection(1);

    if ($response->success) {
        echo '<p>Collection: <strong>' . $response->data['title'] . '</strong></p>';
    } else {
        echo '<p>Error: <strong>' . $response->code . ': ' . $response->message . '</strong></p>';
    }

// Get list of collection
$response = $api->getCollections(array(
    'albums' => true,
    'coverPhoto' => true,
));

    if ($response->success) {
        foreach($response->data['items'] as $collection { ... }
    } else {
        echo '<p>Error: <strong>' . $response->code . ': ' . $response->message . '</strong></p>';
    }