Samenvatting
Het vinkje Publieke data zet de inhoud van een collectie na publicatie als JSON-bestand op je eigen website. Dat bestand staat op een vast adres, en het scherm toont dat adres zodra je website gepubliceerd is.
Je zet het aan op het tabblad Data van de collectie-instellingen. Daarna publiceer je de website, want pas dan ontstaat het bestand.
Wie het adres kent, kan het bestand opvragen. Er zit geen wachtwoord omheen en er is geen afscherming.
Wanneer gebruik je dit?
Je gebruikt dit als een ander systeem de gegevens uit je collectie moet kunnen lezen, zonder dat iemand ze overtypt.
Je gebruikt het ook als dezelfde gegevens op meer dan één plek terug moeten komen, bijvoorbeeld op een tweede website.
Wil je juist de andere kant op werken, en de inhoud van een ander systeem in je collectie tonen, lees dan Externe data.
Hoe werkt dit in Mach3Blocks?
Op het tabblad Data van de collectie-instellingen staan drie velden onder elkaar. Publieke data is het bovenste veld, en het is een vinkje.
Onder dat veld staat de veldmelding "Als dit is aangevinkt, wordt de data beschikbaar na publicatie, zodat deze door derden gebruikt kan worden."
Zet je het aan en sla je op, dan is er op je website nog niets veranderd. Het bestand ontstaat pas bij de eerstvolgende publicatie.
Na die publicatie staat de openbare link achter die veldmelding. Een klik erop opent het bestand in een nieuw venster.
Bij een website die nog nooit is gepubliceerd, staat die link er niet.
Het adres van het bestand
Het adres begint met de domeinnaam van je website. Daarna volgt het vaste pad data/public, en dan de bestandsnaam collection met het collectienummer en .json.
Dat adres ligt vast. Het verandert niet als je de collectie hernoemt, en je kiest het zelf niet.
Dit is het enige gegevensbestand van je website dat van buitenaf op te vragen is. Het bestand dat je website zelf gebruikt, is dat niet.
Wat er verder verandert
Zodra dit vinkje aanstaat, verdwijnen de twee andere velden van het tabblad uit beeld. Externe data en 301 redirects zijn dan niet meer te bedienen.
Stond er al een adres in Externe data, dan blijft die waarde bewaard. Zolang dit veld aanstaat, wordt hij genegeerd.
Het tabblad Imports blijft gewoon staan. In het collectieoverzicht verschijnt een groen vinkje in de kolom Publieke data.
Wat je ermee kunt
Het bestand bevat de hele collectie, in de volgorde die je bij de collectie hebt ingesteld.
| Onderdeel | Wat erin staat |
|---|---|
| De tags | Alle taggroepen met hun tags, met per tag de naam, de webadresnaam, en of hij in de filters verborgen is |
| De items | Elk item van de collectie, met zijn nummer, zijn naam en zijn webadresnaam |
| Het adres per item | Het adres zelf, het linkdoel en het aria-label |
| De SEO-gegevens | De vier SEO-velden en de drie deelvelden van het item |
| De datums | Zichtbaar vanaf, zichtbaar tot, en de datum van aanmaken en van wijzigen |
| De veldwaarden | De waarde van elk collectieveld, onder de sleutel van dat veld |
Elke tekstwaarde staat er per taal in. Heeft je website twee talen, dan staan beide vertalingen in het bestand.
Een afbeelding staat erin als volledig adres, en dat adres wijst naar het originele bestand. De kleinere varianten voor smalle schermen zitten er niet bij.
Een veldwaarde staat onder de sleutel van het veld en niet onder de veldnaam. Die sleutel zie je bij het veld zelf; lees Velden beheren.
Grenzen en wat niet kan
Het verkeer gaat één kant op. Je geeft gegevens weg, en er komt niets terug: een wijziging in het bestand bereikt je collectie nooit.
Dit is één bestand op één adres. Je kunt er geen deel van opvragen en er niet in zoeken, want wie het gebruikt haalt het altijd in zijn geheel op.
De inhoud is zo oud als je laatste publicatie. Er is geen verversing tussendoor, dus na elke wijziging publiceer je opnieuw; lees Website publiceren.
Er zit geen sleutel en geen wachtwoord op het bestand. Wie het adres heeft, kan het opvragen.
Dat geldt ook bij een website met Login. Het bestand is openbaar en gaat niet mee in die afscherming.
Twee velden op dit tabblad sluiten elkaar uit. Wil je een externe bron gebruiken, zet dit veld dan eerst uit; lees Externe data.
Voorwaarden en rechten
Je hebt het recht Collecties toevoegen nodig om de actie Instellingen in het collectieoverzicht te zien.
Heb je een collectie geopend, dan staat de knop Instellingen bovenin er altijd.
Om het bestand op je website te krijgen, heb je daarnaast het recht Publiceren nodig.
De acht rechten die op een collectie werken, staan bij elkaar in Rechtenoverzicht.
Praktijkvoorbeelden
Je onderhoudt je vestigingen in één collectie: naam, adres, openingstijden en telefoonnummer. Twee andere websites moeten precies dezelfde gegevens tonen.
Je zet het vinkje aan en publiceert. De twee andere websites zetten het adres uit de veldmelding in hun eigen collectie als externe bron; lees Externe data.
Je onderhoudt de gegevens daarna nog maar op één plek. Verandert er een openingstijd, dan publiceer je, en de andere websites volgen vanzelf.
Een klant wil je vacatures ook in zijn eigen systeem tonen. Je zet het vinkje aan, publiceert, en geeft hem de link die bij het veld verschijnt.
Hij haalt het bestand daarna zelf op, zo vaak als hij wil. Jij levert niets meer aan.
Loop de collectie wel eerst langs. Alles wat erin staat, komt in het bestand terecht.