Objectwaardes

Samenvatting

Een objectwaarde is een gegeven dat Mach3Blocks al kent en dat je zelf in een veld kunt invoegen. Je schrijft hem tussen dubbele accolades, zoals {{ Website: Naam }}.

Zes bronnen leveren zo'n waarde. Vier daarvan hebben een vaste lijst; de andere twee volgen de namen die jij zelf hebt gegeven.

De namen van deze waardes volgen de taal van je account. Staat je account op Engels, dan heet dezelfde waarde {{ Website: Name }}.

Objectwaardes werken in structured data, en daarnaast in een aantal andere codevelden.

Wanneer gebruik je dit?

Je gebruikt een objectwaarde wanneer je een gegeven niet wilt overtypen dat het platform al kent. Wijzigt dat gegeven later, dan gaat je schema vanzelf mee.

Drie situaties komen daar het vaakst uit voort.

  • Dezelfde gegevens staan op meer dan één plek, bijvoorbeeld je bedrijfsnaam in elk schema.
  • Je website is meertalig, en je schema moet per taal de juiste tekst dragen.
  • Je collectie-overzicht herhaalt een schema per item, en elk item heeft eigen waardes.

Hoe werkt dit in Mach3Blocks?

Je typt een objectwaarde in het veld waar je toch al staat. Er is geen apart scherm en geen apart menu-item voor.

Typ je twee accolades, dan vult het schrijfvlak de rest aan. Kies je een aanvulling, dan komt de hele waarde in je veld te staan.

Bij een collectieveld en bij een variabele zet die aanvulling ook het nummer erbij, zoals {{ Collectieveld: 123, Titel }}. Dat nummer is een hulp en geen eis.

Bij het opslaan zet Mach3Blocks je leesbare naam om naar een nummer, en bij het openen zet het die naam weer terug. Daarom blijft je verwijzing werken nadat je een veld of een variabele hebt hernoemd.

Wat er in structured data extra gebeurt

In een structured-dataveld doet het platform drie dingen die het elders niet doet.

Soort waarde Wat er gebeurt
Een datum Wordt weggeschreven in het ISO 8601-formaat
Een adres Wordt altijd volledig, met het domein ervoor
Een aanhalingsteken in de waarde Wordt afgeschermd, zodat je JSON heel blijft

Waar objectwaardes verder werken

Buiten structured data vult het platform je objectwaardes ook op deze plekken in.

  • Head en Body, op websiteniveau en op paginaniveau
  • Trackingcode en Conversiecode
  • robots.txt
  • Een kop, een tekst en een knop van een collectie-item
  • De waarde van een collectieveld
  • Het veld Standaard item link van een collectie
  • Blokcode en de code van een maatwerkblok

Overzichtstabel met opties, waarden en standaard

De vier vaste lijsten staan hieronder, in de volgorde waarin je schrijfvlak ze aanbiedt. Daarna volgen de twee open lijsten.

Website

Objectwaarde Wat je krijgt
{{ Website: Naam }} De naam van je website
{{ Website: URL }} Het adres van je website, zonder taalcode
{{ Website: Home-URL }} Het adres van je website, met taalcode
{{ Website: Meta titel }} De meta titel van je website

Pagina

Objectwaarde Wat je krijgt
{{ Pagina: Naam }} De naam van de pagina waarop je schema staat
{{ Pagina: URL }} Het adres van die pagina
{{ Pagina: Meta titel }} De meta titel van die pagina
{{ Pagina: Meta omschrijving }} De meta omschrijving van die pagina
{{ Pagina: Meta trefwoorden }} De meta trefwoorden van die pagina
{{ Pagina: Delen titel }} Het veld Delen titel van die pagina
{{ Pagina: Delen omschrijving }} Het veld Delen omschrijving van die pagina
{{ Pagina: Delen afbeelding }} Het adres van de deelafbeelding van die pagina
{{ Pagina: Publicatiedatum }} De publicatiedatum van die pagina
{{ Pagina: Wijzigingsdatum }} De wijzigingsdatum van die pagina

Collectie

Objectwaarde Wat je krijgt
{{ Collectie: Naam }} De naam van de collectie
{{ Collectie: URL }} Het adres van die collectie
{{ Collectie: Aantal items }} Het aantal items in die collectie

Collectie-item

Objectwaarde Wat je krijgt
{{ Collectie-item: Naam }} De naam van het item
{{ Collectie-item: URL }} Het adres van dat item
{{ Collectie-item: Meta titel }} De meta titel van dat item
{{ Collectie-item: Meta omschrijving }} De meta omschrijving van dat item
{{ Collectie-item: Meta trefwoorden }} De meta trefwoorden van dat item
{{ Collectie-item: Delen titel }} Het veld Delen titel van dat item
{{ Collectie-item: Delen omschrijving }} Het veld Delen omschrijving van dat item
{{ Collectie-item: Delen afbeelding }} Het adres van de deelafbeelding van dat item
{{ Collectie-item: Zichtbaar vanaf }} De datum vanaf wanneer dat item zichtbaar is
{{ Collectie-item: Zichtbaar tot }} De datum tot wanneer dat item zichtbaar is
{{ Collectie-item: Publicatiedatum }} De publicatiedatum van dat item
{{ Collectie-item: Wijzigingsdatum }} De wijzigingsdatum van dat item
{{ Collectie-item: Positie }} De plaats van dat item in de collectie

Collectieveld

Een collectieveld heeft geen vaste lijst. Je krijgt een aanvulling per veld van de collectie waarin je werkt.

Die aanvulling zet het nummer en de veldnaam erbij, zoals {{ Collectieveld: 123, Titel }}. Werk je met een externe collectie zonder publieke data, dan toont de lijst de sleutel in plaats van de veldnaam.

Variabele

Een variabele heeft ook geen vaste lijst. Je krijgt een aanvulling per variabele van je website, met het nummer en de naam die jij hebt gekozen.

Eigen variabelen maak je aan in het scherm Variabelen van je website.

Welke bronnen je per veld krijgt

Niet elk veld biedt alle zes de bronnen aan. De aantallen hieronder zijn zonder eigen variabelen; elke variabele komt daar los bij.

Veld Vaste waardes Welke bronnen
Head, Body, Trackingcode en Structured data van een website 14 Website en Pagina
Structured data van een pagina 14 Website en Pagina
Structured data (overzicht) en Structured data (detailpagina) 20, plus een per collectieveld Website, Collectie en Collectie-item
robots.txt 6 Website, plus twee vaste tekstsuggesties
llms.txt 4 Website

Aanbevolen instelling

Zet in je schema geen tekst die het platform al kent. Vul die plekken met een objectwaarde, dan blijft je schema vanzelf actueel.

Wat je in je schema vult De objectwaarde die je gebruikt
De kop van je artikel {{ Pagina: Meta titel }}
De omschrijving {{ Pagina: Meta omschrijving }}
De afbeelding {{ Pagina: Delen afbeelding }}
Het adres {{ Pagina: URL }}
De publicatiedatum {{ Pagina: Publicatiedatum }}
De wijzigingsdatum {{ Pagina: Wijzigingsdatum }}

Voor de naam en het webadres van je website gebruik je de vaste lijst. Alles wat daar niet in staat, zoals je telefoonnummer of je postadres, zet je in een eigen variabele.

De namen volgen de taal van je account

Staat je account op Engels, dan heet dezelfde waarde {{ Website: Name }}. Typ je daar de Nederlandse naam, dan wordt hij niet omgezet en blijft de tekst letterlijk staan.

Voorwaarden en rechten

Voor het openen en het opslaan van de code-instellingen heb je het recht Code-instellingen nodig. Een Beheerder en een Bouwer hebben dat recht standaard.

Om je waarde op je gepubliceerde website te krijgen, heb je het recht Publiceren nodig.

Voor het scherm Variabelen gelden wel rechten. Je hebt Website/presentatie variabelen toevoegen of Website/presentatie variabele waarden bewerken nodig.

Gevolgen bij verkeerd instellen

Een objectwaarde die het platform niet herkent, blijft letterlijk in je veld staan. Er komt geen melding, en in je beheerscherm is niets te zien.

Wat er misgaat Wat je krijgt
Je typt de naam in een andere taal dan die van je account De waarde wordt niet omgezet en de tekst blijft staan
Je gebruikt een bron die op dat niveau niet bestaat Het platform slaat die bron over en de tekst blijft staan
Je zet een collectiewaarde in het schema van een gewone pagina Datzelfde: die collectie is daar niet bekend

In je structured data levert zo'n achtergebleven tekst vaak een schema op dat een zoekmachine niet kan lezen. Kijk je schema daarom na voordat je publiceert.

Drie plekken die een waarde wel aanbieden en niet invullen

Bestemming Wat er gebeurt
Het tabblad llms.txt De tekst komt letterlijk in het gepubliceerde bestand
Een LESS-tabblad De tekst blijft in de gepubliceerde opmaak staan
Head en Body van een collectie-detailpagina Een collectieveld blijft daar letterlijk staan

Kom je een van deze drie tegen, kies dan een andere plek of typ de waarde uit.