Organisation des dossiers à la racine d’un projet SPIP

Dépendances

Les dépendances des trois plugins s’organisent comme suit :

• fonctions : le plugin fonctionnel est optionnel et indépendant. Il peut avoir d’autres dépendances fonctionnelles, mais n’a pas de dépendance avec les autres plugins du projet. En revanche s’il est présent le site ne peut pas fonctionner sans lui.
• squelettes : les squelettes nécessite les fonctions si ce plugin est présent. En effet, lorsque c’est le cas, les squelettes vont utiliser des balises ou des objets ajoutés spécifiquement pour ce site, il y a donc dépendance.
• theme : le thème nécessite les squelettes car le graphisme du site s’applique souvent à une structure HTML et/ou des classes CSS bien particulières à ce site, et qui sont justement définies dans les squelettes.

On a donc : fonctions nécessité par squelettes nécessité par theme.

Nommage / préfixage

Le préfixe des plugins doit être singulier, de manière à limiter les équivoques et faciliter l’activation ou la désactivation par le gestionnaire de plugins.
Ainsi, le nom du dossier “squelettes/” sera le même que celui d’un autre projet, mais son préfixe devra être différent.

Tout comme il est conseillé sur SPIP-Zone, et même si ce n’est pas du tout obligatoire, il est préférable pour limiter les confusions de nommer le nom du dossier du projet de la même manière que le préfixe de base.

Ainsi, si le projet s’appelle par exemple “Mon super projet”, alors le dossier du projet ET le préfixe de base pourrait être “msp” ou “monsuperprojet”.

Ensuite le plugin fonctions (ou core) pourrait avoir comme préfixe : msp_core,
le plugin squelettes pourrait avoir comme prefixe : msp_skel
et le plugin thème pourrait être préfixé : msp_theme.

Ce qui donnerait la structure finale suivante :

racine du site
    \_ plugins
        \_ msp
            \_ core (préfixe : msp_core)
            \_ squelettes (préfixe : msp_skel)
            \_ theme (préfixe : msp_theme)

Cas d’un site complexe avec une évolution des squelettes dans le temps

Toujours dans l’analogie avec SPIP-Zone, il est conseillé de versionner le projet plugin par plugin.

En effet, au cours du temps, il se peut parfaitement que le site ne change pas du tout fonctionnellement (les champs utilisés restent les mêmes), mais que le contenu que l’on veut présenter (les squelettes) ou la manière de l’afficher (le thème) demande des évolutions. Ou inversement !

Il n’y a donc pas de liaison obligatoire entre les changements. Voilà pourquoi si l’on fait une version différente du squelette, ou si l’on change complètement le thème graphique, on versionnera à l’intérieur de ces dossiers.

Proposition de structure :

racine du site
    \_ plugins
        \_ msp
            \_ core
            |   \_ v1
            |   \_ v2
            \_ squelettes
            |   \_ v1
            |   \_ v2
            \_ theme
                \_ v1
                \_ v2

Avantages / inconvénients