Créer son plugin 1

Pour créer mon superbe plugin HelloWorld, il faut déjà lui créer un répertoire hello-world dans le répertoire des plugins et un fichier hello-world.php avec un entête-commentaire contenant les informations du plugin : le nom du plugin, son auteur, description du plugin, version …etc

|- wp-admin
|- wp-content 
      |- cache
      |- languages
      |- plugins
            |- contact-form-7
            |- hello-world
                  |- hello-world.php

<?php
/*
 * Plugin Name: Hello World
 * Plugin URI: http://uri-plugin/si/existe
 * Description: Un plugin qui écrit Hello World
 * Author: Elisabeth Pointal
 * Author URI: http://elisabeth.pointal.org/
 * Text Domain: hello
 * Domain Path: /languages/
 * Version: 1.0.0
 * License: GPL2
 */

Et c'est suffisant, j'ai créé un plugin. Il apparaît bien dans les extensions de mon application Wordpress, il ne me reste qu'à l'activer.

Pour que mon plugin fasse un peu quelque chose, je décide qu'il ajoute “hello World !!” devant le titre des posts.

<?php
/*
 * Plugin Name: Hello World
 * Plugin URI: http://uri-plugin/si/existe
 * Description: Un plugin qui écrit Hello World
 * Author: Elisabeth Pointal
 * Author URI: http://elisabeth.pointal.org/
 * Text Domain: hello
 * Domain Path: /languages/
 * Version: 1.0.0
 * License: GPL2
 */
// Ajoute Hello World devant $content
function print_hello_before_title($content){
    return " Hello World !! " . $content;
}

add_filter('the_title','print_hello_before_title');

Si on veut pouvoir insérer notre superbe «Hello World!!» n'importe où dans nos posts, il faut créer un shortcode.

function hello_world_shortcode(){
    echo "<div>Hello World !!</div>";
}

if(!is_admin()){
    //on ajoute un shortcode appelé helloworld, qui appelle la fonction hello_world_shortcode
    add_shortcode('helloworld', 'hello_world_shortcode');
}

Dans l'édition d'un article, il suffit de taper [helloworld], pour qu'il soit remplacer par <div>Hello World !!</div>.
On peut aussi faire passer des arguments à la fonction hello_world_shortcode.

function hello_world_shortcode($options){
    $style = "";
    $textafter = "";
    //couleur du texte
    if(isset($options['color'])){
       $style = ' style="color:'.$options['color'].';"';
    }
    //Texte après hello World
    if(isset($options['textafter'])){
        $textafter = "<br />".$options['textafter'];
    }
    echo "<div".$style.">Hello World !!".$textafter."</div>";
}

if(!is_admin()){
    add_shortcode('helloworld', 'hello_world_shortcode');
}

Dans l'édition de mon article, je tape alors [helloworld color=“red”] ou autre …

Edition d'un article en utilisant mon shortcode helloworld :
Vue de l'article avec des shortcodes helloworld :

Comme pour le thème, on utilise wp_enqueue_script et wp_enqueue_style pour charger respectivement les fichiers javascript et css.

   //url du dossier du plugin
   define('HELLO_DIR_URL', plugin_dir_url(__FILE__));
  //insertion de mon fichier hello.js dépendant de jquery, sans numéro de version,  en bas de page
  wp_enqueue_script('hello-js', HELLO_DIR_URL . 'js/hello.js', array('jquery'), null,true);
  //insertion du fichier hello.css, indépendant, sans numéro de version
  wp_enqueue_style('hello-css', HELLO_DIR_URL . 'css/hello.css',array(), null);
         

Pour mon superbe plugin, ça peut donner quelque chose du genre avec une class “singleton” HelloWorld qui représente mon plugin et une vue hello.phtml.

<?php
/*
 * Plugin Name: Hello World
 * Description: Un plugin qui écrit Hello World
 * Author: Elisabeth Pointal
 */
class HelloWorld {

    /**
     * @var HelloWorld
     * @access private
     * @static
     */
    private static $_instance = null;
    
    /**
     * Détermine si le css a déjà été ajouté
     * @var boolean
     * @access public
     * @static
     */
    public static $_add_css = false;
    
    
    /**
     * Constructeur de la classe
     *
     * @param void
     * @return void
     */
    private function __construct() {
        if(is_admin()){
            //côté éditeur
            add_action("admin_menu", "HelloWorld::admin_menu");
        }else{
            //côté publique
            add_shortcode('helloworld', 'HelloWorld::shortcode');
        }
    }


    /**
     * Méthode qui crée l'unique instance de la classe
     * si elle n'existe pas encore puis la retourne.
     *
     * @param void
     * @return Singleton
     */
    public static function getInstance() {

        if(is_null(self::$_instance)) {
            self::$_instance = new HelloWorld();
        }

        return self::$_instance;
    }
    
    
    /**
     * Méthode qui interprète un shortcode
     * du type [helloworld class="red" textafter="Madame et Monsieur"]
     * @param array $options contient deux éléments maxi class et textafter 
     */
    public static function shortcode($options){
        //Traitement du tableau $options 
        if(isset($options['class'])){
            $class = ' class="'.$options['class'].'"';
        }
        //on récupère le contenu du fichier hello.phtml
        ob_start();
        include('views/hello.phtml');
        $output = ob_get_clean();
        // le css a été ajouté, on le passe à true, pour qu'il ne soit pas ajouté à chaque passage
        self::$_add_css = true;
        return $output;
    }
    
    
    /**
     * Méthode qui ajoute le plugin dans le menu Réglages côté éditeur
     */
    public static function admin_menu(){
       //Voir créer son plugin 2
    }
}


//on initialise le plugin
$hello = HelloWorld::getInstance();

<?php
//on ajoute le css si ce n'est pas déjà fait
if(!HelloWorld::$_add_css):?>
    <style>
        .red{
            color:red;
        }
        .green{
            color:green;
        }
    </style>
<?php endif;?>

<div <?php echo $class;?>>
     Hello World!!
    <?php if(isset($options["textafter"])){
        echo "</br>".$options["textafter"];
    }?>
</div>

— Elisabeth Pointal 14/05/2016 15:17 —— Créer son plugin 2