Ce filtre, initialement proposé par le plugin Bonux puis intégré au noyau avec SPIP 3.0.17 s’applique :
- soit sur un tableau d’entrées dont chacune des valeurs est de la forme
type_objet|id_objet. Par exemple :array("rubrique|9", "article|8") - soit sur une chaine de la forme
rubrique|9,article|8,...
Il retourne un tableau de couples (objet => id_objet).
Si on lui fournit un argument type, le tableau résultat est restreint aux objets de ce type.
Exemples
Après #SET{liste, #LISTE{article|1,article|2,rubrique|5}}
[(#GET{liste}|picker_selected)] renvoie le tableau array('article' => 1, 'article' => 2, 'rubrique' => 5)
et [(#GET{liste}|picker_selected{article})] renvoie le tableau array('article' => 1, 'article' => 2) qui ne contient que les articles.
Usage
Le format rubrique|9,article|8,... est celui fourni par les saisies de type sélecteur générique.
Exemple : Si dans un plugin, le formulaire de configuration propose un sélecteur de rubriques nommé "accueil", on peut récupérer la sélection dans le squelette avec :
{id_rubrique IN #CONFIG{monplugin/accueil}|picker_selected{rubrique}}