SPIP

Truc et astuce autour du CMS SPIP. Je travail depuis 2012 avec ce CMS dont j’apprécie l’ouverture et la communauté.

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

11 janvier 2017 par Phenix dans Pipelines

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 janvier 2017 par Phenix dans SPIP

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);
}

Trouver toutes les rubriques enfants d’une rubrique #SPIP

20 novembre 2016 par Phenix dans SPIP

[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.

/**
* 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 novembre 2016 par Phenix dans SPIP

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')
);
}
}

Trouver la traduction d’un objet #SPIP

15 septembre 2016 par Phenix dans SPIP

Une fonction bien pratique quand on travaille avec des squelettes multilingues. Avant j’utilisais un assemblage de boucles et de critères, un peu illisible.

Cette fonction simplifie grandement le travail en retrouvant automatiquement une traduction en fonction d’un couple id_objet/objet.
Cela devrait fonctionner avec n’importe quel objet utilisant le système de traduction de SPIP.

<?php
/**
* Récupère la traduction d'un objet via la langue et l'id_objet
*
* @param int $id_objet
* @param string $objet
* @param string $lang
* @access public
* @return int
*/
function objet_trouver_traduction($id_objet, $objet, $lang) {
// Pas de lang, on sort
if (!isset($lang)) {
return $id_objet;
}
// Table
$table = table_objet_sql($objet);
$cle_primaire = id_table_objet($objet);
// On récupère l'éventuelle traduction
$id_traduction = sql_getfetsel(
$cle_primaire,
$table,
array(
'id_trad='.intval($id_objet),
'lang='.sql_quote($lang),
'statut='.sql_quote('publie')
)
);
return $id_traduction;
}
function article_trouver_traduction($id_article, $lang) {
return objet_trouver_traduction($id_article, 'article', $lang);
}
// Si le plugin Traduction entre rubriques est activé
// http://contrib.spip.net/Traduction-des-rubriques
function rubrique_trouver_traduction($id_article, $lang) {
return objet_trouver_traduction($id_article, 'rubrique', $lang);
}

Je l’utilise surtout pour les liens directs dans les squelettes :

<a href="#URL_ARTICLE{[(#EVAL{_ID_ARTICLE_CONTACT}|article_trouver_traduction{#ENV{lang}})]}" class="button large">
Nous contacter
</a>