canducci/avatar

Canducci Avatar

CANDUCCI AVATAR

, _(*1)

Site Referencia: http://pt.gravatar.com/, _(*2)

INSTALAÇÃO

No seu arquivo composer.json, na chave require insira o item abaixo, _(*3)

"canducci/avatar": "0.1.*"

Logo após digite na sua linha de código o seguinte comando:, _(*4)

$ composer update

Para registrar o seu ServiceProvider no Laravel versão 5.0.* e 5.1.* abra o arquivo da pasta config, app e insira no array de providers a seguinte linha:, _(*5)

'providers' => [
  ...,
  ...,

  Canducci\Avatar\Providers\AvatarServiceProvider::class
]  

Após essas configurações o pacote Canducci/Avatar estará instalado., _(*6)

Utilização:

Para facilitar foi criado uma function (função) para manipular de forma simples seguindo esse exemplo:, _(*7)

1 ) Avatar, _(*8)

Como usar?

  Explicação:

    $email   = 'email referente ao seu cadastro no site pt.gravatar.com';
    $tamanho = 'tamanho da imagem em pixel (px)';
    $pasta   = 'pasta responsável por guardar uma cópia da imagem para 
      otimização de tráfego de sua rede'

  Observação: se for especificamente para o Laravel ficará dentro da 
    pasta `public` a pasta da imagem

  Exemplo:

  $email      = 'email@email.com'; // email do gravatar
  $tamanho    = 150; //tamanho em pixel
  $pasta      = 'imagem/'; //aonde vai ser gravado a imagem

  //FUNCTION
  $avatarInfo = avatar($email, $tamanho, $pasta);

  // OU 

  //FACADE
  $avatarInfo = Avatar::avatarInfo($email, $tamanho, $pasta);

Métodos que estão presentes em $avatarInfo, _(*9)

  // Caminho aonde a imagem está sendo gravada e disponível
  abstract function getPath();

  // Código Hash da imagem (md5)      
  abstract function getHash();

  // Tamanho da Imagem
  abstract function getWith();

  // E-mail informado
  abstract function getEmail();

  // Retorno da tag <img> com a imagem que foi trazida do site pt.gravatar.com
  abstract function getTagImage();
    //Exemplo: <img src="/image/2f16dd72d50033880dab74299e087b5a-601.jpg" /> 
    // Dados fictios

  // Caminho e nome da imagem
  abstract function getImage();

  // Dados no formato array
  abstract function getArray();

  // Dados no formato Json  
  abstract function getJson();

Blade contido de maneira simples para utilização direto na view para Framework Laravel 5.0.* e 5.1.*, _(*10)

  // Primeiro parametro é o e-mail do pt.gravatar.com.
  // Sedundo parametro é 0 tamanho da imagem.
  // Terceiro parametro é a pasta que guarda a imagem.

  @avatar('email@hotmail.com', 601, 'image/')

  //Geração:
    //<img src="/image/2f16dd72d50033880dab74299e087b5a-601.jpg" />

2 ) Profile (informações do perfil), _(*11)

O pacote traz o profile do usuário mediante as informações contidas em seu cadastro., _(*12)

Como usar?

  $email = 'email@email.com'; // email do gravatar

  //FUNCTION
  $profileInfo = profile($email);

  // OU 

  //FACADE
  $profileInfo = Avatar::profileInfo($email);

Métodos que estão presentes em $profileInfo, _(*13)

  //caminho dos caminhos
  abstract function getUrls();

  //Ims contidos
  abstract function getIms();

  //Emails contidos
  abstract function getEmails();

  //Número de telefones existentes
  abstract function getPhoneNumbers();

  //Sobre mim
  abstract function getAboutMe();

  //Mostrar nome
  abstract function getDisplayName();

  //Imagem de Background
  abstract function getProfileBackground();

  //Seu nome
  abstract function getName();

  //Suas contas
  abstract function getAccounts();

  //Seu Id de identificação
  abstract function getId();

  //Sua hash
  abstract function getHash();

  //Sua Requisição hash
  abstract function getRequestHash();

  //Endereço do perfil
  abstract function getProfileUrl();

  //Nome preferencial 
  abstract function getPreferredUsername();

  //Endereços imagens pequenas
  abstract function getThumbnailUrl();

  //Todas as fotos
  abstract function getPhotos();

  // Dados no formato array
  abstract function getArray();

  // Dados no formato Json  
  abstract function getJson();

Link exemplo: http://pt.gravatar.com/site/implement/profiles/, _(*14)