Como Incluir o URL da Submissão do Post na Mensagem de Confirmação

Está a utilizar o addon Submissão de Publicações e tem interesse em incorporar o URL da publicação na sua mensagem de confirmação? Conseguir isto é simples com um trecho de PHP e as Smart Tags do WPForms, e nós vamos guiá-lo passo a passo.

As Smart Tags servem como links de referência rápida utilizáveis em mensagens de confirmação. O WPForms fornece uma panóplia de tags pré-construídas para sua conveniência. Para mais detalhes sobre as opções disponíveis, consulte esta documentação.

Mas sabia que também pode criar as suas próprias Smart Tags para usar no WPForms? Neste tutorial, demonstraremos como criar três novas Smart Tags personalizadas:

• Título da Publicação Submetida
• Número de ID do Tipo de Publicação Submetida
• URL da Publicação Submetida

Estas tags serão inestimáveis na nossa mensagem de confirmação, permitindo-nos fornecer aos utilizadores que acabaram de submeter o formulário um link direto para a publicação.

Criar o seu formulário

Se precisar de ajuda para criar um formulário utilizando o addon de Submissão de Publicações, por favor, reveja este tutorial.

Para efeitos deste tutorial, já criámos o nosso formulário com os campos padrão que vêm com o modelo Formulário de Submissão de Publicações de Blog.

Ativar submissão de publicações

Em seguida, precisaremos de ativar as submissões de publicações. Para o fazer, dentro do construtor de formulários, clique no separador Definições, selecione Submissões de Publicações e ative o interruptor para Ativar Submissões de Publicações.

Adicionar o URL da publicação à mensagem de confirmação

Assim que as definições do seu formulário estiverem completas, clique no separador Confirmações.

Como não queremos apenas exibir o URL da publicação, mas sim torná-lo um link clicável, clique no separador Texto na janela do Editor e poderá adicionar a sua mensagem.

Vamos colocar o nosso texto e HTML para a nossa mensagem e URL da publicação, digitando o seguinte:

<p>Thanks for the submission! 
If you'd like to see a preview of your post titled 
<strong>{submitted_cpt_title}</strong> for the post type ID of 
<strong>{submitted_cpt_id}</strong>, just 
<a href="{submitted_cpt_url}">click here</a>.</p>

<p>It will be reviewed shortly.</p>

Estamos a adicionar uma mensagem que informa o visitante que submeteu o formulário sobre o Número de ID do Tipo de Publicação, o Título da Publicação e o URL da Publicação, que seria um link clicável dentro da Mensagem de Confirmação.

Depois de adicionar a sua mensagem, clique em Guardar no formulário e estará pronto para o próximo passo!

Criar a Smart Tag do URL de submissão de publicação

Agora é hora de adicionar o nosso trecho de código ao seu site que irá juntar tudo isto. Se precisar de ajuda sobre como adicionar trechos de código ao seu site, por favor, veja este tutorial.

/**
 * Add Smart Tags to the Post Submission confirmation messages
 *
 * @link   https://wpforms.com/developers/how-to-include-post-submissions-post-url-in-the-confirmation-message
 *
 */

// This function sets up the names of the Smart Tags we will be using.
function wpf_dev_register_smarttag( $tags ) {

	// Key is the tag, value is the tag name.
	$tags[ 'submitted_cpt_id' ]    = 'Submitted Post Type ID';
	$tags[ 'submitted_cpt_url' ]   = 'Submitted Post Type URL';
	$tags[ 'submitted_cpt_title' ] = 'Submitted Post Type Title';

	return $tags;
}

add_filter( 'wpforms_smart_tags', 'wpf_dev_register_smarttag', 10, 1 );

//This function will process the Smart Tags so that we can 
//use them inside the confirmation message and email notifications
function wpf_dev_process_smarttag( $content, $tag ) {

	if ( empty( $_POST[ 'wpforms' ][ 'entry_id' ] ) ) {
		return $content;
	}

	/** @var WPForms_Entry_Handler $entry */
	static $entry;

	if ( empty( $entry ) ) {
		$entry = wpforms()->entry->get( (int) $_POST[ 'wpforms' ][ 'entry_id' ], [ 'cap' => false ] );
	}

	if ( empty( $entry->post_id ) ) {
		return $content;
	}

	switch ( $tag ) {

		case 'submitted_cpt_id':
			$content = str_replace( '{submitted_cpt_id}', (int) $entry->post_id, $content );
			break;

		case 'submitted_cpt_url':
			$content = str_replace( '{submitted_cpt_url}', esc_url( get_permalink( (int) $entry->post_id ) ), $content );
			break;

		case 'submitted_cpt_title':
			$title   = get_post_field( 'post_title', $entry->post_id );
			$content = str_replace( '{submitted_cpt_title}', esc_html( $title ), $content );
			break;
	}

	return $content;
}

add_filter( 'wpforms_smart_tag_process', 'wpf_dev_process_smarttag', 10, 2 );

Dentro da primeira função, estamos a configurar as Smart Tags com nomes e definições do que a informação que elas irão conter, como o título, URL e o número de ID do post.

A segunda função processa estas Smart Tags e irá atribuir-lhes o título, o permalink (URL) e o número de ID do tipo de post, o que nos permitirá usar estas Smart Tags nas nossas mensagens de confirmação.

Agora, sempre que usarmos as Smart Tags {Submitted Post Type URL}, {Submitted Post Type Title} ou {Submitted Post Type ID}, elas serão automaticamente atribuídas com esses valores após uma submissão de formulário bem-sucedida e os seus visitantes poderão facilmente clicar na ligação clique aqui que adicionámos à nossa mensagem de confirmação e ser levados para o rascunho (ou post completo publicado) da sua submissão, bem como ver outras informações como o Post ID e o Post Title.

E é tudo o que precisa! Gostaria de criar mais Smart Tags personalizadas? Dê uma vista de olhos ao nosso tutorial sobre Como Criar uma Smart Tag Personalizada.

Filtros de Referência

• wpforms_smart_tags
• wpforms_smart_tag_process

FAQ

P: Posso fazer com que o URL do post abra numa nova janela/separador?

R: Absolutamente! Se quiser que a ligação abra num novo separador, basta criar a sua ligação HTML desta forma:

<p>Thanks for the submission! 
If you'd like to see a preview of your post titled 
<strong>{submitted_cpt_title}</strong> for the post type ID of 
<strong>{submitted_cpt_id}</strong>, 
just <a href="{submitted_cpt_url}" target="_blank">click here</a>.</p>

<p>It will be reviewed shortly.</p>

P: Posso usar isto nas notificações por e-mail?

R: Atualmente, isto não está disponível para uso nas notificações por e-mail.

P: Seria possível usar estas Smart Tags dentro do formulário?

R: Não, uma vez que o ID e o URL do post só são atribuídos após a submissão do formulário, não seria possível usá-los antes da submissão do formulário.