Skip to content

Commit ae5b03f

Browse files
SimplyCoreySimplyCorey
authored
Merge pull request #61 from gtarraga/develop
Translated in spanish
2 parents f141814 + 4a6b98d commit ae5b03f

File tree

1 file changed

+354
-0
lines changed

1 file changed

+354
-0
lines changed

‎docs/es/README.md‎

Lines changed: 354 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,354 @@
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+
[Italiano](https://www.simplesoftware.io/docs/simple-qrcode/it) | [Русский](https://www.simplesoftware.io/docs/simple-qrcode/ru) | [汉语](https://www.simplesoftware.io/docs/simple-qrcode/zh)
10+
11+
- [Introducción](#docs-introduction)
12+
- [Traducciones](#docs-translations)
13+
- [Configuración](#docs-configuration)
14+
- [Ideas Simples](#docs-ideas)
15+
- [Uso](#docs-usage)
16+
- [Helpers](#docs-helpers)
17+
- [Uso Común de QrCode](#docs-common-usage)
18+
- [Uso fuera de Laravel](#docs-outside-laravel)
19+
20+
<a id="docs-introduction"></a>
21+
## Introducción
22+
Simple QrCode es un empaquetador de fácil uso para el popular framework Laravel basado en el gran trabajo proporcionado por [Bacon/BaconQrCode](https://github.com/Bacon/BaconQrCode). Hemos creado una interfaz que es familiar y fácil de usar para los usuarios de Laravel.
23+
24+
<a id="docs-translations"></a>
25+
## Traducciones
26+
Estamos buscando usuarios que hablen Árabe, Francés, Coreano o Japonés para traducir este documento. Porfavor cread una pull request si podeis ayudar con una traducción!
27+
28+
<a id="docs-configuration"></a>
29+
## Configuración
30+
31+
#### Composer
32+
33+
Primero, añadir el paquete Simple QrCode en su `require` en su archivo `composer.json`:
34+
35+
"require": {
36+
"simplesoftwareio/simple-qrcode": "~1"
37+
}
38+
39+
Luego, ejecutar el comando `composer update`.
40+
41+
#### Service Provider
42+
43+
###### Laravel 4
44+
Registrar `SimpleSoftwareIO\QrCode\QrCodeServiceProvider` en su `app/config/app.php` dentro del array `providers`.
45+
46+
###### Laravel 5
47+
Registrar `SimpleSoftwareIO\QrCode\QrCodeServiceProvider::class` en su `config/app.php` dentro del array `providers`.
48+
49+
#### Aliases
50+
51+
###### Laravel 4
52+
Finalmente, registrar `'QrCode' => 'SimpleSoftwareIO\QrCode\Facades\QrCode'` en su archivo de configuración `app/config/app.php` dentro del array `aliases`.
53+
54+
###### Laravel 5
55+
Finalmente, registrar `'QrCode' => SimpleSoftwareIO\QrCode\Facades\QrCode::class` en su archivo de configuración `config/app.php` dentro del array `aliases`.
56+
57+
<a id="docs-ideas"></a>
58+
## Ideas Simples
59+
60+
#### Print View
61+
62+
Uno de los principales usos de este paquete es la posibilidad de disponer QrCodes en todas nuestras print views. Esto permite a nuestros usuarios volver a la página original después de imprimir simplemente escaneando el código. Todo esto es posible añadiendo lo siguiente en nuestro archivo `footer.blade.php´.
63+
64+
<div class="visible-print text-center">
65+
{!! QrCode::size(100)->generate(Request::url()); !!}
66+
<p>Escanéame para volver a la página principal.</p>
67+
</div>
68+
69+
#### Incorporar un QrCode
70+
71+
Puedes incorporar un código Qr en un e-mail para permitir a los usuarios un ágil escaneo. El ejemplo siguiente muestra como hacer esto con Laravel.
72+
73+
//Inside of a blade template.
74+
<img src="{!!$message->embedData(QrCode::format('png')->generate('Incorpórame en un e-mail!'), 'QrCode.png', 'image/png')!!}">
75+
76+
<a id="docs-usage"></a>
77+
## Uso
78+
79+
#### Uso Básico
80+
81+
Usar el QrCode Generator es muy simple. La sintaxis más básica es:
82+
83+
QrCode::generate('Transfórmame en un QrCode!');
84+
85+
Esto creara un código que diga "Transfórmame en un QrCode!"
86+
87+
#### Generate
88+
89+
`Generate` se usa para crear el QrCode.
90+
91+
QrCode::generate('Transfórmame en un QrCode!');
92+
93+
>Atención! Este método debe de ser usado el último si se usa dentro de una cadena de comandos (chain).
94+
95+
`Generate` por defecto devolverá un string de una imagen SVG. Puedes imprimirla directamente en un navegador moderno con el sistema Blade de Laravel con el siguiente código:
96+
97+
{!! QrCode::generate('Transfórmame en un QrCode!'); !!}
98+
99+
El método `generate` tiene un segundo parámetro que aceptará un nombre de archivo y un directorio para guardar el QrCode.
100+
101+
QrCode::generate('Transfórmame en un QrCode!', '../public/qrcodes/qrcode.svg');
102+
103+
#### Cambio de Formato
104+
105+
>QrCode Generator por defecto devolverá una imagen SVG.
106+
107+
>Atención! El método `format` tiene que ser usado antes que cualquier opción de formato como `size`, `color`, `backgroundColor`, o `margin`.
108+
109+
Actualmente hay 3 formatos compatibles; PNG, EPS, and SVG. Para cambiar el formato usa el siguiente código:
110+
111+
QrCode::format('png'); //Devolvera una imagen PNG
112+
QrCode::format('eps'); //Devolvera una imagen EPS
113+
QrCode::format('svg'); //Devolvera una imagen SVG
114+
115+
#### Cambio de Tamaño
116+
117+
>QrCode Generator devolverá por defecto el tamaño de píxels mínimo para crear el QrCode.
118+
119+
Puedes cambiar el tamaño de un QrCode usando el método `size`. Simplemente especifica el tamaño deseado en píxels usando el siguiente código:
120+
121+
QrCode::size(100);
122+
123+
#### Cambio de Color
124+
125+
>Presta atención al cambiar el color de un QrCode. Algunos lectores tienen dificultades al leer QrCodes en color.
126+
127+
Todos los colores deben ser expresados en RGB (Red Green Blue). Puedes cambiar el color del QrCode usando el siguiente código:
128+
129+
QrCode::color(255,0,255);
130+
131+
Para cambiar el color del fondo usamos:
132+
133+
QrCode::backgroundColor(255,255,0);
134+
135+
#### Cambio de Márgenes
136+
137+
Es posible cambiar el márgen alrededor del QrCode. Simplemente especificamos el márgen deseado usando el siguiente código:
138+
139+
QrCode::margin(100);
140+
141+
#### Corrección de Errores
142+
143+
Cambiar el nivel de corrección de errores es fácil. Unicamente usa el siguiente código:
144+
145+
QrCode::errorCorrection('H');
146+
147+
Las siguientes opciónes son compatibles con el método de `errorCorrection`.
148+
149+
| Error Correction | Assurance Provided |
150+
| --- | --- |
151+
| L | 7% of codewords can be restored. |
152+
| M | 15% of codewords can be restored. |
153+
| Q | 25% of codewords can be restored. |
154+
| H | 30% of codewords can be restored. |
155+
156+
>Cuanto más corrección de error se usa; el QrCode aumenta y puede almacenar menos datos. Para saber más sobre [corrección de error](http://en.wikipedia.org/wiki/QR_code#Error_correction).
157+
158+
#### Encoding
159+
160+
Para cambiar la codificación de carácteres que se usa para crear un QrCode. Por defecto `ISO-8859-1` está seleccionado. Para saber más sobre [codificación de carácteres](http://en.wikipedia.org/wiki/Character_encoding) You can change this to any of the following:
161+
162+
QrCode::encoding('UTF-8')->generate('Transfórmame en un QrCode con símbolos especiales ♠♥!!');
163+
164+
| Codificador de carácteres |
165+
| --- |
166+
| ISO-8859-1 |
167+
| ISO-8859-2 |
168+
| ISO-8859-3 |
169+
| ISO-8859-4 |
170+
| ISO-8859-5 |
171+
| ISO-8859-6 |
172+
| ISO-8859-7 |
173+
| ISO-8859-8 |
174+
| ISO-8859-9 |
175+
| ISO-8859-10 |
176+
| ISO-8859-11 |
177+
| ISO-8859-12 |
178+
| ISO-8859-13 |
179+
| ISO-8859-14 |
180+
| ISO-8859-15 |
181+
| ISO-8859-16 |
182+
| SHIFT-JIS |
183+
| WINDOWS-1250 |
184+
| WINDOWS-1251 |
185+
| WINDOWS-1252 |
186+
| WINDOWS-1256 |
187+
| UTF-16BE |
188+
| UTF-8 |
189+
| ASCII |
190+
| GBK |
191+
| EUC-KR |
192+
193+
>Un error de `Could not encode content to ISO-8859-1` significa que se esta usando una codificación de carácteres incorrecta. Recomendamos `UTF-8` si no está seguro.
194+
195+
#### Merge
196+
197+
El método `merge` une una imagen con un QrCode. Normalmente se usa para añadir logos en un QrCode.
198+
199+
QrCode::merge($filename, $percentage, $absolute);
200+
201+
//Genera un QrCode con una imagen en el centro.
202+
QrCode::format('png')->merge('path-to-image.png')->generate();
203+
204+
//Genera un QrCode con una imagen en el centro. La imagen ocupa un 30% del QrCode.
205+
QrCode::format('png')->merge('path-to-image.png', .3)->generate();
206+
207+
//Genera un QrCode con una imagen en el centro. La imagen ocupa un 30% del QrCode.
208+
QrCode::format('png')->merge('http://www.google.com/someimage.png', .3, true)->generate();
209+
210+
>El método `merge` sólo es compatible con PNG de momento.
211+
>El path del archivo es relativo al path de la app si `$absolute` equivale a `false`. Cambia esta variable a `true` para usar paths absolutos.
212+
213+
>Se debería usar un nivel alto de corrección de error al usar `merge` para asegurarse que el QrCode se sigue podiendo leer. Recomendamos usar `errorCorrection('H')`.
214+
215+
![Merged Logo](https://raw.githubusercontent.com/SimpleSoftwareIO/simple-qrcode/master/docs/imgs/merged-qrcode.png?raw=true)
216+
217+
#### Merge Binary String
218+
219+
El método `mergeString` se puede usar para conseguir el mismo resultado que con `merge`, con la diferencia que permite proveer una representación en string del archivo en vez de el filepath. Ésto es útil al trabajar con el `Storage` facade. Su interfaz es muy similar a la de `merge`.
220+
221+
QrCode::mergeString(Storage::get('path/to/image.png'), $percentage);
222+
223+
//Genera un QrCode con una imagen en el centro.
224+
QrCode::format('png')->mergeString(Storage::get('path/to/image.png'))->generate();
225+
226+
//Genera un QrCode con una imagen en el centro. La imagen ocupa un 30% del QrCode.
227+
QrCode::format('png')->mergeString(Storage::get('path/to/image.png'), .3)->generate();
228+
229+
>Igual que con `merge`, sólo PNG de momento. Lo mismo que con el nivel de corrección de error, alto nivel está recomendado.
230+
231+
#### Uso Avanzado
232+
233+
Todos los métodos soportan chaining. El método `generate` tiene que ser el último y cualquier cambio de `format` tiene que ser llamado primero. Por ejemplo:
234+
235+
QrCode::size(250)->color(150,90,10)->backgroundColor(10,14,244)->generate('Transfórmame en un QrCode!');
236+
QrCode::format('png')->size(399)->color(40,40,40)->generate('Transfórmame en un QrCode!');
237+
238+
Puedes mostrar una imagen PNG sin guardar el archivo usando una string y eligiendo la codificación `base64_encode`.
239+
240+
<img src="data:image/png;base64, {!! base64_encode(QrCode::format('png')->size(100)->generate('Transfórmame en un QrCode!')) !!} ">
241+
242+
<a id="docs-helpers"></a>
243+
## Helpers
244+
245+
#### Qué son los helpers?
246+
247+
Los helpers son una manera fácil de crear QrCodes que causan que causan una acción en el lector al escanear.
248+
249+
#### E-Mail
250+
251+
Este helper genera un QrCode de e-mail que es capaz de rellenar dirección e-mail, asunto, y el cuerpo del e-mail.
252+
253+
QrCode::email($to, $subject, $body);
254+
255+
//Rellena la dirección
256+
QrCode::email('foo@bar.com');
257+
258+
//Rellena la dirección, el asunto y el cuerpo.
259+
QrCode::email('foo@bar.com', 'This is the subject.', 'This is the message body.');
260+
261+
//Solo rellena el asunto y el cuerpo del e-mail.
262+
QrCode::email(null, 'This is the subject.', 'This is the message body.');
263+
264+
#### Geo
265+
266+
Este helper genera una latitude y una longitude que un teléfono puede leer y abrir la localización en Google Maps o alguna app similar.
267+
268+
QrCode::geo($latitude, $longitude);
269+
270+
QrCode::geo(37.822214, -122.481769);
271+
272+
#### Phone Number
273+
274+
Este helper genera un QrCode que puede ser escaneado y llama a un número de teléfono.
275+
276+
QrCode::phoneNumber($phoneNumber);
277+
278+
QrCode::phoneNumber('555-555-5555');
279+
QrCode::phoneNumber('1-800-Laravel');
280+
281+
#### SMS (Mensajes de texto)
282+
283+
Este helper crea SMS que pueden ser previamente rellenados con la dirección y el mensaje.
284+
285+
QrCode::SMS($phoneNumber, $message);
286+
287+
//Crea un mensaje de texto con el número rellenado.
288+
QrCode::SMS('555-555-5555');
289+
290+
//Crea un mensaje de texto con el número y el mensaje rellenados.
291+
QrCode::SMS('555-555-5555', 'Mensaje');
292+
293+
#### WiFi
294+
295+
Este helpers crea QrCodes que conectan un teléfono a una red WiFI.
296+
297+
QrCode::wiFi([
298+
'encryption' => 'WPA/WEP',
299+
'ssid' => 'SSID de la red',
300+
'password' => 'Password de la red',
301+
'hidden' => 'Si la red tiene SSID oculta o no.'
302+
]);
303+
304+
//Conecta a una red abierta.
305+
QrCode::wiFi([
306+
'ssid' => 'Network Name',
307+
]);
308+
309+
//Conecta a una red abierta y oculta.
310+
QrCode::wiFi([
311+
'ssid' => 'Network Name',
312+
'hidden' => 'true'
313+
]);
314+
315+
//Conecta a una red segura.
316+
QrCode::wiFi([
317+
'ssid' => 'Network Name',
318+
'encryption' => 'WPA',
319+
'password' => 'myPassword'
320+
]);
321+
322+
>WiFi scanning no es compatible con productos Apple.
323+
324+
<a id="docs-common-usage"></a>
325+
##Uso común de QrCode
326+
327+
Puedes usar un prefijo de la tabla dentro de la sección `generate` para crear un QrCode que almacene informacion avanzada:
328+
329+
QrCode::generate('http://www.simplesoftware.io');
330+
331+
332+
| Usage | Prefix | Example |
333+
| --- | --- | --- |
334+
| Website URL | http:// | http://www.simplesoftware.io |
335+
| Secured URL | https:// | https://www.simplesoftware.io |
336+
| E-mail Address | mailto: | mailto:support@simplesoftware.io |
337+
| Phone Number | tel: | tel:555-555-5555 |
338+
| Text (SMS) | sms: | sms:555-555-5555 |
339+
| Text (SMS) With Pretyped Message | sms: | sms::I am a pretyped message |
340+
| Text (SMS) With Pretyped Message and Number | sms: | sms:555-555-5555:I am a pretyped message |
341+
| Geo Address | geo: | geo:-78.400364,-85.916993 |
342+
| MeCard | mecard: | MECARD:Simple, Software;Some Address, Somewhere, 20430;TEL:555-555-5555;EMAIL:support@simplesoftware.io; |
343+
| VCard | BEGIN:VCARD | [See Examples](https://en.wikipedia.org/wiki/VCard) |
344+
| Wifi | wifi: | wifi:WEP/WPA;SSID;PSK;Hidden(True/False) |
345+
346+
<a id="docs-outside-laravel"></a>
347+
##Uso fuera de Laravel
348+
349+
Puedes usar este paquete fuera de Laravel instanciando una nueva clase `BaconQrCodeGenerator`.
350+
351+
use SimpleSoftwareIO\QrCode\BaconQrCodeGenerator;
352+
353+
$qrcode = new BaconQrCodeGenerator;
354+
$qrcode->size(500)->generate('Crea un QrCode sin Laravel!');

0 commit comments

Comments
 (0)