Comment personnaliser la limite de révisions de formulaire

Souhaitez-vous personnaliser la limite de révisions de formulaire pour WPForms ? En utilisant un petit extrait de code PHP, vous pouvez facilement ajuster le nombre de révisions enregistrées ou même les désactiver complètement. Dans ce tutoriel, nous vous expliquerons exactement comment y parvenir.

Par défaut, WPForms est automatiquement configuré pour des révisions de formulaire illimitées pour tous vos formulaires. Cependant, les révisions de publication peuvent être désactivées globalement au niveau de WordPress ou du serveur. Pour en savoir plus sur les révisions de publication de WordPress, veuillez consulter leur documentation.

Si tel est le cas, vous utiliserez ce tutoriel pour vous assurer que les révisions et le nombre de révisions que vous souhaitez stocker sont contrôlés par vous et par le filtre que nous utiliserons dans ce tutoriel.

Limite de révisions de formulaire

Avant de créer notre formulaire, nous allons commencer par ajouter cet extrait de code à notre site.

Si vous avez besoin d'aide sur comment et où ajouter des extraits de code à votre site, veuillez consulter ce tutoriel.

Désactivation des révisions de formulaire

Si vous souhaitez désactiver complètement les révisions de formulaire, ajoutez simplement cet extrait de code à votre site.

/**
 * Disable form revisions
 *
 * @link https://wpforms.com/developers/how-to-customize-the-form-revisions-limit/
 */

function wpf_dev_revisions_to_keep( $num, $post ) {
	
	// -1 for unlimited form revisions, set to 0 to disable form revisions completely
	// Control the form revisions number by setting the return value to a specific number
	return 0; 
	
}
add_filter( 'wp_wpforms_revisions_to_keep', 'wpf_dev_revisions_to_keep', 10, 2 );

En utilisant cet extrait de code, les révisions de formulaire ont été désactivées. Cela n'affecte pas vos révisions de publication globales, seulement les révisions WPForms.

Personnalisation de la limite de révisions de formulaire

Si vous avez activé les révisions de publication globales mais que vous souhaitez personnaliser la limite de révisions des formulaires WPForms, veuillez utiliser l'extrait suivant.

/**
 * Customize form revisions limit
 *
 * @link https://wpforms.com/developers/how-to-customize-the-form-revisions-limit/
 */

function wpf_dev_revisions_to_keep( $num, $post ) {
	
	// -1 for unlimited form revisions, set to 0 to disable form revisions completely
	// Control the form revisions number by setting the return value to a specific number
	return 4; 
	
}
add_filter( 'wp_wpforms_revisions_to_keep', 'wpf_dev_revisions_to_keep', 10, 2 );

Avec cet extrait de code, nous enregistrons les 4 dernières révisions. Vous pouvez utiliser n'importe quel nombre ici, et ce sera le nombre de révisions que WPForms stockera.

Activation des révisions de formulaire illimitées

Cet extrait de code est conçu spécifiquement si vos révisions de publication sur WordPress ou votre serveur sont désactivées. L'utilisation de cet extrait de code activerait non seulement les révisions de formulaire WPForms, mais définirait également la limite de révisions de formulaire à illimitée.

WPForms affichera un message pour vous informer si le paramètre global des révisions de publication est désactivé.

Dans le cadre de ce tutoriel, nous voulons non seulement activer les révisions de formulaire, mais aussi définir la limite de révisions de formulaire pour stocker une quantité illimitée. Pour ce faire, nous allons ajouter cet extrait de code à notre site.

/**
 * Enable unlimited post revisions for WPForms
 *
 * @link https://wpforms.com/developers/how-to-customize-the-form-revisions-limit/
 */

function wpf_dev_revisions_to_keep( $num, $post ) {
	
	// -1 for unlimited form revisions, set to 0 to disable form revisions completely
	// Control the form revisions number by setting the return value to a specific number
	return -1; 
	
}
add_filter( 'wp_wpforms_revisions_to_keep', 'wpf_dev_revisions_to_keep', 10, 2 );

Avec cet extrait de code, vous ne verrez aucun message car la limite de révisions de formulaire est maintenant définie sur -1, ce qui signifie illimité. Vous verrez seulement une liste de toutes les révisions.

Et c'est tout ce dont vous avez besoin ! Souhaitez-vous définir une image par défaut pour toutes vos soumissions de publication ? Consultez notre tutoriel sur Comment définir une image mise en avant par défaut pour les soumissions de publication.