É importante ter um certificado bem projetado e atraente. Nesta secção, pode descobrir como desenhar linhas, exibir imagens, definir uma imagem de fundo e inserir campos no certificado.
O esquema XML, no exemplo abaixo, especifica onde irão aparecer os elementos do certificado.
A seguir, vamos examinar cada um dos elementos e explicaremos as propriedades.
<?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>
- Criador: para preencher como criador do cabeçalho do documento PDF (não aparece no documento);
- Autor: para preencher como autor do cabeçalho do documento PDF (não aparece no documento);
- Assunto: para preencher o assunto do cabeçalho do documento PDF (não aparece no documento);
- Palavras-chave: para preencher a lista de palavras-chave do cabeçalho do documento PDF (não aparecem no documento);
- Organização: para exibir o nome da organização no certificado;
- Aluno: para exibir o nome completo do aluno no certificado;
- User_login: para mostrar o nome de utilizador do aluno;
- Curso: para exibir o nome do curso no certificado (para títulos de cursos longos, pode adicionar um atributo ‘truncated‘ à tag , para mostrar apenas uma parte do título do curso – caso use esta opção, será necessário adicionar um valor numérico, por exemplo, para ter o título truncado e manter apenas 55 caracteres:
<course font="Freeserif" weight="" size="28" truncated="55" color="#000000" x="5" y="133" align="center"></course>
- Nota: para exibir a nota geral do curso no certificado;
- Data: para exibir a data em que o certificado foi emitido;
- Data de início do curso: para exibir a data de início do curso;
- Data de conclusão do curso: para exibir a data de término do curso;
- Data de início de sessão: para exibir a data em que o aluno iniciou o evento da primeira sessão num curso combinado;
- Data de conclusão de sessão: para exibir a data em que o aluno terminou o último evento da sessão num curso combinado;
- Descrição: para exibir a descrição do curso no certificado;
- CEUs: exibir as CEUs do curso no certificado;
- Formadores: para exibir os formadores do curso no certificado;
- Nome do formador: para exibir os nomes dos formadores do curso;
- Data: para exibir a data de emissão;
- Data de conclusão: para a data de conclusão do curso (quando é diferente da data de emissão);
- Expirar: para exibir a data de validade do certificado;
- Data de emissão: para exibir a data em que o certificado foi impresso;
- Série: para exibir o número de série do certificado;
- Ramo: para mostrar o nome do ramo do aluno;
- Logo: para exibir a imagem do logotipo no certificado. Pode exibir o logotipo padrão da sua instalação MOQI ou uma imagem externa, fornecendo um URL;
- Background: para exibir uma imagem de background no certificado. O arquivo medium.png corresponde à imagemde fundo do modelo Medium Decoration (o arquivo heavy.png corresponde à imagem de plano de fundo do modelo Heavy Decoration; além dessas imagens de fundo, pode escolher uma imagem externa, ao fornecer o URL – a largura da imagem deve ser igual a 840 pixels);
- Orientação: para definir a orientação da página (portrait ou landscape);
- Label: um label é uma linha de texto que aparecerá no certificado. Um elemento de etiqueta deve aparecer dentro da secção das etiquetas. Pode adicionar qualquer número de etiquetas conforme necessário;
- Linha: uma linha é uma linha gráfica desenhada no certificado. Um elemento de linha deve aparecer dentro da secção de linhas. Pode adicionar qualquer número de linhas conforme necessário;
- Imagem: uma imagem é um gráfico que aparecerá no certificado. Uma imagem deve aparecer dentro da secção de imagens. Pode adicionar qualquer número de imagens conforme necessário;
| Propriedade | Propriedades para elementos de aluno, curso, nota, data, série e organização. |
|---|---|
| Fonte | Nome da fonte a ser usada. |
| Peso | O peso da fonte. Valores possíveis: negrito, itálico, negrito | itálico. Para a fonte normal, deixe o valor vazio. |
| Tamanho | Tamanho da fonte a ser usada. |
| Cor | Valor hexadecimal para a cor do texto (ou seja: # 000000 é preto). |
| x | X coordenada. |
| y | Y coordenada. |
| Alinhar | O alinhamento do texto. Valores possíveis: centro, esquerda, direita. |
| Texto | Texto a aparecer no certificado. Aplica-se apenas ao elemento da organização. |
| Propriedade | Propriedades para os elementos criador, autor, assunto e palavras-chave. |
|---|---|
| Nome | O valor que aparecerá no cabeçalho do documento PDF. |
| Propriedade | Propriedades para elementos de imagem, logotipo e plano de fundo. |
|---|---|
| Arquivo | Nome da imagem a ser usada ou o URL de uma imagem externa. |
| x | X coordenada. Aplica-se apenas aos elementos da imagem e logotipo. |
| y | Y coordenada. Aplica-se apenas aos elementos de imagem e logotipo. |
| Propriedade | Propriedades para o elemento de orientação. |
|---|---|
| Nome | A orientação da página. Valores possíveis: paisagem, retrato. |
| Propriedade | Propriedades para elementos de etiqueta. |
|---|---|
| Texto | Texto para surgir no certificado. |
| Fonte | Nome da fonte a ser usada. |
| Tamanho | Tamanho da fonte a ser usada. |
| Peso | O peso da fonte. Valores possíveis: negrito, itálico, negrito | itálico. Para a fonte normal, deixe o valor vazio. |
| Cor | Valor hexadecimal para a cor do texto (ou seja: # 000000 é preto). |
| x | X coordenada. |
| y | Y coordenada. |
| Propriedade | Propriedades para elementos de linha. |
|---|---|
| Cor | Valor hexadecimal da cor da linha (ou seja: # 000000 é preto). |
| Nota | Uma observação para referência de utilizador. Não aparece no documento. |
| Espessura | A espessura da linha (ou seja: Fina: 0,25, Espessura: 2). |
| x1 | Coordenada X inicial. |
| x2 | Finalizando a coordenada X. |
| y1 | Coordenada Y inicial. |
| y2 | Terminando a coordenada Y. |
Modelos com duas ou mais páginas
Se precisar de um certificado com mais de uma página, inclua cada página numa marca . Deve incluir todas as propriedades do criador, autor, assunto e palavras-chave na sua primeira tag e não precisa de repeti-las novamente na sua segunda (ou terceira … etc) tag . Por exemplo:
<?xml version="1.0" encoding="utf-8" ?>
<certificates>
<certificate>
content of page 1
</certificate>
<certificate>
content of page 2
</certificate>
</certificates>
Adicionar imagens personalizadas aos modelos de certificado
Para adicionar novas imagens de fundo ao seu modelo de certificado, deve carregar os seus arquivos de imagem na seguinte pasta:
<moqi-installation-folder>/www/assets/images/certificate_logos/<your_image_file>
Mais tarde, no seu modelo de certificado, pode colocar
<images> <image file="<your_image_file>" x="238" y="14"></image> </images>
Adicionar fontes personalizadas aos modelos de certificado
A MOQI usa o TCPDF, uma classe PHP FLOSS para gerar documentos PDF, para criar certificados.
Para adicionar novas fontes ao seu modelo de certificado, deve primeiro adicioná-las ao mecanismo TCPDF. Pode fazê-lo de duas maneiras:
A primeira forma é usar o método addTTFfont do TCPDF e enviar como parâmetro um TTF (possivelmente outro tipo também):
$font = $this->addTTFfont("filename.ttf");
…então pode usar o nome da fonte quando precisar, assim:
$this->SetFont($font,'',10);
A segunda maneira é “instalar” as novas fontes no mecanismo TCPDF manualmente. Para isso, pode usar o script tcpdf_addfont.php, incluído nas ferramentas TCPDF.
Vá para:
<moqi-installation-folder>/libraries/external/tcpdf6/tools/
para instalar uma fonte personalizada, use o script tcpdf_addfont.php, como no exemplo a seguir:
php tcpdf_addfont.php -i /home/prountzos/Downloads/FranklinGothicBookRegular.ttf
se tudo estiver correto, verá nos resultados algo 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!
posteriormente, pode usar as fontes recém-instaladas no seu certificado, como no exemplo a seguir:
<student font="franklingothicbook" weight="" size="35" color="#000000" x="5" y="95" alig