Advanced search

On other websites (8482)

• Révision 23894: Début de résolution de #3996 . Ne plus afficher quota_cache qui est obsolète et ...

  18 January 2018, by erational@erational.org

• Revision 101022: début de vérification de fichiers, pour le moment vérifier mime_type précis

  11 June 2018, by maieul@… — Log

  début de vérification de fichiers, pour le moment vérifier mime_type précis

• début de doc pour deux pipelines

  5 December 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.