Comment créer une extension automatique (Must-Use) personnalisée

La difference entre une extension normale et une extension automatique dans WordPress est la suivante : les extensions automatiques, comme leur nom l’indique, sont activées automatiquement une fois téléchargées dans un dossier WordPress spécifique.

Créer une extension automatique personnalisé

1: Créez un répertoire nommé mu-plugins dans votre dossier wp-content.
Au cas où un dossier mu-plugins existerait déjà, n’en créez pas de nouveau, utilisez simplement celui existant.
2: En utilisant un éditeur de texte basique, créez un nouveau fichier et copiez du code dedans. Pour commencer, vous pouvez télécharger cette base simple.
3: Sauvegardez le fichier avec le nom que vous souhaitez en utilisant des caractères latins, des letters et tirets.
Exemple de nom de fichier : wp-rocket-custom.php.
4: Téléchargez ce fichier dans le dossier mu-plugins créé à l’étape 1.
5: Enfin, désactivez et réactivez WP Rocket.

Note: Vous pouvez faire une extension normale à la place d’une extension automatique, en téléchargeant ce même fichier dans le dossiez wp-content/plugins plutôt que mu-plugins. Souvenez-vous que vous devrez activer cette extension sur la page extensions de votre admin WordPress.

Quelques elements à prendre en considération

Testez toujours votre extension avant de le télécharger sur votre site public !
Souvenez-vous qu’un point-virgule manquant dans le PHP peut casser votre site. Si quoique ce soit se casse, retirez le fichier plugin.
Assurez-vous que votre éditeur de texte est bien réglé sur texte simple quand vous éditez du code !
Le texte enrichi pourrait compromettre le code et engendrer des erreurs PHP, ou même un site cassé.
Les extensions automatiques sont chargées automatiquement et dans l’ordre alphabétique de leurs noms de fichiers.
Si pour une raison ou une autre vous utilisez une fonction existante de WP Rocket, mettez la toujours dans une condition comme ceci :
```
if ( function_exists( 'some_wp_rocket_function' ) ) {
	// do something with some_wp_rocket_function() here
	}
	
```

Encore une fois, assurez-vous de bien désactiver et réactiver WP Rocket une fois que vous avez téléchargé votre extension personnalisée.

Exemple de plugin automatique

Important ! Ne faites pas un copier-coller du code suivant depuis cette page, mais téléchargez le gist.
Faire un copier-coller depuis ce document pourrait entraîner des erreurs PHP plus tard car certains caractères peuvent être encodés.

<?php
/**
 * Plugin Name: Your Custom Functionality Plugin
 * Description: Short description of your plugin here.
 * Author:      your name here
 * License:     GNU General Public License v3 or later
 * License URI: http://www.gnu.org/licenses/gpl-3.0.html
 */

// Basic security, prevents file from being loaded directly.
defined( 'ABSPATH' ) or die( 'Cheatin&#8217; uh?' );

/* Prefix your custom functions!
 *
 * Function names must be unique in PHP.
 * In order to make sure the name of your function does not
 * exist anywhere else in WordPress, or in other plugins,
 * give your function a unique custom prefix.
 * Example prefix: wpr20151231
 * Example function name: wpr20151231__do_something
 *
 * For the rest of your function name after the prefix,
 * make sure it is as brief and descriptive as possible.
 * When in doubt, do not fear a longer function name if it
 * is going to remind you at once of what the function does.
 * Imagine you’ll be reading your own code in some years, so
 * treat your future self with descriptive naming. ;)
 */

/**
 * Pass your custom function to the wp_rocket_loaded action hook.
 *
 * Note: wp_rocket_loaded itself is hooked into WordPress’ own
 * plugins_loaded hook.
 * Depending what kind of functionality your custom plugin
 * should implement, you can/should hook your function(s) into
 * different action hooks, such as for example
 * init, after_setup_theme, or template_redirect.
 * 
 * Learn more about WordPress actions and filters here:
 * https://developer.wordpress.org/plugins/hooks/
 *
 * @param string 'wp_rocket_loaded'         Hook name to hook function into
 * @param string 'yourprefix__do_something' Function name to be hooked
 */
add_action( 'wp_rocket_loaded', 'yourprefix__do_something' );

/**
 * Define your custom function here.
 * This example just returns true.
 * 
 * @return bool Boolean value TRUE
 */
function yourprefix__do_something() {
	return true;
}<br>