SPIP

|find

Aurélie, denisb — 2009-12-23T16:52:35Z

Le filtre |find appliqué à un tableau vérifie la présence d'une valeur dans le tableau

Le filtre |find permet de vérifier la présence d'une valeur dans le tableau auquel il est appliqué :

[(#GET{mon_tableau}|find{la_valeur}|oui) Ceci s'affiche si la valeur «la_valeur» est bien présente dans le tableau «mon_tableau».]

Si #GET{mon_tableau} n'est pas un tableau (array au sens PHP), la balise filtrée par |find ne retourne rien.

|table_valeur

Aurélie — 2009-12-23T11:18:24Z

|table_valeur retourne la valeur associée à une clé dans un tableau.

|table_valeur{clé,valeur par défaut}

Le filtre |table_valeur (depuis SPIP 1.9) s'applique à une balise contenant un tableau, prend une clé du tableau comme paramètre et retourne la valeur associée à cette clé. Voir la balise #ARRAY pour une explication plus générale sur les tableaux.

Exemple :

retourne vert.

Le paramètre optionnel valeur par défaut permet de préciser une valeur à retourner si la valeur n'est pas trouvée (la clé n'existe pas ou la balise filtrée n'est pas un tableau).

[(#GET{un_tableau}|table_valeur{3,noir})] retourne noir parce qu'il n'y a pas de clé 3.

|table_valeur fonctionne aussi avec des tableaux "linéarisés", par exemple, les tableaux retournés par les balises #ENV et #CONFIG (mais ces balises disposent de leur propre syntaxe pour accéder aux valeurs du tableau).

Le tableau ci-dessus linéarisé [1] donne ceci :

a:3:{i:0;s:5:"rouge";i:1;s:4:"bleu";i:2;s:4:"vert";}

[(#GET{un_tableau}|table_valeur{2})] retourne toujours vert.

[1] Voir les fonctions serialize et unserialize en PHP.

|push

Aurélie — 2009-12-23T11:17:33Z

|push permet d'ajouter une valeur à la fin d'un tableau.

Le filtre |push (depuis SPIP 2.0) s'applique à une balise contenant un tableau PHP (voir #ARRAY) et y ajoute une nouvelle valeur.

La clé est incrémentée de 1 à chaque nouvelle valeur. Si aucune clé n'a été définie pour la première valeur, le tableau est indexé à partir de 0 (la première clé est 0).

[(#GET{un_tableau}|foreach)] affiche :

5=> une_valeur
6=> une_autre_valeur
7=> une_troisieme_valeur

La première clé est 5 parce qu'elle a été précisée lors de la création du tableau (premier #SET).

Exemple courant d'usage de |push :

Si les articles sélectionnés par la BOUCLE portent les numéros 2, 5 et 10, [(#GET{mes_articles}|foreach)] retourne :

0=>2
1=>5
2=>10

Ici, la première clé est zéro car aucune clé n'a été définie préalablement.

Contrairement à la fonction PHP array_push, |push ne produit pas de message d'erreur si la balise filtrée n'est pas un tableau.



#SET et #GET
cam.lafit, denisb — 2009-12-22T11:45:42Z
La balise #SET définit une variable qui sera utilisable dans l'ensemble du squelette.

La balise #GET permet ensuite de récupérer cette variable.
		#SET{variable,valeur}

#GET{variable} retourne "valeur".
 La variable définie par #SET peut être une chaîne de caractères ou un tableau.
 - Une chaîne de caractères :

#SET{ma_chaine, article de #NOM}
 #GET{ma_chaine} affichera :

article de Toto
 - Un tableau [1] :

#SET{mon_tablo, #ARRAY{a,un,b,deux,c,trois,d,quatre}}
 [(#GET{mon_tablo}|foreach)] affichera :
  a => un
 b => deux
 c => trois
 d => quatre
Usages avancés avec les chaînes de caractères
- Une expression régulière :


#SET{reg1, '(^.*/[^/]+[/])'}
 #SET{reg2, '\.[\w-_]+?'}
 
 [(#FICHIER|replace{#GET{reg2}}|replace{#GET{reg1}})]

 
permet de récupérer et d'afficher le nom du fichier d'un document, débarrassé de son chemin d'accès (path) et de son extension.

Par exemple, si #FICHIER est IMG/pdf/Stats_Sejour_au_311207.pdf nous afficherons Stats_Sejour_au_311207.
 L'intérêt ici d'utiliser les balises #SET et #GET pour l'expression régulière est de permettre l'utilisation des crochets ([ et ]) dans le filtre |replace.
 - Le résultat retourné par un INCLURE :
[(#SET{mon_retour, #INCLURE{fond=calculs}})]
		
		[1] Voir aussi l'article consacré aux tableaux.
		
		


{traduction}
Fulup — 2009-12-16T18:14:37Z
- {traduction} (adalek SPIP 
1.7.1) dibab a ra troidigezhioù ar pennad a-vremañ e yezhoù disheñvel.
		
		


Tapadennoù-skramm
Fulup — 2009-12-16T16:01:11Z
Setu aze un nebeud tapadennoù-skramm tennet eus lodenn brevez lec'hienn SPIP, deoc'h da gaout un tamm sell war ar pezh a c'hall SPIP kinnig.
 Evit kaout ur soñj pishoc'h eus ar pezh a c'haller ober eus an tu foran, kit d'ober un tamm tro war ar roll "lec'hiennoù dindan SPIP".
		Pajenn heuliañ al lec'hienn

 Etrefas aozañ ur pennad

 Ar forom diabarzh

 Keñveriañ stummoù disheñvel ur pennad

 An difazier

 Al lusker enklask

 Ar stadegoù

 Merdeiñ dre al lec'hienn

 Ar mod testenn


		
		


Ik heb een rubriek aangemaakt maar ze verschijnt niet op de openbare site !
Suske — 2009-12-16T13:20:36Z
Rubrieken kunnen enkel gezien worden wanneer ze tenminste een gepubliceerde element (artikel, nieuwsbericht, site, subrubriek) bevatten. Je moet dus minimaal een artikel schrijven en online plaatsen. Je kan natuurlijk een nepartikel publiceren om het systeem te testen.
 Ik heb alles gedaan zoals het moet maar toch is er niets te zien !
 De openbare site gebruikt een cachesysteem waarmee alle bestanden regelmatig herberekend worden (bijvoorbeeld elk uur of om de 4 uren, volgens de programmatie van je sjablonen). Het systeem dient om de toegangen naar de SQL database te besparen en ook om echt functioneren van de site mogelijk maken in geval de SQL server gecrasht is (wat kan gebeuren...).
 Je moet dus het cachesysteem verfrissen door een herbekening van de pagina's te starten. Daarvoor, activeer de toegangskoekie in de private ruimte. Op de openbare site zal je voortaan knopjes kunnen zien waaronder "Pagina vernieuwen".
Op het knopje van een pagina klikken zal dus de inhoud van de pagina verfrissen (doe het bijvoorbeeld op de startpagina om je eerste rubrieken te laten zien).
		
		


Het statuut van de auteurs in SPIP
Suske — 2009-12-15T17:46:17Z
Wanneer je met persoonlijke logingegevens toegang hebt tot een SPIPsite, ben je «auteur» van deze site.
 In SPIP bestaan er 3 soorten auteurs: bezoekers, redacteurs en beheerders.
  
 De bezoeker mag alleen de beperkte delen van de openbare site bereiken alsook de forums wiens hij geabonneerd is. Hij heeft geen toegang tot de private ruimte (/ecrire) van de site.
 
 De redacteur krijgt toegang tot de private ruimte van de site en mag teksten schrijven en inhouden (multimedia documenten alsook teksten) voor evaluatie voorstellen. Dit is het meest gebruikte statuut.
 
 De beheerder krijgt « alle rechten » op de website : toevoegen, verbeteren en uitwissen van inhouden, herlezen en verbeteren van teksten geschreven door andere redacteurs, aanpassen van de boomstructuur, enz. en vooral publicatie op de openbare website.
Hij is de moreel verantwoordelijk voor de inhoud van het website. Beperkte beheerders hebben beheerdersrechten maar beperkt tot een of meerdere rubrieken.

Voorbeelden van typische rechten van auteurs in SPIP
Bezoeker Redacteur Beheerder


 Mag :

 Openbare website bezoeken
 Aan openbare forums van de website deelnemen waarvoor registratie vereist is [*] 
 Krijgt de rechten van een bezoeker en meer : nieuwe inhouden scheppen : artikels en nieuwsberichten schrijven [*], beelden en documenten toevoegen, websites verwijzen [*], enz.
 eigen nieuwe inhouden voor evaluatie voorstellen;
 zijn artikels "in redactie" of "voor evaluatie voorstellen" verder schrijven of verbeteren; voorgestelde nieuwsberichten verbeteren [*] ;
 de door andere redacteurs voorgestelde artikels lezen en bespreken in de private ruimte;
 de voorgestelde artikels "vooraf zien" op het openbare website [*] ;
 de auteurslijst raadplegen;
 de trefwoordenlijst raadplegen [*] ;


Mag NIET :

 Een online geplaatste artikel verbeteren, zelfs eigen artikels niet;
 Nieuwe rubrieken maken. 
 Krijgt de rechten van een redacteur plus : Inhouden op de openbare website online plaatsen: artikels, nieuwsberichten, website, enz. goedkeuren en publiceren
 Oudere online geplaatste inhouden verbeteren ;
 Publieke forums modereren;
 Nieuwe auteurs aan artikels verbinden;
 rechten en statuten van andere auteurs beheren ;
 Nieuwe auteurs inschrijven ;
 Website configuratie van de site beheren ;
 Bijkomende functies activeren, uitschakelen en instellen. 


Standaard stelt SPIP maar drie verschillende statuten voor: het is meestal genoeg voor de meerderheid van de sites. Alhoewel het mogelijk is die lijst uit te breiden en rechten fijner te beheren, onder andere door het gebruik van een aantal bestaande plugins.
		
		[*] Als deze mogelijkheid in de configuratie van het website geactiveerd is.
		
		


De naam « Mon site SPIP » veranderen
Suske — 2009-12-15T17:37:36Z
Het eerste wat je moet doen op je SPIP-site is je identiteit kenbaar maken : naam, adres, beschrijving, logo, enz.
		Om deze informatie in te voeren moet je in het menu van de private ruimte op de knop «Configuratie» klikken, dan in het deel «Inhoud van de site» de volgende formuliervelden invullen.
 
 Merk hierbij op dat deze informatie in de opmaakcodes of formulieren wordt opgenomen in het opmaaksjabloon van uw site ; de informatie heeft betrekking op de inhoud van uw webpagina's en dus op de opzoekbaarheid van uw site.
 Naam van je site
In het eerste formulierveld, onder "Naam van je site", kan een tekst ingevuld worden die op iedere pagina als websitenaam weergegeven zal worden. Standaard wordt «[Mon site SPIP]» getoond : denk eraan de naam te veranderen !
 Adres van de site
Dit veld wordt automatisch ingevuld na ontdekking van het URL-adres van je site. Je kan toch maar beter nagaan of dit goed gewerkt heeft en of het adres overeenkomt met wat je wilt tonen.
 Site beschrijving
Sedert SPIP 1.9(fr) dient dit veld je site in het kort voor te stellen. Enkele korte zinnen kunnen hier een beschrijving geven aan je bezoekers en hen informeren waarover je site gaat.
 De beschrijving kan in de opmaakcode meta description gebruikt worden. Die wordt door zoekmachines gelezen. De beschrijving moet uit minder dan 200 lettertekens bestaan.
 E-mailadres van de webmaster (optioneel)
Sedert SPIP 1.5(fr) bevat dit veld het e-mailadres van de webmaster. Standaard gebruikt SPIP het e-mailadres van de gebruiker die de site heeft geïnstalleerd (eerste beheerder).
 Logo van de website
Sedert SPIP 1.9(fr) is het mogelijk het logo als een visueel document hier te uploaden.
Om je logo te kiezen dien je in de "Configuratie" sectie op de knop "Logo van de website" te klikken: een knop laat je een logo (beeld) kiezen, uploaden en opslaan.
 Met de met SPIP geleverde sjablonen wordt het logo rechtstreeks aan de bovenzijde van je pagina's afgebeeld. Het wordt ook op een aantal andere plaatsen gebruikt, onder andere in het «backend» bestand waarop de bezoekers zich kunnen abonneren. Gebruik dus een beeld dat niet te groot is.
		
		


Mijn site is leeg, wat moet ik doen ?
Suske — 2009-12-15T15:42:58Z
Een nieuw geïnstalleerde SPIP-site is leeg. Het eerste wat je moet doen, is de boomstructuur van de site uitwerken. Je kan de structuur later nog bewerken, het gaat erg makkelijk.
 Je moet ten minste één rubriek aanmaken.
 Hiervoor, klikken op de link «Een rubriek aanmaken».

Vul het formulier in met de nodige informatie.

Herbegin zo voor ieder nieuwe rubriek of subrubriek.
 
 Te volgen : Ik heb een rubriek aangemaakt maar ze verschijnt niet op de openbare site !