Des rédacteurs restreints dans #SPIP

5 September 2016

Chacun sa rubrique !

Il est possible d’améliorer un peu la gestion des utilisateurs de SPIP. Dans cet exemple, on va :

  • Pouvoir restreindre un rédacteur à une ou plusieurs rubriques. C’est similaire au administrateur restreint.
  • Limiter la création d’article par les administrateurs/rédacteurs restreints à leur rubrique uniquement.

C’est assez pratique si vous n’avez pas envie que des articles soit poster n’importe ou sur le site.

On commence par permettre de lier aussi les rédacteurs à une rubrique, il faut placer ce code dans le fichier config/mes_options.php :

<?php
define('_STATUT_AUTEUR_RUBRIQUE', '0minirezo,1comite');

Ensuite on ajoute la vérification des accès restreints dans l’autorisation a créé des articles dans une rubrique.
Attention, c’est une surcharge de fonction, cela veut dire qu’elle va remplacer celle du core de SPIP.

Il faut mettre ce code dans un fichier de fonction (mes_fonctions.php par exemple).

<?php
/**
 * Autorisation de créer un article dans une rubrique $id
 *
 * Il faut pouvoir voir la rubrique et pouvoir créer un article…
 *
 * @param  string $faire Action demandée
 * @param  string $type Type d'objet sur lequel appliquer l'action
 * @param  int $id Identifiant de l'objet
 * @param  array $qui Description de l'auteur demandant l'autorisation
 * @param  array $opt Options de cette autorisation
 * @return bool          true s'il a le droit, false sinon
 **/
function autoriser_rubrique_creerarticledans($faire, $type, $id, $qui, $opt) {
    return
        $id
        and autoriser('voir', 'rubrique', $id)
        and autoriser('creer', 'article')

        // Vérifier l'accès restreint avant d'autoriser la publication
        and (
             !$qui['restreint'] or !$id
             or in_array($id, $qui['restreint'])
         );
}

Executer du code lorsqu’un utilisateur ce connecte sous SPIP

12 August 2016

J’avais besoin d’exécuter un peu de code lorsqu’un utilisateur ce connecte à SPIP. Il y a un moyen assez simple de le faire : dans le traiter du formulaire login.

La connexion de l’utilisateur ce fait dans la partie vérifier du formulaire CVT. Cela veut dire que la session a été créé.

<?php
function prefix_formulaire_traiter($flux) {

    if ($flux['args']['form'] == 'login') {
        // Coder ici
    }

    return $flux;
}

Bien entendu je préfèrerai avoir un pipeline post_login, ce serai plus simple et plus lisible dans le code.
Cela viendra peut-être avec SPIP 3.2 !


Executer du code lorsqu'un inscription est validée sous SPIP

6 August 2016

Dans SPIP, il n’y a pas de pipeline post_inscription. Difficile donc d’exécuter facilement du code lorsque l’inscription est validé par l’utilisateur. Cela va peut être changé avec SPIP 3.2.

En attendant, voici un bricolage avec le pipeline post_edition :

<?php
function prefix_post_edition($flux) {

    // Confirmation d'une inscription
    if ($flux['args']['table'] == 'spip_auteurs'
        and $flux['args']['statut_ancien'] == 'nouveau'
        and $flux['args']['action'] == 'instituer'
        and $flux['data']['statut'] == '6forum' ) { // Limité aux visiteurs
        $id_auteur = $flux['args']['id_objet'];
        // Faire des trucs ici.
    }

    return $flux;
}

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

10 March 2016

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 :

<?php
/**
 * Récupérer le titre des annexes pour les forums
 *
 * @param int $id_objet
 * @access public
 * @return string le titre de l'annexe
 */
function annexe_forum_extraire_titre($id_objet) {
    include_spip('inc/filtres');
    return generer_info_entite($id_objet, 'annexe', 'titre');
}

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 :

<?php
function prefix_forum_objets_depuis_env($objets) {
    $objets['annexe'] = id_table_objet('annexe');
    return $objets;
}

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

<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 :

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

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.


Contrôler les index des tableaux #SPIP

23 January 2016

SPIP possède un mécanisme de tableau dans le compilateur. C’est plutôt rudimentaire et mériterait certainement plus d’attention de la part des développeurs.

Dans beaucoup de cas, ils sont de précieux alliés mais rapidement limités. On les abandonne généralement rapidement au profit d’une fonction php. Soit parce que le code devient illisible, soit parce qu’ils ne sont pas assez souples.

Cependant, il y a quand même moyen de faire des choses assez puissantes sans prise de tête particulière. L’installation de spip_bonux est indispensable, cela permet d’accéder aux balises #SET_PUSH et #SET_MERGE qui rendent le code plus lisible.

Un système de news par secteur ET par mots-clés

J’ai besoin d’afficher tous les articles d’un secteur mélangés avec les articles qui possèdent un mot-clé défini. L’idée est de créer un module de “news” qui peut être enrichi par des articles qui ne seraient pas dans la rubrique “news”. L’idée est simple: remplir un tableau a l’aide de deux boucles SPIP et puis l’afficher avec une boucle DATA.

[(#REM) Initialiser le tableau ]
[(#SET{news, #ARRAY})]
<BOUCLE_article(ARTICLES){id_secteur=1}{par date}{inverse}{lang}{0,2}>
  [(#SET_PUSH{news, #ID_ARTICLE})]
</BOUCLE_article>

[(#REM) Recherche sur le mot-clé "news" ]
<BOUCLE_mot(ARTICLES){id_mot=42}{par date}{inverse}{lang}{0,2}>
  [(#SET_PUSH{news, #ID_ARTICLE})]
</BOUCLE_mot>

#GET{news} contient maintenant 4 id_articles: les deux derniers articles du secteur 1 et les deux derniers articles possédant le mot-clé 42.

Mais comme c’est un système de news, il faut tirer l'affichage par date. Or, les données du tableau sont tirées par ordre de boucles: d’abord, les informations de la boucle article, ensuite les informations de la boucle d’article_mot.

En réalité, ce dont j’ai besoin, c’est de la possibilité de trier mon tableau par date une fois qu’il a été généré par les boucles. Il faut donc que je sauvegarde la date de l’article dans mon tableau.

[(#REM) Initialiser le tableau ]
[(#SET{news, #ARRAY})]
<BOUCLE_article(ARTICLES){id_secteur=1}{par date}{inverse}{lang}{0,2}>
  [(#SET_PUSH{news, #ARRAY{id_article, #ID_ARTICLE, date, #DATE}})]
</BOUCLE_article>

[(#REM) Recherche sur le mot-clé "news" ]
<BOUCLE_mot(ARTICLES){id_mot=42}{par date}{inverse}{lang}{0,2}>
  [(#SET_PUSH{news, #ARRAY{id_article, #ID_ARTICLE, date, #DATE}})]
</BOUCLE_mot>

Voilà, donc maintenant, #GET{news} est un tableau qui contient 4 tableaux à deux clés: id_article et date.

Ensuite, via une petite astuce php, on va utiliser une des deux valeurs comme clé pour recomposer un tableau. Rien de complexe, tout est dans PHP:

[(#REM) Simplifier le tableau pour avoir id_article => date ]
[(#SET{news, #GET{news}|array_column{date, id_article}})]

Array_column est une fonction PHP 5.5. Mais spip_bonux l’apporte au version inférieur.

Ensuite, il ne reste plus qu’à faire une boucle data triée par valeur.

Voici le code complet:

[(#REM)
On va calculer les news:
- Soit cela se trouve dans le secteur des news
- Soit il y a le mot-clé news
]

[(#REM) Initialiser le tableau ]
[(#SET{news, #ARRAY})]
<BOUCLE_article(ARTICLES){id_secteur=1}{par date}{inverse}{lang}{0,2}>
  [(#SET_PUSH{news, #ARRAY{id_article, #ID_ARTICLE, date, #DATE}})]
</BOUCLE_article>

[(#REM) Recherche sur le mot-clé "news" ]
<BOUCLE_mot(ARTICLES){id_mot=42}{par date}{inverse}{lang}{0,2}>
  [(#SET_PUSH{news, #ARRAY{id_article, #ID_ARTICLE, date, #DATE}})]
</BOUCLE_mot>

[(#REM) Simplifier le tableau pour avoir id_article => date ]
[(#SET{news, #GET{news}|array_column{date, id_article}})]

<section class="section-news">
  <span class="label article-section"><:titre_news:></span>
  [(#REM) Affichage de articles du tableau ]
  <B_data_news>
    <ul class="news-list">
      <BOUCLE_data_news(DATA){source tableau, #GET{news}}{par valeur}{inverse}{0,2}>
        <li><INCLURE{fond=inclure/article_resume, id_article=#CLE} /></li>
      </BOUCLE_data_news>
    </ul>
  </B_data_news>
</section>

Générer automatiquement des touch-icons avec #SPIP

2 November 2015

Comme beaucoup de choses en développement web, les touch-icons1 c’est le bordel. Des formats différents en fonction des écrans, en fonction des résolutions d’écrans, des versions d’Android en vrac, et des développeurs perdus au milieu.

Bref, voici un petit squelette SPIP basé sur le travail Mathias Bynens.

L’idée est de placer un fichier apple-touch-icon.png dans le dossier squelettes/ de SPIP pour le décliner automatiquement dans toutes les autres versions. Le fichier ne sera pas agrandi donc il vaut mieux utiliser un fichier de minimum 192px.

Dans certains cas, la gestion automatique n’est pas idéale. On peut alors placer un fichier apple-touch-icon-VALEURxVALEUR.png pour remplacer celui générer automatiquement. Par exemple, si je veux remplacer le fichier 72px: apple-touch-icon-72x72.png

[(#REM)
  Favicon touch icon.
  Voir https://mathiasbynens.be/notes/touch-icons

  Ce fichier va générer les favicons pour un maximum de device.
  Il n'est pas inutile de passer ce squelette dans le filtre supprimer_ligne_vide (https://gist.github.com/phenix-factory/1dc0195bd655a654b9ef)
]

[(#REM)
  Tableau des tailles, en px
  Pour le moment, ils n'ont pas encore pondu autre chose que des icônes carrées. On espère que cela ne change pas.
]

[(#SET{taille_device,
[(#ARRAY{
192,192,
180,180,
152,152,
144,144,
120,120,
114,114,
76,76,
72,72,
60,60,
57,57})]})]

<BOUCLE_generateur_touch_icone(DATA){source tableau, #GET{taille_device}}>
  [(#REM)
    L'utilisateur fourni un fichier spécifique, on affiche directement
  ]

  [(#CHEMIN{apple-touch-icon-#VALEURx#VALEUR.png}|oui)
    [<link rel="[(#VALEUR|=={192}?{icon, apple-touch-icon-precomposed})]" sizes="#VALEURx#VALEUR" href="(#CHEMIN{apple-touch-icon-#VALEURx#VALEUR.png})">]
  ]

  [(#REM)
    Pas de fichier spécifique, on va créer l’icône si le fichier générique le permet.
  ]
  [(#CHEMIN{apple-touch-icon-#VALEURx#VALEUR.png}|non
    |et{#CHEMIN{apple-touch-icon.png}|hauteur|>={#VALEUR}|oui}
    |et{#CHEMIN{apple-touch-icon.png}|largeur|>={#VALEUR}|oui})
    [<link rel="[(#VALEUR|=={192}?{icon, apple-touch-icon-precomposed})]" sizes="#VALEURx#VALEUR" href="(#CHEMIN{apple-touch-icon.png}|image_reduire{#VALEUR,#VALEUR}|extraire_attribut{src})">]
    ]
</BOUCLE_generateur_touch_icone>

Un Gist est disponible pour ce code.


  1. Les icônes qui s’affichent quand un site web est ajouté dans la liste des app d’un smartphone par exemple ↩︎


Modifier la génération des URLs de #SPIP

4 June 2015

SPIP dispose de quelques “schémas” d’URL par défaut. Dans la majorité des cas, ils conviennent aux goûts de chacun.

les urls proposée par SPIP

Cependant, il peut arriver que l’on ait envie de modifier la façon dans les URLs sont créées. Dans mon cas, j’avais envie de changer les URLs Arborescentes qui créée par défaut un schéma objet/titre.

Cela ne me convenait pas dans le cas des auteurs, auteur/nom_auteur ne signifiait rien, je voulais un visiteur/nom_visiteur.

Ce qu’il faut savoir

SPIP possède une table dans laquelle il place toutes les urls du site. Sans surprise, elle a pour nom… spip_urls. Une fois qu’une url est ajoutée dans cette base, elle n’en bougera plus. Même si on change de schéma. Si l’on change le schéma des URLs, les anciennes continueront de fonctionner, en plus des nouvelles.

C’est l’un des rares cas où vider le cache ne suffit pas pour faire des tests, il faut aussi supprimer les URLs de la table. Je vous déconseille fortement de faire cela avec un site en production…

Utiliser les bons pipelines

Il existe 2 pipelines pour modifier les URLs. Toutes ne sont pas modifiables:

  • propres_creer_chaine_url pour les URLs Propres, les URLs Propres+.html et les URLs Libres.
  • arbo_creer_chaine_url pour les URLs Arborescentes.

Ces pipelines retournent un tableau du style:

<?php
$flux = array(
    "data" => "article/test",
    "objet" => array(
            "url" => null,
            "date" => null,
            "id_parent" => null,
            "perma" => null,
            "titre" => "test",
            "lang" => null,
            "parent" => '0',
            "type_parent" => '',
            "type" => "article",
            "id_objet" => 24
        )
);

L’url se trouve dans la cellule data, il suffit de la modifier ! La cellule objet contient des informations que l’on peut exploiter.

Exemple

Par défaut, les url arbo créent une url auteur/nom_de_l’auteur. Or, j’ai envie de changer et d’utiliser “visiteur” à la place de “auteur', voici à quoi devrait ressembler mon pipeline:

<?php
/**
 * On bricole les URLs dans ce pipeline
 *
 * @param mixed $flux
 * @access public
 * @return mixed
 */
function prefix_arbo_creer_chaine_url($flux) {
    // On chope les auteurs pour créer des urls "visiteur"
    if ($flux['objet']['type'] == 'auteur') {
        // On inclut les fonctions d'édition d'url par sécurité
        include_spip('action/editer_url');

        // Créer une URL "visiteur"
        $flux['data'] = 'visiteur/'.url_nettoyer($flux['objet']['titre'],_URLS_ARBO_MAX,_URLS_ARBO_MIN,'-',_url_arbo_minuscules?'strtolower':'');
    }

    return $flux;
}

J’ai repris la fonction url_nettoyer telle qu’elle était utilisée par le core.


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

2 March 2015

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 :

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

$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:

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

Et voilà !


Ajouter une balise #CHERCHER_LOGO à #SPIP

22 February 2015

Lorsque l’on veut récupérer le logo d’un objet SPIP, on est obligé de faire quelques choses qui ressemble à:

<BOUCLE_logo(ARTICLES){id_article=1}>
#LOGO_ARTICLE
</BOUCLE_logo>

C’est assez ennuyant, d’autant que cela risque fort de faire une requête SQL alors que la récupération de logo n’en a absolument pas besoin, les fichiers sont stocker sous la forme objetId_objet.xx dans le dossier IMG.

On pourrait espérer que mettre simplement l’identifiant dans la balise récupère le logo, comme le font les balises URL. Malheureusement cela ne fonctionne pas.

Du coup, je me suis inspiré de la balise #INFO_ pour créer une balise #CHERCHER_LOGO:

<?php
/**
 * #CHERCHER_LOGO{objet, id_objet}
 * Retrouver le logo d'un objet sans avoir à lancer tout le système de boucle.
 *
 * @param mixed $p
 * @access public
 * @return mixed
 */
function balise_CHERCHER_LOGO_dist($p) {
    $objet = interprete_argument_balise(1, $p);
    $id_objet = interprete_argument_balise(2, $p);

    // Faire la conversion pour la fonction chercher_logo
    $objet = "id_table_objet($objet)";

    include_spip('inc/filtres');
    include_spip('public/quete');
    $p->code = "http_img_pack(_DIR_IMG.quete_logo($objet, 'on', $id_objet, '', true), '', 'class=\"spip_logos\"')";
    $p->interdire_scripts = false;

    return $p;
}

Voir mon gist: https://gist.github.com/phenix-factory/57cb993512d13fdfee88


Ajouter l'icône des blocs AJAX dans l'espace publics d'un site #SPIP

3 September 2014

Petite astuce que j’ai trouvée il y a peu.

Lorsque l’ont AJAX des blocs SPIP, le comportement par défaut est de passer le bloc en opacité 50%.
Ce n’est pas forcément le plus explicite pour les visiteurs, plus habitués à avoir un signe de “pseudo-progression”.

Ce n’est le comportement de la partie admin, qui affiche une icône “Loading” dans le coin supérieur droit.

On peut facilement reproduire ce comportement dans l’espace publique avec une petite ligne de css:

.loading {
background: url(../../prive/themes/spip/images/searching.gif) no-repeat top right;
}

Ici je suppose que le fichier css se trouve dans un sous-dossier du dossier squelettes de SPIP. Si ce n’est pas le cas, il faut adapter le chemin.

Bien entendu on peut mettre ce que l’on veut sur la class loading, ici je n’ai fais que reproduire le comportement de SPIP.