Blueprints

Le terme blueprint désigne, en anglais, une reproduction d'un plan détaillé, ce que l'on appelle en dessin technique un dessin de définition. Le terme, signifiant littéralement « impression en bleu », provient d'un procédé d'imprimerie, la cyanotypie, puis la diazographie. — wikipedia

Modèle de données

Les blueprints permettent de déterminer le modèle de données de chaque type de page (quelles données pour quelle page). Ce modèle se traduira en champs de saisie dans le panel.

Dans le contexte du portfolio, plusieurs scénarios peuvent être envisagés. NB: Les wireframes ci-dessous permettent d’imaginer des structures de données différentes ; ils n’impliquent pas (encore) de choix de mise en page.

Scénario 1

• Une page d’accueil avec un projet à la une : un blueprint home
• Des catégories : un blueprint category
• Une page projet : un blueprint project
• Une page à propos : un blueprint about

→ Voir les blueprints pour ce scénario

Scénario 2

• Une page d’accueil avec la liste des projets : pas de blueprint nécessaire
• Une page projet de type “vidéo” : un blueprint video
• Une page projet de type “photo” : un blueprint photo
• Une page projet de type “galerie” : un blueprint gallery
• Une page projet de type “journal” : un blueprint journal, etc.

→ Voir les blueprints pour ce scénario

↗ Documentation sur les blueprints
↗ Exemples de blueprints

Les champs

Kirby propose par défaut un large ensemble de champs, qui permettent la saisie de la plupart des données que l’on peut souhaiter (sinon, regarder les plugins).

Mais aussi : Email, Multiselect, Radio, Range, Structure, Time, Tel, Users, Info, Line, Headline, Hidden…

Interface d’administration

Le panel de Kirby peut être personnalisé pour s'adapter à chaque projet. À cette fin, on utilise les blueprints pour configurer la mise en page des champs de formulaire.

Les blueprints sont des fichiers de configuration écrits en YAML qui permettent de personnaliser l’apparence et l’interface du panel. Ils sont stockés dans le dossier /site/blueprints. Ils peuvent être basés sur de simples presets ou être spécifiquement définis, de manière à concevoir des interfaces d’administrations complexes contenant onglets, colonnes et sections.

Exemple de blueprint pour ce layout :

tabs:
  tab-1:
    label: Tab 1
    columns:
      - width : 2/3
        sections:
          main:
            type: fields
            headline: Informations
            fields :
              subtitle:
                label: Sous-titre
                type: text
              text:
                label: Texte
                type: textarea
      - width: 1/3
        sections:
          meta:
            type: fields
            headline: Fichiers
            fields :
              descrition:
                type: text
              keywords:
                type: tags
          files:
            type: files
            headline: Fichiers
  tab-2:
    label: Tab 2
    fields:
      truc:
        label: Truc
        type: text
  tab-3:
    label: Tab 3
    fields:
      bidule:
        label: Bidule
        type: text

Ensuite…

La structure du contenu est bien formalisée, l’interface d’admin est fonctionelle et ergonomique ; on passe à l’affichage des informations dans les pages :

→ Les templates