Version 60 — Mai 2011 — 81.14.xx.xx
- convertir sa base en UTF-8 :
À utiliser pour une recherche alphabétique exacte ou pour avoir une jolie base dans PHPMyadmin
Passer par un code caché ;) ?exec=convert_sql_utf8
pour convertir sa base en UTF-8, vraiment ! (http://archives.rezo.net/archives/s...)
bah bah bah...
plutôt utiliser le critère {collecte...}
. À voir sur le glossaire de spip.net
- dites moi, vous avez une idée pour trouver si un plugin est là ? (dialogue via irc) :
<marcimat> 1.9.2 ou 1.9.3, php ou squelette ?
<touti> dans un squelette 1.9.2c
<marcimat> [(#EVAL{DIR_PLUGIN_PREFIX}|?{' ',”}) Mon action ]
<marcimat> ou _DIR...
<touti> arf, et en php ?...
<marcimat> if (defined('_DIR_PLUGIN_XXX')){ ... }
<touti> génial merci
<marcimat> pour 1.9.2
<marcimat> en 1.9.3, c'est un poil simplifié tout ça
<touti> ah?
<marcimat> [(#PLUGIN{XXX}) Mon action ]
- Pour récupérer le chemin d’un plugin dans un squelette :
#SET{cheminmonplugin, #EVAL{_DIR_PLUGIN_MONPLUGIN}}
#GET{cheminmonplugin}
- Pipeline automatique de css dans un plugin :
style_public_plugin_xxx.html
et pour l’espace privé
prive/style_prive_plugin_xxx.html
seront prises en compte automatiquement par SPIP
- Faire un CSS qui soit un squelette (cela permet de récupérer des variables) :
[(#REM) dans la page monstyle.html et en première ligne ]
#HTTP_HEADER{'Content-Type: text/css'}
.couleurdefond {
background-color:green;
[(#ENV{id_article}|={33}|?{background-color:pink;})]
}
Appeler la CSS dans une page SPIP
[(#REM) dans la page article.html par exemple cela retournera /?page=styles&id_article=33]
<link rel="stylesheet" type="text/css" href="[(#URL_PAGE{monstyle}|parametre_url{id_article,[(#ENV{id_article})] )]" />
...
<div class="couleurdefond">
change ici la couleur de fond en rose si article=33
</div>
Quand on crée une balise, on peut vouloir récupérer des variables du contexte (il y a un article déjà sur contrib qui explique cela) ; mais quand on veut trouver le type de boucle du contexte, il faut aller le chercher dans la pile $p
:
$p->boucles[$p->id_boucle]->id_table
- Utiliser textebrut pour compter la chaine correctement, sinon l’apostrophe compte 5, ça par exemple !
[(#TITRE|textebrut|strlen|>{30}
|et{[(#TITRE|textebrut|strlen|<{60})]}|oui)
[(#INTRODUCTION|PtoBR|couper{85})]
]
- |unique dans un modèle
Un modèle inséré dans un texte ne peut simplement appeler le filtre |unique car il arrive que spip calcule plusieurs fois le #TEXTE, par exemple pour les besoins de #INTRODUCTION, et l’environnement de |unique n’est pas réinitialisé à chaque fois...
Donc pour ces besoins, on utilisera un « unique nommé », avec un nom généré dynamiquement de manière ... unique à chaque fois.
#SET{ident, #REM|uniquid}
puis utiliser |unique{#GET{ident}}
- un |replace
pour créer l’équivalent d’un sprintf
dans la définition d’un #SET
utilisé dans une
boucle itérateurs (_fil_ et BoOz sur irc) :
#SET{req, #VAL{"
SELECT a.truc_1,
s.truc_2,
s.truc_x
FROM spip_matable s,
spip_auteurs a
WHERRE 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}}>
...
- 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 les articles ayant le mot clef truc :
<BOUCLE_articles(ARTICLES) {titre_mot=truc}>
#TITRE
</BOUCLE_articles>
!OUPS {titre_mot}
étant obsolète on peut désormais écrire :
<BOUCLE_G(ARTICLES) {mots.titre}>
- Le critère {par multi titre}
permet de trier les titres alphabétiquement quand ils utilisent la balise multi pour le multilinguisme.
- 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}>
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 simple {statut?}
dans une boucle annule la restriction de 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 :
<BOUCLE_articles(ARTICLES) {branche ?} {id_mot ?} {id_auteur ?}>
- 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>
- un formulaire simple (pas cvt) qui boucle sur la page et y renseigne un critère de boucle
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>
- nous voulons afficher les articles sauf ceux qui ont un flash dans le corps de leur 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>
- 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 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 :
»...
»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)
...
Dans config/mes_options.php
Pour éviter de voir les numéros ou les balises multis des titres dans l’espace privé (par exemple sur médiathèque)
$table_des_traitements['TITRE'][] = test_espace_prive() ? 'typo(%s)' : 'typo(supprimer_numero(%s))';
Changer la qualité par défaut de compression jpg
define('_IMG_GD_QUALITE', 95);
En local, interdire le compactage des js et css dans le privé, et tout envoi de mails par facteur
if ($_SERVER["HTTP_HOST"] == "127...1") {
define('_INTERDIRE_COMPACTE_HEAD',true);
define('_TEST_EMAIL_DEST', ''); // Facteur n'envoie jamais rien
}
opérateur ou
[(#ENV{id_article}
|ou{#ENV{id_rubrique}}
|ou{#ENV{id_article}}
|ou{#ENV{id_breve}}
) alors afficher ce texte ]
- Variable dans une chaine de langue en squelettes <:ma_chaine{nom=Charles Martin, age=37}:>
permet de passer deux paramètres 'ma_chaine'=>"Bonjour, je suis @nom@ et j'ai @age@ ans".
- Variable dans une chaine de langue en php , utilisé par le plugin medias "._T("medias:erreurs_voir",array('nb'=>count($erreurs)))."
- Le calendrier ICAL ne fonctionne pas ? Assurez vous dans le fichier généré que la première ligne n’est pas vide ! Pour ma part la ligne 1 est devenue #HTTP_HEADER{Content-Type: text/calendar; charset:#CHARSET}BEGIN:VCALENDAR
- Remplaçer lire la suite par autre chose :
[(#TEXTE|couper{110, <a href="#URL_RUBRIQUE"><em>autre chose ...</em></a>})]
- Une syntaxe plus jolie (avec spip 2) pour tester l’existence d’un élément :
[(#PLUGIN{ABONNEMENT}|oui)
#INCLURE{fond=inc/menu_abonnement}]
[(#PLUGIN{ABONNEMENT}|non)
#INCLURE{fond=prive/menu_inscription2}]
- Le critère {ajax}
permet de recharger uniquement le morceau de noisette appellé ; utilisé en SPIP 2 avec pagination
:
<INCLURE{fond=inc-manoisette} {ajax}>
Mais comment faire fonctionner le callback ? et hop :
$(document).ready(function() {
var fonction_a_rappeller=function() {
...
}
if (typeof onAjaxLoad == 'function') onAjaxLoad(fonction_a_rappeller);
if (window.jQuery) jQuery(document).ready(function() {
fonction_a_rappeller.apply(document);
});
});
- Empêcher l’apparition des boutons de recalcul sur une page en particulier (à plaçer sur la première ligne du squelette) :
[(#HTTP_HEADER{Content-type: text/html[; charset=(#CHARSET)]})]
voir http://www.spip.net/fr_article4631....
- Se servir de #VAL
par exemple pour image_typo cela donnerait une image (avec la police victor.ttf) du mot Actuellement :
[(#VAL{Actuellement}|image_typo{police=Victor.ttf, taille=14, largeur=150})]
- Tester les autorisations d’écriture ou de modification d’un auteur (SPIP >= 1.9.3) :
[(#AUTORISER{modifier, article, #ENV{id_article}}) vous pouvez modifier l'article ]
Voir la doc
- Accèder aux données contenues dans les metas du site (attention serialize voir doc)
#CONFIG{meta::descriptif_site}
- Le raccourci sera <charte|typo>
si le fichier se nomme modeles/charte_typo.html
- Avec #MODELE, définir plusieurs paramètres dans un array :
[(#MODELE{nuage} {notid=5|6|7})]
définira les groupes à exclure dans la boucle du modèle
{id_groupe!==^((#ENV{notid, -1}))$}
(voir le plugin nuage)
- Utiliser un array, le déclarer précédemment, puis le remplir dans une boucle incrémentée par le compteur :
#SET{articles, #ARRAY}
<BOUCLE_articles_rub(ARTICLES) {id_rubrique}>
#SET{articles, #GET{articles}|array_merge{#ARRAY{#COMPTEUR_BOUCLE, #ID_ARTICLE}}}
</BOUCLE_articles_rub>
[(#REM) test du tableau faire [(#GET{articles}|print_r)] ]
- Encore plus court
#SET{arraymot,#ARRAY}
<BOUCLE_mot(MOTS){id_groupe}>
#SET{arraymot, #GET{arraymot}|push{#ID_MOT}}
</BOUCLE_mot>
- faire le ménage en base de données :
Aller directement dans la base pour modifier ou supprimer ; par exemple lorsque vous avez 2000 sites qui encombrent, un gros coup de balai peut être nécessaire ! La méthode rapide est donc de lancer une commande directement depuis MYSQL (par exemple via l’interface phpmyadmin)
SELECT * FROM <span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+c3BpcF9zeW5kaWM8L2NvZGU+"></span> WHERE <span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+c3RhdHV0PC9jb2RlPg=="></span> = 'prop'
DELETE FROM <span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+c3BpcF9zeW5kaWM8L2NvZGU+"></span> WHERE <span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+c3RhdHV0PC9jb2RlPg=="></span> = 'prop'
- Supprimer les syndications trop anciennes
Vous avez beaucoup de sites syndiqués et ils ne possèdent pas tous l’option effacer au bout de 2 mois
Voici la requête pour effacer toutes les vieux articles syndiqués (modifier la date selon vos besoins) :
DELETE FROM <span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+c3BpcF9zeW5kaWNfYXJ0aWNsZXM8L2NvZGU+"></span> WHERE date < '2007-12-31 10:00:00'
- Déplacer tous les articles de la rubrique 39 à la rubrique 12 :
UPDATE spip_articles SET id_rubrique = 12 WHERE id_rubrique = 39;
attention : si les deux rubriques ne sont pas dans le même secteur, il faut aussi mettre à jour id_secteur
- Transférer les données crées avec EXTRA2 (mettre en réserve vos spip_metas, iextras et les champs créés) :
En ligne :
ALTER TABLE <span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+c3BpcF9hdXRldXJzPC9jb2RlPg=="></span> ADD <span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+bm9tX2NoYW1wX25vdXZlYXU8L2NvZGU+"></span> text NOT NULL;
tmp/meta_cache.php
- passer un tableau de variables en url :
[(#SELF|parametre_url{'id_mot[]', #ID_MOT})]
ne fonctionne pas ; il faut donc écrire : [(#SELF)]&id_mot[]=#ID_MOT
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
- 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/?var_mode=inclure
(SPIP 2) Afficher les noisettes d’un squelette SPIP
voir Les aides au débuggage de squelettes
- http://www.weblog.eliaz.fr/rubrique...
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¶metre=valeur
Remarquez comment Spip jongle automatiquement avec les &
et les ?
.
- <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}}}
$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...
dans un squelette, afficher la date du jour (la date courante) n’est pas toujours aisé.
deux variables peuvent entrer en jeu :
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)
dans une boucle dont la table possède
un champ date ou date_redac |
hors boucle | |
pas de date ni de date_redac en url
ni passées par formulaire |
#ENV{date_redac}
ou
|
#DATE_REDAC
ou
|
variable date passée en url ou par formulaire | #ENV{date_redac} |
#DATE_REDAC |
variable date_redac passée en url ou par formulaire | #ENV{date} |
#DATE |
variables date et date_redac passées
en url ou par formulaire |
définir en début de squelette la date courante avec par exemple :
puis l’utiliser dans le squelette avec :
|
- la date du prochain jeudi qui suit #DATE
:
[(#VAL{Y-m-d}|date{#VAL{next Thursday}|strtotime{#DATE|affdate{U}}})]
- le nom du jour de l’avant-veille de #DATE
:
[(#VAL{Y-m-d}|date{#VAL{-2 days}|strtotime{#DATE|affdate{U}}}|nom_jour)]
- la date de lundi prochain :
[(#SET{lundi_prochain, #VAL{Y-m-d 00:00:00}|date{#VAL{next Monday}|strtotime{#DATE|affdate{U}}}})]
#GET{lundi_prochain}
- la date du dimanche d’après lundi prochain :
[(#SET{dimanche_apres, #VAL{Y-m-d 23:59:59}|date{#VAL{+6days}|strtotime{#GET{lundi_prochain}|affdate{U}}}})]
#GET{dimanche_apres}
- afficher le label nouveau ! pour un article publié ou modifié il y a moins de 10 jours :
#SET{periode, -10days}
#TITRE[ (#DATE_MODIF|>{#VAL{Y-m-d H:i:s}|date{#GET{periode}|strtotime}}|oui) nouveau !]
et _fil_ (sur irc) propose encore plus simple :
#TITRE[ (#DATE|strtotime|>{#VAL{-10days}|strtotime}|?{nouveau !, ''})]
----
----