Como criar mais tags inteligentes para o usuário

Introdução

Gostaria de criar Smart Tags de usuário personalizadas para usar em seus WPForms que extrairão informações do perfil de usuário do WordPress?

Uma Smart Tag é um trecho de código que você pode usar para inserir informações relevantes nas configurações de notificação do formulário ou como valores padrão de campo. Neste tutorial, vamos criar um formulário para todos os prompts de usuário padrão do WordPress que compõem um perfil e exibi-los em uma página para que os usuários confirmem suas informações.

Por padrão, já existem algumas Smart Tags relacionadas ao usuário disponíveis no WPForms, como User ID, Display Name, User Meta etc.

Criação de novas Smart Tags de usuário

Primeiro, precisamos adicionar esse trecho de código ao nosso site. A primeira função que usa o wpforms_smart_tags criará as Smart Tags. A segunda função que usa o filtro wpforms_smart_tag_process definirá as Smart Tags.

Se precisar de ajuda para adicionar trechos de código ao seu site, consulte este tutorial.

/**
 * Create User Smart Tags from the WordPress profile.
 *
 * @link   https://wpforms.com/developers/how-to-create-more-user-smart-tags/
 */

function wpf_dev_register_user_profile_smart_tags ( $tags ) {
 
    // Key is the tag, item is the tag name.
    $tags[ 'wp_nickname' ]     = 'WP Profile Nickname';
    $tags[ 'wp_username' ]     = 'WP Profile Username';
    $tags[ 'wp_url' ]          = 'WP Profile URL';
    $tags[ 'wp_user_role' ]    = 'WP Profile User Role';
    $tags[ 'wp_user_bio' ]     = 'WP Profile Bio';
     
    return $tags;
}
 
add_filter( 'wpforms_smart_tags', 'wpf_dev_register_user_profile_smart_tags', 10, 1 );
 
 
/**
 * Process the User Smart Tags from the WordPress profile.
 *
 * @link   https://wpforms.com/developers/how-to-create-more-user-smart-tags/
 */
 
function wpf_dev_process_user_profile_smart_tags( $content, $tag ) {
 
    $userID = get_current_user_id();
 
    // Nickname from WordPress profile
    if ( 'wp_nickname' === $tag ) {
 
        $wp_nickname = get_the_author_meta( 'nickname', $userID );
		
        // Replace the tag with the nickname pulled from the user's WordPress profile.
        $content = str_replace( '{wp_nickname}', $wp_nickname, $content );
 
    }
 
    // Username from WordPress profile
    if ( 'wp_username' === $tag ) {
 
        $wp_username = get_the_author_meta( 'user_login', $userID );
		
        // Replace the tag with the username pulled from the user's WordPress profile.
        $content = str_replace( '{wp_username}', $wp_username, $content );
 
    }

    // Website URL from WordPress profile
    if ( 'wp_url' === $tag ) {
 
        $wp_url = get_the_author_meta( 'user_url', $userID );
		
        // Replace the tag with the Website URL pulled from the user's WordPress profile.
        $content = str_replace( '{wp_url}', $wp_url, $content );
 
    }

    // Current role from WordPress profile
    switch ($tag) {
 
        case "wp_user_role":
        $user = wp_get_current_user();
        $roles = implode(', ', (array) $user->roles);
        $content = str_replace( '{' . $tag . '}', $roles, $content );
        break;
 
    }

    // Bio from WordPress profile
    if ( 'wp_user_bio' === $tag ) {
 
        $wp_user_bio = get_the_author_meta( 'description', $userID );
		
        // Replace the tag with the user bio pulled from the user's WordPress profile.
        $content = str_replace( '{wp_user_bio}', $wp_user_bio, $content );
 
    }
 
    return $content;
}
 
add_filter( 'wpforms_smart_tag_process', 'wpf_dev_process_user_profile_smart_tags', 10, 2 );

Esse snippet está adicionando o apelido do perfil WP, o nome de usuário do perfil WP, o URL do perfil WP, a função de usuário do perfil WP e a biografia do perfil WP. Essas Smart Tags serão usadas em nosso formulário para extrair as informações que já temos do perfil do WordPress do usuário, para que ele possa confirmar as informações registradas.

Criando o formulário

Agora é hora de criar nosso formulário para que possamos usar nossas novas Smart Tags. Se você precisar de ajuda para criar um formulário, consulte este artigo.

Para a maioria dos nossos campos neste formulário, estamos apenas adicionando o campo de formulário Single Line Text. Depois de adicionar o campo e atualizar o rótulo, clique na guia Advanced (Avançado ). Você verá o campo Default Value (Valor padrão ), basta selecionar Show Smart Tags (Mostrar Smart Tags) e rolar a tela até encontrar uma das novas Smart Tags que acabamos de adicionar. Depois de selecionar a correta, essa Smart Tag será exibida dentro do Default Value do nosso campo.

Continuaremos a adicionar nossos campos e Smart Tags da mesma forma. Para o campo Bio, usaremos o campo de formulário Paragraph Text (Texto de parágrafo ) para exibir a biografia, mas as etapas para adicionar a Smart Tag ao campo Default Value (Valor padrão) são exatamente as mesmas que as descritas acima.

Agora, quando os usuários visitarem esse formulário, eles verão que as informações já foram extraídas para eles por padrão.

Para obter mais informações sobre a criação de outras Smart Tags, consulte o artigo Como criar uma Smart Tag personalizada.

E isso é tudo o que você precisa para criar mais Smart Tags de usuário com o WPForms. Você gostaria de usar essas Smart Tags em um bloco de código HTML? Em nosso tutorial Como processar Smart Tags em campos HTML, mostraremos como usar o PHP para permitir Smart Tags nesse tipo de campo de formulário.

Relacionado

Referências de filtros:

• wpforms_smart_tags
• wpforms_smart_tag_process