@webbio/strapi-plugin-page-builder

Strapi plugin page-builder

A quick description of page-builder.

Werking van de plugin

Voeg de plugin aan de plugin.ts toe

'page-builder': {
  enabled: true,
  config: {
    modules: [
      'modules.header',
      'modules.cta',
      ...
    ]
  }
}

In de modules array voeg je alle modules toe die beschikbaar moeten zijn op een pagina. Deze worden bij het opstarten van de server automatisch toegevoegd aan Page en Template.

De collectiontypes Page, Template en PageType worden aangemaakt of bijgewerkt op het moment van opstarten van de server. Het kan zijn dat de server een keer crasht, start deze dan even opnieuw op.

Page Types

Maak voor elke pagina type een Page Type aan. Deze kan, maar hoeft niet, gekoppeld worden aan een collection type. Je moet altijd een UID invoeren, als je wenst geen koppeling te maken met een collection type, vul hier alsnog iets in. Het kan zijn dat dit deel van de plugin nog niet werkt, hier is nog niet mee getest. hasPage moet toegevoegd worden aan de collectiontype. Dit komt doordat er gefilterd moet kunnen worden middels graphql. Er is een custom manier gebouwd om ervoor te zorgen dat pages gefilterd kan worden.

Voor elk collection type die een page type is, moet deze properties toegevoegd worden:

"page": {
  "type": "relation",
  "relation": "morphMany",
  "target": "api::page.page",
  "morphBy": "collectionTypeData"
},
"hasPage": {
  "type": "boolean",
  "default": false
}

Zodra dit goed is ingesteld, kan je via deze collectie types direct een pagina aanmaken.

Page

Op een page kan je in de Edit View een page type selecteren. Op basis daarvan wordt er een template geselecteerd (indien gekozen in een page type) en kan je zoeken in verschillende entiteiten binnen die page type. Deze kan je koppelen aan een pagina.

Template

Een template is niets anders dan een sjabloon die je eenmalig kan toevoegen op een pagina. Dit kan via een page type gaan maar kan ook zonder de page type. Een modal zal eerst nog vragen of je zeker bent van je keuze, alle modules zullen vervangen worden.

Platform

Om wijzigignen aan te brengen in een platform, moeten deze in de schema aangepast worden van de api. /src/api/platform/content-types/platform/schema.json

Voor elk collectiontype die je wil toevoegen aan het platform, moet deze relatie toegevoegd worden:

"platform": {
  "type": "relation",
  "relation": "oneToOne",
  "target": "api::platform.platform"
}

Een platform zit altijd aan een pagina gekoppeld. Deze moet handmatig in de pagina toegevoegd worden.

Known bugs

• Na het ontkoppelen en opslaan van een collectie item op een pagina, staat deze nog als "Geselecteerd" in de dropdown.
• Sorteren op pages binnen een collectie type kan niet. Dus stel ik haal alle FAQ's op waarbij ik wil sorteren op een property op de page, kan dat niet.

Improvements

• Deze readme updaten en naar engels vertalen.
• Intl gebruiken voor de teksten.
• Pagetype mag ook een default parent page relation hebben. Bij het aanmaken van een pagina obv een page type, deze relatie als default aan de aangemaakte pagina koppelen. Als ik bijvoorbeeld een post pagina maak, dan wordt de pagina automatisch aan de "actueel" pagina gekoppeld zodat al mijn posts die parent hebben.
• Filteren op Page in GraphQL binnen een collectiontype met een morph op een page kan niet. Strapi staat dit niet toe. Wellicht in de toekomst wel.
• Slug en path genereren op basis van de titel van het collection type waarvan je een pagina aanmaakt. Nu wordt deze leeggelaten. Dit moet zorgvuldig gebeuren, bij een bestaande slug wil je bijvoorbeeld een -2 toevoegen oid.
• Dit vorige punt geldt ook andersom, dus als je een entity koppelt vanuit een pagina. Als de titel en slug nog leeg zijn, vul die dan automatisch in.
• In het overzicht van een collectiontype moet duidelijk worden of en welke pagina er gekoppeld is. https://share.getcloudapp.com/BluzGYEd
• Bij Page Types moet je handmatig de collectiontype uid invoeren. Dit zou idealiter een select zijn van alle mogelijke collecion type uids. Ook moet dit een mogelijkheid bieden voor geen uid.