• Edwiser : shortcodes et hooks

    Ce troisième article sur la connexion de WordPress et Moodle est le plus technique, on y parle de Shortcodes et de Hooks.

    Si vous ne souhaitez pas entrer dans ces aspects rendez vous directement sur Edwiser Bridge, l’essentiel qui offre un résumé de toutes les fonctionnalités d’Edwiser Bridge.

    Un Shortcode de WordPress est un code placé entre crochets qui ajoute une fonction particulière, le plus connu est le shortcode « gallery » qui, placé dans un article, ajoute toutes les images de l’article en bas de page sous forme de miniatures.

    Pour en savoir plus sur les shortcodes

    La définition au Codex de WordPress

    Les shortcodes d’Edwiser Bridge ajoutent à WordPress la personnalisation de l’affichage des cours de Moodle.

    Avec les Hooks (ou « Crochets ») il est possible d’exécuter des actions spécifiques donc d’ajouter des fonctions au plugin. Ils permettent de personnaliser la relation WordPress / Moodle que vous souhaitez obtenir sans entrer dans un développement du code.

    Pour en savoir plus sur les Hooks de WordPress 

     

    Les shortcodes d’Edwiser Bridge

    Shortcode [eb_courses]:

    Ce shortcode est utilisé pour afficher les cours sur une page. Les paramètres qui peuvent être utilisés avec ce shortcode sont les suivants :

    • [eb_courses order = « ASC | DESC »] – Affiche les cours en ordre croissant / décroissant.
    • [eb_courses per_page = « Number »] – Active la pagination et limite le nombre de cours affichés sur une page. Par exemple, [eb_courses per_page = « 12 »] affichera seulement 12 cours sur la première page et les prochains cours sur la page 2 et ainsi de suite.
    • [eb_course categories = « Category_Slug (s) »] – Affiche les cours d’une catégorie / catégorie spécifique. Par exemple, [eb_course categories = « Science »] affichera uniquement les cours de la catégorie Science
    • [eb_courses cat_per_page = « Nombre »] – Affiche uniquement les cours du nombre de catégories défini.
    • [eb_courses group_by_cat = « yes »] – Regroupe et affiche les cours selon les catégories de la page.
    • [eb_courses horizontalally_scroll = « yes »] – Affiche tous les cours dans une barre de défilement horizontale.

    Shortcode [eb_my_courses]:

    Ce shortcode est utilisé pour afficher «mes cours» sur une page. Les paramètres qui peuvent être utilisés avec ce shortcode sont les suivants :

    • [eb_my_courses my_courses_wrapper_title = « Mes cours »] – Définit un titre personnalisé sur votre page mes cours.
    • [eb_my_courses recommended_courses_wrapper_title = « Cours recommandés »] – Définit un titre personnalisé à la section des cours recommandés sur la page mes cours.
    • [eb_my_courses number_of_recommended_courses = « 4 »] – Définit le nombre de cours à afficher dans la section des cours recommandés sur ma page de cours.

    Shortcode [eb_user_account]:

    Affiche le compte d’utilisateur sur une page.

    Les Hooks d’Edwiser Bridge

    Hooks d’action

    Exemples d’utilisations :

    • enregistrer les paramètres manuellement sur la page des paramètres.
    • exécuter une action personnalisée après la fin de la synchronisation du cours.
    • exécuter du code personnalisé après la création du cours sur WordPress.
    • exécuter une action personnalisée après la fin de la synchronisation de chaque utilisateur.
    • exécuter un code personnalisé après avoir enregistré un compte WordPress et l’avoir associé au compte Moodle.

     

    Hooks de filtres

    Exemples d’utilisations :

    • ajouter des données personnalisées au profil d’un utilisateur lorsqu’un compte est créé sur WordPress.
    • filtrer le nom d’utilisateur utilisé lors de la création d’un nouveau compte pour un utilisateur sur Moodle.
    • Définir un mot de passe personnalisé pour les comptes d’utilisateurs.
    • transférer des données de champ de profil supplémentaires de WordPress à Moodle.
    • savoir si le profil d’un utilisateur existant est mis à jour ou si un nouveau compte est créé sur Moodle.

    Détail de tous les Hooks d’actions et de filtres : https://edwiser.org/bridge/documentation/

     

    Edwiser Bridge – Compatibilité du thème

    Lors de l’installation du plugin Edwiser Bridge, vous pouvez constater que les pages ‘archive de cours’ et ‘page de cours simple’ ne s’affichent pas comme vous l’auriez souhaité. Cela se produit car la structure HTML utilisée dans Edwiser Bridge peut être différente de celle utilisée dans votre thème. Voici ce que vous devez faire pour qu’elles s’affichent comme vous le souhaitez. (en anglais)