Astuces SPIP

anne-lise — 2005-03-16T17:42:42Z

Retrouvez dans cette rubrique des astuces pour SPIP comme certains raccourcis typographiques peu connus ou des explications sur les squelettes SPIP.

Quelques raccourcis SPIP
Exemple d'une boucle SPIP
Mémento boucles et balises
Des fichiers cachés sous SPIP ?
Quelques filtres SPIP

Les raccourcis spip permettent de rédiger du contenu en insérant des balises spécifiques dans les champs textes lors de la rédaction d'un article, ces balises sont ensuite transformées par spip en code html pour l'affichage public.

Liste avec la puce spip

Rédaction

- banane
- citron

Télécharger

Résultat

banane
citron

Code généré

Liste sans la puce spip

Rédaction

-*banane
-*citron

Télécharger

Résultat

banane
citron

Code généré

Liste numérotée

Rédaction

-#banane
-#citron

Télécharger

Résultat

banane
citron

Code généré

Sous-liste

Rédaction

-#légumes
-**carotte
-#agrumes
-**citron
-**orange

Télécharger

Résultat

légumes
- carotte
agrumes
- citron
- orange

Code généré

Et pour personnaliser les puces des listes, référez vous en css à list-style-type .

Raccourcis wikipedia

Rédaction

[?piaf]

Télécharger

Résultat

piaf

Code généré

Ecrire du code (php, html) non interprété

Utiliser les balises ou


  Rédaction
ligne de texte


echo hello world;
?>

autre ligne de texte
Télécharger
  Résultat

ligne de texte

echo hello world;

?>
autre ligne de texte

  Code généré

 
Ecrire du code html ou css à interpréter
Utiliser la balise
  Rédaction


vert
Télécharger
  Résultat
 
vert
 
  Code généré


 
Simple retour à la ligne
  Rédaction
votre texte
_ la ligne suivante
_ la ligne suivante
Télécharger
  Résultat

votre texte

la ligne suivante

la ligne suivante

  Code généré

 
Pour insérer une ligne de paragraphe, sautez une ligne.




Les références SPIP pour les raccourcis typographiques se trouvent dans l'aide en ligne, une démonstration est disponible sur demo.spip.org
 
Structure de base d'une boucle spip
Mémento d'une structure de boucle spip :
Cet exemple est à réaliser dans les squelettes html de vos pages SPIP.
>
option avant si réponse
>
la boucle
>
option après si réponse
>
option si aucune réponse
>
un peu de css pour clarifier l'exemple d'application :



Exemple d'application de boucle spip 

du texte peut se placer avant la boucle
>

Voici tous les articles dont les sous titres sont coucou

(ARTICLES){soustitre="coucou"}{par titre}>
#TITRE -#SOUSTITRE
>


>
Désolé! aucun article ne correspond à ces critères!
>
du texte peut se placer après la boucle

Télécharger


Résultat si les critères correspondent

du texte peut se placer avant la boucle
 
Voici tous les articles dont les sous titres sont coucou
 article abc -coucou
 article efg -coucou
 article tuv -coucou


du texte peut se placer après la boucle
 
Résultat si les critères ne correspondent pas 

du texte peut se placer avant la boucle
 Désolé ! aucun article ne correspond à ces critères !
 du texte peut se placer après la boucle
 

Mémento pour les critères de boucles ou les balises
Dans vos squelettes, pour séparer les éléments par une une virgule utiliser {","}
(AUTEURS) {id_article} {par nom} {", "}>
[#URL_AUTEUR">(#NOM)]
>
Pour créer le lien de l'article 12 sans passer par une boucle #URL_ARTICLE{12}
 
Forcer la réindexation d'un site sous SPIP
Il est possible de forcer la mise à jour de la base des indexs. Cette fonctionnalité est accessible en spip<1.9.2 en lançant une page du répertoire "ecrire" :
http://nom_de_votresite/ecrire/admin_index.php
 Cliquez ensuite sur "Cliquez ici pour forcer l'indexation du site" jusqu'à ce que tous les indicateurs soient complètement verts.
 En SPIP > 1.9.2 utilisez le plugin Recherche Etendue.
 Les infos php du serveur
Pour connaitre les possibilités php du serveur qui héberge votre site comme par exemple quelles sont les librairies de traitement d'images installées, allez sur la page :
 SPIP<1.9
http://nom_de_votresite/ecrire/info.php
SPIP>1.9
http://nom_de_votresite/ecrire/?exec=info


Les filtres natifs de SPIP
Les filtres sont des fonctions qui s'appliquent aux balises avec crochets et accolades [(#TEXTE)], [(#URL_ARTICLE)] ... il faut mettre un pipe | (alt + L sur mac) puis le filtre. [(#TEXTE|filtre)]
Il existe dans SPIP des filtres par défaut, mais on peut aussi se servir des fonctions php ou créer ses propres fonctions.
 Filtre conditionnel 
Pour faire apparaitre le lien hypertexte d'un article même si le titre du lien n'existe pas.
Cocher d'abbord Oui dans (ecrire/?exec=configuration) > Contenu des articles > Lien hypertexte
[sur le web : #URL_SITE">(#NOM_SITE|!={''}|?{#NOM_SITE,#URL_SITE}) ]
Plus court ?
[sur le web : #URL_SITE">(#NOM_SITE|sinon{#URL_SITE}) ]
Filtre conditionnel d'une inclusion
A mettre à l'interieur d'une boucle article !
[(#ENV{id_article}|=={'59'}|?{' ',''}){fond=inc-art59}{id_article}>]
Filtre transformant des paragraphes en simple saut à la ligne


[(#TEXTE|Ptobr)]
 Exemples de filtres personnels
Cryptez vos emails en les laissant visibles !
Le filtre antispamarobase s'ajoute au filtre crypt_mail , il permet aux rédacteurs de rédiger un texte qui contient un email protégé des robots spammeurs.
Préférez toutefois un lien vers la page de l'auteur, en rédaction[écrire un mail à l'auteur->auteur54] ou en dur dans un squelette


Ecrire un mail à l'auteur #NOM


L'exemple de contact@elastick.net ici crypté reste visible et actif, ouvrez le code source pour vérifier !
 Démonstration du cryptage de mail
  Rédaction


[->contact@elastick.net]
 
  Résultat

contact@elastick.net

  Code généré
contact@elastick.net
 
/*
* +----------------------------------+
* Nom du Filtre : antispamarobase 
* +----------------------------------+
* Date : 4 avril 2005
* Auteur : ELASTICK.net
* +-------------------------------------+
* Fonctions de ce filtre :
* Crypter l arobase jusqu au point suivant dans le champ d un article, d une rubrique etc..
* sans empecher l affichage a l ecran
* ni son utilisation par un logiciel de messagerie
* +-------------------------------------+
* utilisation dans un squelette :
* [(#TEXTE|antispamarobase)]
* s'utilise avec crypt_mail (placé au dessus) dans mes_fonctions.php
* a combiner eventuellement avec cryptemail_txt
* [(#TEXTE|cryptemail_txt|antispamarobase)] qui crypte la balise 

* 
*/
 
function antispamarobase($texte) {
 while (strpos($texte,"ATICI") > 0) { //!! ATTENTION remplaçer ATICI par un arobase
 $debuarobase = strpos($texte,"ATICI");
 $finarobase = strpos($texte,'.',$debuarobase);
 $cryptarobase = substr($texte,$debuarobase,$finarobase-$debuarobase);
 
 $s= crypt_mail($cryptarobase);
 
 $texte = ereg_replace($cryptarobase, $s, $texte);
 }
 return $texte;
 }
Télécharger
il faut le faire précéder dans mes_fonctions.php de :
/*
* +----------------------------------+
* Nom du Filtre : crypt_mail 
* +----------------------------------+
 
* Date : dimanche 6 juillet 2003
* Auteur : Jean-Pierre KUNTZ
* alias Coyote 
* +-------------------------------------+
* Fonctions de ce filtre :
* Crypter une chaîne de texte (email, URL)
* sans en empecher l affichage à l ecran
* ni l'utilisation par un logiciel de messagerie
* +-------------------------------------+
* 
* Pour toute suggestion, remarque, proposition d'ajout
* reportez-vous au forum de l'article :
* http://spip-contrib.net/article.php3 ?id_article=197
*/
 
function crypt_mail($texte) { 
 $s=""; 
 for ($i=0;$i($texte);$i++) { 
 $s.="&#".ord($texte{$i}).";"; 
 } 
 return $s; 
} 
 
function cryptemail_txt($texte) {
 while (strpos($texte,"mailto:") > 0) {
 $debemail = strpos($texte,"mailto:");
 $finemail = strpos($texte,'"',$debemail);
 $textemail = substr($texte,$debemail,$finemail-$debemail);
 
 $s= crypt_mail($textemail);
 
 $texte = ereg_replace($textemail, $s, $texte);
 }
 return $texte;
 }
Télécharger
Un code pour retirer toutes les balises 
SPIP ajoute des balises de style dans le texte, est-ce vraiment utiles ? Le débat fait rage, ici, pour la démonstration, on propose d'éliminer ces balises.
Un exemple ?
  Rédaction

  Résultat






  Code généré

 
Après application du filtre, nous aurons :


Télécharger
 est donc gênant pour gérer le border des images ou leurs marges, il suffira alors d'appliquer le filtre et d'ajouter ces propriétés de class css après l'appel des fichiers css :

Voici donc un filtre pour retirer toutes les balise  le code d'un filtre SPIP est à mettre dans le fichier mes_fonctions.php
et si ce fichier n'existe pas vous devez le créer dans un dossier nommé squelettes à la racine de votre site.
 
function virebalisestyle($str) {
 if($str!="") {
$str= preg_replace( "/style ='([^>]*)'/i" , "" , $str);
}
 return $str;
}
?>
Cette fonction/filtre s'utilisera ainsi :
[(#TEXTE|virebalisestyle)]