{"id":230605,"date":"2022-11-30T17:12:00","date_gmt":"2022-11-30T14:12:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=230605"},"modified":"2022-11-09T23:10:11","modified_gmt":"2022-11-09T20:10:11","slug":"regras-de-reescrita-personalizadas-e-modelos-de-pagina-no-wordpress","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/regras-de-reescrita-personalizadas-e-modelos-de-pagina-no-wordpress\/","title":{"rendered":"Regras de reescrita personalizadas e modelos de p\u00e1gina no WordPress"},"content":{"rendered":"\n

A API do WordPress Rewrite<\/a><\/strong> \u00e9 uma API s\u00f3lida, supondo que voc\u00ea esteja confort\u00e1vel com express\u00f5es regulares.<\/p>\n

E, honestamente, mesmo se voc\u00ea n\u00e3o for, ferramentas como PHP Live RegEx<\/a><\/strong> tornam muito f\u00e1cil testar seu c\u00f3digo antes de coloc\u00e1-lo na add_rewrite_rule<\/code>chamada da API.<\/p>\n

\"Regras<\/a><\/p>\n

No entanto, h\u00e1 momentos em que voc\u00ea pode se encontrar em uma situa\u00e7\u00e3o em que precisa trabalhar com regras de reescrita e modelos de p\u00e1gina. E quando esse \u00e9 o caso, nem sempre \u00e9 t\u00e3o simples quanto fazer uma simples chamada com uma \u00fanica express\u00e3o regular.<\/p>\n

A raz\u00e3o? Se voc\u00ea tiver v\u00e1rias p\u00e1ginas usando o mesmo modelo, nem sempre ter\u00e1 a p\u00e1gina localizada no mesmo \u00edndice na consulta executada em cada p\u00e1gina.<\/p>\n

Para isso, temos que lidar com isso de uma maneira um pouco diferente de, digamos, simplesmente acessar um \u00edndice num\u00e9rico de informa\u00e7\u00f5es na consulta global.<\/p>\n

Regras de reescrita e modelos de p\u00e1gina<\/h2>\n

Primeiro, vamos supor que temos dois modelos (que n\u00e3o est\u00e3o em ordem espec\u00edfica):<\/p>\n

    \n
  1. template-alpha.php<\/li>\n
  2. template-beta.php<\/li>\n<\/ol>\n

    E ent\u00e3o digamos que queremos configurar um URL personalizado para p\u00e1ginas que usam um desses modelos.<\/p>\n

    Isso se dividiria nas seguintes etapas:<\/p>\n

      \n
    1. Iterar pelas postagens na consulta,<\/li>\n
    2. Armazene a postagem usando o modelo em sua respectiva matriz,<\/li>\n
    3. Configure as regras de reescrita para cada postagem com uma determinada consulta.<\/li>\n<\/ol>\n

      Para este exemplo, manterei as regras de reescrita bem simples. Afinal, express\u00f5es regulares podem ser dif\u00edceis o suficiente para seguir, ent\u00e3o tentar segui-las ao lidar com o objeto Query, v\u00e1rios arrays e manipular as regras pode ser um pouco demais.<\/p>\n

      Com isso dito, aqui est\u00e1 o c\u00f3digo de exemplo que \u00e9 dividido com base nas etapas acima. No final do post, vou compartilhar um trecho que junta tudo em algumas fun\u00e7\u00f5es separadas para que voc\u00ea possa ver como tudo isso se encaixa.<\/p>\n

      Com isso dito, veja como lidar com todos os itens acima.<\/p>\n

      1 Adicionando Regras de Reescrita<\/h3>\n

      Primeiro, precisamos ler algumas informa\u00e7\u00f5es do objeto de consulta global do WordPress para encontrar todas as p\u00e1ginas que possuem modelos aplicados a elas.<\/p>\n

      Para fazer isso, podemos ler as informa\u00e7\u00f5es do objeto de consulta global em uma vari\u00e1vel local<\/a><\/strong>. Isso facilita a fuga do restante do c\u00f3digo se n\u00e3o houver nada com o que trabalhar.<\/p>\n

      <?php \n\n$query = $this->query->query([\n    'post_type' => 'page',\n    'meta_key' => '_wp_page_template',\n    'meta_value' => ['template-alpha.php', 'template-beta.php'],\n]);\n\nif (!$query) {\n    return;\n}\n\n\/\/ More to come...\n<\/code><\/pre>\n
      2 Armazenar informa\u00e7\u00f5es relevantes em uma matriz<\/h3>\n
      Assumindo que existem p\u00e1ginas com templates, ent\u00e3o continuaremos armazenando cada uma das p\u00e1ginas<\/a><\/strong> em arrays para que possamos gerenciar facilmente suas respectivas regras de reescrita.<\/p>\n
      <?php\n\nforeach ($query as $post) {\n    $slug = get_page_template_slug($post->ID);\n\n    if ('template-alpha.php' === $slug) {\n        $this->alphaPages[] = $post;\n    }\n\n    if ('template-find-a-camp.php' === $slug) {\n        $this->betaPages[] = $post;\n    }\n}\n<\/code><\/pre>\n
      Observe que, acima, fa\u00e7o refer\u00eancia a uma matriz global. Suponha que isso seja simplesmente inicializado como uma matriz vazia no construtor da classe.<\/p>\n
      3 Configure as Regras de Reescrita<\/h3>\n
      Agora que temos dois arrays \u2013 um para cada modelo e as p\u00e1ginas que o cont\u00eam \u2013 podemos iterar por eles e atribuir regras de reescrita para cada uma dessas p\u00e1ginas.<\/p>\n
      Por exemplo, digamos que para um modelo, digamos alfa, queremos configurar regras de reescrita para os EUA e estados.<\/p>\n
      Aqui est\u00e1 o c\u00f3digo<\/a><\/strong> paratemplate-alpha.php<\/code>:<\/p>\n
      <?php\n\nadd_rewrite_tag('%country%', '([^&]+)');\nadd_rewrite_tag('%state%', '([^&]+)');\n\nforeach ($this->alphaPages as $post) {\n    add_rewrite_rule(\n        '^'.$post->post_name.'\/([^\/]*)\/([^\/]*)\/?',\n        'index.php?page_id='.$post->ID.'&country=$matches[1]&state=$matches[2]',\n        'top'\n    );\n\n    add_rewrite_rule(\n        '^'.$post->post_name.'\/([^\/]*)\/?',\n        'index.php?page_id='.$post->ID.'&country=$matches[1]',\n        'top'\n    );\n}\n<\/code><\/pre>\n
      E aqui est\u00e1 o c\u00f3digo<\/a><\/strong> para template-beta.php<\/code>:<\/p>\n
      <?php\n\nadd_rewrite_tag('%acme-id%', '([^&]+)');\n\nforeach ($this->betaPages as $post) {\n    add_rewrite_rule(\n        '^(.*)?\/([A-Za-z0-9-]+-)(d+)\/?',\n        'index.php?page_id='.$post->ID.'&acme-id=$matches[3]',\n        'top'\n    );\n}\n<\/code><\/pre>\n
      Claro, as express\u00f5es regulares usadas no c\u00f3digo acima s\u00e3o simplesmente para fins de demonstra\u00e7\u00e3o. O seu ser\u00e1 para o que for necess\u00e1rio para o seu projeto.<\/p>\n
      4 Todos Juntos Agora<\/h3>\n
      \u00c9 importante dividir toda essa funcionalidade em seus pr\u00f3prios m\u00e9todos para que tudo possa ser facilmente encapsulado e testado, se necess\u00e1rio.<\/p>\n
      Para isso, veja como ficar\u00e1 o c\u00f3digo completo :<\/a><\/strong><\/p>\n
      <?php\n\npublic function addRewriteRules()\n{\n    $query = $this->query->query([\n        'post_type' => 'page',\n        'meta_key' => '_wp_page_template',\n        'meta_value' => ['template-alpha.php', 'template-beta.php'],\n    ]);\n\n    if (!$query) {\n        return;\n    }\n\n    $this->setPageTypes($query);\n    $this->setAlphaRewriteRules();\n    $this->setBetaRewriteRules();\n}\n\nprivate function setPageTypes($query)\n{\n    foreach ($query as $post) {\n        $slug = get_page_template_slug($post->ID);\n\n        if ('template-alpha.php' === $slug) {\n            $this->alphaPages[] = $post;\n        }\n\n        if ('template-find-a-camp.php' === $slug) {\n            $this->betaPages[] = $post;\n        }\n    }\n}\n\nprivate function setAlphaRewriteRules()\n{\n    add_rewrite_tag('%country%', '([^&]+)');\n    add_rewrite_tag('%state%', '([^&]+)');\n\n    foreach ($this->alphaRules as $post) {\n        add_rewrite_rule(\n            '^'.$post->post_name.'\/([^\/]*)\/([^\/]*)\/?',\n            'index.php?page_id='.$post->ID.'&country=$matches[1]&state=$matches[2]',\n            'top'\n        );\n\n        add_rewrite_rule(\n            '^'.$post->post_name.'\/([^\/]*)\/?',\n            'index.php?page_id='.$post->ID.'&country=$matches[1]',\n            'top'\n        );\n    }\n}\n\nprivate function setBetaRewriteRules()\n{\n    add_rewrite_tag('%acme-id%', '([^&]+)');\n\n    foreach ($this->betaPages as $post) {\n        add_rewrite_rule(\n            '^(.*)?\/([A-Za-z0-9-]+-)(d+)\/?',\n            'index.php?page_id='.$post->ID.'&acme-id=$matches[3]',\n            'top'\n        );\n    }\n}\n<\/code><\/pre>\n
      Lembre-se, por\u00e9m; isso \u00e9 apenas baseado no c\u00f3digo de demonstra\u00e7\u00e3o compartilhado neste post. Quando voc\u00ea est\u00e1 trabalhando em seu projeto, as express\u00f5es regulares, modelos e assim por diante variam.<\/p>\n
      Fonte de grava\u00e7\u00e3o:  tommcfarlin.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
      H\u00e1 momentos em que voc\u00ea pode se encontrar em uma situa\u00e7\u00e3o em que precisa trabalhar com regras de reescrita e modelos de p\u00e1gina.<\/p>\n","protected":false},"author":1,"featured_media":163544,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[898,722,846,867],"tags":[1170],"class_list":["post-230605","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-codigo-2","category-desenvolvedor","category-tutoriais","category-wordpress-8","tag-affiai-pt-pt"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/230605","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/comments?post=230605"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/230605\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media\/163544"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media?parent=230605"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/categories?post=230605"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/tags?post=230605"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}