<?php
// The MIT License (MIT)
//
// Copyright (C) 2016 TrendSpottr
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
// THE SOFTWARE.

// NOTE:  Before you can run this file successfully, you must edit the the line that
//        sets the authenticationString and insert your TrendSpottr API Key.  That key
//        can be found by logging into your TrendSpottr.com account, then clicking on your
//        email address in the upper right of any TrendSpottr and selecting "Edit Account"
//        from the menu that will drop down. If you don't do that, the first API call made
//        by this script will fail with an invalid api key, and the script will abort.
date_default_timezone_set('UTC');
mb_internal_encoding('UTF-8');
mb_regex_encoding('UTF-8');
mb_http_output('UTF-8');
mb_language('uni');

function apiRequest($parameters)
{
    $serverURL = "https://api.trendspottr.com/v2.0/trendfeed";
    $apiKey    = 'ENTER_YOUR_API_KEY_HERE';

    // Add the API Key to the list of provided parameters
    $parameters['key']    = $apiKey;

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_USERAGENT, "curl");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPGET, true);
    curl_setopt($ch, CURLOPT_ENCODING, "gzip");
    // curl_setopt($ch, CURLOPT_VERBOSE, true);

    curl_setopt($ch, CURLOPT_URL, $serverURL . '?' . http_build_query($parameters));
    $result = curl_exec($ch);
    $http_status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    $rval = json_decode($result);
    if (json_last_error() !== JSON_ERROR_NONE)
    {
        throw new Exception("json_decode error: ".json_last_error_msg(), $http_status);
    } elseif ($http_status != 200)
    {
        if (is_object($rval) && isset($rval->error_msg))
            throw new Exception($rval->error_msg, $http_status);
        else
            throw new Exception("Unknown error: ".$result, $http_status);
    }

    return $rval;
}

/*
 * getFeedList
 */
$parameters = array(
    'action' => 'getFeedList',
);
try
{
    $rval = apiRequest($parameters);

    printf("Feed Groups\n");
    $i = 0;
    foreach ($rval->feed_groups as $feed_group)
    {
        printf("    %2d: %s\n", $i++, $feed_group);
    }

    printf("Feeds\n");
    $i = 0;
    foreach ($rval->feed_list as $feed)
    {
        printf("    %2d: ID: %d, %s: %s\n", $i++, $feed->feed_id, $feed->feed_group, $feed->feed_name);
    }
} catch (Exception $e)
{
    printf("%s: failed: HTTP status: %d: %s\n", $parameters['action'], $e->getCode(), $e->getMessage());
}

/*
 * searchFeedList
 */
$parameters = array(
    'action' => 'searchFeedList',
    'query_string' => 'internet of things',
);

printf("\nSearch for Feeds related to: '%s'\n", $parameters['query_string']);
try
{
    $rval = apiRequest($parameters);

    $i = 0;
    foreach ($rval->matching_feeds as $feed)
    {
        printf("    %2d: ID: %d, %s: %s\n", $i++, $feed->feed_id, $feed->feed_group, $feed->feed_name);
    }

} catch (Exception $e)
{
    printf("%s: failed: HTTP status: %d: %s\n", $parameters['action'], $e->getCode(), $e->getMessage());
}

function printArticles($articles)
{
    $i = 0;
    foreach ($articles as $article)
    {
        printf("    %2d: ID: %d\n", $i++, $article->id);
        printf("        Link: %s\n", $article->link);
        printf("        Title: %s\n", $article->title);
        printf("        Description: %s\n", $article->description);
        if (isset($article->feed_id))
            printf("        Feed ID: %s\n", $article->feed_id);
        if (isset($article->feed_group))
            printf("        Feed Group: %s\n", $article->feed_group);
        if (isset($article->feed_name))
            printf("        Feed Name: %s\n", $article->feed_name);
        echo PHP_EOL;
    }
}

/*
 * searchArticles
 */
$parameters = array(
    'action'       => 'searchArticles',
    'query_string' => 'Electric Vehicles',
    'count'        => 2,
);

printf("\nSearch for 2 most recent articles related to: '%s'\n", $parameters['query_string']);
try
{
    $rval = apiRequest($parameters);
    printArticles($rval->matching_articles);
} catch (Exception $e)
{
    printf("%s: failed: HTTP status: %d: %s\n", $parameters['action'], $e->getCode(), $e->getMessage());
}

printf("Get the next 2 most recent articles\n");
$parameters['offset'] = 2;
try
{
    $rval = apiRequest($parameters);
    printArticles($rval->matching_articles);
} catch (Exception $e)
{
    printf("%s: failed: HTTP status: %d: %s\n", $parameters['action'], $e->getCode(), $e->getMessage());
}

/*
 * getFeedID
 */
$parameters = array(
    'action'     => 'getFeedID',
    'feed_group' => 'Automotive',
    'feed_name'  => 'Electric Vehicles',
);

printf("\nGet the FeedID for the %s / %s Feed\n", $parameters['feed_group'], $parameters['feed_name']);
try
{
    $rval = apiRequest($parameters);
    $feedID = $rval->feed_id;
    printf("    %s / %s feed has feedID %d\n", $parameters['feed_group'], $parameters['feed_name'], $feedID);
} catch (Exception $e)
{
    printf("%s: failed: HTTP status: %d: %s\n", $parameters['action'], $e->getCode(), $e->getMessage());
}

/*
 * getArticles
 */
$parameters = array(
    'action'       => 'getArticles',
    'feed_id'      => $feedID,
    'count'        => 2,
);

printf("\nGet the for 2 most recent articles for feed: %d\n", $parameters['feed_id']);
try
{
    $rval = apiRequest($parameters);
    printArticles($rval->articles);
    $pagingCursor = $rval->paging_cursor;
} catch (Exception $e)
{
    printf("%s: failed: HTTP status: %d: %s\n", $parameters['action'], $e->getCode(), $e->getMessage());
}

printf("Get the next 2 most recent articles\n");
$parameters['paging_cursor'] = $pagingCursor;
try
{
    $rval = apiRequest($parameters);
    printArticles($rval->articles);
} catch (Exception $e)
{
    printf("%s: failed: HTTP status: %d: %s\n", $parameters['action'], $e->getCode(), $e->getMessage());
}