README

🖼 The simplest Gravatar PHP package

Easy as it's supposed to be 💪

pH2Gravatar is lightweight gravatar library giving you an elegant way to generate gravatar profile photos from email addresses 🪄

Requirements
How to install it?
How to use it?
Who wrote it?
How to build this library - Full Video Course

⛏ Requirements

PHP 7.3, or higher! 🐘

🏗 How to install it?

With composer:

composer require ph-7/ph2gravatar

💭 How to use it?

Example 1

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

use PH7\PH2Gravatar\Image;
?>

<!-- Here, we leave the default parameters. https://en.gravatar.com/site/implement/images/ -->
<!-- By default, the image size is 200px -->
<img src="<?= Image::get('me@test.email') ?>" alt="My gravatar image" />


<!-- Here, we set the gravatar image size to 400px -->
<img src="<?= Image::get('me@test.email', ['size' => 400]) ?>" alt="My gravatar image" />

Example 2

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

use PH7\PH2Gravatar\Image as Gravatar;

// Show the gravatar image link
echo Gravatar::get('me@test.email', [
    'size' => 80,
    'rating' => 'pg',
    'display' => 'retro'
]);
// https://www.gravatar.com/avatar/9c47a7bb2aec6e61df372a8f8446ed9d?s=80&r=pg&d=retro

Example 3

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

use PH7\PH2Gravatar\Image as GravatarImage;

$email = 'me@myemail.com';
$size = 400;

$imageUrl = GravatarImage::get($email, [
    'size' => $size,
    'display' => '404',
    'rating' => 'g'
    ]
);

// $imageUrl output
// https://www.gravatar.com/avatar/4995f3f0b59f4abfda86e74f92896f3b?s=400&r=g&d=404

🪄 Author

I'm Pierre-Henry Soria. A dedicated, passionate and positive software engineer 😊 You can keep in touch with me at hi [[AT]] ph7 {{D0T}} me 📮

Are you enjoying my work? Offer me a coffee and boost the software development at the same time! 💪

📺 Watch me building it!

👉 Click here to watch on YouTube

📃 License

pH2Gravatar is distributed under MIT license 🚀 Enjoy!

ph-7 / ph2gravatar

Maintainers

Details