innhold/content/docs/utvikling/referanse/metadata/page.md

Metadata-referanse

PnP støtter valgfrie metadatafiler for forbedret innholdskontroll.

Filformat

Metadatafiler bruker INI-formatet og må hete metadata.ini.

Plassering

Plasser metadata.ini i samme mappe som innholdsfilen din:

/content/blogg/2025-01-15-innlegg/
  ├── article.md
  ├── metadata.ini
  └── cover.jpg

Støttede felt

title

Type: String
Påkrevd: Nei
Standard: Hentet fra første H1 i innholdet eller mappenavn

Overstyr sidetittelen.

title = "Min egendefinerte tittel"

date

Type: Dato (YYYY-MM-DD)
Påkrevd: Nei
Standard: Hentet fra mappenavn eller filmodifiseringstidspunkt

Sett publiseringsdatoen.

date = "2025-01-15"

lastModified

Type: Dato (YYYY-MM-DD)
Påkrevd: Nei
Standard: Ingen

Spor når innholdet sist ble oppdatert.

lastModified = "2025-02-10"

summary

Type: String
Påkrevd: Nei
Standard: Ingen

Gi et sammendrag for listevisninger.

summary = "En kort beskrivelse av dette innholdet."

menu

Type: Boolean
Påkrevd: Nei
Standard: false

Vis denne siden i navigasjonsmenyen.

menu = true

menu_order

Type: Integer
Påkrevd: Nei
Standard: 999

Rekkefølgen for menyvisning (lavere tall vises først).

menu_order = 1

slug

Type: String
Påkrevd: Nei
Standard: Mappenavn

Egendefinert URL-slug for oversatte versjoner.

slug = "about"

Flerspråklig metadata

For flerspråklige sider kan du legge til språkspesifikke seksjoner:

title = "Om oss"
summary = "Lær mer om oss"
menu = true

[en]
title = "About us"
summary = "Learn more about us"
slug = "about"

PnP vil automatisk bruke riktig seksjon basert på nåværende språk.

Fullstendig eksempel

Fullstendig metadata.ini-eksempel:

title = "Forstå PnP-ruting"
date = "2025-01-15"
lastModified = "2025-01-20"
summary = "Lær hvordan PnPs mappebaserte rutingssystem fungerer og hvorfor det er designet for lang levetid."
menu = true
menu_order = 3

[en]
title = "Understanding PnP Routing"
summary = "Learn how PnP's folder-based routing system works and why it's designed for longevity."
slug = "routing"

Fallback-atferd

Hvis metadata.ini ikke er til stede:

• Tittel: Hentet fra første H1 i markdown/HTML, eller mappenavn
• Dato: Hentet fra mappenavn (YYYY-MM-DD-*) eller filmodifiseringstidspunkt
• Sammendrag: Vises ikke
• Meny: Vises ikke i navigasjon

Bruke metadata i egendefinerte maler

Metadata er tilgjengelig i maler via $metadata-variabelen:

<?php if ($metadata && isset($metadata['custom_field'])): ?>
    <p><?= htmlspecialchars($metadata['custom_field']) ?></p>
<?php endif; ?>

Du kan legge til egendefinerte felt i metadata.ini og bruke dem i malene dine.