معرفی پکیج Laravolt Avatar در لاراول

در این مقاله از لیداوب، با پکیج Laravolt Avatar که برای ایجاد تصاویر آواتار در لاراول کاربرد دارد، آشنا می‌شویم.

Laravolt Avatar پکیجی در لاراول است که توسط Bayu Hendra Winata طراحی شده است. با استفاده از این پکیج به راحتی می‌توان رشته‌هایی مانند نام‌ها را به آواتار تبدیل کرد. این پکیج همچنین از پکیج Intervention Image در درون خود استفاده می‌کند که تصاویر base64 را ایجاد کرده و به عنوان یک تصویر و SVG آن‌ها را ذخیره می‌کند.

استفاده از این پکیج در قالب Blade شما به صورت زیر خواهد بود:

<img src="{{ Avatar::create('Joko Widodo')->toBase64() }}" />

<!-- SVG markup -->
{!! Avatar::create('Susilo Bambang Yudhoyono')->toSvg(); !!}

این پکیج دارای ویژگی‌های قابل تنظیم زیادی است؛ برای مثال، می‌توانید یک تصویر مجزا را در هنگام رندر آن پیکربندی کنید:

// width = 100, height = 200
Avatar::create('Soekarno')->setDimension(100, 200);
Avatar::create('Soekarno')->setBackground('#001122');
Avatar::create('Soekarno')->setShape('square');

در اینجا، پیکربندی کامل این پکیج را مشاهده می‌کنید. بنابراین، می‌توانید تمام گزینه‌های ممکن برای تنظیم و سفارشی سازی ایجاد آواتارها را مشاهده کنید:

<?php

return [

// Supported: "gd", "imagick"
'driver' => 'gd',

// Initial generator class
'generator' => \Laravolt\Avatar\Generator\DefaultGenerator::class,

// Whether all characters supplied must be replaced with their closest ASCII counterparts
'ascii' => false,

// Image shape: circle or square
'shape' => 'circle',

// Image width, in pixel
'width' => 100,

// Image height, in pixel
'height' => 100,

// Number of characters used as initials.
'chars' => 2,

// font size
'fontSize' => 48,

// convert initial letter to uppercase
'uppercase' => false,

// Fonts used to render text.
// If contains more than one fonts, randomly selected based on name supplied
'fonts' => ['path/to/OpenSans-Bold.ttf', 'path/to/rockwell.ttf'],

// List of foreground colors to be used, randomly selected based on name supplied
'foregrounds' => [
'#FFFFFF'
],

// List of background colors to be used, randomly selected based on name supplied
'backgrounds' => [
'#f44336',
'#E91E63',
'#9C27B0',
'#673AB7',
'#3F51B5',
'#2196F3',
'#03A9F4',
'#00BCD4',
'#009688',
'#4CAF50',
'#8BC34A',
'#CDDC39',
'#FFC107',
'#FF9800',
'#FF5722',
],

'border' => [
'size' => 1,

// border color, available value are:
// 'foreground' (same as foreground color)
// 'background' (same as background color)
// or any valid hex ('#aabbcc')
'color' => 'foreground'
]
];

با استفاده از کامپوزر می‌توانید این پکیج را در پروژه لاراول خود نصب کنید:

composer require laravolt/avatar

# Or for Laravel 5.1
composer require laravolt/avatar ~0.3

همچنین، می‌توانید برای دریافت اطلاعات کامل درباره این پکیج سری به GitHub بزنید. توجه داشته باشید که اگر از لاراول ۵.۴ یا نسخه‌های قبل از آن استفاده می‌‌کنید، قبل از استفاده از این پکیج باید Facade Avatar را به صورت دستی پیکربندی کنید تا بتوانید از آن در قالب پروژه لاراول خود استفاده کنید.

برای آشنایی با سایر پکیج‌های لاراول می‌توانید، مقالات کاربردی مشابه ما را در لیداوب دنبال کنید.