> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://doc.openagenda.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Personnaliser les templates de l'extension Openagenda pour WordPress


# Marche à suivre :

||| La principale erreur lorsqu’on souhaite modifier une extension, consiste à modifier directement le code source de l'extension.
||| L’écosystème WordPress, et ses extensions, fonctionnent avec des systèmes de mise à jour : ainsi, régulièrement, notre extension OpenAgenda est mise à jour afin d'y apporter des corrections ou de nouvelles fonctionnalités.
||| Si vous modifiez directement les fichiers d’une extension, vos modifications seront écrasées en cas de mis à jour et tout votre travail sera perdu.

### Surcharger les "templates" de l'extension :

Cela consiste à placer dans le **thème enfant** de votre site un **fichier** de l'extension pour que ce soit **votre version** qui soit **prise en compte**.

1. **Créez un thème enfant**
Vous trouverez [ici la démarche à suivre pour créer un thème enfant sur Wordpress](https://wordpress.com/fr/support/themes/themes-enfants/?_gl=11gahwky_gcl_au*MTA3MDI1NzA2NC4xNzQzNjg5OTY2).
2. **Créez un dossier "openagenda" à la racine de votre thème enfant**
3. **Copiez-Collez les templates de l'extension que vous souhaitez modifier**

# Liste et description des différents templates :

### Affichage de la liste d'évènements

###### list-header.php
Affiche :
* Le nombre total d’évènement ;
* les filtres actifs (affichés en rouge dans l'exemple ci-dessous) ;

###### event-loop.php
Affiche :
* les boutons d'export
* les paginations au-dessus et en-dessous des événements

![](https://storage.crisp.chat/users/helpdesk/website/-/e/0/b/a/e0babfaa1e65e800/image_l38grj.png)
###### event.php
Modèle utilisé pour afficher les informations de l'événement sur la vue liste. 
Affiche :
* **l'image **de l'évènement
* **le titre** de l'évènement
* le badge favori
* **la date** de l'évènement
* **la description courte **de l'évènement
* **le lieu** de l'évènement

![](https://storage.crisp.chat/users/helpdesk/website/-/e/0/b/a/e0babfaa1e65e800/image_1u4mw4t.png)
### Affichage d'un évènement unique

###### single-event.php
Modèle utilisé pour afficher les informations de l'événement sur la vue événement simple.
Affiche :
* **le titre** de l'évènement
* le badge favori
* **la/les date.s** de l'évènement sous différents formats
* les **boutons de partage** sur les réseaux sociaux
* **la description courte **de l'évènement
* **l'image **de l'évènement
* **la liste des dates** de l'évènement
* la **description longue** de l'évènement
* **les consignes d'inscription**
* **les autres champs additionnels** qui ont été renseignés (cf. template event-additional-fields.php)
* **les infos du lieu** de l'évènement (cf. template event-location.php)
![](https://storage.crisp.chat/users/helpdesk/website/-/e/0/b/a/e0babfaa1e65e800/image_vo62ri.png)
###### event-additional-fields.php
Modèle utilisé pour afficher la liste des champs additionnels sur les vues événement simples.

###### event-location.php
Modèle utilisé pour afficher les informations sur le lieu sur les vues événement simples.

### Shortcode "Preview"
###### preview-loop.php
Conteneur principal pour le widget et code court de prévisualisation.
L'affichage du preview s'appuie ensuite sur le template **event.php**.

# Pour en savoir plus

Pour plus d'informations, vous retrouverez le détail des templates, des filtres et des fonctions dans la [doc suivante](https://developers.openagenda.com/extension-wordpress/#personnalisation).