Utiliser nos fragments de codes

Des fragments de code ? Pourquoi ça ?

WP Customer Area possède de nombreuses options que vous pouvez paramétrer dans les réglages. Mais cela ne s’arrête pas là ! Nous mettons à votre disposition de nombreux filtres et actions WordPress (consultables dans Customer Area -> Statuts -> Actions et filtres), qui vous permettrons à l’aide de bouts de codes, de personnaliser ou changer le comportement de votre plugin favori !

La liste des actions et filtres vous donnera une bonne vue d’ensemble des éléments sur lesquels vous pouvez directement agir. Sinon, vous pouvez consulter notre page d’exemples de fragments de code.

Les fragments de code nous permettent de ne pas surcharger les pages d’options, tout en vous laissant des possibilités de modification de certaines fonctionnalités. La présente documentation vous expliquera où insérer ces fragments de code dans le but de les rendre fonctionnels.

Comment on s’y prend ?

Certains fragments de code fonctionneront s’ils sont insérés dans votre fichier functions.php de votre thème, mais d’autres n’auront aucun effet, car les filtres ou l’actions en question auront déjà été executées lorsque votre thème aura été chargé.

Nous vous recommandons donc dans tous les cas d’insérer ces bouts de code dans un plugin. Pour ce faire, suivez les étapes ci-dessous :

Créer un dossier nommé wpca-custom-tweaks dans le dossier plugins de votre installation WordPress.

Dans ce dossier, créez un fichier nommé wpca-custom-tweaks.plugin.php et insérez-y le code indiqué ci-dessous.
Note : le nom du fichier n’a aucune importance.
Attention: Si vous choisissez un autre nom dans Plugin Name, veillez à en choisir un qui commence par WPCA pour le faire figurer après le plug-in WP Customer Area et ses extensions sur la page des plug-ins de votre site. En effet, vous aurez besoin que les plugins WP Customer Area et leurs classes PHP soient déjà exécutées si vous souhaitez accéder à certains d’entre eux.

<?php
/*
Plugin Name: WPCA Custom Tweaks
Plugin URI:
Description: Just an example of a simple WP plugin that can be use to add code snippets for WP Customer Area
Version:     1.0.0
Author:      Thomas Lartaud
Author URI:  https://old.wp-customerarea.dev
License:     GPL2
License URI: https://www.gnu.org/licenses/gpl-2.0.html
*/

defined('ABSPATH') or die('Nope, not accessing this');

/**
 * Code snippet example
 * Remove the description field from the profile page
 *
 * @see https://old.wp-customerarea.dev/code-snippets/ for more snippet examples
 *
 * @param $fields array Profile fields
 *
 * @return mixed array Modified profile fields
 */
function remove_some_profile_fields( $fields )
{
	unset($fields[ 'description' ]);
	return $fields;
}

add_filter('cuar/core/user-profile/get_profile_fields', 'remove_some_profile_fields');

Enregistrez le fichier et activez l’extension WPCA Custom Tweaks.
Vérifiez que le fragment de code attaché à ce plugin fonctionne. Ici, le plugin inclut déjà un fragment de code d’exemple qui a pour effet de supprimer le champs “Biographie” sur les pages “Mon Compte” et “Détails du Compte” de WP Customer Area.
Vous êtes maintenant prêt à ajouter vos propres fragments de code ! Supprimmez la fonction code snippet example et son filtre, et rajoutez les vôtres !

Amusez-vous bien !

Documentation