Esta miniaplicação inclui a correspondência inteligente de esquemas de cores para que tente encaixar-se automaticamente no esquema de cores da wiki sem necessitar de qualquer CSS personalizado para o corrigir. Ele faz isso usando as cores do Special:ThemeDesigner; se você alterou as cores do wiki usando CSS em vez de ThemeDesigner, isso pode não funcionar corretamente.

Installation

Notas de Uso

Os pop-ups são configuráveis por meio da interface do usuário integrada. Você pode acioná-los clicando em vez de passar o mouse, personalizar o atraso do foco e ativar e desativar as animações. Também é possível desativá-los inteiramente por usuário para usuários individuais que não desejam.

Quando os pop-ups estão desabilitados, há um link no final do artigo, logo abaixo das categorias, que pode ser clicado para reabrir a interface do usuário de configuração e ativá-los novamente mais tarde.

Ajuda Rápida na Configuração

The options in the popup configuration are:

• Desativar Pop-ups de Referência — Isso desativa os pop-ups para que eles não apareçam mais, exceto os personalizados. Eles podem ser ativados novamente usando o link "Configurar pop-ups de referência" na parte inferior dos artigos.
  • Alguns wikis podem bloquear os pop-ups, o que impedirá que você possa desativá-los. Você deve entrar em contato com os administradores desse wiki para discuti-lo nesse caso.
• Atraso de Foco — A quantidade de tempo (em milissegundos) que você deve passar o mouse sobre a referência antes que o pop-up seja aberto. O padrão é 200ms, mas você pode ajustá-lo se for muito longo ou muito curto para o seu gosto. Esteja ciente de que valores muito curtos podem ser irritantes ao rolar.
• Faça os pop-ups ficarem abertos até serem tocados com o mouse — Os pop-ups permanecerão abertos assim que aparecerem, como no modo de clique, até que você mova o mouse sobre o pop-up e depois saia dele. Isso permite que você abra o pop-up passando o mouse e mova o mouse para outro lugar sem que o pop-up feche em você até que você queira.
• Ativar por — Por padrão, os pop-ups reagem ao passar o mouse; no entanto, você pode alternar entre passar o mouse e clicar de acordo com sua preferência. No modo clique, você deve clicar nas referências para abrir os pop-ups.
  • No modo de clique, clicar na referência uma segunda vez enquanto o pop-up já estiver aberto irá ignorá-lo (fechá-lo) e levá-lo para a seção de referências na parte inferior do artigo normalmente.
• Ativar Animações de Abrir/Fechar — Por padrão, os pop-ups têm uma animação deslizante aberta/fechada que é executada por 300ms. Isso geralmente é mais agradável aos olhos do que abrir, mas se você não se importa com isso, pode desativá-lo.

Configuração do Administrador

Os administradores podem remover o link de configuração do gadget de seu wiki colocando os Pop-ups de referência no modo "bloqueio". Isso forçará os pop-ups a permanecerem ativados e removerá o link de configuração do final do artigo, mas não do próprio pop-up.

Para ativar o bloqueio, basta adicionar isso ao MediaWiki:Common.js acima da importação mencionada:

((window.dev = window.dev || {}).ReferencePopups = dev.ReferencePopups || {}).lockdown = true;

Você também pode alterar os padrões para novos usuários. Você pode desabilitar a animação por padrão usando:

((window.dev = window.dev || {}).ReferencePopups = dev.ReferencePopups || {}).defaults = { animate: false };

Pop-ups Personalizados

O componente popup deste script é totalmente reutilizável e pode ser reaproveitado para exibir o que você quiser, bem como referências. Um script pré-fabricado e um conjunto de modelos são fornecidos se você quiser apenas algo para entrar e usar. Como alternativa, se você for capaz de escrever seu próprio JavaScript, poderá codificar diretamente nos pop-ups para fazer coisas como novo conteúdo AJAX e exibi-lo em um pop-up à medida que certos elementos interagem.

Para usar os pop-ups personalizados, você precisará importar o script Custom Popup:

dev:ReferencePopups/custom.js

E você precisará copiar essas 2 predefinições em seu wiki para usar o script:

• Template:Popup
• Template:PopupContent

As predefinições descrevem como usá-las.

Uma coisa importante a notar é que o script custom popup vaiusar a configuração ReferencePopup do usuário mesmo que o ícone de engrenagem não apareça nos personalizados. Isso significa que, se o pop-up estiver no modo de clique, anexar pop-ups a elementos de página que já possuem seus próprios scripts pode ter consequências estranhas. Ao contrário dos pop-ups normais, os personalizados são "nunca" fixos e não podem ser desativados.

Você também pode construir skins personalizadas para seus pop-ups personalizados. Um exemplo disso está na página de demonstração, você pode ver o CSS para isso aqui.