2018/2019 - ICOM Université Lyon 2 - DUCCI
Pourquoi? Quoi? Comment?
https://chstudio.fr | |
@s_hulard | |
http://github.com/shulard | |
s.hulard@chstudio.fr | |
s.hulard@univ-lyon2.fr |
Wordpress est une application web écrite en PHP.
Elle nécessite un hébergement web et quelques logiciels :
Il faut se connecter à MySQL pour créer une base de données.
echo "CREATE DATABASE wordpress" | mysql -u root -p
Wordpress peut être téléchargé directement sur le site officiel :
C:\wamp\www
/Applications/MAMP/htdocs
http://localhost/[wordpress]
wp-admin
du sitehttp://localhost/wordpress/wp-admin/
http://localhost/wordpress/
wp-admin
, pour l'administration du CMSwp-content
, pour les contenus, thèmes, plugins hors BDDwp-config.php
, pour la configuration généraleindex.php
, comme contrôleur principal
function custom_init()
{
//All of these are optional
$args = array(
'label' => "Nouveau type",
'labels' => array(
'name' => 'Nouveaux types',
'singular_name' => 'Nouveau type'
),
'public' => true,
'exclude_from_search' => false,
'publicly_queryable' => true,
'show_ui' => true,
'show_in_nav_menus' => true,
'show_in_menu' => true,
'show_in_admin_bar' => true,
'rewrite' => array(
'slug' => 'nouveau-type'
)
);
//Register the newsletter post type.
register_post_type( 'custom-type' , $args );
}
add_action( 'init', 'custom_init' );
/*
Theme Name: Empirik
Author: Stéphane HULARD & Jérôme VADON
Author URI: http://www.chstudio.fr/
Description: Site Web 2013 Empirik
Version: 1.0
License: GNU General Public License
*/
Il peut être accompagné d'un fichier screenshot.png
qui permet d'avoir un aperçu visuel directement dans l'administration.
Elle est complétement détaillée sur le Wordpress Codex !
header.php
, l'entête de la pagefooter.php
, le pied de la pageindex.php
, page d'accueil et template par défautsingle.php
, post seulpage.php
, page seulearchive.php
, category.php
, tag.php
Template:
/*
Template: parent-theme
*/
/!\ ------------------
Coller ici le contenu du fichier style.css du parent ou utiliser @import
Parfois, il faut sortir du cadre offert par un thème existant :
ATTENTION: Il vaut mieux créer un thème que transformer complètement un thème parent.
Un thème est au minimum composé de 3 choses :
style.css
le décrivantindex.php
pour afficher les contenuswp-content/themes/[mon-theme]
style.css
/*
Theme Name: Truite
Author: Moi
*/
Theme Name:
pour un nom "User Friendly" du thèmeAuthor:
, Version:
, Author:
, Licence:
, ...index.php
<?php
the_title();
Template par défaut, ce fichier contient toute la logique d'affichage générale.
Il n'est pas obligatoire de le créer mais c'est conseillé !
functions.php
Ce fichier permet de définir le comportement technique du thème.
Il contient l'intialisation et la personnalisation de Wordpress :
functions.php
<?php
function montheme_setup() {
add_editor_style();
add_theme_support( 'post-thumbnails' );
add_theme_support( 'menus' );
add_image_size( 'logo-mini', 110, 110, true );
register_nav_menu( "main", __('Menu principal', 'i18n'));
register_nav_menu( "search", __('Recherche d\'annonces', 'i18n'));
register_nav_menu( "rent-folder", __('Dossier de candidature locatif', 'i18n'));
}
add_action( 'after_setup_theme', 'montheme_setup' );
"La boucle" est un concept technique important de Wordpress qui décrit le principe de récupération des contenus dans une page.
Les contenus sont récupérés grâce à des requêtes SQL et affichés dans des boucles.
<?php
if ( have_posts() ) {
while( have_posts() ) { the_post();
the_title();
echo "
";
}
}
La documentation autour de la création de thèmes est très riche et partiellement traduite en français.
L'étude des thèmes existants est un bon point de départ pour découvir les différentes possibilités cachées...
Les plugins sont des morceaux de code permettant d'ajouter des fonctionnalités à Wordpress :
Comme pour les thèmes, il est possible d'en installer directement depuis Wordpress. Ils sont principalement référencés sur Wordpress.org.
Il existe énormément de plugins gratuit qui sont de qualité très variable...
Un plugin peut se présenter sous deux formes différentes :
Ils sont toujours placés dans :
wp-content/plugins
pour les plugins "standards"wp-content/mu-plugins
pour les "must use" pluginsCe sont des plugins installés dans un répertoire spécial wp-content/mu-plugins
et qui sont activés automatiquement sur tous les sites de l'installation.
Ils ne sont pas affichés dans la liste par défaut de la page "Plugins" de l'administration. Ils apparaissent quand même dans une partie "must use"
Les mises à jour de ces plugins ne sont pas incluent dans les notifications, c'est le webmaster qui est responsable de leur mise à jour (à faire à la main).
Comme pour le thème, la définition du plugin est réalisé grâce à des commentaires...
/*
Plugin Name: Hello Dolly
Plugin URI: http://wordpress.org/plugins/hello-dolly/
Description: This is not just a plugin, it symbolizes the hope and enthusiasm of an entire generation summed up in two words sung most famously by Louis Armstrong: Hello, Dolly. When activated you will randomly see a lyric from Hello, Dolly in the upper right of your admin screen on every page.
Author: Matt Mullenweg
Version: 1.6
Author URI: http://ma.tt/
*/
Ensuite, dans ce fichier toutes les actions nécessaires au fonctionnement du plugin sont effectuées.
Il est parfois difficile de trouver le bon plugin, voici une liste de plugins validés et solides