Reescrevendo plugins do CKEditor 4 para o CKEditor 5

Na DrupalBook, damos suporte a plataformas Drupal em que a experiência de edição é crítica para o negócio, e não um aspecto técnico secundário. Quando o Drupal migrou do CKEditor 4 para o CKEditor 5, isso trouxe uma base de edição moderna, mas ao mesmo tempo criou uma lacuna séria para organizações que dependiam de plugins consolidados do CKEditor 4. Este artigo explica como fechamos essa lacuna, migrando funcionalidades essenciais, garantindo a continuidade do trabalho das equipes editoriais e permitindo que nossos clientes migrassem para versões modernas do Drupal.

Plugins ausentes no CKEditor 5

A passagem do CKEditor 4 para o CKEditor 5 não foi uma atualização padrão — foi uma substituição completa da arquitetura do editor. Do ponto de vista gerencial, isso significou que muitos plugins conhecidos ficaram subitamente indisponíveis, incluindo ferramentas que os editores usavam diariamente havia muitos anos. Em vários projetos de clientes, esses plugins ausentes estavam profundamente integrados aos fluxos de trabalho, aos materiais de treinamento e aos padrões de qualidade. Removê-los teria levado à desaceleração da produção de conteúdo, ao aumento de erros e à queda da confiança dos editores na plataforma.

Para os tomadores de decisão, o problema era estratégico, e não técnico. Permanecer no CKEditor 4 significava bloquear as atualizações do Drupal e aumentar os riscos de segurança e manutenção no longo prazo, ao passo que atualizar sem os plugins essenciais quebraria imediatamente os processos de negócio. Esperar até que o ecossistema alcançasse os requisitos era irrealista por causa dos prazos dos projetos e das exigências de conformidade. Como resultado, restava apenas uma opção viável: a migração personalizada dos plugins críticos do CKEditor 4 para o CKEditor 5, com foco em preservar a experiência do usuário, e não em reproduzir com exatidão o antigo comportamento técnico.

Migração do plugin Keep Text Selection do CKEditor 4

Um dos primeiros problemas relatados pelos editores após a mudança para o CKEditor 5 foi a sensação de perda de controle na execução das tarefas diárias de edição. Ações como adicionar links ou inserir mídia nem sempre eram mais aplicadas ao texto pretendido, o que quebrava hábitos editoriais há muito consolidados. Embora essa mudança de comportamento fosse consequência de melhorias internas do CKEditor 5, seu impacto na produtividade foi imediato e perceptível, especialmente para editores profissionais que trabalham em grande volume.

Do ponto de vista do negócio, isso não era um problema menor de usabilidade, mas uma regressão de fluxos de trabalho. Os editores precisavam repetir ações, corrigir erros manualmente e desacelerar para reconferir o resultado. O objetivo da migração da funcionalidade Keep Text Selection era restaurar a confiança e a previsibilidade sem exigir que os editores mudassem sua forma habitual de trabalhar. Ao garantir que a intenção do usuário fosse respeitada em cada ação, eliminamos o atrito da criação diária de conteúdo e mantivemos o nível de eficiência que os clientes esperavam antes da migração.

Migração do IMCE com imagens, Lightbox, Tooltips e vídeo

A mais significativa foi a migração do IMCE, que, nos projetos dos clientes, atuava como uma ferramenta completa de gestão de mídia integrada diretamente ao editor. Os editores o usavam não apenas para enviar imagens, mas também para gerenciar recursos reutilizáveis, inserir vídeos, ativar comportamentos de lightbox e enriquecer o conteúdo com tooltips. Esses recursos eram centrais para a qualidade do conteúdo e o engajamento dos usuários, especialmente em plataformas editoriais complexas.

A estrutura de conteúdo mais rígida do CKEditor 5 exigiu um repensar completo da implementação dessa funcionalidade; no entanto, o requisito de negócio era inequívoco: nenhuma perda de recursos e nenhuma quebra dos fluxos de trabalho editoriais. Reimplementamos a integração do IMCE com suporte total à inserção de conteúdo de mídia rico, alinhando-a aos padrões modernos do Drupal e do CKEditor 5. Os editores mantiveram a capacidade de criar conteúdo visualmente rico e interativo, e as organizações ganharam uma base mais limpa e confiável, que dá suporte à escalabilidade de longo prazo, à governança e a melhorias futuras.

A migração do CKEditor 4 para o CKEditor 5 é, em última análise, uma questão de continuidade de negócio, e não apenas uma atualização técnica. Plugins ausentes podem minar de forma silenciosa a produtividade, a qualidade e a confiança dos usuários se não forem tratados de maneira consciente. Nossa experiência mostra que reescrever plugins críticos costuma ser a forma mais eficaz de proteger os fluxos de trabalho existentes e, ao mesmo tempo, atender aos requisitos das plataformas modernas.
Na DrupalBook, encaramos migrações como essas como investimentos estratégicos na eficiência editorial e na longevidade da plataforma, garantindo que as equipes possam continuar trabalhando sem interrupções à medida que a infraestrutura digital evolui.