Sur d’autres sites (13975)

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

• Evolution #3119 (Nouveau) : Développer le classement des objets de SPIP par Glissé/lâché

  13 décembre 2013, par realet RealET

  Possibilité de classer des articles par drag’n drop dans l’interface privée, par exemple avec sortable ( http://jqueryui.com/sortable/ ) ou mêmes les images et documents, selon ce même principe (une démo http://blog.arnaud-k.fr/demos/jquery-drag-n-drop/ )

  Analyse¶

  Il y a déjà une balise #RANG qui calcule le numéro de titre s’il y en a un (ça affiche la partie numéro de numéro point espace titre).
  Idéalement, et pour assurer une bonne transition, il faudrait sans doute :

  1. Créer un champ rang
  2. modifier la balise rang en conséquence
  3. Enregistrer le numéro du titre dans le champ rang
  4. Et que l’opération de drag’n’drop :
     • modifie les champs rang impactés
     • et enregistre aussi le numéro point espace dans les titres pour rétro compatibilité (pouvoir débrayer ça par un define dans mes_options)
  5. Et rajouter un bouton pour supprimer le classement

  Et prévoir que dans les boucles, par rang !par date puisse fonctionner correctement si rang à NULL.

  Discussion originale : http://thread.gmane.org/gmane.comp.web.spip.devel/64769

• Evolution #3118 (Nouveau) : API de Wafer

  13 décembre 2013, par realet RealET

  Les enluminures typo avant d’être une extension de porte plume disposaient de wafer : un bouton faisant apparaître une barre d’outil.
  Dans les barres d’outil, il y avait entre autres :

  • rechercher/remplacer
  • insertion d’un lien avec possibilité de saisir la bulle d’aide et la langue

  A minima, il faudrait une API dans porte plume pour créer un wafer.

  Et peut-être y intégrer les 2 éléments listés ci-dessus.