Astuces SPIP

#SET{req, #VAL{"
  SELECT a.truc_1,
         s.truc_2,
         s.truc_x
    FROM spip_matable s,
         spip_auteurs a
   WHERE a.id_auteur = s.id_auteur
     AND date_format(s.truc_x, '%Y %m %d') = '%s'
ORDER BY s.truc_x desc
   LIMIT , 100
"}|replace{'%s', #ENV{ladate}}}


<BOUCLE_rech(DATA) {source sql, #GET{req}}>
  ...

----

</code >
----

CRITÈRES

- Critère Critère conditionnel, sans parenthèses ni crochets, , seulement des bisoux, euh, des accolades...  :

<BOUCLE_seulement_pour_la_rubrique_dix(RUBRIQUES) {id_rubrique=#ID_RUBRIQUE|=={10}|?{10}}>
   Mon code ....
</BOUCLE_seulement_pour_la_rubrique_dix>

- Afficher Afficher les articles ayant le mot clef «  truc  »  :
<code truc  :< code >
<BOUCLE_g(ARTICLES <BOUCLE_articles(ARTICLES ) titre_mot=truc>
#TITRE
</BOUCLE_g BOUCLE_articles >

{titre_mot}</code >  étant  {{obsolète}}   on  peut  écrit  désormais  :< code >
 &lt;BOUCLE_g(ARTICLES )  {mots . ! OUPS <code>{titre_mot}

étant obsolète on peut désormais écrire :

<BOUCLE_G(ARTICLES) {mots.titre}>

- Le Le critère {par multi titre} permet de trier les titres alphabétiquement alphabétiquement quand ils utilisent la balise multi pour le multilinguisme.

- Le critère {fusion} permet de faire un « GROUPBY » :

- Le critère {fusion} permet de faire un GROUPBY ; exemple sur un fil RSS, pour éviter des articles de même nom, on peut faire :

<BOUCLE_syndic(SYNDIC_ARTICLES) {fusion titre} {0, 10}>

exemple sur un fil RSS , pour éviter des articles de même nom , on peut faire  :< code >
<BOUCLE_syndic(SYNDIC_ARTICLES ) fusion titre 0 , 10 >
</code >
On peut également faire une fusion pour avoir les articles tous issus de sites différents :

<BOUCLE_syndic(SYNDIC_ARTICLES) {fusion syndic_articles.id_syndic}>

- Un Un simple {statut?} dans une boucle annule la restriction de statut statut sur la boucle document (comme sur une boucle article), on peut aussi demander {statut=prepa}

- Utiliser un critère optionnel, et demander le critère via l’url :

<code - Utiliser un critère optionnel , et demander le critère via l’url  :< code >



- N’afficher que les articles dont le « num titre » est pair :

- n’afficher que les articles dont le num titre est pair ( ou impair )  :
_ on considère que tous les titres des articles sont préfixés avec un nombre suivi d’un point suivi d’un espace (« 123. Le titre ») :

<BOUCLE_art_pair(ARTICLES) {par num titre} {titre==^[[:digit:]]*[02468][.][[:space:]]} {"<br />"}>
#TITRE
</BOUCLE_art_pair>
<hr>
<BOUCLE_art_impair(ARTICLES) {par num titre} {titre==^[[:digit:]]*[13579][.][[:space:]]} {"<br />"}>
#TITRE
</BOUCLE_art_impair>

[form_crit_opt<-]

-  un un formulaire simple (pas cvt) qui boucle sur la page et y renseigne un critère de boucle
_ par exemple un < code>select</code > de boucle  : mots-clefs (< code>name=« avec_mot »</code >) dont chaque < code>value</code > est un id_mot mais avec une option ’ tous les mots ’

par exemple un select de mots-clefs (name="avec_mot") dont chaque value est un « id_mot » mais avec une option « tous les mots »

la boucle ARTICLES correspondante (au retour du formulaire) utilisera donc le critère {id_mot ...}.

mais comment ? puisque la boucle doit retourner les articles liés soit à un id_mot unique soit à n’importe quel id_mot

pour la boucle on utilisera les REGEXP de mysql avec comme critère :

   {id_mot == ^#ENV{avec_mot}$}

dans le select, on passera comme value pour l’option ’tous les mots’
 :

pour un formulaire en method get :

   <option value=".%2B">tous les mots</option>

pour un formulaire en method post :

   <option value=".+">tous les mots</option>

[exclu_flv<-]

-  Afficher nous voulons afficher les articles «  sauf  » sauf ceux qui ont un flash dans le corps de leur texte  : texte

on travaille en 2 boucles. la première va extraire les id_articles depuis la table spip_documents_liens des articles (objet) liés à un document (id_document) inséré dans le corps du texte (vu) et d’extension .flv :

#SET{noflash, #ARRAY}
<BOUCLE_noflash(spip_documents_liens) {objet = article} {vu = oui} {spip_documents.extension = flv}>
#SET{noflash, #GET{noflash}|push{#ID_OBJET}}
</BOUCLE_noflash>

la seconde boucle exclue ces articles (!IN) de sa recherche :

<BOUCLE_a(ARTICLES) {id_article !IN #GET{noflash}} {"<br />"}>
#TITRE
</BOUCLE_a>

[pos_crit<-]

-  N’afficher que les articles dont le surtitre contient la lettre « x » à une certaine position, position fournie dans une variable d’environnement (par exemple, passée en url).

[pos_crit<-]
- nous voudrions n’afficher que les articles dont le surtitre contient la lettre « x » à une certaine position, position fournie dans une variable d’environnement (par exemple, passée en url).
SPIP _ spip ne permettant pas d’utiliser la fonction « SUBSTRING » de mysql comme critère de boucle, nous utiliserons les expressions régulières (REGEXP) de mysql.

tout d’abord, construire la regexp :

#SET{reg, #VAL{.}|str_repeat{#ENV{position}|moins{1}}}

deux cas de figure :

• si la position où rechercher la lettre « x » est 1 (c’est à dire au début du surtitre) ; la regexp sera vide «   »
• si la position n’est pas 1, par exemple si #ENV{position} est égale à 4, nous aurons « ... »

il ne reste plus qu’à écrire le critère de boucle en ajoutant ^ (« commence par ») et le x final :

<BOUCLE_p(ARTICLES) {surtitre == ^#GET{reg}x}>
  #SURTITRE  -- (x en #ENV{position}e position)
  ...

----

MES_OPTIONS

----

MES_OPTIONS

Dans config/mes_options.php

- Éviter Pour éviter de voir les numéros ou les balises multis des titres dans l’espace privé privé (par exemple sur médiathèque)  :
<code >
<cadre class=’spip ’>
$table_des_traitements[’TITRE’][] = test_espace_prive() ? ’typo(%s)’ : ’typo(supprimer_numero(%s))’ ;
</code </cadre >

- Changer Changer la qualité par défaut de compression jpg  : jpg
<code >
cadre class=’spip ’>
define(’_IMG_GD_QUALITE’, 95) ;
</code </cadre >

- En En local, interdire le compactage des js et css dans le privé, , et tout envoi de mails par facteur
<code >
cadre class=’spip ’>
if ($_SERVER[« HTTP_HOST »] == « 127...1 »)
define(’_INTERDIRE_COMPACTE_HEAD ’, true define(’_INTERDIRE_COMPACTE_HEAD’,true ) ;
define(’_TEST_EMAIL_DEST’, ’’) ; // Facteur n’envoie jamais rien
rien

</code cadre >----

SQUELETTES

----

SQUELETTES

- Utiliser le filtre |ou :

<code >
<cadre class=’spip ’>
[(#ENVid_article

<INCLURE{fond=inc-manoisette ,  ajax <INCLURE{fond=inc-manoisette}   {ajax }>

Mais comment faire fonctionner le callback ? et hop :

$(document).ready(function() {
  var fonction_a_rappeler=function fonction_a_rappeller=function () {
    ...
  }
  if (typeof onAjaxLoad == 'function') onAjaxLoad(fonction_a_rappeller);
  if (window.jQuery) jQuery(document).ready(function() {
    fonction_a_rappeler fonction_a_rappeller .apply(document);
  });
});

- Empêcher l’apparition des boutons de recalcul sur une page en particulier :

- Empêcher l’apparition des boutons de recalcul sur une page en particulier ( à plaçer sur la première ligne première ligne du squelette)  :

[(#HTTP_HEADER{Content-type :<code >
 [(#HTTP_HEADER{Content-type : text/html[; charset=(#CHARSET)]})]

(voir voir http://www.spip.net/fr_article4631....).

- Se servir de #VAL :

- Se servir de < code>#VAL</code > par exemple pour < code>

et pour vider l’url on écrira : [(#SELF|parametre_url{id_mot, ''})]

- Créer un lien vers la page site avec la variable id_syndic=xx (à mettre dans une boucle de syndication) corrige également l’erreur produite par generer_url_site (maj SPIP) :

[(#URL_PAGE{site}|parametre_url{id_syndic,#ID_SYNDIC})]

- Créer un lien vers l’article 54 en se passant de boucle :

<a href="#URL_ARTICLE{54}">lien</a>

- URL propres arborescentes

cf http://comments.gmane.org/gmane.com...

$type_urls = 'arbo';
define('_SET_HTML_BASE', 1); // ajoute aux pages html une directive  
<base..> et traite les ancres des pages produites

- Afficher les requêtes SQL ( SPIP 2 )  :
<code >
http://adresse_spip http://adresse_spip /?var_profile (SPIP 2 ) permet d’afficher les requêtes SQL que fait SPIP pour créer la page ainsi que les temps de calcul pour chaque boucle et inclusion.

-

http://adresse_spip/?-  {{Afficher  var_mode=inclure</code >  (SPIP  2 )  Afficher  les noisettes d’un squelette}}  ( squelette  SPIP 2 )  :
 <code>http://adresse_spip /? var_mode=inclure

voir voir Les aides au débuggage de squelettes

----

----

SITES D’ASTUCES

-http://www.weblog.eliaz.fr/rubrique...

----

----

RACCOURCIS TYPOS

Pour faire un lien dans un texte, on utilise le raccourci [->artXX] ou [->rubXX] ou [->motXX], etc.

Mais comment fait-on si on veut pointer vers une page en lui transmettant des paramètres ? Un nom d’onglet par exemple : l’onglet des sites sur une page de mots-clés...

C’est simple il suffit d’écrire [->motXX?parametre=valeur] (dans notre ex. ce pourrait être [->mot33?onglet=sites]) Spip transforme alors le raccourci en URL cliquable du type spip.php?motxx&parametre=valeur

Remarquez comment Spip jongle automatiquement avec les & et les ?.

----

INCLURE dans un squelette

- <INCLURE{fond=../../ma_noisette}> ou encore #INCLURE{fond=../../ma_noisette} pour afficher le html (évalué) de « ma_noisette.html » placé 2 répertoires au-dessus de la racine du spip ;

- <INCLURE(../../ma_noisette.html)> pour afficher le texte brut de « ma_noisette.html » placé 2 répertoires au-dessus de la racine du spip ;

- <INCLURE(../../mon_script.php)> pour exécuter le script php de « mon_script.php » placé 2 répertoires au-dessus de la racine du spip.

- Définir une variable calculée par une noisette

sans variable on utilise <INCLURE{fond=monsquelette}> ou [(#INCLURE{fond=monsquelette})]

pour définir la variable calculée :#SET{mavariable, #INCLURE{fond=monsquelette}{monparam=#ENV{monparam}}}

INCLURE dans un formulaire

$date_recolte = recuperer_fond('formulaires/inc-date_recolte', $flux['args']['contexte']);

$code = recuperer_fond("inclure/inc-liste-articles", array( 'id_rubrique' => $id_rubrique));

Voir http://programmer.spip.org/recupere...

DATE DU JOUR

dans un squelette, afficher la date du jour (la date courante) n’est pas toujours aisé.

deux variables peuvent entrer en jeu :

• la date retournée par la boucle dans laquelle on veut afficher notre date du jour
• une variable nommée date passée en url ou par le biais d’un formulaire

pour chaque cas, néanmoins, il existe une possibilité d’afficher la date du jour et ce sans que cette date soit tributaire du cache du squelette (ce sera toujours la date courante qui sera affichée)

un champ date ou date_redac

en url ou par formulaire

#SET{cur_date, #VAL{Y-m-d h:i:s}|date}

puis l’utiliser dans le squelette avec :

#GET{cur_date}