Skip to content

Commit 3f33c65

Browse files
author
Corey McCormick
committed
Merge branch 'develop' of github.com:SimpleSoftwareIO/simple-qrcode into develop
2 parents 2d15a57 + a147658 commit 3f33c65

File tree

1 file changed

+355
-0
lines changed

1 file changed

+355
-0
lines changed

‎docs/pt-br/README.md‎

Lines changed: 355 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,355 @@
1+
Simple QrCode
2+
========================
3+
4+
[![Build Status](https://travis-ci.org/SimpleSoftwareIO/simple-qrcode.svg?branch=master)](https://travis-ci.org/SimpleSoftwareIO/simple-qrcode)
5+
[![Latest Stable Version](https://poser.pugx.org/simplesoftwareio/simple-qrcode/v/stable.svg)](https://packagist.org/packages/simplesoftwareio/simple-qrcode)
6+
[![Latest Unstable Version](https://poser.pugx.org/simplesoftwareio/simple-qrcode/v/unstable.svg)](https://packagist.org/packages/simplesoftwareio/simple-qrcode)
7+
[![License](https://poser.pugx.org/simplesoftwareio/simple-qrcode/license.svg)](https://packagist.org/packages/simplesoftwareio/simple-qrcode)
8+
[![Total Downloads](https://poser.pugx.org/simplesoftwareio/simple-qrcode/downloads.svg)](https://packagist.org/packages/simplesoftwareio/simple-qrcode)
9+
[Русский](https://www.simplesoftware.io/docs/simple-qrcode/ru) |
10+
[汉语](https://www.simplesoftware.io/docs/simple-qrcode/zh)
11+
12+
- [Introdução](#docs-introduction)
13+
- [Traduções](#docs-translations)
14+
- [Configuração](#docs-configuration)
15+
- [Simples ideias](#docs-ideas)
16+
- [Uso](#docs-usage)
17+
- [Helpers](#docs-helpers)
18+
- [Uso comum do QrCode](#docs-common-usage)
19+
- [Uso sem Laravel](#docs-outside-laravel)
20+
21+
<a id="docs-introduction"></a>
22+
## Introdução
23+
Simple QrCode é wrapper de fácil uso do Framework Laravel, baseado no grande trabalho provide pelo [Bacon/BaconQrCode](https://github.com/Bacon/BaconQrCode). Criamos uma interface que é fácil e familiar de instalar para usuários Laravel.
24+
25+
<a id="docs-translations"></a>
26+
## Traduções
27+
Estamos procurando por usuário que falem Árabe, Espanhol, Francês, Coreano ou Japonês, para nos ajudar a traduzir este documento. Por favor, crie um pull request if você é capar de fazer uma tradução!
28+
29+
<a id="docs-configuration"></a>
30+
## Configuração
31+
32+
#### Composer
33+
34+
Primeiramente, adicione o pacote Simple QrCode ao seu `require` no arquivo `composer.json`:
35+
36+
"require": {
37+
"simplesoftwareio/simple-qrcode": "~1"
38+
}
39+
40+
Próximo, execute o comando `composer update`.
41+
42+
#### Provedor de Serviço
43+
44+
###### Laravel 4
45+
Registre o `SimpleSoftwareIO\QrCode\QrCodeServiceProvider` em seu `app/config/app.php` dentro do array`providers`.
46+
47+
###### Laravel 5
48+
Registre a `SimpleSoftwareIO\QrCode\QrCodeServiceProvider::class` em seu `config/app.php` dentro do array `providers`.
49+
50+
#### Aliases
51+
52+
###### Laravel 4
53+
Finalmente, registre o `'QrCode' => 'SimpleSoftwareIO\QrCode\Facades\QrCode'` em seu arquivo de configuração `app/config/app.php` dentro do array `aliases`.
54+
55+
###### Laravel 5
56+
Finally, register the `'QrCode' => SimpleSoftwareIO\QrCode\Facades\QrCode::class` em seu arquivo de configuração `config/app.php` dentro do array `aliases`.
57+
58+
<a id="docs-ideas"></a>
59+
## Simple Ideas
60+
61+
#### Print View
62+
63+
Um dos principais itens que utilizam este pacote para é ter QRCodes em todos os nossos pontos de vista de impressão. Isto permite que nossos clientes para retornar para a página original depois de impresso, basta digitalizar o código. Conseguimos isso adicionando o seguinte em nosso arquivo footer.blade.php.
64+
65+
<div class="visible-print text-center">
66+
{!! QrCode::size(100)->generate(Request::url()); !!}
67+
<p>Scan me to return to the original page.</p>
68+
</div>
69+
70+
#### Embarcando um QrCode
71+
72+
Você pode incorporar um qrcode dentro de um e-mail, que permita que seus usuários escaneiem rapidamente. Abaixo, um exemplo de como fazer isso utilizando o Laravel.
73+
74+
//Inside of a blade template.
75+
<img src="{!!$message->embedData(QrCode::format('png')->generate('Embed me into an e-mail!'), 'QrCode.png', 'image/png')!!}">
76+
77+
<a id="docs-usage"></a>
78+
## Uso
79+
80+
#### Uso Básico
81+
82+
É muito fácil utilizar o gerador de Qrcode. A sintaxe mais básica é:
83+
84+
QrCode::generate('Me transforme em um QrCode!');
85+
86+
Isso criará um Qr que diz "Me transforme em um QrCode!"
87+
88+
#### Generate
89+
90+
`Generate` é usado para criar o QrCode.
91+
92+
QrCode::generate('Me transforme em um QrCode!');
93+
94+
>Atenção! Esse método deve ser chamado por último dentro da cadeia.
95+
96+
`Generate` por padrão irá retornar uma string de imagem SVG. Você pode exibir diretamente em seu browser, utilizando o Laravel's Blade com o código abaixo:
97+
98+
{!! QrCode::generate('Me transforme em um QrCode!'); !!}
99+
100+
O método `generate` tem um segundo parametro que aceita um arquivo e um path para salvar o Qrcode.
101+
102+
QrCode::generate('Me transforme em um QrCode!', '../public/qrcodes/qrcode.svg');
103+
104+
#### Alteração de Formato
105+
106+
>Por padrão o gerador de QrCode está configurado para retornar uma imagem SVG.
107+
108+
>Cuidao! O método `format` deve ser chamado antes de qualquer outra opção de formatação como `size`, `color`, `backgroundColor` e `margin`.
109+
110+
Atualmente são suportados três tipos de formatos; PNG, EPS, and SVG. Para alterar o formato, use o seguinte código:
111+
112+
QrCode::format('png'); //Retornará uma imagem no formato PNG
113+
QrCode::format('eps'); //Retornará uma imagem no formato EPS
114+
QrCode::format('svg'); //Retornará uma imagem no formato SVG
115+
116+
#### Alteração de Tamanho
117+
118+
>Por padrão, o gerador QrCode retornará o menos tamanho possível em pixels para criar o QrCode.
119+
120+
Você pode alterar o tamanho do QrCode usando o método `size`. Simplesmente especificando o tamanho desejado em pixels usando a seguinte sintaze:
121+
122+
QrCode::size(100);
123+
124+
#### Alteração de cor
125+
126+
>Cuidado quando estiver alterando a cor de um QRCode. Alguns leitores tem uma grande dificuldade em ler QrCodes coloridos.
127+
128+
Todas as cores devem ser definidas em RGB(Red Green Blue). Você pode alterar a cor de um qrCode usando o código abaixo. You can change the color of a QrCode by using the following:
129+
130+
QrCode::color(255,0,255);
131+
132+
Alterações do plano de fundo também são suportadas e definidas da mesma maneira.
133+
134+
QrCode::backgroundColor(255,255,0);
135+
136+
#### Alteração de Margem
137+
138+
A capacidade de alterar a margem ao redor do QrCode também é suportada. Simplesmente especifique o tamenho desejado da margem, utilizando a sintaxe abaixo:
139+
140+
QrCode::margin(100);
141+
142+
#### Correção de erros
143+
144+
Alterar o nível de correção de erros é simples. Utilize a seguinte sintaxe:
145+
146+
QrCode::errorCorrection('H');
147+
148+
As seguintes opções são suportadas para o método `errorCorrection`.
149+
150+
| Error Correction | Assurance Provided |
151+
| --- | --- |
152+
| L | 7% of codewords can be restored. |
153+
| M | 15% of codewords can be restored. |
154+
| Q | 25% of codewords can be restored. |
155+
| H | 30% of codewords can be restored. |
156+
157+
>The more error correction used; the bigger the QrCode becomes and the less data it can store. Read more about [error correction](http://en.wikipedia.org/wiki/QR_code#Error_correction).
158+
159+
#### Codificação
160+
161+
Alterar a codificação que é usada para criar um QrCode. Por padrão, a encodificação padrão é a `ISO-8859-1`. Leia mais sobre [character encoding](https://pt.wikipedia.org/wiki/Codifica%C3%A7%C3%A3o_de_caracteres) Você pode alterar a codificação usando o seguinte código:
162+
163+
QrCode::encoding('UTF-8')->generate('Make me a QrCode with special symbols ♠♥!!');
164+
165+
| Character Encoder |
166+
| --- |
167+
| ISO-8859-1 |
168+
| ISO-8859-2 |
169+
| ISO-8859-3 |
170+
| ISO-8859-4 |
171+
| ISO-8859-5 |
172+
| ISO-8859-6 |
173+
| ISO-8859-7 |
174+
| ISO-8859-8 |
175+
| ISO-8859-9 |
176+
| ISO-8859-10 |
177+
| ISO-8859-11 |
178+
| ISO-8859-12 |
179+
| ISO-8859-13 |
180+
| ISO-8859-14 |
181+
| ISO-8859-15 |
182+
| ISO-8859-16 |
183+
| SHIFT-JIS |
184+
| WINDOWS-1250 |
185+
| WINDOWS-1251 |
186+
| WINDOWS-1252 |
187+
| WINDOWS-1256 |
188+
| UTF-16BE |
189+
| UTF-8 |
190+
| ASCII |
191+
| GBK |
192+
| EUC-KR |
193+
194+
>Um erro de `Could not encode content to ISO-8859-1` significa que foi inserido algum caractere inválido. Recomendamos o `UTF-8` se você não tiver certeza.
195+
196+
#### Mesclar
197+
198+
O método `merge` mescla uma imagem sobre um Qrcode. É comumente usado para se colocar logos dentro de um QrCode.
199+
200+
QrCode::merge($filename, $percentage, $absolute);
201+
202+
//Gera um QrCode com uma imagem centralizada.
203+
QrCode::format('png')->merge('path-to-image.png')->generate();
204+
205+
//Gera um QrCode com uma imagem centralizada. A imagem inserida ocupará 30% do QrCode.
206+
QrCode::format('png')->merge('path-to-image.png', .3)->generate();
207+
208+
//Gera um QrCode com uma imagem centralizada. A imagem inserida ocupará 30% do QrCode.
209+
QrCode::format('png')->merge('http://www.google.com/someimage.png', .3, true)->generate();
210+
211+
>O método `merge` suporta somente arquivos do tipo PNG.
212+
>O filepath é relativo ao caminho base da aplicação, se o `$absolute` estiver setada para `false`. Altere essa variável para `true` para usar caminhos absolutos.
213+
214+
>Você deve usar um alto nível de correção de erros quando usado o método `merge`, para garantir que o QrCode será legível. Recomendamos usar `errorCorrection('H')`.
215+
216+
![Merged Logo](https://raw.githubusercontent.com/SimpleSoftwareIO/simple-qrcode/master/docs/imgs/merged-qrcode.png?raw=true)
217+
218+
#### Merge Binary String
219+
220+
O método `mergeString` pode ser usado para alcaçar a mesma chamada do método `merge`, exceto que ele permite que você represente uma string de um arquivo ao invés do filepath. Isso é útil quando é utilizado o padrão `Storage` . A chamada a essa interface é bastante similar ao método `merge`.
221+
222+
QrCode::mergeString(Storage::get('path/to/image.png'), $percentage);
223+
224+
//Gera um QrCode com uma imagem centralizada.
225+
QrCode::format('png')->mergeString(Storage::get('path/to/image.png'))->generate();
226+
227+
//Gera um QrCode com uma imagem centralizada. A imagem inserida ocupará 30% do QrCode.
228+
QrCode::format('png')->mergeString(Storage::get('path/to/image.png'), .3)->generate();
229+
230+
>Assim como o método `merge`, somente arquivos do tipo PNG são suportados. O mesmo aplica-se para correção de erros, altos níveis são recomendados.
231+
232+
#### Uso Avançado
233+
234+
Todos os métodos suportam encadeamento. O método `generate` deve ser chamado por ultimo e o método `format` deve ser chamado primeiro. Por exemplo, vocẽ pode executar o código seguinte:
235+
236+
QrCode::size(250)->color(150,90,10)->backgroundColor(10,14,244)->generate('Make me a QrCode!');
237+
QrCode::format('png')->size(399)->color(40,40,40)->generate('Make me a QrCode!');
238+
239+
Você pode exibir uma imagem PNG, sem salvar o arquivo e prover uma string encodificada pelo método `base64_encode`.
240+
241+
<img src="data:image/png;base64, {!! base64_encode(QrCode::format('png')->size(100)->generate('Make me into an QrCode!')) !!} ">
242+
243+
<a id="docs-helpers"></a>
244+
## Ajudantes
245+
246+
#### O que são ajudantes?
247+
248+
Ajudantes são uma maneira fácil de criar QrCodes que executam uma ação quando escaneados.
249+
250+
#### E-Mail
251+
252+
Esse helper, gera um qrcode de e-mail que é capaz de ser preenchido no endereço de e-mail, assunto e corpo.
253+
254+
QrCode::email($to, $subject, $body);
255+
256+
//Fills in the to address
257+
QrCode::email('foo@bar.com');
258+
259+
//Fills in the to address, subject, and body of an e-mail.
260+
QrCode::email('foo@bar.com', 'This is the subject.', 'This is the message body.');
261+
262+
//Fills in just the subject and body of an e-mail.
263+
QrCode::email(null, 'This is the subject.', 'This is the message body.');
264+
265+
#### Geo
266+
267+
Esse helper gera uma latitude e longituded que o pode ser lido por um aparelho celular e abrir a localização no Google maps ou outro aplicativo similar.
268+
269+
QrCode::geo($latitude, $longitude);
270+
271+
QrCode::geo(37.822214, -122.481769);
272+
273+
#### Phone Number
274+
275+
Esse helper, gera uma QrCode que pode ser escaneado exibido um telefone.
276+
277+
QrCode::phoneNumber($phoneNumber);
278+
279+
QrCode::phoneNumber('555-555-5555');
280+
QrCode::phoneNumber('1-800-Laravel');
281+
282+
#### SMS (Mensagens de Texto)
283+
284+
Esse Helper, cria uma mensagem SMS que pode ser This helper makes SMS messages that can be preenchida com o emissoe e o corpo da mensagem.
285+
286+
QrCode::SMS($phoneNumber, $message);
287+
288+
//Cria uma mensagem de texto com o telefone preenchido.
289+
QrCode::SMS('555-555-5555');
290+
291+
//Cria uma mensagem de text com o numero telefonico e a mensagem preenchida.
292+
QrCode::SMS('555-555-5555', 'Body of the message');
293+
294+
#### WiFi
295+
296+
Esse Helper, faz com que QrCodes escaneaveis, permitam o aparelho celular se conectar a uma rede WI-FI.
297+
298+
QrCode::wiFi([
299+
'encryption' => 'WPA/WEP',
300+
'ssid' => 'SSID of the network',
301+
'password' => 'Password of the network',
302+
'hidden' => 'Whether the network is a hidden SSID or not.'
303+
]);
304+
305+
//Connects to an open WiFi network.
306+
QrCode::wiFi([
307+
'ssid' => 'Network Name',
308+
]);
309+
310+
//Connects to an open, hidden WiFi network.
311+
QrCode::wiFi([
312+
'ssid' => 'Network Name',
313+
'hidden' => 'true'
314+
]);
315+
316+
//Connects to an secured, WiFi network.
317+
QrCode::wiFi([
318+
'ssid' => 'Network Name',
319+
'encryption' => 'WPA',
320+
'password' => 'myPassword'
321+
]);
322+
323+
>Escaneamento WIFI atualmente não são suportados nos produtos Apple.
324+
325+
<a id="docs-common-usage"></a>
326+
##Uso Comum do QRCode
327+
328+
Você pode usar um prefixo listado na tabela abaixo dentro da seção `generate` para criar um QrCode para armazenar informações mais avançadas:
329+
330+
QrCode::generate('http://www.simplesoftware.io');
331+
332+
333+
| Usage | Prefix | Example |
334+
| --- | --- | --- |
335+
| Website URL | http:// | http://www.simplesoftware.io |
336+
| Secured URL | https:// | https://www.simplesoftware.io |
337+
| E-mail Address | mailto: | mailto:support@simplesoftware.io |
338+
| Phone Number | tel: | tel:555-555-5555 |
339+
| Text (SMS) | sms: | sms:555-555-5555 |
340+
| Text (SMS) With Pretyped Message | sms: | sms::I am a pretyped message |
341+
| Text (SMS) With Pretyped Message and Number | sms: | sms:555-555-5555:I am a pretyped message |
342+
| Geo Address | geo: | geo:-78.400364,-85.916993 |
343+
| MeCard | mecard: | MECARD:Simple, Software;Some Address, Somewhere, 20430;TEL:555-555-5555;EMAIL:support@simplesoftware.io; |
344+
| VCard | BEGIN:VCARD | [See Examples](https://en.wikipedia.org/wiki/VCard) |
345+
| Wifi | wifi: | wifi:WEP/WPA;SSID;PSK;Hidden(True/False) |
346+
347+
<a id="docs-outside-laravel"></a>
348+
##Uso fora do Laravel
349+
350+
Você pode usar o pacote fora do Laravel instanciando a classe `BaconQrCodeGenerator`.
351+
352+
use SimpleSoftwareIO\QrCode\BaconQrCodeGenerator;
353+
354+
$qrcode = new BaconQrCodeGenerator;
355+
$qrcode->size(500)->generate('Make a qrcode without Laravel!');

0 commit comments

Comments
 (0)