Es importante tener un certificado bien diseñado y atractivo. En esta sección, podrá descubrir cómo dibujar líneas, mostrar imágenes, establecer una imagen de fondo e insertar campos en el certificado.

El esquema XML, en el ejemplo siguiente, especifica dónde aparecerán los elementos del certificado.

A continuación, examinaremos cada uno de los elementos y explicaremos sus propiedades.

<?xml version="1.0" encoding="utf-8" ?>
<certificates>
    <certificate>
        <organization text="MOQI" font="Freeserif" weight="bold" size="60" color="#005b7f" x="120" y="13"></organization>
        <student font="Freeserif" weight="" size="35" color="#000000" x="5" y="95" align="center"></student>
        <course font="Freeserif" weight="" size="28" color="#000000" x="5" y="133" align="center"></course>
        <grade font="Freeserif" weight="bold" size="28" color="#000000" x="160" y="150" align="center"></grade>
        <date font="Freeserif" weight="" size="15" color="#575757" x="225" y="182"></date>
        <serial font="Freeserif" weight="" size="14" color="#575757" x="107" y="182"></serial>
        <logo file="default" x="14" y="14"></logo>
        <background file="medium.png"></background>
        <orientation name="landscape"></orientation>
        <creator name="MOQI"></creator>
        <author name="MOQI"></author>
        <subject name="Certificate for "></subject>
        <keywords name="This is a list of keywords"></keywords>
        <labels>
            <label text="NOT JUST ANOTHER ELEARNING COMPANY" font="Freeserif" size="20" color="#000000" x="80" y="41"></label>
            <label text="We Make e-Learning Special" font="Freeserif" weight="" size="18" color="#000000" x="110" y="51"></label>
            <label text="Certificate of Achievement" font="Freeserif" weight="" size="35" color="#000000" x="80" y="67"></label>
            <label text="This Certificate is Awarded to:" font="Freeserif" weight="" size="24" color="#000000" x="97" y="82"></label>
            <label text="For the successful completion of:" font="Freeserif" weight="" size="22" color="#000000" x="95" y="120"></label>
            <label text="With grade:" font="Freeserif" weight="" size="22" color="#000000" x="120" y="152"></label>
            <label text="Instructor" font="Freeserif" weight="" size="10" color="#000000" x="20" y="192"></label>
            <label text="Serial Number" font="Freeserif" weight="" size="10" color="#000000" x="110" y="192"></label>
            <label text="Date" font="Freeserif" weight="" size="10" color="#000000" x="200" y="192"></label>
        </labels>
        <lines>
            <line x1="5" y1="5" x2="292" y2="5" color="#005b7f" thickness="2" note="Top Thick"></line>
            <line x1="292" y1="5" x2="292" y2="204" color="#005b7f" thickness="2" note="Right Thick"></line>
            <line x1="5" y1="204" x2="292" y2="204" color="#005b7f" thickness="2" note="Bottom Thick"></line>
            <line x1="5" y1="5" x2="5" y2="204" color="#005b7f" thickness="2" note="Left Thick"></line>
            <line x1="7" y1="7" x2="290" y2="7" color="#005b7f" thickness=".25" note="Top Thin Border"></line>
            <line x1="290" y1="7" x2="290" y2="202" color="#005b7f" thickness=".25" note="Right Thin Border"></line>
            <line x1="7" y1="202" x2="290" y2="202" color="#005b7f" thickness=".25" note="Bottom Thin Border"></line>
            <line x1="7" y1="7" x2="7" y2="202" color="#005b7f" thickness=".25" note="Left Thin"></line>
            <line x1="17" y1="190" x2="97" y2="190" color="#000000" thickness=".25" note="Signature Line"></line>
            <line x1="107" y1="190" x2="187" y2="190" color="#000000" thickness=".25" note="Serial Line"></line>
            <line x1="197" y1="190" x2="277" y2="190" color="#000000" thickness=".25" note="Date Line"></line>
        </lines>
        <images>
            <image file="certificate.gif" x="238" y="14"></image>
            <image file="signature.gif" x="18" y="176"></image>
        </images>
    </certificate>
</certificates>

  • Creador: para rellenar como creador de la cabecera del documento PDF (no aparece en el documento);
  • Autor: para rellenar como autor la cabecera del documento PDF (no aparece en el documento);
  • Asunto: para rellenar el asunto de la cabecera del documento PDF (no aparece en el documento);
  • Palabras clave: para rellenar la lista de palabras clave de la cabecera del documento PDF (no aparece en el documento);
  • Organización: para mostrar el nombre de la organización en el certificado;
  • Estudiante: para mostrar el nombre completo del estudiante en el certificado;
  • User_login: para mostrar el nombre de usuario del estudiante;
  • Curso: para mostrar el nombre del curso en el certificado (en el caso de títulos de cursos largos, puede añadir un atributo «truncado» a la etiqueta , para mostrar sólo una parte del título del curso; si utiliza esta opción, tendrá que añadir un valor numérico, por ejemplo, para que el título se trunque y se queden sólo 55 caracteres:
course font="Freeserif" weight="" size="28" truncated="55" color="#000000" x="5" y="133" align="center"></course>
  • Calificación: para mostrar la calificación global del curso en el certificado;
  • Fecha: para mostrar la fecha de emisión del certificado;
  • Fecha de inicio del curso: para mostrar la fecha de inicio del curso;
  • Fecha de finalización del curso: para mostrar la fecha de finalización del curso;
  • Fecha de inicio de la sesión: para mostrar la fecha en que el estudiante comenzó el primer evento de la sesión en un curso combinado;
  • Fecha de finalización de la sesión: para mostrar la fecha en que el estudiante terminó el último evento de la sesión en un curso combinado;
  • Descripción: para mostrar la descripción del curso en el certificado;
  • CEUs: para mostrar los CEUs del curso en el certificado;
  • Formadores: para mostrar los formadores del curso en el certificado;
  • Nombre del formador: para mostrar los nombres de los formadores del curso;
  • Fecha: para mostrar la fecha de emisión;
  • Fecha de finalización: para mostrar la fecha de finalización del curso (cuando es diferente de la fecha de emisión);
  • Caducar: para mostrar la fecha de caducidad del certificado;
  • Fecha de emisión: para mostrar la fecha de impresión del certificado;
  • Serie: para mostrar el número de serie del certificado;
  • Rama: para mostrar el nombre de la rama del estudiante;
  • Logotipo: para mostrar la imagen del logotipo en el certificado. Puede mostrar el logotipo por defecto de su instalación de MOQI o una imagen externa proporcionando una URL;
  • Fondo: para mostrar una imagen de fondo en el certificado. El archivo medium.png corresponde a la imagen de fondo de la plantilla Decoración Media (el archivo heavy.png corresponde a la imagen de fondo de la plantilla Decoración Pesada; además de estas imágenes de fondo, puede elegir una imagen externa proporcionando la URL – el ancho de la imagen debe ser igual a 840 píxeles);
  • Orientación: para establecer la orientación de la página;
  • Etiqueta: una etiqueta es una línea de texto que aparecerá en el certificado. Un elemento de etiqueta debe aparecer dentro de la sección de etiquetas. Puede añadir el número de etiquetas que necesite;
  • Línea: una línea es un trazo gráfico dibujado en el certificado. Un elemento de línea debe aparecer dentro de la sección de líneas. Puede añadir el número de líneas que necesite;
  • Imagen: una imagen es un gráfico que aparecerá en el certificado. Debe aparecer una imagen dentro de la sección de imágenes. Puede añadir el número de imágenes que necesite;
PropriedadPropiedades para el estudiante, el curso, el grado, la fecha, la serie y organización.
FuenteNombre de la fuente que se va a utilizar.
PesoEl peso de la fuente. Valores posibles: negrita, cursiva, negrita | cursiva. Para la fuente normal, deje el valor vacío.
TamañoTamaño de la fuente que se va a utilizar.
CorValor hexadecimal para el color del texto (por ejemplo: # 000000 es negro).
xX coordenada.
yY coordenada.
AlinearLa alineación del texto. Valores posibles: centro, izquierda, derecha.
TextoTexto que debe aparecer en el certificado. Se aplica sólo al elemento organización.
Propriadad Propiedades de los elementos creador, autor, tema y
palabras clave.
NombreEl valor que aparecerá en la cabecera del documento PDF.
Propriedad Propiedades de los elementos de imagen, logotipo y fondo.
ArchivoNombre de la imagen a utilizar o la URL de una imagen externa imagen.
xCoordenada X. Se aplica sólo a los elementos de imagen y logotipo.
yCoordenada Y. Se aplica sólo a los elementos de imagen y logotipo.

Propriedad Propiedades del elemento de orientación.
NombreLa orientación de la página. Valores posibles: paisaje,
retrato.

Propriedad Propiedades de los elementos de la etiqueta.
TextoTexto que debe aparecer en el certificado.
FuenteNombre de la fuente que se va a utilizar.
TamañoTamaño de la fuente que se va a utilizar.
PesoEl peso de la fuente. Valores posibles: negrita, cursiva, negrita | cursiva. Para la fuente normal, deje el valor vacío.
ColorValor hexadecimal para el color del texto (por ejemplo: # 000000 es negro).
xX coordenada.
yY coordenada.

Propriedad Propiedades de los elementos de línea.
ColorValor hexadecimal del color de la línea (por ejemplo: # 000000 es negro).
NotaUna nota de referencia para el usuario. No aparece en el documento.
EspessuraEl grosor del hilo (por ejemplo: fino: 0,25, grueso: 2).
x1Coordenada X inicial.
x2Terminando a coordenada X.
y1Coordenada Y inicial.
y2Terminando a coordenada Y.

Plantillas con dos o más páginas

Si necesita un certificado con más de una página, incluya cada página en una etiqueta . Debe incluir todas las propiedades de creador, autor, asunto y palabra clave en su primera etiqueta y no necesita repetirlas de nuevo en su segunda (o tercera… etc) etiqueta. Por ejemplo:

<?xml version="1.0" encoding="utf-8" ?>
<certificates>
<certificate>
content of page 1
</certificate>
<certificate>
content of page 2
</certificate>
</certificates>

Añadir imágenes personalizadas a las plantillas de certificados

Para añadir nuevas imágenes de fondo a su plantilla de certificado, debe cargar sus archivos de imagen en la siguiente carpeta:

<moqi-installation-folder>/www/assets/images/certificate_logos/<your_image_file>

Más tarde, en su plantilla de certificado, puede poner

<images>
<image file="<your_image_file>" x="238" y="14"></image>
</images>

Añadir fuentes personalizadas a las plantillas de certificados

MOQI utiliza TCPDF, una clase FLOSS de PHP para generar documentos PDF, para crear certificados.

Para añadir nuevas fuentes a su plantilla de certificados, primero debe añadirlas al motor TCPDF. Puede hacerlo de dos maneras:

La primera forma es utilizar el método addTTFfont de TCPDF y enviar como parámetro un TTF (posiblemente también de otro tipo):

$font = $this->addTTFfont("filename.ttf");

…entonces puedes usar el nombre de la fuente cuando lo necesites, así:

$this->SetFont($font,'',10);

La segunda forma es «instalar» las nuevas fuentes en el motor TCPDF manualmente. Para ello, puede utilizar el script tcpdf_addfont.php, incluido en las herramientas TCPDF. Ir a:

<moqi-installation-folder>/libraries/external/tcpdf6/tools/

para instalar una fuente personalizada, utilice el script tcpdf_addfont.php, como en el siguiente ejemplo:

php tcpdf_addfont.php -i /home/prountzos/Downloads/FranklinGothicBookRegular.ttf

si todo es correcto, verás en los resultados algo así como:

>>> Converting fonts for TCPDF:
*** Output dir set to /var/www/moqi/libraries/external/tcpdf6/fonts/
+++ OK : /home/prountzos/Downloads/FranklinGothicBookRegular.ttf added as franklingothicbook
>>> Process successfully completed!

más tarde, puede utilizar las fuentes recién instaladas en su certificado, como en el siguiente ejemplo:

<student font="franklingothicbook" weight="" size="35" color="#000000" x="5" y="95" alig