Clase para Justificar Texto Enriquecido
(Justifing Rich Text Class) Versión 1.0

Menú principal

Introducción

La librería JLPDF se realizó para cubrir una necesidad propia de contar con una función tipo MultiCell con la capacidad de justificar un texto pero adicionalmente poder utilizar texto formateado o enriquecido, es decir, poder poner dentro del texto justificado negritas, colores, tipos de letra, subrayados, etc.

Estas funciones no las tiene el MultiCell, ni niguna otra función de impresión de textos, de todas las que nos proporciona la librería FPDF, y después de analizar todos los ejemplos y scripts publicados en el sitio y revisar las ligas publicadas, llegamos a la conclusión de que no existía una función así.

Ciertamente hay varias implementaciones muy buenas e interesantes como son aquellas que pretenden Convertir de HTML a PDF pero con resultados muy pobres ya que ninguna de ellas combina nuestras dos necesidades: Texto justificado y Formato enriquecido.

Por ese motivo nos dimos a la tarea de realizarla con un muy aceptable resultado. Y en este momento lo publicamos en este sitio con la intención de aportar a la comunidad de desarrolladores de software libre una sencilla herramienta que en lo particular nos ha facilitado varias tareas en lo que a reportes se refiere.

Presentamos la clase tal como la utilizamos y pretendemos, posteriormente, irla mejorando con ayuda de la comunidad de programadores y visitantes de elticus.com

Imagen 1. Ejemplo de texto con formato justificado y centrado generado con JLPDF.

Para que sirve

La librería JLPDF sirve para facilitar la realización de documentos en PDF desde el lenguaje PHP de una forma simple e intuitiva, pudiendo utilizar formatos de Negritas, Subrayado, Cursivas, Tipos de letra, Tamaños de fuentes, Colores o combinaciones de estos, conservando la alineación e incluso utilizar texto Justificado o centrado de manera transparente, tal como se hace al escribir código en HTML básico.

Esta librería cumple con los parámetros estáblecidos por el FPDF, por lo que puede combinarse con otras librerías para, de este modo, poder incorporala a las funciones de dominio público que están publicadas en el sitio http://fpdf.org

Instrucciones de uso

JLPDF está basada en la popular librería FPDF (de hecho, está heredada de ella) por lo que para utilizarla es necesario descargar e instalar dicha librería desde el sitio oficial de distribución.

FPDF es un software "freeware" es decir, es totalmente gratuito tanto para aplicaciones comerciales como públicas, por lo que puede uno descargarla y utilizarla con toda confianza. JLPDF también lo es.

Cuando ya hallamos conseguido e instalado el FPDF, copiaremos el archivo JLPDF.PHP en la misma carpeta. A partir de ahí ya podremos "instanciarlo" tal como se muestra en el siguiente código:

<?PHP
 /* definimos la ruta de las fuentes*/
 define('FPDF_FONTPATH','font/');
 /* Incorporamos la librería */ 
 require('jlpdf.php');
 
  ...
  
  /* Generamos una instancia para comenzar a utilizarla */
 $pdf=new JLPDF();
?> 

Al ser JLPDF una clase heredada de FPDF, cuenta con la posibilidad de hacer uso de todas sus funciones, por lo que podemos reutlizar el código realizado para FPDF sin problemas.

JLPDF cuenta con una Función para Impresión de Texto Enriquecido que funciona de la siguiente manera:

 
 function JLCell($txt, $ANCHO, $alineacion)

Ejemplo simple

<?PHP
 /* definimos la ruta de las fuentes*/
 define('FPDF_FONTPATH','font/');
 /* Incorporamos la librería */ 
 require('jlpdf.php');
 
 /* Texto que se va a imprimir */ 
 $cadena=  "Un [blue]elefante[black] se columpiaba sobre la tela de una [BIG]araña[normal]. ";
 $cadena.= "Como veía que resistía, fue a llamar a [red]otro elefante[black]. ";
 $cadena.= "[b]Dos elefantes[/b] se columpiaban sobre la [i]tela de una araña[/i]. ";
 $cadena.= "[times]Como veían que resistía, fueron a llamar a otro elefante.";
  
 /* Generamos una instancia para comenzar a utilizarla */
 $pdf=new JLPDF();
 $pdf->AddPage();
 $pdf->SetFont('Arial','',12);

 /* Nos posicionamos en la posició 0,10 */
 $pdf->SetX(0);
 $pdf->SetY(10);
 /* Texto en una columna  de 100 puntos de ancho, justificada */
 $pdf->JLCell("$cadena",100,'j');

 $pdf->Output();
?> 

Imagen 2. Ejemplo simple de utilización de JLPDF.

Como seguramente podremos apreciar, en la cadena de texto se incorporaron una serie de "comandos" o meta-instrucciones como por ejemplo "[blue]" que activa el color azul, o "[b]" que activa el modo de negritas y todo está perfectamente justificado aún cuando los formatos cambian el tamaño del texto o incluso la fuente.

Condiciones de uso

1. Estas librerías son de libre uso y distribución tanto en aplicaciones libres como comerciales siempre y cuando no usurpes la titularidad del mismo. (Debes respetar la mención de autoría que aparece dentro de los comentarios del código fuente)
2. Eres libre de modificarlo y adaptarlo a tu conveniencia.
3. Si consideras que le has hecho mejoras significativas, haznos llegar el resultado para publicarlo y que todos nos beneficiemos de dichas mejoras.
4. Si publicas y/o distribuyes estos archivos tal como están o modificados, debes mencionar la dirección de la página de procedencia http://elticus.com
5. Estas librerías se distribuyen "tal cual" y tu puedes elegir utilizarlas o no. Han sido realizadas con la intención de que te sean útiles procurando en lo posible evitar "bugs" o errores, no obstante, no nos podemos hacer responsables de pérdidas de información o cualquiér otro daño provocado por su uso bajo ninguna circunstancia.
6. Constantemente estaremos publicando actualizaciones a los archivos aquí presentados, por lo que te recomendamos estar atento para que tengas la última versión y te evites la posibilidad de fallos o problemas.