Le plugin ACS

Installation

-  L’installation des plugins est automatisée depuis l’interface d’administration de SPIP à partir de SPIP 2. Pour celà, vous devez avoir crée un dossier plugins puis un sous-dossier plugins/auto à la racine de votre site web. SPIP 2 affiche alors un nouveau sous-menu du menu Configuration : « Configurer les plugins ». Pour installer ACS, il vous suffit alors de fournir l’adresse du fichier zip du plugin, de valider (le plugin est copié dans le dossier plugins/auto), puis d’activer le plugin ACS (c’est la procédure standard d’installation de plugins avec SPIP depuis SPIP 2).

-  Pour les versions plus anciennes de SPIP (versions 1.9.n), téléchargez le plugin, puis copiez-le dans le dossier plugins à la racine de votre site SPIP.

ATTENTION : ACS exige php5, qui n’est pas activé par défaut chez tous les hébergeurs.
Cette page de wiki explique comment activer php5 chez différents hébergeurs.
Si php5 n’est pas activé, vous obtiendrez une page blanche.

Une fois le plugin ACS téléchargé, installé, activé, et configuré, le webmestre (et les personnes qu’il autorise) ont accès à un nouveau choix du menu Configuration : le sous-menu « Configurer le site ».

ACS pour le webmestre d’un site SPIP

Afin d’être immédiatement utilisable par les webmestres non spécialistes des squelettes SPIP, ACS inclut des jeux de squelettes SPIP configurables prêts à l’emploi (les modèles ACS), comme le modèle Cat (Catalogue de composants ACS).

Pour commencer, le plus simple est d’aller sur l’onglet Composants, et de configurer les composants de base du modèle ACS actif.

Dans le modèle Cat, par exemple, il suffit de configurer le composants Fond pour définir des valeurs par défaut pour tout le site, et de configurer le composant Onglets pour activer les valeurs par défaut proposées pour une navigation par onglets.

Utiliser les pinceaux d’ACS

Si le plugins « crayons » est installé, tous les composants d’un modèle ACS sont éditables directement depuis le site public : il suffit de cliquer sur le pinceau qui s’affiche au survol d’un composant (lorsque le cookie de correspondance" d’un administrateur ACS est activé depuis la partie privée de SPIP). Pour un usage optimal des pinceaux ACS, il est recommandé d’installer également le plugin « Palette », qui permet de changer les couleurs en cliquant sur une roue de sélection des couleurs, et donc sans être obligé de connaître leurs codes html.
Cette fonction extrêmement puissante permet de très rapidement réaliser le design d’un nouveau site ou de modifier de A à Z le look d’un site existant à l’aide d’un « clickodrome », sans éditer le moindre squelette SPIP,

ACS pour les développeurs de squelettes SPIP

ACS est prévu pour être utilisé conjointement avec tout squelette SPIP, dans lequel vous pouvez facilement intégrer vos nouveaux composants personnalisés ou des composants existants du modèle ACS actif [1].

Adapter un composant existant

ACS utilise le système de « surcharge » (override) de SPIP pour ses composants : les composants inclus dans le ou les jeux de squelettes choisis en Squelette(s) sur l’onglet Administration d’ACS « overrident » les composants éponymes du modèle ACS actif.

Pour développer de nouveaux composants comme pour perfectionner ou personnaliser un composant existant, on a donc tout intérêt à définir un dossier de squelette dans lequel on crée un sous-dossier composants contenant uniquement les nouveaux composants personnalisés. ACS permet de définir plusieurs niveaux de « surcharge » (override) : on peut donc séparer complètement et proprement les éléments de squelettes téléchargés des éléments personnalisés.
(Il est donc inutile (et déconseillé) d’aller modifier directement les composants inclus dans la distribution du plugin.)

Les composants des modèles ACS inclus dans la distribution du plugin ACS fournissent de nombreux exemples de code réutilisable pour développer de nouveaux composants.

Contribuer

Le plugin ACS sera d’autant plus apprécié que le choix de composants et de modèles sera important et diversifié. Il est developpé sur SPIP-zone, le référentiel de code officiel de SPIP. Un site communautaire lui-même motorisé par la version en cours de développement d’ACS a été mis en place pour y regrouper la documentation, une FAQ, les adresses de téléchargements, ...