mheap/silex-gravatar

This package is abandoned and no longer maintained. No replacement package was suggested.

Gravatar extension for Silex

dev-master 2017-10-10 20:00 UTC

Requires

• php: >=7.0
• se/gravatar-php: ^2.0

Requires (Dev)

• phpunit/phpunit: ^6
• silex/silex: 2.*
• squizlabs/php_codesniffer: ^3.1
• twig/twig: >=1.2.0

Suggests

• twig/twig: >=1.2.0

MIT

• Sven Eisenschmidt
• Michael Heap

• silex
• gravatar
• avatar

README

Requirements

This extension only works with PHP 7.1+ and Silex 2. Version 1.1.0 is compatible with Silex 1.

Installation

Install with composer:

composer require mheap/silex-gravatar

Usage

First, you need to register the Gravatar extension. All of the options shown are optional.

$app->register(new SilexExtension\GravatarExtension(), array(
    'gravatar.cache_dir'  => sys_get_temp_dir() . '/gravatar',
    'gravatar.cache_ttl'  => 240, // 240 seconds
    'gravatar.options' => array(
        'size' => 100,
        'rating' => Gravatar\Service::RATING_G,
        'secure' => true,
        'default'   => Gravatar\Service::DEFAULT_404,
        'force_default' => true
    )
));

To fetch a Gravatar URL, use $app['gravatar']:

$app->get('/', function() use($app) {
    return $app['gravatar']->get('[e-mail]');
});

If you're using Twig via Silex\Provider\TwigServiceProvider(), a gravatar function will be automatically registered for you. This allows you do do the following:

{% if gravatar_exist('[e-mail]') %}
    Gravatar found
{% endif %}

<img src="{{ gravatar('[e-mail]', {'size': 50}) }}" />

Available configuration options

The GravatarExtension provides access to the Gravatar web service through Sven Eisenschmidts's Gravatar <https://github.com/fate/Gravatar-php>_ library.

• gravatar.cache_dir (optional): A directory to cache the direct web service calls to gravatar.com
• gravatar.cache_ttl (optional): The time how long a cache entry will live, defaults to 360 seconds
• gravatar.options (optional): An associative array of arguments for the Gravatar\Service class

Running the tests

There are no external dependencies for this library. Just composer install then run ./vendor/bin/phpunit