Current File : /home2/selectio/public_html/limpiar.in.net/vendor/simplesoftwareio/simple-qrcode/docs/it/README.md
[](https://travis-ci.org/SimpleSoftwareIO/simple-qrcode) [](https://packagist.org/packages/simplesoftwareio/simple-qrcode) [](https://packagist.org/packages/simplesoftwareio/simple-qrcode) [](https://packagist.org/packages/simplesoftwareio/simple-qrcode) [](https://packagist.org/packages/simplesoftwareio/simple-qrcode)
- [Introduzione](#docs-introduction)
- [Traduzioni](#docs-translations)
- [Configurazione](#docs-configuration)
- [Semplici Utilizzi](#docs-ideas)
- [Utilizzo](#docs-usage)
- [Helpers](#docs-helpers)
- [Uso generico dei QrCode](#docs-common-usage)
- [Uso al di fuori di Laravel](#docs-outside-laravel)
<a id="docs-introduction"></a>
## Introduzione
Simple QrCode è un semplice wrapper per il popolare framework Laravel basato sul bellissimo lavoro [Bacon/BaconQrCode](https://github.com/Bacon/BaconQrCode). Abbiamo creato un'interfaccia familiare e semplice da installare per gli utenti Laravel.
<a id="docs-translations"></a>
## Traduzioni
Siamo alla ricerca di utenti che ci aiutino a tradurre la documentazione in Arabo, Spagnolo, Francese, Coreano o Giapponese. Se pensate di potercela fare non esitate a fare una pull request!
<a id="docs-configuration"></a>
## Configurazione
#### Composer
Per prima cosa, aggiungete il pacchetto di Simple QrCode al file `require` in `composer.json`:
"require": {
"simplesoftwareio/simple-qrcode": "~2"
}
Ora lanciate il comando `composer update`.
#### Service Provider
###### Laravel <= 5.4
Registrate `SimpleSoftwareIO\QrCode\QrCodeServiceProvider::class` nel vostro `config/app.php` all'interno dell'array `providers`.
#### Alias
###### Laravel <= 5.4
Infine, registrate `'QrCode' => SimpleSoftwareIO\QrCode\Facades\QrCode::class` nel vostro file di configurazione `config/app.php` all'interno dell'array `aliases`.
<a id="docs-ideas"></a>
## Semplici Utilizzi
#### Print View
Uno degli usi principali di questo pacchetto è la possibilità di avere codici Qr in tutte le nostre print views. Questo permette all'utente di tornare alla pagina originale semplicemente facendo lo scan del codice. Tutto ciò è possibile aggiungendo le seguenti linee nel nostro footer.blade.php.
<div class="visible-print text-center">
{!! QrCode::size(100)->generate(Request::url()); !!}
<p>Scansionami per tornare alla pagina principale.</p>
</div>
#### Incorporare un QrCode
Potreste incorporare un codice Qr in una e-mail per permettere agli utenti uno scan immediato. Il seguente è un esempio di come potresti fare tutto ciò con Laravel.
//Inside of a blade template.
<img src="{!!$message->embedData(QrCode::format('png')->generate('Incorporami in una e-mail!'), 'QrCode.png', 'image/png')!!}">
<a id="docs-usage"></a>
## Utilizzo
#### Utilizzo Base
Usare il generatori di codici Qr è molto semplice. La sintassi più semplice è:
QrCode::generate('Trasformami in un QrCode!');
Questo comando produrrà un codice Qr che dice "Trasformami in un QrCode!"
#### Generate
`Generate` è usato per creare codici Qr:
QrCode::generate('Trasformami in un QrCode!');
>Attenzione! Questo metodo deve essere chiamato per ultimo se lo si usa all'interno di una catena (chain).
`Generate` restituirà, di default, una stringa di immagini SVG. Puoi stamparla direttamente in un browser recente dal sistema Blade di Laravel con il seguente codice:
{!! QrCode::generate('Make me into a QrCode!'); !!}
Il metodo `generate` accetta un secondo parametro che indica la directory nella quale verrà salvato il codice Qr.
QrCode::generate('Make me into a QrCode!', '../public/qrcodes/qrcode.svg');
#### Variazione del formato
>QrCode Generator è impostato di default per generare immagini SVG.
>Attenzione! Il metodo `format` deve essere chiamato prima di qualunque altra opzione di formato come `size`, `color`, `backgroundColor`, o `margin`.
Momentaneamente, sono supportati tre formati: PNG, EPS e SVG. Per cambiare il formato usare uno dei seguenti comandi:
QrCode::format('png'); //Genererà un'immagine PNG
QrCode::format('eps'); //Genererà un'immagine EPS
QrCode::format('svg'); //Genererà un'immagine SVG
#### Variazione della grandezza
>QrCode Generator restituirà, di default, la più piccola grandezza possibile per creare il QrCode.
Puoi cambiare la grandezza del codice Qr usando il metodo `size`. Basta specificare la grandezza desiderata, in pixel, usando la seguente sintassi:
QrCode::size(100);
#### Variazione del colore
>Fai attenzione quando cambi il colore di un QrCode! Alcuni lettori potrebbero avere dei problemi a leggere dei codici Qr colorati diversamente.
Tutti i colori dovranno essere espressi in RGB (Rosso Verde Blu). Puoi cambiare il colore di un QrCode usando questa sintassi:
QrCode::color(255,0,255);
Puoi anche cambiare il colore di sfondo con la seguente istruzione:
QrCode::backgroundColor(255,255,0);
#### Variazione del margine
E' anche possibile variare il margine attorno al codice Qr. Basta infatti specificare la grandezza del margine nella seguente sintassi:
QrCode::margin(100);
#### Correzione dell'errore
Cambiare il livello di correzione dell'errore è facile. Per farlo, usare questa sintassi:
QrCode::errorCorrection('H');
Seguono le opzioni supportate dal metodo `errorCorrection`.
| Error Correction | Assurance Provided |
| --- | --- |
| L | 7% of codewords can be restored. |
| M | 15% of codewords can be restored. |
| Q | 25% of codewords can be restored. |
| H | 30% of codewords can be restored. |
>Più error correction viene usata, più sarà grande il QrCode e meno dati sarà in grando di contenere. Leggi di più a riguardo [error correction](http://en.wikipedia.org/wiki/QR_code#Error_correction).
#### Encoding
Puoi cambiare l'encoding dei caratteri utilizzato per creare il codice Qr. Di default è selezionato `ISO-8859-1`. Leggi di più a riguardo [character encoding](http://en.wikipedia.org/wiki/Character_encoding)
Puoi cambiare l'encoding utilizzando:
QrCode::encoding('UTF-8')->generate('Trasformami in un QrCode con simboli speciali ??!!');
| Encoder dei caratteri |
| --- |
| ISO-8859-1 |
| ISO-8859-2 |
| ISO-8859-3 |
| ISO-8859-4 |
| ISO-8859-5 |
| ISO-8859-6 |
| ISO-8859-7 |
| ISO-8859-8 |
| ISO-8859-9 |
| ISO-8859-10 |
| ISO-8859-11 |
| ISO-8859-12 |
| ISO-8859-13 |
| ISO-8859-14 |
| ISO-8859-15 |
| ISO-8859-16 |
| SHIFT-JIS |
| WINDOWS-1250 |
| WINDOWS-1251 |
| WINDOWS-1252 |
| WINDOWS-1256 |
| UTF-16BE |
| UTF-8 |
| ASCII |
| GBK |
| EUC-KR |
>L'errore `Could not encode content to ISO-8859-1` significa che si sta usando l'encoding erraro. E' raccomandato usare `UTF-8` se non si è sicuri.
#### Merge
Il metodo `merge` unisce un immagine con un QrCode. Il merge è molto usato per inserire loghi in un codice Qr.
QrCode::merge($filename, $percentage, $absolute);
//Genera un QrCode con una immagine al centro.
QrCode::format('png')->merge('path-to-image.png')->generate();
//Genera un QrCode con una immagine al centro. L'immagine inserita occupa il 30% del codice Qr.
QrCode::format('png')->merge('path-to-image.png', .3)->generate();
//Genera un QrCode con una immagine al centro. L'immagine inserita occupa il 30% del codice Qr.
QrCode::format('png')->merge('http://www.google.com/someimage.png', .3, true)->generate();
>Il metodo `merge` supporta solamente il formato PNG.
>Il percorso specificato è relativo alla base path se `$absolute` è impostata su `false`. Cambiare questa variabile in `true` per utilizzare percorsi assoluti.
>Dovresti usare un alto livello di error correction quando usi il metodo `merge` per assicurarti che il Qr sia ancora leggibile. Raccomandiamo di usare `errorCorrection('H')`.
#### Merge Binary String
Il metodo `mergeString` può essere usato per ottenere quasi lo stesso risultato di `merge`, con la differenza che permette di inserire una rappresentazione testuale del file al posto del percorso. Questo è utile quando si lavora con la facade `Storage`. La sua interfaccia è molto simile a quella di `merge`.
QrCode::mergeString(Storage::get('path/to/image.png'), $percentage);
//Genera un QrCode con una immagine al centro.
QrCode::format('png')->mergeString(Storage::get('path/to/image.png'))->generate();
//Genera un QrCode con una immagine al centro. L'immagine inserita occupa il 30% del codice Qr.
QrCode::format('png')->mergeString(Storage::get('path/to/image.png'), .3)->generate();
>Come la chiamata a `merge`, anche questa volta è supportato solamente il formato PNG. Lo stesso vale per gli error correction, H è il valore raccomandato.
#### Utilizzo Avanzato
Tutti i metodi supportano il chaining. Il metodo `generate` deve essere chiamato per ultimo e tutti gli eventuali metodi `format` devono essere chiamati per primi. Per esempio sono validi i seguenti:
QrCode::size(250)->color(150,90,10)->backgroundColor(10,14,244)->generate('Make me a QrCode!');
QrCode::format('png')->size(399)->color(40,40,40)->generate('Trasformami in un QrCode!');
Puoi mostrare un'immagine PNG senza salvare il file relativo impostando una stringa e scegliendo l'encoding `base64_encode`.
<img src="data:image/png;base64, {!! base64_encode(QrCode::format('png')->size(100)->generate('Trasformami in un QrCode!')) !!} ">
<a id="docs-helpers"></a>
## Helpers
#### Cosa sono gli helpers?
Gli Helpers sono un metodo molto semplice per creare codici Qr che permettono al lettore di eseguire una certa azione quando scansionati.
#### E-Mail
Questo helper genera un QrCode in grado di riempire i campi di una e-mail quali indirizzo, oggetto e corpo.
QrCode::email($to, $subject, $body);
//Fills in the to address
QrCode::email('foo@bar.com');
//Fills in the to address, subject, and body of an e-mail.
QrCode::email('foo@bar.com', 'Questo è l'oggetto.', 'Questo è il corpo del messaggio.');
//Fills in just the subject and body of an e-mail.
QrCode::email(null, 'Questo è l'oggetto.', 'Questo è il corpo del messaggio.');
#### Geo
Questo helper genera una latitudine e una longitudine che un telefono può leggere ed aprire con Google Maps o applicazioni simili.
QrCode::geo($latitude, $longitude);
QrCode::geo(37.822214, -122.481769);
#### Numeri di Telefono
Questo helper genera un QrCode che, una volta scansionato, digita un numero di telefono.
QrCode::phoneNumber($phoneNumber);
QrCode::phoneNumber('555-555-5555');
QrCode::phoneNumber('1-800-Laravel');
#### SMS (Messaggi)
Questo helper crea messaggi SMS che possono essere precompilati con il destinatario e il corpo del messaggio.
QrCode::SMS($phoneNumber, $message);
//Creates a text message with the number filled in.
QrCode::SMS('555-555-5555');
//Creates a text message with the number and message filled in.
QrCode::SMS('555-555-5555', 'Corpo del messaggio.');
#### WiFi
Questo helper crea codici Qr scansionabili che permettono la connessione del telefono ad una determinata rete WiFi.
QrCode::wiFi([
'encryption' => 'WPA/WEP',
'ssid' => 'SSID della rete',
'password' => 'Password della rete',
'hidden' => 'Whether the network is a hidden SSID or not.'
]);
//Connects to an open WiFi network.
QrCode::wiFi([
'ssid' => 'Nome Rete',
]);
//Connects to an open, hidden WiFi network.
QrCode::wiFi([
'ssid' => 'Nome Rete',
'hidden' => 'true'
]);
//Connects to an secured, WiFi network.
QrCode::wiFi([
'ssid' => 'Nome Rete',
'encryption' => 'WPA',
'password' => 'miaPassword'
]);
>La scansione WiFi non è al momento supportata sui dispositivi Apple.
<a id="docs-common-usage"></a>
##Uso generico dei QrCode
Puoi utilizzare un prefisso della tabella sottostante per generare dei codici Qr in grado di contenere maggiori informazioni:
QrCode::generate('http://www.simplesoftware.io');
| Usage | Prefix | Example |
| --- | --- | --- |
| Website URL | http:// | http://www.simplesoftware.io |
| Secured URL | https:// | https://www.simplesoftware.io |
| E-mail Address | mailto: | mailto:support@simplesoftware.io |
| Phone Number | tel: | tel:555-555-5555 |
| Text (SMS) | sms: | sms:555-555-5555 |
| Text (SMS) With Pretyped Message | sms: | sms::I am a pretyped message |
| Text (SMS) With Pretyped Message and Number | sms: | sms:555-555-5555:I am a pretyped message |
| Geo Address | geo: | geo:-78.400364,-85.916993 |
| MeCard | mecard: | MECARD:Simple, Software;Some Address, Somewhere, 20430;TEL:555-555-5555;EMAIL:support@simplesoftware.io; |
| VCard | BEGIN:VCARD | [See Examples](https://en.wikipedia.org/wiki/VCard) |
| Wifi | wifi: | wifi:WEP/WPA;SSID;PSK;Hidden(True/False) |
<a id="docs-outside-laravel"></a>
##Uso al di fuori di Laravel
Puoi usare questo package al di fuori di Laravel istanziando una nuova classe `BaconQrCodeGenerator`.
use SimpleSoftwareIO\QrCode\BaconQrCodeGenerator;
$qrcode = new BaconQrCodeGenerator;
$qrcode->size(500)->generate('Crea un QrCode senza Laravel!');
Mini Shell