**Ceci est une ancienne révision du document !**
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', 'signPage' => 1, 'signPosX' => 80, 'signPosY' => 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.