Document

oSailing

Créer une page vierge pour la liste des articles (ex:blog)

la page qui liste les articles est la page home.php. On y accède par : nomdedomaine.fr/blog/

On boucle pour dynamiser la liste :


                    if ( have_posts() ) : 
                    while ( have_posts() ) : the_post(); 
                    // Mon article
                    endwhile; 
                    endif;

Pour récupérer les infos :


                    get_the_tiltle(); -> récupère le titre
                    get_the_excerpt(); -> récupère l'extrait
                    get_the_permalink(); -> récupère le lien de l'article

Pour installer un plugin :


                    composer require wpackagist-plugin/nomDuPlugin
                    wp plugin activate nomDuPlugin

https://developer.wordpress.org/themes/functionality/featured-images-post-thumbnails/

Permet a appache d'écrire dans le dossier upload:


                    mkdir wp-content/uploads
                    sudo chown -R $USER:www-data wp-content/uploads

get_the_category(); envoie un array, pour lister les catégories:


                    foreach (get_the_category() as $category) :
                    Dans le href :  class="post__footer__category-link" 
 Récup de la donnée : $category->name;
                    endforeach;

pour regénérer le CSS en fonction du SCSS (à faire après chaque changement dans le scss)


                    composer run build-assets

Pour gérer la taille des images (remplacer size):

get_the_post_thumbnail_url(null,size);

Pagination des articles (pp remplace les balises php):


                    // si on a un article précédent (get_next_post() ne renvoie pas une chaine vide), alors on
                        affiche le lien
                    if (get_next_post() !== "") :
                    Article précédent dans un lien ahref -> get_permalink(get_previous_post()) ">
                    endif;

                    if (get_next_post() !== "") : 
                    Article suivant dans un lien ahref -> get_permalink(get_next_post())
                    endif;

function.php lance les fonctions au démarrage du thème.

Déclarer la présence d'un menu dans Wordpress dans le fichier functions.php


                    // On déclare les EMPLACEMENTS de menus de notre thème
                    // on crée un emplacement "header-menu" (attention, on ne crée pas un MENU header-menu)
                    // ainsi qu'un emplacement "footer-menu"
                    function register_my_menus() {
                     register_nav_menus(
                     [ 
                     'header-menu' => __( 'Header Menu' ),
                     ]
                     );
                     }
                     // fonctionne un peu comme un eventListener javascript
                     // on demande à WP de déclencher l'appel à register_my_menus()
                     // au moment du "init"
                     // 'init' => 
                     add_action( 'init', 'register_my_menus' );