Recherche avancée

Sur d’autres sites (6327)

• début de doc pour deux pipelines

  5 décembre 2013

  MediaSPIP propose deux pipelines :

  • ms_config pour modifier une valeur de configuration
  • ms_ajout_html pour ajouter du HTML dans un squelette.

  Pipeline ms_config

  Le pipeline ms_config est utilisé, par exemple, dans le formulaire de sélection des champs à cacher dans la page d’un média :

  [(#SET<i>infos_cachees, #PIPELINE<i>ms_config,#ARRAY<i>cle,mediaspip/medias/infos_cachees,valeur,#ARRAY<i> info_nb_comments,<:mediaspip_core:label_case_info_nb_comments :>, info_nb_vues,<:mediaspip_core:label_case_info_nb_vues :>, info_publie,<:mediaspip_core:label_case_info_published :>, info_date_redac,<:mediaspip_core:label_case_info_date_redac :>, info_update,<:mediaspip_core:label_case_info_update :>, info_auteur,<:mediaspip_core:label_case_info_auteur :></i></i></i> |table_valeur<i>valeur</i></i>)]

  Le pipeline fait donc transiter un tableau avec deux éléments :

  • cle : le nom de la variable de configuration
  • valeur : la valeur de la variable (dans l’exemple ci-dessus, un tableau de champs à cacher)

  Dans un plugin imaginaire "fax", qui utiliserait MediaSPIP, et qui ajouterait un champ fax à la table des articles, on peut utiliser le pipeline ms_config pour ajouter ce nouveau champ fax à la liste de champs à cacher :

  • définir le pipeline dans le fichier paquet.xml du plugin "fax" <pipeline nom="ms_config" inclure="fax_pipelines.php"></pipeline>
  • ajouter le code suivant dans le fichier fax_pipelines.php du plugin function fax_ms_config($flux) <i> if ((strcmp($flux[’cle’],’mediaspip/medias/infos_cachees’) == 0) && is_array($flux[’valeur’])) <i> $flux[’valeur’][’info_fax’] = _T(’fax:label_case_info_fax’) ; </i> return $flux ; </i>
  • en finalement ajouter la chaîne de langue fax:label_case_info_fax dans le fichier lang/fax_fr.php du plugin // F ’fax’ => ’Numéro de fax’,

  Le champ fax apparaîtra ainsi dans la liste des champs à cacher, dans la page de configuration des squelettes de MediaSPIP.

  Pipeline ms_ajout_html

  Le pipeline ms_ajout_html est utilisé, par exemple, dans le squelette d’affichage d’un média :

  [(#PIPELINE<i>ms_ajout_html,#ARRAY<i>args,#ARRAY<i> objet,article, id_objet,#ID_ARTICLE, squelette,content/article-medias.html, infos_cachees_medias,#GET<i>infos_cachees_medias</i> </i>,data,’’</i></i>)]

  Ce pipeline passe un tableau à deux éléments :

  • data : le HTML produit (vide à l’initialisation, dans cet exemple)
  • args : un tableau contenant les arguments suivants -* squelette : le squelette dans lequel sera inclus le code HTML -* objet et id_objet : la boucle courante dans laquelle a été inclus le pipeline (une boucle ARTICLES dans l’exemple) -* et un paramètre spécifique à ce squelette,
    infos_cachees_medias<code>, qui contient le tableau des champs à cacher.<br /> <br /> Dans le plugin imaginaire "fax" défini plus haut, on utilise le pipeline <code>ms_ajout_html

    pour afficher ou non le nouveau champ fax dans le squelette content/article-medias.html :

  • définir le pipeline dans le fichier paquet.xml du plugin "fax" <pipeline nom="ms_ajout_html" inclure="fax_pipelines.php"></pipeline>
  • ajouter le code suivant dans le fichier fax_pipelines.php du plugin function fax_ms_ajout_html($flux) <i> if (strcmp($flux[’args’][’squelette’],’content/article-medias.html’) == 0) <i> $flux[’data’] .= recuperer_fond(’inclure/ms_article_medias’, $flux[’args’]) ; </i> return $flux ; </i>
  • créer le fichier inclure/ms_article_medias dans le plugin [(#VAL<i>info_fax</i>|in_array<i>#ENV<i>infos_cachees_medias</i></i>|non)[ <div class="info_media info-fax"> <p><span class="title"><:fax:titre_fax :> </span><span class="fax #EDIT{fax}"> (#FAX)</span></p> </div> <p>]]</p>
  • finalement ajouter la chaîne de langue fax:titre_fax dans le fichier lang/fax_fr.php du plugin // T ’titre_fax’ => ’Numéro de fax’,

  Le champ "fax" sera ainsi inclus dans les informations de description du média, à condition qu’il n’ait été sélectionné comme champ à cacher.

• nomenclature #3201 : lien_objet() devrait être renommé objet_lien()

  23 octobre 2014, par RastaPopoulos ♥

  Héhé, j’ai dû rechercher moi aussi, je ne me souvenais plus. Je ne sais plus à quel occasion j’en ai eu besoin, mais il s’agit d’une fonction générique MAIS placée dans le plugin Médias ! Je ne savais même pas que le code était placé là, je l’avais vu utilisé dans des squelettes, et j’avais copié ça dans des squelettes à moi.
  http://code.spip.net/@lien_objet

  Donc en fait il faudrait :
  1) La déplacer dans le core, dans les filtres accessibles en squelettes
  2) La renommer comme expliqué ici
  3) Pointer l’ancienne de Médias vers la nouvelle du core

  Ça peut donc se faire sans rien casser.

• Additionals : Add postalcodeBR method

  14 octobre 2014, par fernandopasse

  Additionals : Add postalcodeBR method
  Validates brazialian postal codes
  Closes #1291