Tutorial dello schema
Tutorial dello schemaLezione 8: Migrazioni di sito

Lezione 8: Migrazioni di sito

Possiamo eseguire un gruppo di queries GraphQL per adattare il contenuto del sito durante la migrazione verso un nuovo dominio, lo spostamento di pagine a un URL diverso, o altro.

Affinché questa query GraphQL funzioni, la Configurazione dello schema applicata all'endpoint deve avere le Mutazioni annidate abilitate

Adattamento del contenuto al nuovo dominio

Questa query GraphQL filtra prima tutti i post contenenti "https://my-old-domain.com" nel loro contenuto, e sostituisce questa stringa con "https://my-new-domain.com":

mutation ReplaceOldWithNewDomainInPosts {
  posts(
    filter: {
      search: "https://my-old-domain.com"
    }
  ) {
    id
    rawContent
    adaptedRawContent: _strReplace(
      search: "https://my-old-domain.com"
      replaceWith: "https://my-new-domain.com"
      in: $__rawContent
    )
    update(input: {
      contentAs: { html: $__adaptedRawContent }
    }) {
      status
      errors {
        __typename
        ...on ErrorPayload {
          message
        }
      }
      post {
        id
        rawContent
      }
    }
  }
}

Adattamento del contenuto a un nuovo URL di post o pagina

Dopo aver modificato lo slug di un post o di una pagina, possiamo convertire tutto il contenuto in modo che punti al nuovo URL.

Questa query GraphQL recupera prima il dominio dall'impostazione WordPress "siteurl" per ricreare i vecchi e nuovi URL della pagina:

query ExportData(
  $oldPageSlug: String!
  $newPageSlug: String!
) {
  siteURL: optionValue(name: "siteurl")
 
  oldPageURL: _strAppend(
    after: $__siteURL,
    append: $oldPageSlug
  ) @export(as: "oldPageURL")
 
  newPageURL: _strAppend(
    after: $__siteURL,
    append: $newPageSlug
  ) @export(as: "newPageURL")
}
 
mutation ReplaceOldWithNewURLInPosts
  @depends(on: "ExportData")
{
  posts(
    filter: {
      search: $oldPageURL
    },
    sort: { by: ID, order: ASC }
  ) {
    id
    rawContent
    adaptedRawContent: _strReplace(
      search: $oldPageURL
      replaceWith: $newPageURL
      in: $__rawContent
    )
    update(input: {
      contentAs: { html: $__adaptedRawContent }
    }) {
      status
      errors {
        __typename
        ...on ErrorPayload {
          message
        }
      }
      post {
        id
        rawContent
      }
    }
  }
}

Forniamo quindi i vecchi e nuovi slug di pagina tramite il dizionario variables:

{
  "oldPageSlug": "/privacy/",
  "newPageSlug": "/user-privacy/"
}