canducci/quickresponse

PHP QR Code

####PHP QR Code version (1.1.4)

PHP QR Code - Site http://sourceforge.net/projects/phpqrcode/

This is PHP implementation of QR Code 2-D barcode generator. It is pure-php LGPL-licensed implementation based on C libqrencode by Kentaro Fukuchi.

LICENSING

Copyright (C) 2010 by Dominik Dzienia

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3 of the License, or any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License (LICENSE file) for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

== INSTALATION AND USAGE ==

• INSTALL file
• http://sourceforge.net/apps/mediawiki/phpqrcode/index.php?title=Main_Page

== CONTACT ==

Fell free to contact me via e-mail (deltalab at poczta dot fm) or using folowing project pages:

• http://sourceforge.net/projects/phpqrcode/
• http://phpqrcode.sourceforge.net/

== ACKNOWLEDGMENTS ==

Based on C libqrencode library (ver. 3.1.1) Copyright (C) 2006-2010 by Kentaro Fukuchi http://megaui.net/fukuchi/works/qrencode/index.en.html

QR Code is registered trademarks of DENSO WAVE INCORPORATED in JAPAN and other countries.

Reed-Solomon code encoder is written by Phil Karn, KA9Q. Copyright (C) 2002, 2003, 2004, 2006 Phil Karn, KA9Q

Canducci QuickResponse

QR Code

Instalação

Configurações

Para aplicações Laravel, configure dessa maneira:

Adicione em seu composer.json essa chave:

"canducci/quickresponse": "0.0.1"

Agora execute esse comando no seu console:

$ composer update

####Laravel

Abra o arquivo config/app.php e adicione essa linha em suas configurações de providers:

'providers' => [
    ...    
    Canducci\QuickResponse\Providers\QuickResponseProvider::class,
    
]

Para funcionar o apelido (facade) adicione essa linha em suas configurações de aliases:

'aliases' => [

    ...
    'QuickResponse' => Canducci\QuickResponse\Facades\QuickResponse::class
    
]

####Métodos

Recebe uma interface de message

public function data(IMessageType $message)

Renderiza a imagem e exibe direto no navegador

public function render($level = QuickResponseLevel::L, $pixel = QuickResponsePixel::Three, 
                $frame = QuickResponseFrameSize::Two)

Cria a imagem e grava em disco no formato .png

public function saveAs($path, $level = QuickResponseLevel::L, $pixel = QuickResponsePixel::Three, 
                $frame = QuickResponseFrameSize::Two)

####A sequencia dos métodos é:

1 - Passe a interface `IMessateType` no método `data($msg)`.
2 - Depois utilize `render()` ou `saveAs()`.
3 - Sequencia: (Exemplo)    
    $msg = new \Canducci\QuickResponse\MessageText($name); 
    QuickResponse::data($msg)->saveAs('q/text.png');

Observação: Os métodos render e saveAs já estão formatados em um padrão, deixando livre para novas configurações.

####Como utilizar no Laravel

Para Texto ou Links:

$name = "test";
$msg = new \Canducci\QuickResponse\MessageText($name); 
//Facade 
QuickResponse::data($msg)->saveAs('q/text.png');
//Instância
$qr = new Canducci\QuickResponse\QuickResponse();
$qr->data($msg)->saveAs('q/text.png');

Para Telefone

$msg = new \Canducci\QuickResponse\MessagePhone(55,11,1111111);    
QuickResponse::data($msg)->saveAs('q/phone.png');

Para SMS

$msg = new \Canducci\QuickResponse\MessageSMS(55,11,11111111);    
QuickResponse::data($msg)->saveAs('q/sms.png');    	

Para Email Simples

$msg = new \Canducci\QuickResponse\MessageSimpleEmail('test@test.com');    
QuickResponse::data($msg)->saveAs('q/emailsimple.png');

Para Email Completo

$msg = new \Canducci\QuickResponse\MessageExtendedEmail('test@test.com', 'Test', 'Test Complete');    
QuickResponse::data($msg)->saveAs('q/email.png');

Para Skype

$msg = new \Canducci\QuickResponse\MessageSkype('test@test.com');    
QuickResponse::data($msg)->saveAs('q/skype.png');

Cartão de Visita Simples

$people = messagePeople('Test');
$phone = messagePhone(55,11,11111111);
$msg = messageBusinessCardSimple($people, $phone);
QuickResponse::data($msg)->saveAs('q/cardsimple.png');

Cartão de Visita Completo

$people = messagePeople('Test');
$phone = messagePhone(55,11,11111111);
$phone1 = messagePhone(55,18,32695189);
$phone2 = messagePhone(55,18,32695189);
$address = messageAddress('Office', '','Home','Rua, 001','Sao Paulo','SP','04500000','Brasil');
$msg = messageBusinessCardDetailed($people,$phone,$phone1,$phone2,'sobre1;test1','Home Office','dt@dt.com', $address);
QuickResponse::data($msg)->saveAs('q/carsdetailed.png');

Cartão de Visita Simples com Foto

$people = messagePeople('Test');
$phone = messagePhone(55,11,11111111);
$msg = messageBusinessCardPhoto($people, $phone, file_get_contents('40x40.jpg'));
QuickResponse::data($msg)->saveAs('q/carsphoto.png');

####Helpers

$msg = messageText('Test Laravel');

• Save

qrSaveAs($msg, 't.png');
//ou
quickresponse()->data($msg)->saveAs('1.png');
//ou
QuickResponse::data($msg)->saveAs('1.png');
    

• Render

return qrRender($msg); 
//ou
return quickresponse()->data($msg)->render();
//ou
return QuickResponse::data($msg)->render();
	

Mais Helpers

function messageText($text); 
    return new MessageText
    
function messagePeople($name);
    return new MessagePeople
    
function messageAddress($label, $pobox, $ext, $street, $town, $region, $postcode, $country);
    return new MessageAddress
    
function messageSkype($name);
    return new MessageSkype
     
function messagePhone($country,$area,$number);
    return new MessagePhone
    
function messageSMS($country,$area, $number);
    return new MessageSMS
    
function messageSimpleEmail($email);
    return new MessageSimpleEmail
    
function messageExtendedEmail($email, $subject, $body);
    return new MessageExtendedEmail
    
function messageBusinessCardSimple(IMessagePeople $people, IMessagePhone $phone);
    return new MessageBusinessCardSimple
    
function messageBusinessCardDetailed(IMessagePeople $people, IMessagePhone $phone, IMessagePhone $phoneprivate, 
                IMessagePhone $phonecelular,$sortName, $orgName, $email, IMessageAddress $address)
    return new MessageBusinessCardDetailed
    
function messageBusinessCardPhoto(IMessagePeople $people, IMessagePhone $phone, $photo);
    return new MessageBusinessCardPhoto

####Direto no navegador:

Rota

get('print', function()
{
    $msg = messageText('https://packagist.org/packages/canducci/quickresponse');
    //Facade
    return QuickResponse::data($msg)
            ->render();
});

View

<div>
    <img src="https://raw.githubusercontent.com/netdragoon/phpqrcode/HEAD/print" border="0" />
</div>

####Observação: Esse pacote funciona perfeitamente fora do framework Laravel

Crie um composer.json com formato logo abaixo:

{    
    "require": {     
        "canducci/quickresponse":"0.0.1"   
    }
}

Rode o comando $ composer update, e após a instalação use assim:

<?php

    require 'vendor/autoload.php';
        
    //Instância
    $msg = new Canducci\QuickResponse\MessageText('Test');
    
    //Instância
    $qr = new Canducci\QuickResponse\QuickResponse();
    
    echo $qr->data($msg)->render(); // saída imagem
    
    //OU
    
    $qr->data($msg)->saveAs('path_da_pasta_nome_imagem'); // Exemplo: q/1.png