SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

290 Plugins, 198 contribs sur SPIP-Zone, 115 visiteurs en ce moment

Accueil > Squelettes > Outils pour squelettes > Zcore > Initialiser Zcore > Plugin « Initialiser Zcore »

Plugin « Initialiser Zcore »

15 juillet 2015 – par Teddy Payet – commentaires

9 votes

Suite à l’article Créer des squelettes avec Zcore, ce plugin voit le jour. Il permet de créer pour tous les objets éditoriaux le squelette nécessaire pour fonctionner avec l’architecture « Z » et plus précisément avec Zcore.

Installation

Le plugin est répertorié dans le dépôt proposé par défaut : « SPIP-Zone - Plugins ». Aussi, il est installable depuis la page Gestion des plugins, onglet Ajouter des plugins si vous avez activé ce dépôt. Pour le retrouver dans la liste des plugins, il vous suffit de rechercher "zinit".

En cas de besoin, référez-vous à l’article dédié à ce sujet sur spip.net.

Présentation

Ce plugin reprend les principes dans l’article "Créer des squelettes avec Zcore" et vous aide à faire ces différentes opérations depuis l’espace privé. Après activation, un lien est ajouté dans le menu "Squelettes" : "Squelettes Zcore". Il vous amènera sur la page suivante :

Sur cette dernière, vous avez 3 tableaux :

  • Les contrôles ;
  • Les répertoires ;
  • Les objets éditoriaux.

Les contrôles

Dans la version 0.2 du plugin, il n’y a qu’un contrôle qui est fait : la détection de la présence de la globale "z_blocs".
Le plugin ne crée pas à votre place la globale.

Les répertoires

Si la globale "z_blocs", utilisée par le plugin Zcore, est définie, le plugin listera les répertoires (ou plutôt blocs). Dans le cas contraire, la liste minimum de répertoires est la suivante :

  • content (obligatoire) ;
  • head ;
  • head_js.

Ces répertoires sont les blocs minimum attendus par les fichiers structure.html et body.html fournis par le plugin Zcore.
La première colonne donne les noms des répertoires, la seconde vérifie la présence de ces répertoires dans squelettes_zcore. Ce répertoire étant créé par le plugin.
La troisième colonne liste la présence des répertoires dans le répertoire squelettes.
Un bouton "Mise à jour" est présent sous la deuxième et troisième colonnes.

Mise à jour
Ce bouton permet de créer les répertoires définis par z_blocs. Si des répertoires présents dans le dossier "squelettes_zcore" ne font pas partis de la liste minimum de répertoires de z_blocs, ils seront supprimés s’ils sont vides.
Le principe est le même si vous cliquez sur le bouton "Mise à jour" de la colonne "squelettes".

Les objets éditoriaux

Nous avons là encore le principe de 3 colonnes :

  • Le nom des objets éditoriaux ;
  • Leur présence dans "squelettes_zcore" avec le nom du fichier html ;
  • Leur présence dans "squelettes" avec le nom du fichier html.

Comme pour chaque détection, on aura une icône "rouge" si le fichier est absent, et une icône "verte" si le fichier est présent.

Mise à jour
Lorsqu’on clique sur le bouton "Mise à jour", le plugin va créer les fichiers dans le répertoire adéquate.

Détection des objets éditoriaux
La liste des objets est déterminée par la description des tables dans SPIP. Chaque descriptif de table possède la valeur "page". Si cette valeur est vide, l’objet est ignoré dans la liste. Cet objet n’est donc pas prévu par son concepteur pour être visible dans l’espace public de SPIP.
De ce fait, si vous ne voyez pas un objet éditorial précis, une piste est à voir de ce côté-là.

Ignorer des objets éditoriaux
Le plugin permet en plus de la détection citée précédemment, d’exclure des objets précis. Actuellement, le plugin ne prend pas en compte l’objet "éditorial" Plugin, Dépôt et Paquet, qui en soit ne sont pas des objets éditoriaux pour des sites internets classiques. Ils ont pourtant une page de vue pour l’espace public (cf. http://plugins.spip.net/?plugin12). Ils sont exclus grâce à $GLOBALS['zinit_tables_exclues']. Voici les valeurs dans le plugin :

  1. $GLOBALS['zinit_tables_exclues'] = array('spip_jobs', 'spip_types_documents', 'spip_messages', 'spip_depots', 'spip_plugins', 'spip_paquets');

Si vous désirez rajouter des tables à exclure, il vous suffit de personnaliser cette globale dans votre fichier mes_options.php.

Aller plus loin

Il est possible de personnaliser le nom du répertoire qui recevra les templates de base grâce à la constante _ZINIT_DIR_SQUELETTES. Par défaut, sa valeur est : _DIR_RACINE.'squelettes_zcore/' soit "../squelettes_zcore".
Il n’est pas recommandé de changer cette valeur.

De plus, il est aussi possible de personnaliser le répertoire dans lequel copier ces templates grâce à la constante _DIR_SQUELETTES. Par défaut, sa valeur est _DIR_RACINE.'squelettes/' soit le répertoire "squelettes" de votre site.
Si vous désirez par exemple créer un plugin offrant des squelettes à base de Zcore, il vous suffit de renseigner le chemin vers votre plugin dans le fichier mes_options.php

Voir en ligne : http://plugins.spip.net/zinit

Dernière modification de cette page le 15 juillet 2015

Retour en haut de la page

Vos commentaires

  • Le 6 janvier à 23:56, par PRX En réponse à : Plugin « Initialiser Zcore »

    Bonjour,

    il y a un petit problème sur l’usage du flux RSS avec HTTPS avec ce squelette seul (ou avec d’autres) en plugin (appel de /spip.php ?page=backend) (installation https suivant mode d’emploi https://contrib.spip.net/Passer-un-site-SPIP-sous-https) , la page renvoyée n’est pas au format et cela génère un erreur sur le navigateur « Aucune information de style ne semble associée à ce fichier XML. L’arbre du document est affiché ci-dessous. »

    Vos squelettes utilisent-ils la balise #CHEMIN comme recommandé ?
    De où cela pourrait-il bien venir ?
    merci d’avance.

    Répondre à ce message

  • Le 28 juillet 2015 à 15:57, par bystrano En réponse à : Plugin « Initialiser Zcore »

    Merci pour ce plugin très utile ! C’était pénible de faire ça à la main, et partir d’un jeu de squelettes Z existant pose d’autres problèmes…

    Je me permet quand même une petite remarque : je trouverais utile qu’il génère aussi une page pour le sommaire.

    • Le 18 février 2016 à 14:06, par Teddy Payet En réponse à : Plugin « Initialiser Zcore »

      Bonjour,

      Désolé pour la réponse très tardive

      Pour sommaire.html, il n’est pas nécessaire de créer ce fichier à la racine du répertoire squelettes/ car Z-core utilise le fichier page.html pour la gestion de cette page non éditoriale (cf. ce n’est pas une table de la base de données).

    Répondre à ce message

Répondre à cet article

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Hébergeurs payants

    24 janvier 2009 – 34 commentaires

    Cet article en encore à réorganiser / scinder en deux selon le type (mutualisé ou pro). À priori, SPIP fonctionnera sur tout hébergeur payant traditionnel (qui propose PHP et MySQL). Merci de ne pas mettre des remarques du genre « l’hébergeur truc (...)

  • MediaBox

    10 mai 2010 – 539 commentaires

    Avertissement Le présent plugin est installé et activé par défaut sur toute les version de SPIP > 3.0. Inutile donc de l’installer manuellement sauf si vous utilisez SPIP 2.1. Aperçu La MediaBox est une Boîte multimédia polyvalente et (...)

  • DocumentationFormsTables

    9 décembre 2006 – commentaires

    Article publié : ces notes et d’autres sont désormais publiées sur SPIP-Contrib ici Forms & tables - carnet de notes, donc il faut mieux y aller pour tout complément Différence entre un formulaire et une table un formulaire est dédié a la saisie (...)

  • GIS 4

    11 août 2012 – 1495 commentaires

    Présentation et nouveautés La version 4 de GIS abandonne la libraire Mapstraction au profit de Leaflet. Cette librairie permet de s’affranchir des librairies propriétaires tout en gardant les mêmes fonctionnalités, elle propose même de nouvelles (...)

  • Editer votre base « en ligne » avec Adminer

    4 décembre 2012 – 10 commentaires

    Vous serez peut-être un jour amené à chercher un outil qui permette d’éditer en direct le contenu de cette base de données. Cet article vous propose de le faire avec Adminer qui permet d’éditer des bases MySQL et SQLite ! Son utilisation est assez (...)