Documentations et Dossiers Notifications | PHPBoost 5.2
Bonjour à toutes et à tous,
Aujourd'hui je vous présente un module pour PHPBoost 5.2.
Un module permettant d'envoyer des notifications à vos membres lorsque d'autres personnes interagissent avec leurs contenus. C'est-à-dire que si un membre poste un sujet sur le forum et qu'un autre membre envoie un message dans ce sujet, le membre qui a créé le sujet recevra une notification lui indiquant que le membre a ajouté une réponse à son sujet.
<span class="warning">De base le module de notifications ne communique pas avec les différents modules de PHPBoost, c'est pour cela que vous devez mettre en oeuvre les addons qui sont proposés sur cette page ! </span>
Les addons sont des petits morceaux de code à ajouter sur le module pour lequel il a été fait afin justement "d'activer" les notifications pour ce module. Vous trouverez de plus amples détails ci-dessous.
Pour télécharger le module Notifications pour PHPBoost 5.2 Cliquez-ici
Donc comme vous l'aurez compris ce module fonctionne grâce à des addons ! Sans cela, la seule fonctionnalité du module c'est de pouvoir envoyer une notification à un membre depuis votre espace d'administration, ce n'est pas vraiment ce que l'on souhaite j'imagine ! Donc voici les différents addons
Recevoir une notification lorsque quelqu'un poste un message dans notre sujet[
Recevoir une notification lorsque qu'un modérateur ou administrateur supprime notre sujet
Recevoir une notification lorsqu'un membre répond à notre sondage
Recevoir une notification lorsqu'un modérateur ou un administrateur verrouille notre sujet
Recevoir une notification lorsqu'un modérateur ou un administrateur déverrouille notre sujet
Recevoir une notification lorsque notre contribution est mise à jour
Connaître le nombre de notification(s) dans le module connect ..
Certains addons nécessite des champs que certaines requêtes SQL de PHPBoost 5.2 n'ont pas (N'ayez crainte vous n'avez juste qu'à modifier une ligne pour demander à PHPBoost qu'il prenne en compte une colonne en plus ..)
Notez que dans la PHPBoost 5.2 final il n'y aura pas besoin de faire les deux modifications ci-dessous car les colonnes seront prise en compte .. En attendant si vous utilisez une RC, vous devez le faire
Recevoir une notification lorsque quelqu'un poste un message dans notre sujet
Recevoir une notification lorsque qu'un modérateur ou administrateur supprime notre sujet
Recevoir une notification lorsqu'un membre répond à notre sondage
Recevoir une notification lorsqu'un modérateur ou un administrateur verrouille notre sujet
Recevoir une notification lorsqu'un modérateur ou un administrateur déverrouille notre sujet
Pour les contributions j'ai fait qu'un seul addon donc à voir si y'a encore des choses à faire à ce niveau plus tard ..
Recevoir une notification lorsque notre contribution est mise à jour
Connaître le nombre de notification(s) dans le module connect ..
Edité par Myster Le 12/01/2019 à 10h38
Aujourd'hui je vous présente un module pour PHPBoost 5.2.
Notifications!
Un module permettant d'envoyer des notifications à vos membres lorsque d'autres personnes interagissent avec leurs contenus. C'est-à-dire que si un membre poste un sujet sur le forum et qu'un autre membre envoie un message dans ce sujet, le membre qui a créé le sujet recevra une notification lui indiquant que le membre a ajouté une réponse à son sujet.
<span class="warning">De base le module de notifications ne communique pas avec les différents modules de PHPBoost, c'est pour cela que vous devez mettre en oeuvre les addons qui sont proposés sur cette page ! </span>
Liste des fonctionnalités!
- Envoyer une notification à un membre, ou tous les membres depuis l'administration
- Gérer le nombre de notifications par pages
- Archivage des notifications une fois lues
- Supprimer une notification en particulier (ou toutes d'un coup)
- Activation/Désactivation de la suppression automatique des notifications après la lecture
- Recevoir des notifications sur les différents modules de PHPBoost grâce aux addons ci-dessous
- Option permettant l'archivage automatique des notifications (à activer dans l'administration)
- Possibilité d'archiver une notification spécifique si l'option d'archivage automatique n'est pas activée.
Mais pourquoi tu nous parles d'addons ?
Les addons sont des petits morceaux de code à ajouter sur le module pour lequel il a été fait afin justement "d'activer" les notifications pour ce module. Vous trouverez de plus amples détails ci-dessous.
Preview du module
Lien de téléchargement
Pour télécharger le module Notifications pour PHPBoost 5.2 Cliquez-ici
Les addons
Donc comme vous l'aurez compris ce module fonctionne grâce à des addons ! Sans cela, la seule fonctionnalité du module c'est de pouvoir envoyer une notification à un membre depuis votre espace d'administration, ce n'est pas vraiment ce que l'on souhaite j'imagine ! Donc voici les différents addons
Recevoir une notification lorsque quelqu'un poste un message dans notre sujet[
Recevoir une notification lorsque qu'un modérateur ou administrateur supprime notre sujet
Recevoir une notification lorsqu'un membre répond à notre sondage
Recevoir une notification lorsqu'un modérateur ou un administrateur verrouille notre sujet
Recevoir une notification lorsqu'un modérateur ou un administrateur déverrouille notre sujet
Recevoir une notification lorsque notre contribution est mise à jour
Connaître le nombre de notification(s) dans le module connect ..
A FAIRE ABSOLUMENT AVANT D'INTEGRER LES ADDONS
Notez que dans la PHPBoost 5.2 final il n'y aura pas besoin de faire les deux modifications ci-dessous car les colonnes seront prise en compte .. En attendant si vous utilisez une RC, vous devez le faire
Caché :
Par ceci:
Par le code suivant:
Voilà c'est tout !
- Il nous faut l'user_id du créateur du topic pour les différentes notifications donc allez dans forum/post.php, puis à la ligne 256 remplacez
Code PHP :
$topic = PersistenceContext::get_querier()->select_single_row_query('SELECT idcat, title, nbr_msg, last_user_id, last_msg_id, status FROM ' . PREFIX . 'forum_topics WHERE id=:id', array( 'id' => $idt_get ));
Par ceci:
Code PHP :
$topic = PersistenceContext::get_querier()->select_single_row_query('SELECT user_id, idcat, title, nbr_msg, last_user_id, last_msg_id, status FROM ' . PREFIX . 'forum_topics WHERE id=:id', array( 'id' => $idt_get ));
- Et pour finir il nous faut le titre du sujet donc allez dans forum/action.php à la ligne 69 puis remplacez ceci:
Code PHP :
Par le code suivant:
Code PHP :
Voilà c'est tout !
Liste des addons
Le forum
Recevoir une notification lorsque quelqu'un poste un message dans notre sujet
Caché :
Dans forum/post.php, vers la ligne 340 juste après:
Ajoutez ceci:
Code PHP :
$last_msg_id = $Forumfct->Add_msg($idt_get, $topic['idcat'], $contents, $topic['title'], $last_page, $last_page_rewrite);
Ajoutez ceci:
Code PHP :
if ($topic['user_id'] != AppContext::get_current_user()->get_id()) { $notify = New Notifications(); $notify->set_sender_id(AppContext::get_current_user()->get_id()); $notify->set_recipient_id($topic['user_id']); $notify->set_reading(0); $notify->set_date(time()); $notify->set_content(NotificationsFormat::contenu('forum.msg', array( 'url_username' => UserUrlBuilder::profile(AppContext::get_current_user()->get_id())->rel(), 'username' => AppContext::get_current_user()->get_display_name(), 'sujet' => $topic['title'], 'url' => PATH_TO_ROOT . "/forum/topic" . url('.php?id=' . $idt_get . $last_page, '-' . $idt_get . $last_page_rewrite . '.php', '&') . '#m' . $last_msg_id ))); Notifications::add_notification($notify); }
Recevoir une notification lorsque qu'un modérateur ou administrateur supprime notre sujet
Caché :
A la ligne 80 dans forum/action.php, juste en dessous de
ajoutez ceci:
Code PHP :
$Forumfct->Del_topic($msg['idtopic']); //Suppresion du topic.
ajoutez ceci:
Code PHP :
if($topic['user_id'] != AppContext::get_current_user()->get_id()) { $notify = New Notifications(); $notify->set_sender_id(AppContext::get_current_user()->get_id()); $notify->set_recipient_id($topic['user_id']); $notify->set_reading(0); $notify->set_date(time()); $notify->set_content(NotificationsFormat::contenu('forum.del.topic', array( 'url_username' => UserUrlBuilder::profile(AppContext::get_current_user()->get_id())->rel(), 'username' => AppContext::get_current_user()->get_display_name(), 'sujet' => $topic['title'], ))); Notifications::add_notification($notify); }
Recevoir une notification lorsqu'un membre répond à notre sondage
Caché :
Ajoutez ceci:
- Dans forum/action.php vers la ligne ligne 215 en dessous de:
Code PHP :
Ajoutez ceci:
Code PHP :
if ($topic['user_id'] != AppContext::get_current_user()->get_id()) { $notify = New Notifications(); $notify->set_sender_id(AppContext::get_current_user()->get_id()); $notify->set_recipient_id($topic['user_id']); $notify->set_reading(0); $notify->set_date(time()); $notify->set_content(NotificationsFormat::contenu('forum.poll', array( 'url_username' => UserUrlBuilder::profile(AppContext::get_current_user()->get_id())->rel(), 'username' => AppContext::get_current_user()->get_display_name(), 'sujet' => $topic['title'], 'url' => PATH_TO_ROOT . "/forum/topic.php?id=".$idt_get ))); Notifications::add_notification($notify); }
Recevoir une notification lorsqu'un modérateur ou un administrateur verrouille notre sujet
Caché :
Dans le fichier forum/action.php vers la ligne 230 juste en dessous de
Ajoutez ceci:
Code PHP :
$Forumfct->Lock_topic($idt_get);
Ajoutez ceci:
Code PHP :
if ($topic['user_id'] != AppContext::get_current_user()->get_id()) { $notify = New Notifications(); $notify->set_sender_id(AppContext::get_current_user()->get_id()); $notify->set_recipient_id($topic['user_id']); $notify->set_reading(0); $notify->set_date(time()); $notify->set_content(NotificationsFormat::contenu('forum.lock.topic', array( 'url_username' => UserUrlBuilder::profile(AppContext::get_current_user()->get_id())->rel(), 'username' => AppContext::get_current_user()->get_display_name(), 'sujet' => $topic['title'], 'url' => PATH_TO_ROOT . "/forum/topic.php?id=".$idt_get ))); Notifications::add_notification($notify); }
Recevoir une notification lorsqu'un modérateur ou un administrateur déverrouille notre sujet
Caché :
Dans le fichier forum/action.php vers la ligne 239 juste en dessous de
Ajoutez ceci:
Code PHP :
$Forumfct->Unlock_topic($idt_get);
Ajoutez ceci:
Code PHP :
if ($topic['user_id'] != AppContext::get_current_user()->get_id()) { $notify = New Notifications(); $notify->set_sender_id(AppContext::get_current_user()->get_id()); $notify->set_recipient_id($topic['user_id']); $notify->set_reading(0); $notify->set_date(time()); $notify->set_content(NotificationsFormat::contenu('forum.unlock.topic', array( 'url_username' => UserUrlBuilder::profile(AppContext::get_current_user()->get_id())->rel(), 'username' => AppContext::get_current_user()->get_display_name(), 'sujet' => $topic['title'], 'url' => PATH_TO_ROOT . "/forum/topic.php?id=".$idt_get ))); Notifications::add_notification($notify); }
Les contributions
Pour les contributions j'ai fait qu'un seul addon donc à voir si y'a encore des choses à faire à ce niveau plus tard ..
Recevoir une notification lorsque notre contribution est mise à jour
Caché :
Rendez-vous dans /user/contribution_panel.php vers la ligne 111
Juste en dessous de :
Ajoutez ceci:
Juste en dessous de :
Code PHP :
//Enregistrement en base de données ContributionService::save_contribution($contribution);
Ajoutez ceci:
Code PHP :
$notify = New Notifications(); $notify->set_sender_id(AppContext::get_current_user()->get_id()); $notify->set_recipient_id($topic['user_id']); $notify->set_reading(0); $notify->set_date(time()); $notify->set_content(NotificationsFormat::contenu('update.contrib', array( 'url_username' => UserUrlBuilder::profile(AppContext::get_current_user()->get_id())->rel(), 'username' => AppContext::get_current_user()->get_display_name(), 'contribution' => $topic['title'], 'url' => PATH_TO_ROOT."/user/contribution_panel.php?id=".$id_to_update ))); Notifications::add_notification($notify);
Module: "Connect"
Connaître le nombre de notification(s) dans le module connect ..
Caché :
- Allez dans connect/phpboost/ConnectModuleMiniMenu.class.php vers la ligne 47 juste en dessous de :
Code PHP :$unread_contributions = UnreadContributionsCache::load();
Ajoutez ceci :
Code PHP :
Puis pour déclarer dans le template le nombre de notifications:
Vers la ligne 107 de ce même fichier juste en dessous de :
Code PHP :'NUMBER_UNREAD_CONTRIBUTIONS' => $contribution_number,
Ajoutez ceci :
Code PHP :'NBR_NOTIFICATIONS' => $nbr_notifications,
Vous pouvez maintenant afficher le nombre de notifications dans connect_mini.tpl qui se trouve dans connect/templates/connect_mini.tpl ou dans /templates/{Votre theme}/modules/connect/connect_mini.tpl
Edité par Myster Le 12/01/2019 à 10h38
Bonsoir
Très bien de module un grand merci pour le dev
une petite suggestion quand on crée une notification on a le choix de le faire pour un memebre (je suppose que pour plusieurs c'est faisable aussi en espaçant avec; les adresses ou pseudos ?) ou tous les membres
ne pourrait on pas ajouter les groupes? ce qui affinerait encore la communication du site avec ses membres
par exemple dans notre association sportive nous avons une section danse et des sous catégories du type :
danses de salon mardi
danse de salon mercredi
rock salsa bachata( même prof)
il est arrive que le prof de salon qui vient de loin a annulé a cause du mauvais temps et prévient assez tardivement la notification à tout son sens
elle est rapide, couvre tout un groupe ,si en plus c'est relayé par un envoi de mail c'est le top
ou autre exemple
activité zen
gym
etc même principe sous divisé en sous groupe
se serait sympa de pouvoir notifier à un groupe d'utilisateur (un ascenseur, on choisi un ou + groupes et hop)
j'avais oublié qui envoi les notifications aux utilisateurs? dans le cas d'un envoi spécifique car je n'ai pas vu de droit dans la config comme sur les autres modules
cordialement
Patrick Edité par patgame Le 28/02/2019 à 22h01
Très bien de module un grand merci pour le dev
une petite suggestion quand on crée une notification on a le choix de le faire pour un memebre (je suppose que pour plusieurs c'est faisable aussi en espaçant avec; les adresses ou pseudos ?) ou tous les membres
ne pourrait on pas ajouter les groupes? ce qui affinerait encore la communication du site avec ses membres
par exemple dans notre association sportive nous avons une section danse et des sous catégories du type :
danses de salon mardi
danse de salon mercredi
rock salsa bachata( même prof)
il est arrive que le prof de salon qui vient de loin a annulé a cause du mauvais temps et prévient assez tardivement la notification à tout son sens
elle est rapide, couvre tout un groupe ,si en plus c'est relayé par un envoi de mail c'est le top
ou autre exemple
activité zen
gym
etc même principe sous divisé en sous groupe
se serait sympa de pouvoir notifier à un groupe d'utilisateur (un ascenseur, on choisi un ou + groupes et hop)
j'avais oublié qui envoi les notifications aux utilisateurs? dans le cas d'un envoi spécifique car je n'ai pas vu de droit dans la config comme sur les autres modules
cordialement
Patrick Edité par patgame Le 28/02/2019 à 22h01
Répondre
Vous n'êtes pas autorisé à écrire dans cette catégorie