1. Introduction

Sommaire

Codex

Vous trouverez la documentation officielle de Wordpress (en anglais) à l'adresse codex.wordpress.org.

La base d'un thème Wordpress

Un thème est un répertoire (un dossier) contenant un certain nombre de fichiers, notamment :

  • Des templates (modèles de pages)
  • Des feuilles de style CSS
  • Des scripts Javascript
  • Des fichiers multimédia

Les thèmes sont installés dans le répertoire wp-content/themes. Pour créer un thème, il faudra donc créer un nouveau sous-répertoire à cet endroit.

Un thème peut être un enfant d'un autre thème. Cela signifie qu'il héritera des propriétés d'un autre thème.

Afin qu'un thème soit reconnu en tant que tel par Wordpress, celui-ci doit impérativement contenir deux fichiers :

  • index.php
  • style.css

Le fichier index.php

Ce fichier est le fichier principal de votre thème puisque c'est celui qui sera chargé par défaut pour toutes vos pages. Nous y reviendrons dans la seconde partie.

Le fichier style.css

Le fichier style.css contient les informations de base de votre thème.
Ces informations doivent être indiquées en commentaires en haut du fichier.

style.css
Fichier style.css du thème Twenty Thirteen

Le fichier peut être laissé vide, auquel cas votre thème portera le nom du dossier que vous avez créé. Il est tout de même préférable d'en indiquer un maximum, notamment Theme Name qui indique le nom de votre thème.

  • Theme Name : le nom du thème qui sera affiché dans le back-office
  • Theme URI : l'URL du thème si celui-ci est hébergé dans une bibliothèque de thèmes
  • Author : nom de l'auteur du thème
  • Author URI : site web de l'auteur
  • Description : texte de présentation du thème
  • Version : numéro de version
  • License : type de licence (GNU, MIT, etc.)
  • License URI : lien vers les conditions de la licence
  • Tags : tags permettant de retrouver plus facilement le thème si celui-ci est hébergé dans une bibliothèque de thèmes
  • Text Domain : identifiant du thème utilisé pour la traduction

Attention : Wordpress est très capricieux et pourrait ne pas reconnaître vos informations si vous ne respectez pas précisément la nomenclature. Veillez à bien mettre des majuscules où il y en a, ne mettez pas d'espace avant les deux points et mettez-en un après.

Créons notre premier thème

Dans ce cours nous allons créer un thème pour un site de cinéma. Nous appellerons donc notre thème "Cinéma" mais attention : le nom de votre répertoire ne doit contenir ni espace, ni caractères spéciaux.
Nous créerons donc un répertoire cinema dans lequel nous créerons les deux fichiers requis.

style.css
Notre fichier style.css doit ressembler à ça.

Simplement avec ce fichier style.css et un index.php vide, vous devriez voir apparaître votre thème dans la liste des thèmes installés depuis le menu "Apparence > Thèmes" de votre site.

Par défaut, votre thème sera représenté par un rectangle vide. Vous pouvez lui attribuer une image en ajoutant un fichier screenshot.png dans votre répertoire. Les dimensions recommandées sont 1200x900.

Liste des thèmes installés
Le voilà