Month: June 2007

Sa famille et ses proches,

Vous font part du décès de

Bertrand GUGGER

Gérant de TOGGG

La Crémation a eu lieu dans l’intimité familiale.

La famille remercie toutes les personnes qui prendront part à sa peine.

La caractèristique principale des plugins est leur habilité à fournir des fonctionnalités supplémentaires ou à modifier le fonctionnement de spip sans avoir à modifier le noyau (core) de spip.

L’aspect fondamendal de cette habilité est l’incorporation dans le “_SPIP_PATH” de la racine du plugin. Cela veut dire que tout find_in_path() et conséquemment charger_fonction() ou include_spip() sera capable d’aller chercher des éléments dans l’arborescence du plugin. C’est valable aussi bien pour des scripts .php que pour des squelettes .html, des images, etc.

Dès qu’il est activé, le répertoire du plugin devient prioritaire par rapport aux répertoires du noyau : ecrire/, dist/ et racine du site. Donc, par exemple, si le plugin fournit un inc/forum.php, c’est ce script qui sera inclus lors d’un include_spip(“inc/forum.php. Il viendra donc remplacer le script original du noyau. Cette capacité est toutefois à utiliser avec parcimonie et on lui préfèrera dans la mesure du possible les autres possibilité d’insertion par options, fonctions ou pipeline. En effet, un tel remplacement fait que le script correspondant du noyau devient “invisible” et ses mises à jour ne seront plus suivies. C’est pourquoi on appelle communément cette technique un carlsbad therapist “fork” (branchement).

Les répertoires des plugins restent néanmoins moins prioritaires que les répertoires squelettes. Ceci permet à l’utilisateur final de pouvoir fournir sa propre copie qui prendra le pas sur les plugins et le noyau. On peut dire ainsi que les plugins fournissent une localisation intermédiare entre le noyau (distribution standard) et les squelettes (fourniture propre à l’utilisateur sanuk shoes)

A noter que l’activation d’un plugin fournit une constante décrivant son répertoire : _DIR_PLUGIN_XXX, où XXX est le préfixe du plugin, qui est à utiliser dès lors qu’on veut forcer la recherche d’un élément au répertoire du plugin. Attention, cet élément ne sera alors plus surchargeable et on préfèrera les find_in_path() ou include_spip() sui laissent toute liberté à l’utilisateur de fournir ses propres élements.

How to Migrate to France & Start a Business

France lies in the heart of Europe and with its long tradition of high developed culture it attracts people of all age groups and different backgrounds. France is a destination for the sophisticated person in specific who is looking for the never experienced encounter of a different way of life. The strict centralistic structure of the land where all influences, governmental and cultural spread from Paris over the entire country, the effects of them become thinner the further you distance from the Capitol. For that reason you will find a unique array of opportunities that offers the vibrant lifestyle in Paris with its flair that is well-known throughout the world to the cozy country side idyll of the Provence or the lifestyle of the high society at the Cote d’Azure. Often students move to France for a limited time just to experience the typical French lifestyle. The approach to life itself with the attributes of hard work combined with extensive social life and of course food is appealing to the young person seeking different views of life before settling.

If you are looking to live there for the rest of your life you have different options and a good education provides you an advantage that can enable you to start even a business anywhere you like. A good education can be achieved today easily by using online masters degree programs. Choose courses that fit your likes as masters of health administration, master in finance or get an online mba degree, a communication degree, a criminal justice degree online or an mba in healthcare management. The possibilities are endless. If you intend to work in the ever expanding IT world you might select the information technology degree online.

For migrating to France with the intention of catching and participating in the unique vibrant lifestyle that is so different from the one of the New World and try to combine it with an own business, you will discover a vast number of options that definitely will satisfy the search for the uniqueness in life. With a merchant cash advance you might open up a home based business first catering the many stores and shops that embrace the expansions of the online merchandising. Assisting them in broadening their clients and showing them the unique opportunities the new age has to offer, you can scoop off the clients that are not familiar with these new trends. With this type of business you are able to offer all kind of online jobs: take part in SEO works, offer services like PPI calculator or help the many small businesses to compete in the corporate world by showing them how to use the internet effectively.

Spicing your life up and gaining the view of a so different culture is what France is all about. Have the experience of your lifetime and know what it means when people say c’est la vie.

De façon similaire aux config/mes_options.php et squelettes/mes_fonctions.php un plugin peut fournir des scripts .php qui seront inclus respectivement à chaque requète ou à chaque recalcul de page.

Cela se fait par les éléments <options> ou <fonctions> de plugin.xml. Le nom du script est donc libre mais pour la lisibilité du plugin on les dénomme couramment options_xxx.php ou fonctions_xxx.php

Au même titre que les config/mes_options.php et squelettes/mes_fonctions.php “centraux” on peut dans ces scripts :

• définir des constantes de base de SPIP
• fixer des variables de personalisation
• fixer una realizzazione siti web
• donner des fonctions qui surchargent les fonction_dist() simplement en nommant la fonction à l’identique sans le _dist (mécanisme “historique”) ou des fonctions chargées par charger_fonction(). En effet, cet utilitaire vérifie d’abord que la fonction n’est pas déjà définie. Si donc on en a donné une version dans ces scripts, c’est celle-ci qui sera utilisée.
• fournir des balises qu’elles soient en supplément ou surchargent une balise existante (…_dist()). Il suffit d’y fournir une fonction balise_MA_BALISE()
• définir des filtres, c’est essentiellement un fonction du nom du filtre supplémentaire ou surchargeant lefiltre_dist()

On peut évidemment le faire en mettant tout “en vrac” dans ces scripts mais pour la clareté de lecture on procède le plus souvent par include_spip(“balises/xxx.php”) ou include_spip(“filtres/xxx.php”) ceci étant laissé à l’entière discrétion du réalisateur.

RAPPEL : les “options” sont systématiquement chargées à chaque requète, les “fonctions” seulement lors du recalcul d’une page, exactamento san diego flooring. On placera donc dans “options” ce qui est nécessaires partout et notamment dans l’espace privé et dans “fonctions” ce qui est nécessaire seulement aux squelettes.

The Top French Technology Schools

Even though accounting schools in France tend to be largely and intensively sought after due to the many advantages they can bring to students once they graduate, technology schools also make for some of the best options a great number of people are thinking about choosing in terms of career triggers. If you are planning on either joining such a French technology school or you are simply curious to find out more about this topic, you have reached the right page. You are going to read some hopefully useful information on the top technology schools in France.

First, we have the University of Liverpool, which offers online courses and programs in terms of electrical engineering, electronics and computer science and even online master’s degree courses to both French and overseas students. Information Technology and Software Engineering are the main two fields students can choose from for their master’s programs here. The University has been founded in 1881 and it gave birth to no less than 8 Noble prize winners. There are around 3,000 students coming from more than 175 countries to the University of Liverpool in France in order to complete their master’s courses. Visit the official web site of the university and learn more here about the main programs offered there and read here all the details you need on accommodation and fees. Just like searching for free movies online, you could be also looking for alternatives of paying smaller fees as well.

The second choice you could be definitely looking into in terms of technological schools in France refer to the Ecole Polytechnique, which is an educational institution supported by the French state and t is also considered to be the most prestigious engineering school in France. The French elite in terms of science, industry and economy is being yearly trained here. Just like the best master of public health in the US or the dental hygienist schools are being judged and measured considering their performances and students’ satisfaction, the same can be said about the Ecole Polytechnique as well. The official scope of the University is to offer its students high levels of scientific training and also broad views of the outside world as well. Their courses and programs refer to undergraduate and graduate courses, master’s and doctoral programs and all courses are held in French. International students cam also benefit from the existence of the International program of the Ecole Polytechnique, featuring full academic year or shorter periods. Scholarships connected to the Socrates, Unitech and Erasmus frameworks are welcomed here. There are also advanced undergraduate and graduate studies which are part of a special regular pluriscientific 4-year curriculum of the École Polytechnique.

All in all, France has many swell technological schools you could attend. Just visit a smartpet shop, buy your dog or cat enough supplies to last for a whole semester or a while year, ask a friend to petsit your furry friend and buy your airplane ticket as soon as you can.

Les pipelines sont un mécanisme récent et extrèmement puissant qui permet aux plugins d’intervenir dans la fabrication des pages publiques et privées.

De façon très générale, une fonction pipeline récupère un “flux”, le modifie éventuellement puis le renvoie. Par exemple, pour un flux de type texte, elle peut analyser le texte qu’elle reçoit et y rajouter des morceaux comme elle le désire. Celà se fait le plus souvent par des expressions régulières. Attention, vu que le plugin n’est pas tout seul à agir sur ce flux, il est fondamental de renvoyer ce qu’on a reçu, modifié ou non.

Déclaration

Un plugin s’intercale dans un pipeline en déclarant sa fonction dans le tableau global $spip_pipeline. Attention, cette déclaration doit ajouter sa propre fonction précédée d’un pipe |, ceci afin de ne pas écraser les insertions des autres plugins. Pour les plugins, cela est fait automatiquement par l’administration plugins d’après le fichier de définition plugin.xml vu dans le chapitre suivant, donc pas de souci si on utilise ce moyen.

Les pipelines disponibles

Voir le script ecrire/inc_version.php pour une liste actualisée.

Nom	Type	Description	Flux	Défaut
affichage_final	P	Contenu final	Texte	f_surligne, f_tidy, f_admin
affiche_droite	E	Colonne droite	T1
affiche_gauche	E	Colonne gauche	T1
affiche_milieu	E	Colonne milieu	T1
ajouter_boutons	E	Boutons navigation	OB
ajouter_onglets	E	Onglets sous bouton	T2
body_prive	E	Corps de page	Texte
exec_init	E	Initialisation ?	T1
header_prive	E	Header	Texte	f_jQuery
insert_head	P	Header	Texte	f_jQuery
insert_js	P	js fichier ou inline	T3
verifie_js_necessaire	P	Booléen js nécessaire	T4
mots_indexation	F	Mots à indexer	T5
nettoyer_raccourcis_typo	T	Nettoyer raccourcis typos	Texte
pre_propre	T	Avant propre()	Texte	extraire_multi
post_propre	T	Après propre()	car insurance ex()
pre_typo	T	Avant typo()	Texte	extraire_multi
post_typo	T	Avant typo()	Texte	quote_amp
pre_edition	E	Avant éditer objet	T6	premiere_revision
post_edition	E	Après éditer objet	T6	nouvelle_revision
pre_syndication	P	Flux RSS	Texte
post_syndication	P	Flux RSS	T7
pre_indexation	F	Avant indexation	Texte
requete_dico	F	Recherche dictionnaire	T8
agenda_rendu_evenement	P	Rendu agenda	T9
taches_generales_cron	F	Tâches CRON	Cron
calculer_rubriques	F	Calcul des rubriques	Null

Types de plugins :

• P : espace public
• E : espace privé (ecrire/
• T : Texte ou Typographie
• F : Tâche de fond
  

  Types de flux

Type	Composition
Texte	Du contenu sous forme de texte
T1	array(’args’=>array(’exec’=>’…’),’data’=>’’))
T2	array(’data’=>$onglets,’args’=>$rubrique)
T3	array(“type” => “fichier/inline”,”data” => array())
T4	array(“page” => $page, “data” => “”)
T5	array(’args’=>array(’min_long’=>…),’data’=>array(mots))
T6	array(’args’ => array( ’table’=>’spip_…’, ’id_objet’=> … ), ’data’=>champs )
T7	array(lien, id_syndic, données)
T8	array(’args’=>array(’val’=>…,’min_long’=>…),’data’=>requète)
T9	array(’args’=>array(’evenement’=>$evenement, ’type’=>’ics/avec_heure/sans_heure’), ’data’=>$sum)
OB	Objet Bouton
Cron	Tableau de délais (secondes) par tâche

Tout cela est assez compliqué et en pleine mutation, il faut malheureusement souvent étudier le code du core ou des exemples life insurance quotes d’autres plugins pour comprendre comment utiliser les pipelines complexes. Les types “texte” sont en général plus faciles à mettre en oeuvre.

A technological history of France

Science and technology have advanced greatly all over the globe; there is hardly any country that does not depend on some type of technology for its everyday use. When we speak of science and technology, we normally picture very modern countries with huge neon signs and tall skyscrapers. This, however, is a misconception. even countries that don’t have such things, agricultural economies or countries well known for their arts and historical significance, often have some contribution to make to the world of c=science and technology. When we speak of technologically advanced nations, we immediately think of the United States, Japan and China. However, we miss out a very significant contributor in this case; France. It is true that when we think of this country, we think of the Eiffel tower, we also think of fancy perfumes and of course, the ever so famous French fashion industry.  However, we fail to acknowledge the contributions that this country has made to technology and science. Today I will be discussing briefly the technological history of France.

There are a number of different fields of science and technology that France is actually quite prominent in. Since these types of technology do not include very popular products like smartphones and laptops, we are unaware of the country’s performance in this respect. Did you, for instance, know that France is the leader in nuclear technology exports? We all probably know about bulging disc issues a lot more than we know of this fact!

Everyone knows of the bullet trains in Japan and the high speed transport that is now popular worldwide. we are all aware of the numerous automobiles that are present in the world. However, did you know that such methods of transport originated in France?

The French are also known for their contribution to the photography industry, not only in terms of fashion shoots, but also in terms of the development of this technology. If you think you will be taking a payday loan or a pikalaina as the French would call it, to purchase a brand new camera, you owe it to the French!

France promotes the research in the fields of science and technology by the numerous science and technology universities that are present in the country. This research is what has truly enabled France to become the source of the invention of so many useful items without which we would not be able to survive. Refrigerators, for instance, exist thanks to the hard work of many French scientists. Internal combustion engines too exist because of the French.

It can be safe to conclude that we cannot assume that we know all of a country’s strengths and contributions without fully studying not only its obvious traits but also the various traits that the country may have that are simply not highlighted. In this case, I believe not many of us thought that the fashion capital of the world had anything to do with science and technology.  Yet, it’s evident that France has quite a rich history of technology that awaits further research by all those who are interested!

 

Exactement comme le fait le noyau, un plugin peut fournir des action ou des exec qui seront directement chargeables par requête url.

En théorie, un exec n’effectue pas de modification par lui même mais les délègue à des action qui ne devraient elles-même pas faire d’affichage. Ce n’est toutefois pas toujours respecté et on retiendra surtout qu’un exec se déclenche depuis l’espace privé ecrire/ alors qu’une action l’est depuis l’espace public, la racine du site.

exec

Ces scripts son fournis dans un sous-répertoire exec/. Le script exec/xxx.php est lancé par l’utilisateur final en demandant l’url http://le.domaine.tld/ecrire/?exec=xxx[&param=blah]

Il doit fournir une fonction principale exec_xxx() ou exec_xxx_dist() (si on veut la rendre surchargeable) qui sera le point d’entrée chargé par ecrire/index.php. Cette fonction ne prend pas d’argument. Elle récupèrera les paramètres éventuels dans la requète par appel de _request() (GET ou POST

Un plugin peut ainsi fournir des exec supplémentaires ou surcharger ceux provenant du noyau.

action

Exactement de la même façon de un travel insurance, un plugin peut fournir des action par l’intermédiaire d’un script action/xxx.php.Une action sera lancée par l’url http://le.domaine.tld/?action=xxx[&param=blah]

La fonction que ecrire/public.php lancera dans ce script est : action_xxx() où xxx est le nom de l’action. Comme pour exec, cette fonction ne prend pas d’argument mais récupère ses paramètres éventuels par _request()

Une action précise de plus un “redirect”, l’url qui doit être lancée lorsqu’elle s’achève. Cela passe par la globale $GLOBALS['redirect'] ou par le paramètre d’url de même nom.

Il existe de plus un mécanisme optionnel de sécurisation lié aux actions. Celui-ci passe par la fonction securiser_action() et utilise un argument spécifique à l’action (arg) et un hash calculé d’après l’auteur et cet arg grâce à la fonction calculer_action_auteur()

Comme pour les exec un plugin peut ainsi fournir des action supplémentaires ou redéfinir celles existantes.

Nommage

Attention, le nom d’un exec ou d’une action est unique dans tout le spip, il est donc important de veiller à l’unicité du nom qu’elle utilise si on veut éviter toute “collision”, bien sûr, dans la mesure où l’intention n’est justement pas de surcharger un autre exec ou action…

Un principe couramment adopté est de “préfixer” le nom de l’action ou de l’exec un water softener review par un mot unique, la tendance est d’utiliser le propre préfixe du plugin dont l’unicité est assurée. Cela donnera quelque chose comme action/prefixe_xxx.php ou exec/prefixe_xxx.php

Voir à ce sujet la convention en cours d’élaboration

French Technology Companies to Watch in 2012

As there is no dearth of coach hire services; there is also no dearth of technology companies in France. With the advancement of science and technology in Europe, a lot of technology companies have been coming into being each year in different parts of Europe. France is not an exception in this regard. As people are interested in the top ranked online MBA programs; people are also interested to know about the top ranked technology companies in France.

There are a lot of such companies. As anti aging skin care products can be divided into different types; the technology companies in France can be divided into different types. Two of the most prominent types are:

Software companies
Video Game companies

Some of the most important technology industries from these categories are discussed below. These are some of the companies in France to watch in 2012.

As you are interested to know about the best sell boats services; you are also interested to know about the well-known French Software industries. OVH is one of them. It is a web hosting service that is owned privately. This is well-known for its mutual hosting, VOIP services, dedicated servers and domain names. You will find all these services in a new form in 2012. This software farm has gained popularity due to its constant adaptation to the needs of its consumers. As Friendswood air conditioning can offer you a better service, this web hosting company can offer you a lot of services.

Evite is another well-known farm that you will find in a new look in 2012. This is a website specially meant for social-planning. It produces, sends and manages invitations in the internet. As people are always in search of high quality academic institutions for bachelors in criminal justice; people are also in search of high quality software farms. So, people are leaning towards it for a better service.

As Melaleuca Foundation restores the hope of people in disaster; the video game industries in France also restore the hopes of so many people around the world. Each New Year, a lot of new games are coming into being to entertain the people worldwide. As trazer amor de volta can help you out of different problems; these companies also help the games lovers out of their daily problems by giving them monetary relief.

Adeline Software International is known for its wonderful video games and people are eagerly waiting for its 2012 versions. This is basically a game developer company that is working since 1993. Since then, its motto is the sheer entertainment of its consumers.

BigBen Interactive is another important name in the field of video games. As medical aid is important to save the physical health of the people; BigBen Interactive games are also important to save the mental health of the people. Video game lovers around the world are crazy about its games.

So, these are some of the old French technology companies to watch in their new form in 2012. As it is not possible to mention the names of all the institutions for accredited online MBA; it is also not possible to mention all the names of the technology companies.

La gestion des textes en pludieurs langues par un plugin est tout à fait similaire à celle existant dans le noyau.

Il suffit de fournir un sous-répertoire lang/ dans lequel on place des fichiers de traduction comme chose_fr.php, chose_en.php, etc.

Ces fichiers rajoutent au tableau global de nom $GLOBALS['idx_lang'] les chaînes traduites indicées par le mnémonique de traduction. Par exemple, le plugin crayons fournit une traduction allemande dans le fichier lang/crayons_de.php ainsi :

$GLOBALS[$GLOBALS[‘idx_lang’]] = array( ‘annuler’ => ‘Widerrufen’, ‘editer_@type@_@id@’ => ‘@type@ @id@ voll &auml;ndern’, …. );

Important : on voit ici que $GLOBALS['idx_lang'] est bien le nom de la globale et non pas la globale elle-même.

On utilise ensuite ces chaines traduites en les préfixant par le nom du fichier langue.

Dans les squelettes : <:chose:mnemonique:>, par exemple ici <:crayons:annuler:>

Dans le PHP en utilisant la fonction _T() comme _T("chose:mnemonique")

Les mnémoniques avec des, anthony morrison scam @param@ sont des chaines paramétrées. Elles permettent d’incorporer des valeurs variables dans la traduction. Par exemple, la 2ème ligne de l’exemple tiré de crayons s’utilise en fournissant 2 variables comme arguments supplémentaires à _T() : _T("crayons:editer_@type@_@id@, $type, $id). Si type vaut “article” et id 17, on obtiendra : “article 17 voll ändern”

Il est impératif d’utiliser dans les traductions des entités html ou numérique pour les caractères accentués, comme ici &auml ; pour ä.
A titre de curiosité, la première chaîne en arabe devient :
’annuler’ => ’&#1573 ;&#1604 ;&#1594 ;&#1575 ;&#1569 ;’
qui donne 'annuler' => 'إلغاء'

Si la traduction n’existe pas, le mnémonique outdoor garden fountain sera utilisé, les tirets bas (underscore) étant remplacés par des espaces.

A noter que le nom du fichier de traduction qui fournit le préfixe précédant les deux-points est en fait indépendant du nom du plugin. On peut même fournir plusieurs fichiers de préfixes différents pour un même plugin.

Un plugin est déterminé par sa pièce centrale : le fichier plugin.xml situé à sa racine.

Ce document suit la syntaxe xml. Son élément racine est <plugin>. Attention, il doit utiliser uniquement des caractères ASCII (non accentués) pour assurer sa portabilité. On doit donc utiliser des entités html ou numériques pour tout autre caractère.

Balises de description :

Elément	Description	Obligatoire	Typo
<nom>	Le nom du plugin tel qu’il apparaitra dans le panneau de configuration.	X
<version>	La version du plugin	X
<etat>	Etat du plugin, parmi dev (developpement), experimental, test, stable.	X
<auteur>	Le ou les auteurs du plugin. Vous pouvez utiliser les raccourcis typo et chaînes de langue dans ce champ.		X
<description>	Décrit ce que fait le plugin.		X
<lien>	Liens html vers la homepage ou la doc du plugin qui donne plus d’information sur son fonctionnement.		X

Balises d’implémentation :

Elément	Description	Obligatoire	Typo
<prefix>	permet de définir le nom des préfixes de fonction définies par le plugin. Pour des raisons de cohabitation saine avec ses petits copains plugins, toutes les fonctions propres à votre plugin devront commencer par ce préfixe. Regardez les exemples du plugin « Rien » pour voir comment faire. La seule contrainte est de préfixer les declarations de fonction et d’ecrire vos appels de fonction sur le mode $truc = Rien_ma_fonction($val);.	X
<options>	permet de définir un fichier qui sera chargé à chaque hit, comme l’était le fichier mes_options.php.
<fonctions>	permet de définir un fichier qui sera chargé à chaque recalcul de page, comme l’était le fichier mes_fonctions.php.
<pipeline>	permet de définir un point d’insertion du plugin dans un pipeline de traitement.

Cet élément <pipeline> inclut alors les sous-éléments suivants :

Elément	Description	Obligatoire	Typo
<nom>	donne le nom du pipeline ou insérer l’appel au plugin.	X
<action>	donne le nom de la fonction à appeler (sans le préfixe qui sera ajouté automatiquement par SPIP). Si non précisé, ce sera le nom du pipeline soit une fonction : prefix_nom_pipeline()
<inclure>	Nom du fichier à inclure pour que la fonction soit disponible. Si non précisé, la fonction doit être disponible dans le script options

Les tags <nom>, <version> et <prefix> sont obligatoires. Les autres sont facultatifs. Il n’est pas autorisé d’utiliser un nom de fonction identique au nom de préfixe (La fonction Rien_rien() sera refusée parce que c’est comme ca – pour les curieux je peux raconter l’histoire… -), ni d’utiliser les noms de fonctions install, uninstall et configure qui sont réservés pour des évolutions que vous devinez déjà.

Pour des raisons de performance, il est conseillé de découper proprement les fonctions de son plugin dans des fichiers séparés, afin que seules les fonctions requises soient chargées lors des include.

Et pour plus de réponses à vos questions n’hesitez pas à regarder tous les exemples disponibles sur spip-zone.

Voir description initiale sur contrib dont cet article reprend des extraits.

SPIP est un CMS unique en son genre.

Au delà de son fonctionnement qu’on peut qualifier de “data driven”, à savoir piloté par les données (les fameuses BOUCLES), il a toujours fourni en première ligne les moyens de “customiser”, adapter son fonctionnement et sa présentation au goût et aux besoins propres au site.

C’était d’abord la possibilité de fournir ses propres “squelettes” (templates), d’adjoindre des fragments de php spécifiques et de surcharger les fonctions de base du core (les xxx_dist() que nous verrons plus loin).

La version 1.9 introduit un mécanisme complémentaire, les plugins. Ils sont issus de la volonté d’ouvrir spip à des fonctionnalités supplémentaires sans alourdir le noyau de SPIP (le core). La tendance actuelle est même d’alléger ce core en transférant les fonctionnalités optionnelles dans des plugins. SPIP 2.0 devrait être réduit et livré avec une collection de plugins “de base” que l’utilisateur activera selon ce qu’il utilise réellement. Par exemple, il est question que les brêves ne soient plus dans ce core mais dans un plugin optionnel. En effet, seule une partie des installations les utilisent et il est préférable de ne pas alourdir le système de base pour ceux qui n’en ont pas besoin.

Mais déjà, SPIP 1.9 a complètement réorganisé les répertoires qui le constituent afin de bien séparer les éléments selon leur durée de vie, le fait qu’il soient modifiables et leur appartenance à ce qui est propre ou spécifique au site ou au code de base. Un des autres objectifs visés ici est la possibilité de mutualiser le noyau : que plusieurs sites puissent partager une base de code commune.

Etudions d’abord cette nouvelle organisation des répertoires, de ce qui appartient à SPIP à ce qui est propre au site, de ce qui reste constant à ce qui bouge.

---

DISTRIBUTION

---

racine du site

La racine a été complètement vidée et ne contient pratiquement plus que index.php qui redirige sur spip.php, c’est maintenant l’unique point d’entrée de la partie publique du site.

inc-public.php3 est un fichier fantome pour assurer la compatibilite ascendante.

.htaccess optionnel pour l’url rewriting essentiellement.

win_png.htc et rien.gif pour assurer la transparence png avec MSIE

ecrire/

Ce dossier contient maintenant l’ensemble des fichiers interprétables côté serveur (PHP et MySQL) et ce, aussi bien pour le coté “public” (sous-dossier public/) que pour le coté “privé”.

Le nom de ce dossier est historique, c’était auparavant là où on trouvait le code permettant de modifier le contenu du site. Paradoxalement, c’est un dossier maintenant immuable, on “écrira” plus jamais dedans. Dans une installation normale, il ne contient que les scripts livrés par la distribution, il est quasi impératif de ne pas y faire de modification.

Son script index.php est le point d’entrée de ecrire/, la partie privée du site.

Voyons la documentation de spip.net pour le détail.

dist/

Il contient tous les fichiers livrés au client (HTML, Javascript, feuilles de style, images de différents formats) ainsi que les patrons de mise en page nommés squelettes. Ces squelettes sont interprétés coté serveur afin d’envoyer au client un texte purement MIME (la plupart du temps du HTML, mais aussi du RSS, du SVG … voire du JS).

Ce sont les modèles standards livrés avec SPIP, ils ne doivent eux aussi pas être modifiés mais remplacés en les copiant dans squelettes/

Détail dans la documentation de spip.net

oo/

Ce dossier fournit le mode “accessibilité” de spip (spip en mode texte), Il contient essentiellement un index qui renvoie dans le système standard.

---

ADAPTATION

---

config/

Ce dossier créé à l’installation contient le script de connection à la base de données, connect.php et le script fixant le mode des fichiers créés par le serveur, chmod.php.

C’est aussi ici qu’on place les options universelles du site, mes_options.php

IMG/

Il contient tous les documents originaux (taille réelle) du sites. Il est subdivisé en sous-dossiers par types de documents.

A l’installation, il ne contient que les documents de test pour la fabrication des images.

squelettes/

C’est ici qu’on dispose tous les fichiers scripts, images, formulaires … propres au site en suivant la même structure que ecrire/ ou dist/. Par exemple, pour redéfinir le sommaire du site, on y copie/adapte le sommaire.html de la dist/.

On met là notamment, le script mes_fonctions.php qui est chargé à chaque recalcul de page. A noter qu’il est possible de faire un xxx_fonctions.php qui sera chargé uniquement lorsque la page xxx sera demandée, exemple sommaire_fonctions.php

A l’installation, ce dossier n’existe pas, il faut le créer.

plugins/

Ce dossier qui est aussi à créer par soi-même reçoit les sous-dossiers de chaque plugin. Par exemple, le plugin crayons est placé dans plugins/crayons/.

C’est ce dossier qui fait l’objet de cette formation.

---

TEMPORAIRE

---

local/

Il contient tous les fichier (re-)calculables à partir des documents et données du site.

Il s’agit essentiellement des caches d’images réduites. On y trouve aussi les caches calculés par certains plugins comme coloration_code.

Ce dossier peut être vidé, cela ne coûtera que son recalcul.

tmp/

Ici sont stockés tous les fichiers temporaires comme les caches de squelettes, les sessions, les logs etc.

Il contient aussi le sous-réperoire dump/ où sont effectuées les sauvegardes de données.

Ce dossier peut être vidé à tout moment. Voir Étendre SPIP
et Contribuer au développement de SPIP

En version 1.9, le fonctionnement de SPIP a été rationalisé complètement. Il n’existe plus maintenant que 2 points d’entrée pour le site :

• Public : index.php alias spip.php à la racine
• Privé : ecrire/index.php

La page demandée est précisée dans un cas comme dans l’autre par les arguments GET ou POST associés à la requète. Nous verrons plus loin quels sont les principaux.

A de très rares exceptions près (a priori customisation), tous les autres scripts présents dans l’arborescence ne sont pas exécutables directement mais uniquement incluables. Ils sont d’ailleurs en général “protégés” par un test initial :

if (!defined(“_ECRIRE_INC_VERSION”)) return; // securiser

Ceci vérifie que la constante _ECRIRE_INC_VERSION est définie, ce qui ne sera pas le cas si le script est chargé directement.

Cette constante est définie par ecrire/inc_version.php qui constitue la clé de voute de l’architecture SPIP. Ce script est en effet inclus pratiquement en tout début par les index public ou privé.

Pour l’index public, cela passe par l’inclusion initiale de ecrire/public.php : mis à part cet include, on peut voir que cet index est pratiquement vide.

ecrire/inc_version.php

Ce script est commun à tous les composants de spip. C’est lui qui procède aux définitions, initialisations et inclusions de base qui déterminent le fonctionnement de tout le reste. Il initialise les constantes et les variables globales nécessaires au fonctionnement de SPIP, notamment celles assurant sa portabilité sur les différentes plates-formes.

Assez tôt lors de son chargement, il inclut les fichiers :

• inc/utils.php, où figurent les fonctions indispensables à SPIP (voir plus loin)
• le script optionnel hors distribution nommé mes_options.php qui permet de moduler cette initialisation sans avoir à modifier le fichier inc_version.php.

Déroulement du code :

• définition de la constante “clé” _ECRIRE_INC_VERSION vue plus haut
• définition des constantes représentant les répertoires de base de SPIP et en particulier _DIR_RACINE, racine du site, et _DIR_RESTREINT, répertoire ecrire/ sur lesquelles toutes les autres constantes de dossier seront basées, voir le détail dans le code.
• recherche, sans encore l’inclure du script mes_options.php historiquement dans ecrire/ et dans une installation normalisée dans config/
• initialisation de l’ensemble des globales de base de spip dont les variables de personalisation, voir index technique de spip.net
• inclusion de inc/utils.php
• inclusion de mes_options.php optionnel
• appel de spip_initialisation() si mes_options ne l’a pas déjà fait (en particularisant éventuellement cette initialisation). Elle prend en paramètre les 4 répertoires de base de spip : config/, IMG/, tmp/ et local/ et :
  • définit à partir d’eux tous les répertoires nécessaires à spip et les droits qui leur sont affectés.
  • récupère et désinfecte tous les arguments de la requète : GET, POST, COOKIES et environnement serveur.
  • installe le module de lecture/écriture/suppression de fichiers nécessaire entre autres à tous les caches
  • commande le chargement des métas, la configuration de spip, depuis la base de donnée … et incidemment la connection à cette base.
• charge les plugins à partir du cache tmp/charger_plugins_options.php en regénérant si nécessaire ce script.

Si l’on est en cours d’installation, inc_version.php a un fonctionnement particulier que nous n’aborderons pas ici.

inc/utils.php

Ce script ne réalise aucune action mais définit les fonctions utilitaires fondamentales de spip. Il y en a plus d’une cinquantaine ! Voici les plus importantes :

• find_in_path() : afin de permettre la customisation du site, le plupart des fichiers, que ce soit script, squelettes ou fichiers servis comme les images, sont recherchés dans le “path”, dans l’ordre, les répertoires :
  • squelettes : ceux optionnellement définis dans $GLOBALS['dossier_squelettes'] et squelettes/
  • des plugins activés
  • ecrire/
  • dist/
  • racine du site
• include_spip() : permet d’inclure un script php selon le schema précédent, donc de le surcharger en fournissant une alternative (communément appelée “fork”)
• charger_fonction() : scenario identique mais adapté à une fonction, celle-ci pouvant être définie n’importe où. Le mécanisme cherche d’abord la fonction sous son nom() puis si pas trouvée, sous nom_dist() comme c’était fait historiquement (tous les fichiers de Spip sont chargés par ces deux dernières fonctions).
• spip_log() : utilitaire permettant de faire des logs, typiquement dans tmp/spip.log, important pour la mise au point et le suivi d’un site. A noter qu’étant basée sur un var_export(), on peut lui passer tout type de paramètre à tracer.
• spip_query() : toutes les requètes SQL doivent passer par cette fonction. Important, il faut préciser les noms des tables comme spip_nomtable, la fonction se chargeant de remplacer “spip_” par le véritable préfixe des tables de l’installation.
• _q() : cette fonction protège les variables incluses dans une requète SQL (échappement). Il est fondamental de passer toute variable utilisée dans une requète SQL si on veut éviter des attaques par injection
• _request() : permet de récupérer des variables argument de la requète, sans se préoccuper qu’elles viennent d’un GET, POST ou COOKIE et en étant assuré qu’elles sont “nettoyées” correctement.
• spip_initialisation() vue plus haut

config/mes_options.php

Ce script optionnel permet de configurer les constantes, variables et fonctions de spip “à sa sauce”.

On peut :

• y adapter les variables de personalisation (globales), par exemple les dossiers squelettes spécifiques ou le type d’url propre utilisé.
• redéfinir des fonctions dépendant du mécanisme xxx_dist() ou plus généralement chargées par charger_fonction()
• définir des “constantes” PHP : en effet, une fois définie, une constante PHP ne peut plus être changée dans la session

En particulier, il est possible dans ce fichier personnel d’invoquer la fonction spip_initialisation pour définir les répertoires de données et, par exemple, disposer ainsi de plusieurs sites sous SPIP utilisant une seule distribution (l’appel standard de cette fonction, plus loin dans inc_version.php, sera automatiquement neutralisé).

Argument de requète principal

Comme on l’a vu, les seuls accès à spip se font par index.php à la racine ou dans ecrire/. La page demandée est précisée par les arguments accompagnant cette requète. Ce peut être par GET ou POST. Ces arguments peuvent être explicites ou générés par l’url rewriting lorsqu’on utilise les urls propres.

Il s’agit de :

• page : c’est l’unique argument pour l’espace publique. Il précise la page demandée comme sommaire (le défaut), article … Il est interprété par ecrire/public.php pour déterminer le fond principal (le squelette.html du même nom que l’argument page) à renvoyer après l’avoir “rempli” en fonction des autres paramètres de la requète comme id_article.
• action : bien que ce paramètre soit aussi interprété par ecrire/public.php , il s’agit ici d’une requète effectuant (si tout va bien) une modification dans les données du serveur. SPIP fournit un mecanisme permettant de sécuriser une telle requète. Le script qui sera utilsé est action/xxx.php où xxx est la valeur de action
• exec : c’est typiquement l’argument d’une url “privée”. Sa valeur xxx donne le script ecrire/exec/xxx.php qui sera utilisé.

Voir Étendre SPIP