Primeiros passos
Plugin WordPress
Ligue o WordPress ao DocID®, proteja conteúdo e utilize atributos profissionais verificados em fluxos nativos.
O plugin oficial DocID® liga o WordPress a uma das maiores redes online de profissionais de saúde. Protege artigos, páginas, tipos de conteúdo personalizados e conteúdos multimédia e pode integrar identidades profissionais verificadas com utilizadores, funções, menus e conteúdo nativos do WordPress.
Abrir o plugin DocID® no WordPress.org
Pré-requisitos
- Um site WordPress com HTTPS e acesso de administrador
- Uma conta DocID® com um asset de site configurado e credenciais OAuth
- Uma cópia de segurança e um ambiente de staging para validar temas, plugins e regras de acesso específicos do site
Instalar o plugin
Através da administração do WordPress
Abra Plugins → Adicionar novo → Carregar plugin, selecione o arquivo atual do plugin DocID®, instale-o e escolha Ativar plugin.
Com WP-CLI
Instale e ative um arquivo local a partir da raiz do WordPress:
Configurar OAuth e os dados de clientes solicitados
- Abra Definições → DocID® → Credenciais OAuth.
- Copie o URL de callback apresentado para os URI de redirecionamento permitidos do asset correspondente no painel empresarial DocID®.
- Introduza o Client ID e o Client Secret do asset.
- Em Dados de clientes solicitados, mantenha openid e professional e ative apenas os dados opcionais profile, email ou phone de que o site necessita.
Scopes disponíveis
| Scope | Estado | Claims |
|---|---|---|
| openid | Obrigatório | sub |
| professional | Obrigatório | profession_id, discipline_id, profession_verified |
| profile | Opcional | name, title, given_name, family_name, gender |
| Opcional | ||
| phone | Opcional | phone_number |
Contas WordPress nativas opcionais
Ative o aprovisionamento nativo apenas quando funções, capacidades ou integrações do WordPress precisarem de um utilizador atual nativo. Os novos utilizadores recebem um nome estável e não pessoal e são associados apenas pelo subject DocID® imutável, nunca automaticamente por e-mail. A sincronização opcional do e-mail ativa automaticamente o scope email opcional. A barra de administração pode ser ocultada separadamente para utilizadores DocID® aprovisionados sem afetar outros utilizadores do WordPress. As funções locais atribuídas fora do DocID® permanecem inalteradas.
Mapeamentos de funções
Associe todos os utilizadores DocID® ou identificadores exatos de profissão, disciplina, instituição ou tema a uma ou mais funções não administrativas do WordPress. Os mapeamentos correspondentes são combinados e podem ser adicionados, editados ou removidos na tabela.
Proteção de conteúdo
Use o painel de início de sessão DocID® nos ecrãs de edição suportados para proteger artigos, páginas, tipos de conteúdo personalizados ou multimédia. O separador Proteção de conteúdo oferece uma vista paginada, pesquisável e filtrável por tipo de conteúdo, com ligações diretas de edição.
A ligação de início de sessão adapta-se ao estado: apresenta iniciar sessão aos visitantes e terminar sessão aos utilizadores DocID® autenticados. Os atributos login_text e logout_text personalizam ambos os rótulos. O nome de utilizador usa o melhor valor disponível por esta ordem: título, nome próprio e apelido; título e apelido; e-mail autorizado; ID de utilizador DocID® estável.
| Shortcode | Descrição |
|---|---|
| [docid-account-navigation] | Mostra Iniciar sessão aos visitantes. Aos utilizadores DocID® autenticados, mostra o melhor nome de utilizador disponível seguido de | Terminar sessão. |
| [docid-loggedin-content]Content[/docid-loggedin-content] | Mostra o conteúdo incluído apenas a utilizadores DocID® autenticados. |
| [docid-loggedout-content]Content[/docid-loggedout-content] | Mostra o conteúdo incluído apenas a visitantes sem uma sessão DocID® autenticada. |
| [docid-login-link] | Mostra Iniciar sessão aos visitantes e Terminar sessão aos utilizadores DocID® autenticados. |
| [docid-login-link login_text="Access" logout_text="Leave"] | Utiliza rótulos de texto personalizados para ambos os estados de autenticação. |
| [docid-username] |
Dados de perfil
| Shortcode | Scope | Descrição |
|---|---|---|
| [docid-profile-id] | openid (obrigatório) | O identificador estável e único da conta DocID®. |
| [docid-profile-name] | profile (opcional; autorização necessária) | O título, o nome próprio e o apelido combinados. |
| [docid-profile-title] | profile (opcional; autorização necessária) | O título ou a forma de tratamento. |
| [docid-profile-given-name] | profile (opcional; autorização necessária) | O nome próprio. |
| [docid-profile-family-name] | profile (opcional; autorização necessária) | O apelido. |
| [docid-profile-gender] | profile (opcional; autorização necessária) |
Aceder ao estado de autenticação e aos claims em PHP
A API Base pública pode ler a sessão DocID® atual sem exigir o aprovisionamento nativo do WordPress. Os valores opcionais só existem quando o respetivo scope foi solicitado, autorizado e devolvido.
Testar antes do lançamento
- Abra conteúdo público e protegido sem iniciar sessão.
- Conclua o início de sessão com uma conta de teste elegível e confirme o regresso ao conteúdo inicialmente solicitado.
- Continue sem dados de perfil opcionais e confirme que a autenticação funciona com os scopes obrigatórios.
- Teste cada mapeamento de função e destino de início de sessão, incluindo uma conta sem correspondência.
- Termine a sessão e confirme que o conteúdo protegido deixou de estar acessível.
A integração fornece funções técnicas de autenticação e controlo de acesso. Os operadores do site continuam responsáveis pela escolha dos scopes, permissões, avisos e bases jurídicas adequados à sua implementação.