var Phenix = function () {
Troll du Web depuis 1996

Tutoriel


Recherche ajax avec les formulaires SPIP

Une recherche « live »

Le but de ce formulaire est une recherche dynamique : a chaque nouvelle lettre dans l’input la recherche s’affine.

La bonne nouvelle c’est qu’on peut faire cela nativement avec les fonctions présentent dans SPIP.

Dans un premier temps, il faut créer un fichier formulaires/recherche_ajax.php. Il va mettre à jour le contexte du formulaire en lui passant un critère de recherche {recherche}.

  1. <?php
  2.  
  3. if (!defined('_ECRIRE_INC_VERSION')) {
  4. return;
  5. }
  6.  
  7. function formulaires_recherche_ajax_charger_dist($ajax_bloc) {
  8. return array(
  9. 'ajax_bloc' => $ajax_bloc,
  10. 'recherche_'.$ajax_bloc => _request('recherche_'.$ajax_bloc),
  11. 'lang' => $lang,
  12. );
  13. }

Ensuite un peu de JavaScript et d’HTML pour recharger un bloc ajax, dans un fichier formulaires/recherche_ajax.html.
Ici, j’ai simplement repris le formulaire de recherche de SPIP en modifiant le name de l’input de recherche.

  1. <div class="formulaire_spip formulaire_recherche[ (#ENV{class})]" id="formulaire_recherche">
  2. <form action="[(#ENV{action})]" method="get">
  3. <div class="editer-groupe">
  4. [(#ENV{action}|form_hidden)]
  5. [<input type="hidden" name="lang" value="(#ENV{lang})" />]
  6. <label for="#ENV{_id_champ}"><:info_rechercher_02:></label>
  7. <input type="[(#HTML5|?{search,text})]" class="search text" name="recherche_#ENV{ajax_bloc}" id="#ENV{_id_champ}"[ value="(#ENV{recherche})"] />
  8. <input type="submit" class="submit" value="&gt;&gt;" title="<:info_rechercher:>" />
  9. </div>
  10. </form>
  11. </div>

Dans le même fichier, à la fin, un peu de JavaScript pour mettre à jour le bloc_ajax (a savoir un squelette avec la boucle de recherche). Pour plus d’information, sur le fonctionnement d’Ajax avec SPIP, la page de la documentation officiel est bien faite.

  1. <script type="text/javascript">
  2. // Chaque input déclenche la recherche ajax
  3. $("#recherche_#ENV{ajax_bloc}").on("input", function () {
  4. ajaxReload(
  5. "#ENV{ajax_bloc}",
  6. {
  7. args: {
  8. // Envoyer le contenu du formulaire dans le
  9. // contexte de recherche SPIP
  10. recherche: $(this).val()
  11. }
  12. }
  13. );
  14. });
  15. </script>

Dans le bloc ajax (un fichier inclure/grille_article), je place simplement ma boucle de recherche :

  1. [(#SET{defaut_tri, #ARRAY{titre, 1, num titre, 1, date, #ENV{date_sens, -1}, id_article, 1, points, -1
  2. }})
  3.  
  4. ]<B_article_ajax>
  5. #ANCRE_PAGINATION
  6. <BOUCLE_article_ajax(articles){recherche ?}{tri #ENV{par, [(#ENV{recherche}|?{points, num titre})]}, #GET{defaut_tri}}{pagination}>
  7. <INCLURE{fond=inclure/article_resume}{id_article} />
  8. </BOUCLE_article_ajax>
  9. [<p class="pagination">(#PAGINATION)</p>]
  10. </B_article_ajax>

Il ne reste qu’à appeler tout cela :

  1. [(#FORMULAIRE_RECHERCHE_AJAX{grille_article})
  2.  
  3. ]<INCLURE{fond=inclure/grille_article}{env, ajax=grille_article} />

Pour en savoir plus sur les formulaires de SPIP, rien ne vaut la documentation de spip.net :).


Le DNS expliqué à vos managers

Le DNS est un pilier central de l’internet. Vous l’utilisez tous les jours, parfois sans vous en rendre compte.
Et pourtant, même parmi les informaticiens, c’est un domaine obscur et mal connu.

Donc forcément, quand il s’agit d’expliquer à un néophyte comment fonctionne le DNS, on fini généralement pas passer pour un chaman.

Il n’y aura pas d’explication technique ici, c’est un article à vocation pédagogique. Donc cela veut aussi dire que des raccourcis vont être utilisé et qu’il y aura un grand nombre d’approximations technique. Pas taper !
En partie aussi parce que je suis très loin d’être un expert du sujet.

Pour des informations plus techniques, il y a les exposés de Stéphane Bortzmeyer qui sont bien complet sur le sujet.

Les grands livres

Les DNS c’est un peu comme des grands livres. Il y en a plusieurs : le livre .org, le livre .net, le livre .com, etc.
Ces grands livres contiennent les titres d’autres livres, plus petits : Gandi, OVH, one.com... Qui eux même contiennent les adresses des serveurs web qui contiennent le site en question.
Grosso modo, tout ceux qui vendent des noms de domaine, possèdent un livre.

Lorsque l’ordinateur cherche à savoir ou ce trouve un nom de domaine précis, henix.be par exemple, il commence par regarder dans le grand livre .be quel petit livre il faut consulter.
.be ne sait pas exactement ou se trouve henix.be, mais par contre, il contient la référence du livre qui contient l’endroit ou ce trouve henix.be : all2all.org.

L’ordinateur regarde alors dans le petit livre all2all.org ou ce trouve henix.be.
All2all.org sachant exactement ou ce trouve henix.be va le dire à l’ordinateur, qui a alors trouvé ce qu’il cherchait et peut demander au bon serveur d’afficher le site web.


C’est une métaphore très simple, qui peut être comprise facilement par tout le monde.
Plus d’excuse pour ne pas expliquer aux autres !


Utiliser les forums de #SPIP sur d’autres types d’objets

Parce que dans SPIP, il n’y a pas que des articles !

J’en ai marre de ne jamais me souvenir de cette procédure donc je vais la noter une bonne fois pour toutes :’-) .

Procédure :

Il faut déclarer quelques petites choses pour réussir à implémenter les forums de SPIP sur d’autres objets que les articles :

On commence par définir la fonction qui permet au formulaire de forum de trouver le titre de l’objet. Mettons que vous ayez un plugin qui définit un objet « annexe » sur lequel vous voulez utiliser les forums :

Dans le fichier de fonctions.php du plugin :

  1. /**
  2.  * Récupérer le titre des annexes pour les forums
  3.  *
  4.  * @param int $id_objet
  5.  * @access public
  6.  * @return string le titre de l'annexe
  7.  */
  8. function annexe_forum_extraire_titre($id_objet) {
  9. include_spip('inc/filtres');
  10. return generer_info_entite($id_objet, 'annexe', 'titre');
  11. }

Ensuite, il faut définir le pipeline qui va permettre à la balise #FORMULAIRE_FORUM de trouver automatiquement l’objet du forum :

Dans le fichier pipelines.php :

  1. function prefix_forum_objets_depuis_env($objets) {
  2. $objets['annexe'] = id_table_objet('annexe');
  3. return $objets;
  4. }

On n’oublie pas d’ajouter le pipeline dans le paquet.xml :

  1. <pipeline nom="forum_objets_depuis_env" inclure="prefix_pipelines.php" />

Dans le cas où les forums sont désactivés partout, on peut forcer le passage avec une fonction à déclarer dans le fichier inc/annexe_accepter_forums_publics.php :

  1. function inc_annexe_accepter_forums_publics_dist($arg = null) {
  2. return 'abo'; // chaine de 3 caractere parmi 'non','pos','pri','abo'
  3. }

Normalement à ce stade, la balise #FORMULAIRE_FORUM affiche le formulaire sur votre objet :).

Il ne faut pas oublier d’ajouter le critère {id_annexe ?} dans la boucle principale des forums et dans celle qui compte les messages. Sans quoi, SPIP va afficher tous les messages sans distinction.

Limitation :

Il y a cependant une configuration qui ne fonctionne pas correctement :

Si les forums sont désactivés sur les articles, il est impossible d’utiliser le mécanisme de réponse car #PARAMETRES_FORUM ne renvoie rien.
Le problème vient de cette partie du code, qui est spécifique à la configuration des articles.
Il est toujours possible de faire une surcharge brutale de la balise pour faire sauter cette limitation. Mais, du coup, le formulaire de configuration de l’admin n’a plus aucun sens.

Conclusion :

Les forums de SPIP ne sont pas encore complètement portables sur d’autres objets. Il y a visiblement eu du travail dans ce sens, mais ce n’est pas encore complet.
Cependant, il suffit souvent d’activer les forums d’articles pour que tout se passe pour le mieux.


Utiliser le critère {recherche} de #SPIP avec PHP

Les boucles SPIP possèdent un mécanisme de recherche particulièrement utile. On utilise le critère recherche.

Cela permet de faire des recherches sur n’importe quel objet SPIP et d’avoir des résultats un peu plus précis qu’un simple LIKE sur une requête SQL.

J’ai découvert qu’on pouvait également utiliser ce système en dehors d’une boucle, avec un peu de PHP :

  1. <?php
  2. $prepare_recherche = charger_fonction('prepare_recherche', 'inc');
  3. list($rech_select, $rech_where) = $prepare_recherche(
  4. _request('recherche'), // Le terme recherché
  5. $objet // L'objet dans lequel on recherche
  6. );

$rech_where contient un WHERE sql qui peut être utilisé dans une requête. Il ne faut juste pas oublie la jointure sur la table spip_resultats :

  1. <?php
  2. // On fait la requête SQL qui va bien
  3. $recherche = sql_allfetsel('*', 'spip_articles INNER JOIN spip_resultats as resultats ON resultats.id=spip_articles.id_article', $rech_where);

Et voilà !