Une fonction bash pour chercher dans les fichiers de langue #SPIP

14 January 2017

Une petite fonction bash qui va chercher dans les fichiers de langue de SPIP après un mot en particulier.
Toujours pratique pour ne pas déclarer 10 fois la même chaîne de langue.

Il suffit d’ajouter ceci dans votre fichier .bashrc.

# Recherche dans les fichiers de langue SPIP
search_spip_lang () {
    LANG=${2:-"fr"} # On cherche par défaut dans le français. Mais le deuxième paramètre est la langue
    ag -G "lang/(.*)_$LANG.php" -- "$1" .
}

Un second paramètre peut être utiliser pour chercher dans une langue précise (sinon, il cherche en français).

Exemple :

Recherche en français du mot “spip”.

search_spip_lang spip

Recherche en anglais du mot “spip”.

search_spip_lang spip en

Ici j’utilise la commande ag pour chercher dans les fichiers. Il suffit de l’installer :

sudo apt install silversearcher-ag

Ack pourrait sans doute aussi faire le travail, mais ag est plus rapide :)


Executer du code lorsqu’un article #SPIP est publié

11 January 2017

Petit pipeline SPIP cool : quand un article SPIP est publié, on exécute le code.

Pratique par exemple pour envoyer une notification spéciale.

<?php
function prefix_post_edition($flux) {
    if ($flux['args']['table'] == table_objet_sql('article')
        and $flux['args']['action'] == 'instituer'
        and $flux['args']['statut_ancien'] != 'publie'
        and $flux['data']['statut'] == 'publie'
    ) {
        $id_article = $flux['args']['id_objet'];
        // Coder ici !
}

Autoriser un auteur s'il est présent dans la zone d'une rubrique #SPIP (acces restreint)

8 January 2017

Une petite fonction d’autorisation sympas : autoriser un auteur (peu importe son statut) à publier dans une rubrique, s’il est dans la zone de cette rubrique. :

<?php
function autoriser_accesrestreint_publiedans($faire, $type, $id, $qui, $opt) {
    include_spip('accesrestreint_fonctions');
    // On récupère les zones de la rubrique
    $zones = accesrestreint_zones_rubrique_et_hierarchie($id);
    foreach ($zones as $zone) {
        // Est-ce que l'auteur appartient à la zone ?
        if (accesrestreint_acces_zone($zone, $qui['id_auteur'])) {
            return true;
        }
    }

    return false;
}

Ensuite, on peut surcharger les autorisations de SPIP pour qu’elles tiennent compte de cette fonction :

<?php
/**
 * Surcharge de l'autorisation de publication dans les rubriques. On va prendre
 * en compte l'accès restreint. Si un auteur est dans la zone de la rubrique, on
 * l'autorise à publier
 */
function autoriser_rubrique_publierdans($faire, $type, $id, $qui, $opt) {
    if (autoriser('publiedans', 'accesrestreint', $id, $qui, $opt)) {
        return true;
    }

    return autoriser_rubrique_publierdans_dist($faire, $type, $id, $qui, $opt);
}

/**
 * Surcharge de l'autorisation de création d'article pour prendre en compte
 * l'autorisation d'accesrestreint
 */
function autoriser_rubrique_creerarticledans($faire, $type, $id, $qui, $opt) {

    if (autoriser('publiedans', 'accesrestreint', $id, $qui, $opt)) {
        return true;
    }

    return autoriser_rubrique_creerarticledans_dist($faire, $type, $id, $qui, $opt);
}

Du text-overflow: ellipsis et un élément à width: 100%.

25 November 2016

J’étais en train de bricoler une div avec une largeur à 100% et un texte-overflow ellipsis.

Cela ne fonctionne pas en l’état :

.ma_div {
  display: block;
  overflow: hidden;
  white-space: nowrap;
  width: 100%;
  text-overflow: ellipsis;
}

Pourquoi ? Je ne sais pas trop, mais avec quelques règles en plus on peut avoir le résultat que l’on attend, a savoir une div “fluide” et un texte avec “…” pour ce qui dépasse :

.ma_div {
  display: table;
  overflow: hidden;
  white-space: nowrap;
  width: 100%;
  table-layout: fixed;
  text-overflow: ellipsis;
}

Trouver toutes les rubriques enfants d'une rubrique #SPIP

20 November 2016

[Edit] : Comme signalé dans un commentaire, il existe bien une fonction native qui s’occupe de cela.

Il est parfois intéressant d’avoir la liste complètes des sous-rubriques d’une rubrique.

Par exemple, pour conditionner l’affichage d’un élément à une rubrique et tous ces enfants.

Il n’existe pas de fonction SPIP pour faire cela (ou en tout cas je ne l’ai pas trouvée). Voici donc un peu de code pour régler le problème.
C’est un collègue qui est à l’origine de cette fonction, je l’ai adaptée.

Attention, il faut PHP >= 5.5 ou installer le plugin SPIP bonux, à cause de la fonction array_column.

<?php
/**
 * Retrouver les enfants directs d'une rubrique.
 *
 * @param int $id_rubrique
 * @access public
 * @return array tableau contenant les id_rubrique direct.
 */
function trouver_enfant($id_rubrique) {
    include_spip('base/abstract_sql');
    $sous_rubriques = sql_allfetsel('id_rubrique', 'spip_rubriques', 'id_parent='.intval($id_rubrique));
    return array_column($sous_rubriques, 'id_rubrique');
}

/**
 * Trouver les sous-rubriques d'une rubrique.
 *
 * @param int $id_rubrique l'id de la rubrique
 * @return array une liste d'id_rubrique
 */
function trouver_enfants($id_rubrique) {

    // Trouver la première série de sous-rubrique.
    $sous_rubriques = trouver_enfant($id_rubrique);

    // S'il n'y a pas de sous rubriques, on sort de la boucle avec juste la rubrique de base
    if (count($sous_rubriques) === 0) {
        return array($id_rubrique);
    } else {
        // On cherche en profondeur.
        foreach ($sous_rubriques as $id_sous_rubrique) {
            $recur = trouver_enfant($id_sous_rubrique);

            // Il y a des enfants, on les ajoute à la liste des sous rubrique
            // déjà trouvée.
            if ($recur) {
                $sous_rubriques = array_merge($sous_rubriques, $recur);
            }
        }

        // Placer la rubrique initiale en première position.
        array_unshift($sous_rubriques, $id_rubrique);

        return $sous_rubriques;
    }
}

Formulaire générique d'édition de méta #SPIP

10 November 2016

L’idée derrière ce formulaire est assez simple, pouvoir gérer n’importe quelle valeur de la table spip_metas et la modifiée. Si elle n’existe pas, la méta sera crée.

Il convient de prendre en compte qu’il y a 2 types de méta dans spip :

  • les métas simples, le casier ne contient qu’une seul valeur .
  • les métas plus complexent qui sont des tableaux php sérialisé.

Cela couvre un besoin similaire à Identité Extra, mais de manière plus générique.

L’idée finale serait d’avoir un plugin de gestion des métas du site (et donc des options des plugins) plus générique et plus facile d’accès. Je trouve qu’il pourrait être plus simple de déclarer des options de plugin sans avoir a déclaré systématiquement un CVT complet.

Fichier formulaires/editer_meta.html :

<div class="formulaire_spip formulaire_#FORM">

    [<p class="reponse_formulaire reponse_formulaire_erreur">
    (#ENV*{message_erreur})
    </p>]
    [<p class="reponse_formulaire reponse_formulaire_ok">
        (#ENV*{message_ok})
    </p>]

    [(#EDITABLE|oui)
    <form action="#ENV{action}" method="post">
        #ACTION_FORMULAIRE{#ENV{action}}

        #GENERER_SAISIES{#ENV{_saisies}}

        <p class="boutons">
            <input type="submit" class="submit" value="<:pass_ok:>" />
        </p>
    </form>
    ]
</div>

fichier formulaires/editer_meta.php :

<?php
if (!defined('_ECRIRE_INC_VERSION')) {
    return;
}

/**
 * Fonction saisie pour le formulaire d'édition générique de méta
 *
 * @param string $casier nom du meta casier
 * @param string $meta nom de l'éventuel sous-méta
 * @param array $options tableau d'options :
 *
 * ```php
 * $options_defaut = array(
 *      'type_saisie' => 'input',
 *      'label' => 'label'
 * );
 * ```
 *
 * @access public
 * @return array
 */
function formulaires_editer_meta_saisies_dist($casier, $meta = null, $options = array()) {

    // option par défaut
    $options_defaut = array(
        'type_saisie' => 'input',
        'label' => 'label'
    );
    // Fusionner les options par défaut avec les options de l'utilisateur
    $options = array_merge($options_defaut, $options);

    // Récupérer le meta casier et créer sa saisie
    $casier = ($meta) ? $casier.'/'.$meta : $casier;
    $saisies = array(
        array(
            'saisie' => $options['type_saisie'],
            'options' => array(
                'nom' => $casier,
                'label' => $options['label']
            )
        )
    );

    return $saisies;
}

/**
 * Fonction charger pour le formulaire d'édition générique de méta
 *
 * @param string $casier nom du meta casier
 * @param string $meta nom de l'éventuel sous-méta
 * @param array $options tableau d'options :
 *
 * ```php
 * $options_defaut = array(
 *      'type_saisie' => 'input',
 *      'label' => 'label'
 * );
 * ```
 *
 * @access public
 * @return array
 */
function formulaires_editer_meta_charger_dist($casier, $meta = null, $options = array()) {
    // Récupérer le casier
    $casier = ($meta) ? $casier.'/'.$meta : $casier;

    // Lire la configuration
    include_spip('inc/config');
    $contexte = lire_config($casier, array());

    // Dans le cas d'une saisie simple, on s'assure de renvoyer un tableau
    // valide pour la fonction charger
    if (!is_array($contexte)) {
        $contexte = array($casier => $contexte);
    }

    return $contexte;
}

/**
 * Fonction traiter pour le formulaire d'édition générique de méta
 *
 * @param string $casier nom du meta casier
 * @param string $meta nom de l'éventuel sous-méta
 * @param array $options tableau d'options :
 *
 * ```php
 * $options_defaut = array(
 *      'type_saisie' => 'input',
 *      'label' => 'label'
 * );
 * ```
 *
 * @access public
 * @return array
 */
function formulaires_editer_meta_traiter_dist($casier, $meta = null, $options = array()) {

    // Enregistrer la méta
    include_spip('inc/config');

    // Récupérer l'ancienne configuration du casier
    $old_config = lire_config($casier);
    if (is_array($old_config)) {
        // Dans le cas d'une méta complexe, on va fusionner les fusionner avec
        // la nouvelle
        $new_config = _request($casier);
        $new_config = array_merge($old_config, $new_config);
    } else {
        // Cas d'une saisie simple, on enregistre simplement la meta
        $new_config = _request($casier);
    }

    // Ecrire la nouvelle méta
    $ecrire = ecrire_config($casier, $new_config);

    // Retour du formulaire
    if ($ecrire) {
        return array(
            'editable' => true,
            'message_ok' => _T('info_modification_enregistree')
        );
    } else {
        return array(
            'editable' => true,
            'message_erreur' => _T('erreur')
        );
    }
}

Quand tu n'as pas comprit le principe des clés primaire en AUTO_INCREMENT

28 October 2016

J’ai trouvé ceci dans le code d’un plugin Joomla.
Je ne comprenais pas pourquoi j’avais une erreur de clé primaire dupliquée. Voilà pourquoi :

$db->setQuery("SELECT MAX(  `extension_id` ) as id FROM  `#__extensions` WHERE  `type` =  \"plugin\" AND (`extension_id` > 8000 AND `extension_id` < 10000)");
$id = $db->loadResult();
if (empty($id) or $id='') $id = 9998;
$id = $id + 1;
// Enable mod_
$db->setQuery("INSERT INTO #__extensions (extension_id, name, type, element, folder, enabled, access, protected, manifest_cache, params)
VALUES (".((int)$id).", '******', 'plugin', 'cp', 'system', 1, 1, 1, '{\"name\":\"******\",\"type\":\"plugin\",\"creationDate\":\"December 2006\",\"author\":\"*******\",\"copyright\":\"**********\",\"authorEmail\":\"********\",\"authorUrl\":\"*******\",\"version\":\"3.0.0\",\"description\":\"*******_COPYRIGHT_DESCRIPTION\",\"group\":\"\"}', '{}')");
$db->query();

Visiblement, le concept de clé primaire en AUTO_INCREMENT est - j’espère plutôt “était” - inconnu du créateur de ce plugin.


Menu responsive avec foundation

7 October 2016

Depuis la version 6 du framework SASS/CSS Foundation, le composant qui sert à créer le menu principal du site, à savoir la “top bar” n’est plus un menu responsif “out of the box”.

C’est à vous d’en construire un avec les composants, comme l’explique la documentation.

Voici une structure html qui devrait couvrir la majorité des besoins. N’ont pas que c’est bien compliqué à réaliser, mais j’en ai marre de la refaire encore et toujours.

<div class="title-bar" data-responsive-toggle="main-menu" data-hide-for="medium">
    <button class="menu-icon" type="button" data-toggle></button>
    <div class="title-bar-title">Menu</div>
</div>
<div class="top-bar" id="main-menu">
    <div class="top-bar-left">
        <ul class="vertical medium-horizontal menu dropdown" data-responsive-menu="drilldown medium-dropdown" data-parent-link="true">
            <li>
                <a href="#">Lien</a>
                <ul class="menu vertical">
                    <li>
                        <a href="">Lien</a>
                        <ul class="menu vertical">
                            <li>
                                <a href="">Lien</a>
                            </li>
                            <li>
                                <a href="">Lien</a>
                            </li>
                            <li>
                                <a href="">Lien</a>
                            </li>
                        </ul>
                    </li>
                    <li>
                        <a href="">Lien</a>
                    </li>
                    <li>
                        <a href="">Lien</a>
                    </li>
                </ul>
            </li>
            <li><a href="#">Lien</a></li>
            <li><a href="#">Lien</a></li>
            <li><a href="#">Lien</a></li>
            <li><a href="#">Lien</a></li>
            <li><a href="#">Lien</a></li>
        </ul>
    </div>
</div>

Afficher la requête SQL de WP_Query

23 September 2016

Toujours pratique pour débugger :

<?php
$args = array(...);
$customPosts = new WP_Query($args);
echo "Last SQL-Query: {$customPosts->request}";

Formidablement illisible...

22 September 2016

J’ai trouvé ce bout de code dans le plugin formidable de SPIP, je cherchais un moyen d’exporter les réponses d’un formulaire.

Franchement comment savoir ce que contient $exporter ? Ça pourrait être n’importe quoi…
Je suis pas toujours super chaud pour mettre des fonctions dans des variables. S’il est possible de faire une structure de if … else, je pense que c’est plus souhaitable. Bien sur, il y a beaucoup de cas ou c’est très pratique, mais ici, j’ai comme un doute.

<?php
if ($id_formulaire > 0
    and $type_export
    and $types_echange = echanges_formulaire_lister_disponibles()
    and $exporter = $types_echange['exporter'][$type_export]
){
    $exporter($id_formulaire);
}