# Utilisez UptoSign dans votre plugin Dolibarr

Vous voulez sceller ou faire signer des documents PDF depuis votre plugin dolibarr ? suivez le guide !

## La base

Le module UptoSign propose un objet (au sens PHP) facile à utiliser pour des développeurs tiers: c'est l'objet UptoSignCore.

Ajoutez uptosigncore dans vos include:

```
dol_include_once('/uptosign/class/uptosignCore.class.php');
```

Instanciez un objet uptosignCore et utilisez le :

```

$uptosignCore = new uptosignCore([
	'db'=>$db,
	'src_file_name'=>'/var/www/dolibarr-14/documents/toto.pdf', // fichier pdf à faire signer ou sceller
	'object' => $invoice,
	'list_of_signers' => null,
	'procedure' => 'seal', // ou "sign" si vous voulez lancer une signature, voir plus loin
	'plugin_name' => 'SuperTest-1.0', // le nom de votre plugin
	'pos_x' => 60, //position x (en mm) du sceau uptosign
	'pos_y' => 20, //position y (en mm) du sceau uptosign
	'seal_page' => 1, //numéro de la page, -1 pour dernière page, -2 pour avant-dernière page ...
	'title' => 'Mon super document PDF à sceller '
]);
```

## Et lancez la procédure de scellement

Par exemple

```
$res = $uptosignCore->run();
```

C'est tout ! Votre document est envoyé pour être scellé.

## Lancer une signature

La signature est un peu plus longue dans la mesure où vous devez lister les signataires et indiquer à uptosign où les signatures doivent être apposées sur le document !
### La liste des signataires

```
        $list_of_signers = array();
        $list_of_signers[] = array('id' => 15,
                                    'firstname' => 'Eric',
                                    'lastname' => 'SEIGNE',
                                    'company' => 'CAP-REL',
                                    'email' => 'eric.seigne@cap-rel.fr',
                                    'mobile' => '+33698744401',
                                    'sign_page' => 1,
                                    'sign_pos_x' => 80,
                                    'sign_pos_y' => 100 );
        $list_of_signers[] = array('id' => 28,
                                    'firstname' => 'Client',
                                    'lastname' => 'SYMPA',
                                    'company' => 'ENTREPRISE',
                                    'email' => 'client.sympa@caprel.fr',
                                    'mobile' => '+337123123123',
                                    'sign_age' => 1,
                                    'sign_pos_x' => 20,
                                    'sign_pos_y' => 100 );

```

### L'objet uptosignCore


```
$uptosignCore = new uptosignCore([
	'db'=>$db,
	'src_file_name'=>'/var/www/dolibarr-14/documents/toto.pdf', // fichier pdf à faire signer
	'object' => $invoice,
	'list_of_signers' => $list_of_signers,
	'procedure' => 'sign',
	'plugin_name' => 'SuperTest-1.0', // le nom de votre plugin
	'pos_x' => 60, //position x (en mm) du sceau uptosign
	'pos_y' => 20, //position y (en mm) du sceau uptosign
	'seal_page' => 1, //numéro de la page, -1 pour dernière page, -2 pour avant-dernière page ...
	'title' => 'Mon super document PDF à signer '
]);
```

### Et lancez la procédure de signature

Par exemple

```
$res = $uptosignCore->run();
```

C'est tout ! Votre document est envoyé pour être signé par les différentes parties.