Estendendo o Ephox Editors com JavaScript customizado

Este tópico destaca um ponto de extensão genérico para JavaScript customizado para uso com o Ephox Editors: Tiny MCE e Textbox.io no IBM Connections. Ele foi projetado para ser utilizado por desenvolvedores e integradores familiarizados com técnicas de desenvolvimento de JavaScript.

Ponto de extensão do Textbox

Nota: Você deve ter experiência com o JavaScript para utilizar este ponto de extensão.
Nota: Extensões customizadas para o Ephox Editors for IBM Connections não são suportadas pela IBM e são usadas por sua conta e risco. Ao registrar um PMR na IBM, pode ser necessário desativar ou remover quaisquer extensões customizadas e replicar o problema antes que a IBM aceite o PMR.

Os desenvolvedores e integradores podem customizar e estender a funcionalidade do Ephox Editors: Tiny MCE eTextbox.io usando a API JavaScript do Ephox Editors. O ponto de extensão fornece uma instância do objeto do editor que representa a instância do Ephox Editors: Tiny MCE e Textbox.io que deve ser criada no IBM Connections. O desenvolvedor pode usar esse objeto para chamar qualquer uma das funções disponíveis no editor de objeto disponível dentro da API do Ephox Editors: Tiny MCE eTextbox.io.

Customização e Ponto de Extensão

O ponto de extensão permite que o desenvolvedor forneça uma função JavaScript que é executada imediatamente após a instância do editor ser criada pela integração, mas antes de ser carregada na página. Os desenvolvedores podem especificar JavaScript arbitrário nessa função para customizar o Ephox Editors: Tiny MCE e Textbox.io. O objeto do editor é transmitido apenas para sua comodidade.

Para utilizar este ponto de extensão, os desenvolvedores precisam definir sua função no atributo postCreateTextboxio do objeto integrationConfig no arquivo config/config.js. Quando você abre o arquivo config/config.js, você vê uma função de modelo em branco disponível que você pode preencher com o código para sua extensão. A função recebe a instância do editor Ephox Editors: Tiny MCE eTextbox.io.

Melhores práticas para ícone de desenvolvimento de extensão

O Ephox recomenda que, ao desenvolver extensões, você faça suas modificações em uma cópia do pacote Ephox Editors for IBM Connections. Assim que suas customizações tiverem sido feitas, você poderá, então, executar novamente o script de implementação fornecido com a integração para implementar suas mudanças no servidor, assegurando que você tenha um backup do código que está sendo executado no servidor. Em alguns casos, no entanto, pode ser útil desenvolver diretamente no servidor, principalmente ao usar um servidor de desenvolvimento ou temporário. Nesse caso, você pode seguir as etapas conforme descrito em Alterando Customizações Após a Implementação.

O exemplo de extensão a seguir mostra como definir uma macro. Esta macro converterá qualquer texto entre "tags" [red] e [/red] em texto vermelho.
postCreateTextboxio: function(editor) {

    editor.macros.addSimpleMacro('[red]', '[/red]', function(match) {

        return '<span style="color: red">' + match + '</span>';

    });

}