El propósito de esta sección es ofrecer un ‘Inicio rápido’ a las personas que quieren utilizar nuestro Kit de Desarrollo y están buscando ejemplos para comenzar. En nuestra documentación también encontrará algunos ejemplos, y cuando descargue nuestra librería notará que también contiene un archivo con códigos de ejemplos. Esperamos que esta sección no esté muy recargada.

Actualmente nuestro Kit de Desarrollo está disponible únicamente en PHP. Consiste de un archivo de librería que deberá ser incluido en cada archivo PHP en el cual quiera utilizar nuestro servicio. Recomendamos el uso de los bloques ‘’Try / Catch’’ para poder atrapar las excepciones de manera apropiada, en caso de que ocurran. Son de gran ayuda cuando algo sale mal.

Uso básico

La invocación básica del kit de desarrollo consiste de lo siguiente; Deberá incluir el archivo de librería (actualmente es la versión 1.4) y luego utilizar un bloque de ‘’Try / Catch’’ alrededor de la invocación del servicio.

require 'htm2pdfapi.php';

Try {
 $pdf = new Htm2PdfApi ($userid, $apikey);
 ....
} catch Exception($error) {
 // hacer algo con $error->getMessage() y/o $error->getCode()
}

Por supuesto debe reemplazar $userid y $apikey con el ID de usuario y la llave de Interfaz que recibió al momento de registrarse.

Todo es sencillo ¿Cierto? Ahora veamos ejemplos reales.

Convirtiendo una URL a PDF

Tomemos un ejemplo donde nos gustaría convertir una URL (diagmos http://www.bbc.co.uk) a PDF y vamos a agregar algunos ajustes personalizados como el tamaño de la página, márgenes y la orientación.

Tomemos un ejemplo donde queramos convertir un URL (digamos http://bbc.co.uk) a PDF y luego agregar ajustes personalizados como tamaño de página, márgenes y orientación.

Obtenemos algo así:

require 'htm2pdfapi.php';

Try {
 $pdf = new Htm2PdfApi ($userid, $apikey);    // inicializar la Interfaz

 $pdf->SetPageSize('Letter');                 // el tamaño del pdf será ‘carta’
 $pdf->SetPageOrientation('Portrait');        // la orientación es tipo ‘retrato’
 $pdf->SetMargins(5,5,5,5,'mm');              // márgenes de 5mm por los cuatro lados

 $pdf->CreateFromURL('http://www.bbc.co.uk'); // se ejecuta la conversión

 $pdf->Display();                             // se muestra el PDF como archivo adjunto
} catch Exception($error) {
 // hacer algo con $error->getMessage() y/o $error->getCode()
}

Convirtiendo HTML puro a PDF

Ahora también puede convertir HTML crudo a PDF con el Kit de Desarrollo. Éste es uno de los cuatro métodos de conversión (los otros son; convertir un URL a PDF, convertir un archivo a PDF y convertir un formulario personalizado a PDF).

Agreguémos algunas marcas de agua personalizadas encima de opciones de formato regular, como tamaño de página, márgenes y orientación.

Obtenemos algo así:

require 'htm2pdfapi.php';

Try {
 $pdf = new Htm2PdfApi ($userid, $apikey);    // inicializar la Interfaz

 $pdf->SetPageSize('A4');                     // el tamaño del pdf será ‘A4’
 $pdf->SetPageOrientation('Landscape');       // la orientación es tipo 'paisaje'
 $pdf->SetMargins(1,1,1,1,'in');              // márgenes de 1 pulgada por los cuatro lados

 $pdf->SetWatermarkLocation(100,100);         // colocamos una marca de agua en las coordenadas 100,100
                                              // La marca de agua dice ‘DRAFT’ en fuente tahoma color rojo
 $pdf->SetWatermarkText('BORRADOR','Tahoma','#FF0000', 64);

 $pdf->CreateFromHTML('<html>...</html>');    // se ejecuta la conversión

 $pdf->DisplayInline();                       // se muestra el PDF en el explorador
} catch Exception($error) {
 // hacer algo con $error->getMessage() y/o $error->getCode()
}

Los ejemplos que acabamos de ver son los más simples. El kit de desarrollo puede hacer mucho más, así que si realmente está interesado debería revisar la documentación completa. Y no se olvide – regístrese y obtenga todos los beneficios ahora mismo!