Squelette Koinós

Introduction

Ce squelette est distribué sous forme de plugin. Il nécessite d’autres plugins, qui sont décrits dans le paquet.xml et seront donc automatiquement installés.

Après une présentation de l’historique et des décisions éditoriales ayant conduit à la construction de ce squelette, nous présenterons les choix techniques. Puis nous ferons un tour des différentes pages, en expliquant, si besoin, comment configurer le squelette.

Origine : créer un support d’information local et indépendant sous logiciel libre

L’idée du squelette Koinós est née en 2013, pour répondre à la nécessité de créer un support d’information local et indépendant, en l’occurrence dans la vallée du Cousin, dans l’Yonne, en Bourgogne : https://www.valleeducousin.fr/.

Pour s’affranchir des supports locaux habituels

En effet, dans ce territoire [1] comme dans beaucoup d’autres, les principaux supports d’informations écrits se résument à trois catégories :

• la presse régionale, qui soigne son audimat avec du sport et des faits divers, tout en évitant de s’engager sur des sujets « sensibles », par exemple sur des projets économiques pouvant avoir des répercussions écologiques négatives ;
• les supports officiels des collectivités territoriales (bulletins communal, intercommunal, du conseil général et du conseil régional) dont l’objet principal est la valorisation des actions politiques ;
• les « gratuits » dont le contenu inégal doit rester suffisamment neutre pour en garantir le financement par les encarts publicitaires.

Pour s’affranchir des réseaux sociaux dominants

On ne compte plus les associations, les personnes physiques, voire les institutions officielles qui ont recours aux réseaux sociaux habituels pour communiquer.

Si ces outils clé-en-main semblent n’avoir que des avantages (facilité d’utilisation, gratuité, interconnexions)... ils sont en réalité incompatibles avec la notion d’indépendance, au moins pour quatre raisons principales :

• si c’est gratuit... l’utilisateur·trice est « le produit » : toutes ses données sont revendues, y compris et surtout les données personnelles ;
• l’encodage « propriétaire » : impossible de savoir quels algorithmes se cachent dans leur code. Rigidité d’utilisation. Contenus contextuels indésirables ;
• la position de monopole : la facilité d’interconnexion des réseaux dominants reprend le principe d’une nasse à poissons, d’où l’on ne peut plus ressortir ;
• le stockage physique des données : leurs serveurs se situent dans des pays dont la législation ne protège pas assez les utilisateurs·trices quant au devenir de ses données : droit de modification ou même de suppression.

D’où le choix de SPIP, un logiciel libre particulièrement accessible.

Offrir un panel d’outils collaboratifs efficaces

Dès le départ, le squelette a été pensé de façon générique, pour être déployable partout, autour de trois principaux objets éditoriaux : articles, images, événements.

Notez que la création d’un agenda événementiel à l’échelle du « territoire » a rapidement constitué le cœur et le succès du projet, tant ces infos étaient éparpillées.

A celles et ceux qui font vivre un « territoire »

Le squelette Koinós s’adresse principalement à trois catégories d’utilisateurs·trices :

• Des habitant·es, militant·es, érudit·es, poètes... qui souhaitent publier et partager des articles localement (outil journal), ou relayer des événements (outil agenda) ;

• Des responsables d’association, structures locales, artisans, productrices et producteurs locaux qui souhaitent :
  • Présenter leur structure (outil annuaire) ;
  • Indiquer les évènements que ces structures organisent (outil agenda) ;

• Des photographes, peintres, artistes qui mettent en valeur le territoire par leurs créations, qui souhaitent essentiellement publier des images (outil albums), annoncer leurs expos (outil agenda).

Partis-pris

Outils de base : journal, agenda, annuaire, album

Le squelette propose par défaut les fonctionnalités suivantes :

• Journal : une (ou plusieurs) rubrique(s) (avec sous-rubrique) de type « journal » avec :
  • La possibilité de mettre un ou plusieurs articles en valeur sur la page d’accueil « À la Une » ;
  • La possibilité d’actualiser les articles via un usage détourné des forums, les actualisations étant alors visibles sur la page d’accueil et en haut des articles concernés.
• Annuaire : Une rubrique de type annuaire qui utilise les fonctionnalités du plugin « Coordonnées ». Chaque activité ayant une page dans l’annuaire peut y annoncer ses événements, qui apparaîtront aussi dans l’agenda.
• Agenda : Une page regroupant l’ensemble des évènements (plugin Agenda) du site, évènements qui peuvent être rattachés :
  • Soit aux articles du journal ;
  • Soit aux articles qui constituent l’annuaire ;
  • La possibilité de mettre un ou plusieurs événements en valeur sur la page d’accueil « À la Une ».
• Albums : Une page présentant l’ensemble des albums, avec :
  • La possibilité de mettre un ou plusieurs albums en valeur sur la page d’accueil « À la Une » ;
  • Une page spécifique par album.

Par ailleurs

• Une rubrique « à propos » avec une présentation spécifique du site est possible.
• Le pied de page peut contenir quelques textes, gérés avec le plugin Page Unique

Sobriété graphique : minimaliste, aéré et accessible

Le travail de refonte graphique effectuée en 2020-2021 a conduit aux choix suivants :

• design responsive (cela allait de soit !) ;
• limitation des couleurs : blanc, noir, gris, bleu ;
• grande écriture et grande aération / espacements conséquents ;
• accessibilité, dans la mesure de nos compétences, toute suggestions d’amélioration étant la bienvenue.

Technique : peu de dépendances

• Utilisation du framework Z et découpage du code en de nombreuses inclusions ;

• Absence de dépendance à d’autres squelettes (même pas la dist), sauf pour quelques CSS précis et stables dans le temps, tels que ceux de reset.

• Utilisation des plugins suivants pour certains aspects éditoriaux :
  • « Compositions » pour des ajustements de présentation selon le type de rubrique ;
  • « Pages uniques » (pour le contenu disposé en pied de page) ;
  • « Formidable » pour les formulaires de contact ;
  • « Polyhiérarchie ».
• Peu de configuration : les rares configurations proposées concernent essentiellement des choix éditoriaux. Aucune configuration n’est proposée en terme de maquetage. Les personnes qui voudraient personnaliser les aspects de maquetage/présentation surchargeront les fichiers du squelette.

Facilités pour la rédaction

Édition possible depuis l’espace public

Aller dans l’espace privé pour éditer du contenu publié peut représenter un frein auprès de certaines personnes.

• C’est pourquoi, l’activation du plugin-squelette implique l’activation du plugin « Crayons » ;
• Mais Koinós intègre également la possibilité d’ajouter des événements à un article... directement depuis l’espace public !
• Par ailleurs, sous chacun des événements publiés, un lien permet de basculer vers l’édition en partie privée.

« Sur le fil » : une fonctionnalité destinée aux fils d’actualité

Cette fonctionnalité a été développé à partir des considérations suivantes :

• Les infos courtes de plus en plus privilégiées sur les sites d’information ;
• L’objet « brève », qui existait pour cela aux débuts de SPIP, a été abandonné parce que ces dernières, n’étant pas rattachées à un fil, perdait leur intérêt dès qu’elles étaient passées ;
• Il ne serait pas non plus pertinent de multiplier les articles courts et vite périmés ;
• Rattacher ces infos courtes au fil d’actualité d’un article permet de remonter le temps ;
• Cela permet de prolonger la durée de vie de certains articles... et d’optimiser leur référencement.

En pratique, on a détourné volontairement l’outil forum de Spip. Nous espérons à terme développer un plugin avec des objets spécifiques pour cette fonctionnalité. En attendant il n’est donc plus possible, avec Koinós, d’utiliser les forums de façon classique.

On alimente le fil d’un article depuis l’espace public, via un lien « afficher le formulaire d’ajout d’actualité » (sous le chapeau de chaque article). Seul un administrateur, ou le rédacteur de l’article concerné peut alimenter un fil d’actualité.

Ce fil est ensuite visible à deux endroits :

• Entre le chapeau et le corps de l’article, l’actualité la plus récente poussant les précédentes vers le bas ;
• Sur la troisième colonne de la page sommaire (page d’accueil du site), toujours par ordre ante-chronologique ;

Il est possible de paramétrer l’affichage du fil d’actualité dans la configuration du plugin.

Logos semi-automatiques

Des « logos semi automatiques » sont utilisés.

C’est à dire que lorsqu’il s’agit d’afficher le logo d’un article, on recherche :

• Le logo de l’article ;
• à défaut celui d’un·e des auteur·ices des articles [2] ;
• à défaut, la première image associée à l’article.

Pour les évènements, cela dépend des pages. Selon la page cela peut être l’une des trois possibilités suivantes :

1. le logo de l’évènement, ou à défaut celui de l’évènement source, ou encore la première image associée à l’évènement ;
2. le logo de l’article suivant les règles ci-dessus ;
3. le logo de l’évènement (selon la règle n°1) et à défaut le logo de l’article.

La règle adoptée varie selon les pages, pour trouver un équilibre entre utilisation du logo comme élément d’identification de l’évènement/de l’organisateur·rice et nécessité de ne pas répéter trop de fois le même.

Agenda synchronisé : une option (presque) indispensable

Bien que l’utilisation du squelette Koinós ne l’impose pas, le site pour lequel il a été développé initialement utilise abondamment le plugin « Import ICS 2 et supérieur (agenda distant) ».

Ce plugin permet de gagner un temps considérable pour l’alimentation de l’Agenda du site... puisqu’il permet de s’abonner à un flux d’événement depuis le site de l’organisateur·trice.

Structure générale des pages

A l’exception de la page sommaire (accueil du site), chaque page se compose ainsi :

• un menu horizontal de navigation incluant le formulaire de recherche ;
• un contenu central en deux colonnes (à l’exception de la page sommaire détaillée plus bas) ;
  • une colonne principale avec le contenu éditorial proprement dit
  • une Colonne latérale avec, selon les pages
    • court texte ;
    • logo ;
    • métadonnées ;
    • navigation ;
    • information de contact, etc.
• un pied de page qui se décompose ainsi :
  • deux colonnes de textes, personnalisables ;
  • un colophon indiquant le nom du site ;
  • un court menu horizontal.

La page sommaire (page d’accueil) : en trois colonnes

Toutes les pages de Koinós sont en deux colonnes, à l’exception de la page d’accueil, qui en compte trois : une principale et deux latérales.

Cette page a fait l’objet de tous les soins : les principaux paramètres de configuration de Koinós concernent la page sommaire (ou page d’accueil)... notamment pour les réglages de la une et des encarts « Sur le fil » ou « Voir aussi » de la troisième colonne.

Colonne principale : la Une suivie des 20 derniers articles

« La Une » de Koinós permet de mettre en avant de 0 à 2 objets parmi les articles, albums, événements ou images, soit manuellement, soit automatiquement, soit semi-automatiquement.

Selon votre configuration du plugin, vous trouverez en mode édition, sous chacun de ces objets, la case à cocher : « A la une ». Les articles auront également la case à cocher « Voir aussi », expliquée ci-après.

Colonne latérale n°1 : Agenda

La colonne Agenda affiche les X événements à venir puis tous les événements « en cours ».

Colonne latérale n°2 : Sur le fil puis Voir aussi

En fonction de la configuration choisie, cette colonne permet d’afficher :

• L’encart « Sur le fil » : les dernières actualisations d’article ;
• L’encart « Voir aussi », contenant des articles auquel on souhaite redonner une visibilité sur la page d’accueil. Il suffit pour cela de cocher la case éponyme en mode édition. Attention : la sélection des articles « Voir aussi » est exclusivement manuelle. Il faut donc veiller à réguler leur nombre, en cochant / décochant cette case.

Les pages d’article

Remarque : les pages d’articles ont la même structure qu’il s’agisse d’article du journal ou d’entrée de l’annuaire.

Colonne principale

• Disposition générale : Surtitre, titre, sous-titre, chapeau, texte, post-scriptum, images et documents qui n’ont pas été insérés manuellement dans le texte, puis liste des prochains évènements.
• Une particularité... le fil d’actualité  : La construction du texte est un peu particulière. En effet, nous proposons aux personnes qui ont le droit de modifier l’article d’ajouter, via un formulaire, des « actualités » à l’article.
  L’idée est reprise des sites d’information des médias main stream. Techniquement, il s’agit d’un détournement des forums [3]. Par exemple, pour un article présentant une lutte locale, on pourra ajouter des actualités décrivant les manifestations, décisions des autorités politiques, victoires, défaites, etc. Ces actualités apparaissent :
  
  • Au-dessus du texte de l’article, par ordre antéchronologique ;
  • Sur la page sommaire (accueil du site), dans la troisième colonne, sous la manchette « Sur le fil ».
• Événements : À la fin de la page, les auteurs et admin de l’article peuvent lui ajouter un évènement. Ces événements s’afficheront également à deux autres endroits :
  • Sur la page sommaire (accueil du site) : sur la 2^e colonne ;
  • Sur la page « Agenda »

Colonne latérale

Logo, méta-données, mots-clés, coordonnées et éventuellement formulaire de contact.

Pour les coordonnées, on utilise le plugin homonyme.

Concernant le formulaire de contact :

• Les emails utilisés sont celles associés à l’article via le plugin coordonnées, en revanche, pour contacter l’auteur, il faut se rendre sur la page de l’auteur. Ce choix a été fait pour mieux distinguer les articles de type « annuaire » des articles de type « journal ».
• Le formulaire utilisé est un formulaire formidable dont l’identifiant est contact_annuaire [4] ; il vous faut donc créer votre propre formulaire. Vous pouvez utiliser, si besoin, la version que nous proposons ci-joint [5].

Les pages de rubrique

Colonne principale

Les articles de la rubrique et de ses sous-rubriques. Plusieurs modes d’affichage s’offre aux internautes :
-  Par défaut : articles par ordre ante-chronologique, avec logo et résumé
-  Par année : articles par année puis par mois
-  Par mot clé : Pour chaque groupe de mot clé, possibilité de trier les articles par mot clé associé.

Colonne latérale

Logo, descriptif de la rubrique, liste des sous-rubriques et des rubriques sœurs.

La page « Agenda »

Ce n’est pas une rubrique, mais une page spéciale qui va chercher tous les événements du site, disponible à l’adresse ?page=agenda.

• Dans sa colonne principale, elle recense d’abord les évènements en cours, puis les évènements à venir ;
• Un cours texte peut être mis Colonne latérale. On peut le configurer dans l’espace privé, dans la page de configuration du squelette Koinós .
• La colonne de droite propose aussi de trier par mots-clés, en listant les différents mots-clés disponibles.

La page « Annuaire »

Il est possible de créer une rubrique spécifique « Annuaire » en lui affectant la composition « Annuaire ».

• La colonne principale contient les articles classés par ordre alphabétique, avec les coordonnées associées à chacun des articles ;
• La colonne latérale est similaire à la colonne latérale des rubriques standards.

La page « A propos »

Il est possible de créer une rubrique spécifique « À propos », en lui affectant la composition « A propos » :

• les articles y sont triés par numéro préfixé au titre (01. Présentation générale, 05. Charte éditoriale, etc.) ;
• aucune métadonnée (auteur, date) n’est affichée ;
• la colonne latérale des pages articles de cette rubrique propose des liens vers les autres articles de la rubrique.

La page « Albums » et la page d’album

La page « Albums »

Accessible via ?page=albums, cette page regroupe tous les albums.

• Colonne principale : liste des albums par ordre antéchronologique. Chaque album est présenté rapidement avec un aperçu des six premières images ;
• Colonne latérale, on peut insérer un texte, depuis la page de configuration du squelette. La colonne latérale propose également de filtrer les albums par auteur·ices associé·es.

La page d’album

Chaque album dispose d’une page individuelle. Les images y sont présentées en grand format, avec une mediabox pour faire un diaporama. La colonne latérale contient le descriptif de l’album et les métadonnées associées.

Les pages d’auteurs et de mots-clés

Le contenu des page d’un auteur ou d’un mot clé est assez similaire

• Colonne principale :
  • les évènements associés (directement ou par le biais d’un article) à l’auteur/le mot clé ;
  • les activités, c’est-à-dire les article présents dans la rubrique agenda, associées à l’auteur / au mot-clé ;
  • les albums associés à l’auteur / le mot-clé ;
  • les articles de journal associé à l’auteur / au mot-clé ;
• Colonne latérale :
  • le logo de l’auteur / du mot-clé ;
  • la bio de l’auteur / le descriptif + le texte du mot-clé ;
  • les coordonnées de l’auteur, avec formulaire de contact [6] ;
  • les autres mots du même groupe.

Configuration du squelette Koinós

Pour accéder au menu de configuration, aller dans « Squelettes>Configurer le squelette Koinós ». Le menu propose de régler la une, la colonne latérale, les pages spéciales et l’affichage de la bannière.

Configuration de la Une (page d’Accueil)

• Objets en une
  • Nombre : de 0 à 2
  • Catégories : Albums, Articles, Événements, Images
  • Type de sélection : Manuel, Automatique, Manuel puis automatique si besoin (pour arriver au nombre d’objets choisi)

• Albums en une
  • Âge maxi en jours depuis la date de publication
  • Possibilité d’une mise en une automatique

• Articles à la une
  • Âge maxi en jours depuis la date de publication
  • Possibilité d’une mise en une automatique

• Événements à la une
  • Âge maxi en jours depuis la date de modification
  • Possibilité d’une mise en une automatique

• Images à la une
  • Âge maxi en jours jusqu’à la date de l’événement
  • Possibilité d’une mise en une automatique

Configuration de colonne « sur le fil » (Sur la page d’accueil)

Koinós permet de configurer le contenu de la deuxième colonne de la page d’accueil, destiné aux dernières actualisations d’articles (encart « Sur le fil ») et/ou aux articles sélectionnés manuellement.

• Nombre d’événements sur le fil : de 0 à nombre choisi
• Âge maxi : de 0 à nombre choisi

Configuration des pages spéciales : Agenda, Albums

Les pages Agenda et Albums ne sont pas de vraies rubriques. Ce sont des pages spéciales dédiées à un type de contenu spécifique. Le menu permet de régler le texte d’accueil de chacune d’entre elles.

Configuration de la Bannière

Une option permet de n’afficher la bannière que sur la page d’accueil.

Plusieurs remarques sur la bannière :

• Elle s’affiche sous le menu ;
• Elle se masque comme le contenu, derrière le menu principal au fur et à mesure que l’on fait dérouler la page ;
• Elle diminue en taille sur petit écran ;
• Sa largeur est limitée à 2000 px.

Personnalisation des éléments communs aux différentes pages

Modifier le menu de navigation principal

Le menu de navigation principal, situé en haut est configurable via le plugin Menus. Il suffit de créer un menu dont l’identifiant est nav.

Modifier les textes en pied de page

Le pied de page peut contenir des textes, par exemple pour insérer une présentation du site ou un formulaire d’inscription à une infolettre. Pour ce faire, il faut créer des pages uniques, dont les identifiants commencent par prefooter.

Modifier le menu en pied de page

Enfin un menu secondaire peut se trouver en pied de page. Il suffit de créer un menu dont l’identifiant est footer.

Vidéos de présentation

Voici quelques captures vidéos pour découvrir Koinós

Présentation générale

Ajouter un événement à un article depuis l’espace public

Modifier un événement depuis l’espace public

Alimenter un fil d’actualité depuis l’espace public

Paramétrer de Koinós