CustomCertElement TextReplace is a plugin for Moodle that enables dynamic text replacement in custom certificates using placeholders with automatic or custom values. It is ideal for institutions that need to adjust certificate content in a flexible and automated way.
" Description
This plugin is an extension of Moodle's Custom Certificate, adding a new element that allows replacing default texts or variables with new values during certificate generation. This way, administrators and teachers can create even more personalized certificates for their courses.
🚀 Features
- Automatic replacement of defined texts or placeholders
- Use of standard variables and custom fields from users and courses
- Support for creating new custom variables
- Native integration with the Custom Certificate plugin
- Simple configuration directly through the certificate's admin interface
- Compatible with multiple Moodle versions
🧩 Using Variables
The plugin supports variables in the format {context:identifier}, which are automatically replaced with the corresponding value during certificate generation.
Examples:
User:
{user:lastname} ' user's last name
{user:custom_field_identifier} ' value of a user's custom profile field
Course:
{course:fullname} ' course full name
{course:custom_field_identifier} ' value of a course's custom field
This feature offers great flexibility for customizing certificates according to specific information from each user and course.
🔧 Installation
Clone or download the repository:
git clone https://github.com/vandersonfarias/moodle-customcertelement_textreplace.git
Copy the plugin folder into the Custom Certificate element directory in Moodle:
[moodle]/mod/customcert/element/
Access the Moodle admin interface and follow the instructions to complete the plugin installation.
Add the Text Replace element to your custom certificate and configure it as needed.
⚙️ Configuration
- When creating or editing a certificate, add the Text Replace element.
- Define the texts or placeholders to be replaced and their corresponding values.
- Save the certificate and preview the applied replacements in the generated certificate.
" Requirements
- Moodle with the Custom Certificate plugin installed and configured
- Admin access or appropriate permissions to install plugins
📄 License
This project is licensed under the GNU GPL v3.
🙋♂️ Contributions
Contributions are welcome! Feel free to open issues or submit pull requests with improvements, fixes, or suggestions.
📫 Contact
Developed by Vanderson Farias.
For questions or suggestions, reach out via GitHub.
Portuguese
CustomCertElement TextReplace é um plugin para o Moodle que permite realizar substituições dinâmicas de texto em certificados personalizados, utilizando placeholders com valores automáticos ou personalizados. Ideal para instituições que necessitam ajustar o conteúdo dos certificados de forma flexível e automatizada.
" Descrição
Este plugin é uma extensão do Custom Certificate do Moodle, adicionando um novo elemento que permite substituir variáveis ou textos padrões por novos valores no momento da geração do certificado. Assim, administradores e professores podem criar certificados ainda mais personalizados para seus cursos.
🚀 Funcionalidades
Substituição automática de textos ou placeholders definidos.
Uso de variáveis padrão e campos personalizados do usuário e do curso.
Suporte à criação de novas variáveis personalizadas.
Integração nativa com o plugin Custom Certificate.
Configuração simples diretamente pela interface de administração do certificado.
Compatível com múltiplas versões do Moodle.
🧩 Uso de Variáveis
O plugin permite o uso de variáveis no formato {contexto:identificador}, que são substituídas automaticamente pelo valor correspondente no momento da geração do certificado.
Exemplos:
Usuário:
{user:lastname} ' sobrenome do usuário.
{user:identificador_campo_personalizado} ' valor de um campo de perfil personalizado do usuário.
Curso:
{course:fullname} ' nome completo do curso.
{course:identificador_campo_personalizado} ' valor de um campo personalizado do curso.
Esse recurso oferece grande flexibilidade para a personalização de certificados, adaptando o conteúdo conforme as informações específicas de cada usuário e curso.
🔧 Instalação
Clone ou baixe o repositório:
bash
Copiar
Editar
git clone https://github.com/vandersonfarias/moodle-customcertelement_textreplace.git
Copie a pasta do plugin para o diretório de elementos do Custom Certificate no Moodle:
swift
Copiar
Editar
[moodle]/mod/customcert/element/
Acesse a interface de administração do Moodle e siga as instruções para concluir a instalação do plugin.
Adicione o elemento Text Replace ao seu certificado personalizado e configure conforme necessário.
⚙️ Configuração
Ao editar ou criar um certificado, adicione o elemento Text Replace.
Defina os textos ou placeholders a serem substituídos e os valores correspondentes.
Salve o certificado e visualize a substituição aplicada no certificado gerado.
" Requisitos
Moodle com o plugin Custom Certificate instalado e configurado.
Acesso de administrador ou permissões adequadas para instalação de plugins.
📄 Licença
Este projeto está licenciado sob a GNU GPL v3.
🙋♂️ Contribuições
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou enviar pull requests com melhorias, correções ou sugestões.
📫 Contato
Desenvolvido por Vanderson Farias.
Em caso de dúvidas ou sugestões, entre em contato através do GitHub.
