attogram/shared-media-api

<?php

namespace Attogram\SharedMedia\Api;

/**
 * Media file object
 */
class Media extends Base
{
    const VERSION = '1.0.2';

    /**
     * search for Media files
     *
     * @see https://www.mediawiki.org/wiki/API:Search
     * @param string $query
     * @return array
     */
    public function search($query)
    {
        $this->logger->debug('Meda:search');
        if (!Tools::isGoodString($query)) {
            $this->logger->error('Media::search: invalid query');
            return [];
        }
        $this->setGeneratorSearch($query, self::MEDIA_NAMESPACE);
        return $this->getImageinfoResponse();
    }

    /**
     * get Media file information
     *
     * @return array
     */
    public function info()
    {
        $this->logger->debug('Meda:info');
        if (!$this->setIdentifier('', 's')) {
            return [];
        }
        return $this->getImageinfoResponse();
    }

    /**
     * get Media files embedded on a Page
     *
     * @see https://www.mediawiki.org/wiki/API:Images
     * @return array
     */
    public function getMediaOnPage()
    {
        $this->logger->debug('Meda:getMediaOnPage');
        if (!$this->setIdentifier('', 's')) {
            return [];
        }
        $this->setGeneratorImages();
        return $this->getImageinfoResponse();
    }

    /**
     * get a list of Media files in a category
     *
     * @see https://www.mediawiki.org/wiki/API:Categorymembers
     * @return array
     */
    public function getMediaInCategory()
    {
        $this->logger->debug('Meda:getMediaInCategory');
        return $this->getCategorymemberResponse('file');
    }

    /**
     * format a media file response as a simple string
     *
     * @param array $response
     * @return string
     */
    public function format(array $response)
    {
        $this->logger->debug('Meda:format');
        $car = '<br />';
        $format = '';
        foreach ($response as $media) {
            $format .= '<div class="media">'
            . '<img'
            . ' src="' . Tools::getFromArray($media, 'thumburl') . '"'
            . ' width="' . Tools::getFromArray($media, 'thumbwidth') . '"'
            . ' height="' . Tools::getFromArray($media, 'thumbheight') . '"'
            . ' title="'.Tools::safeString(print_r($media, true)).'">'
            . $car . '<span class="pageid">' . Tools::getFromArray($media, 'pageid') . '</span>'
            . $car . '<span class="title">'
            . Tools::safeString(Tools::getFromArray($media, 'title'))
            . '</span>'
            . '</div>';
        }
        return $format;
    }
}