{"id":321,"date":"2026-05-13T19:00:12","date_gmt":"2026-05-13T22:00:12","guid":{"rendered":"https:\/\/neodoor.neo\/?post_type=neodoor_aula&p=321"},"modified":"2026-05-21T09:05:15","modified_gmt":"2026-05-21T12:05:15","slug":"page-link-to","status":"publish","type":"post","link":"https:\/\/www.portanova.com.br\/notebook\/page-link-to\/","title":{"rendered":"[MU] Redirecionar p\u00e1gina para URL externa"},"content":{"rendered":"

Aula: Redirecionar p\u00e1gina para URL externa \u2013 substituindo o plugin “page-links-to”<\/h2>\n

Objetivo:<\/strong> Criar um MU-Plugin leve que adiciona uma metabox na edi\u00e7\u00e3o de p\u00e1ginas, posts e custom post types, permitindo definir uma URL externa. Quando a p\u00e1gina for acessada no frontend, o usu\u00e1rio ser\u00e1 redirecionado automaticamente para essa URL, sem necessidade de plugins pesados.<\/p>\n

Contexto:<\/strong> O plugin original page-links-to<\/code> \u00e9 \u00fatil para criar “atalhos” \u2013 uma p\u00e1gina que redireciona para um link externo ou interno. Nosso MU-Plugin faz exatamente isso, com c\u00f3digo limpo e sem sobrecarga, usando o hook template_redirect<\/code> e armazenando o link como metadado.<\/p>\n

Funcionalidades implementadas<\/h3>\n
    \n
  • Metabox na edi\u00e7\u00e3o de posts\/p\u00e1ginas\/CPTs para inserir a URL de redirecionamento.<\/li>\n
  • Redirecionamento HTTP 307 (tempor\u00e1rio) ou configur\u00e1vel para 301 (permanente).<\/li>\n
  • Suporte a URLs internas (ex: \/contato<\/code>) ou externas (ex: https:\/\/exemplo.com<\/code>).<\/li>\n
  • Verifica\u00e7\u00e3o se o campo foi preenchido e se n\u00e3o est\u00e1 em branco ou vazio.<\/li>\n
  • Total compatibilidade com o Elementor e outros builders \u2013 o redirecionamento ocorre antes de qualquer renderiza\u00e7\u00e3o.<\/li>\n<\/ul>\n

    C\u00f3digo do MU-Plugin: neodoor-page-redirect.php<\/code><\/h3>\n

    Crie a pasta wp-content\/mu-plugins\/neodoor-page-redirect\/<\/code> e dentro dela o arquivo neodoor-page-redirect.php<\/code> com o conte\u00fado abaixo.<\/p>\n

    <?php\n\/**\n * Plugin Name:  Neodoor Page Redirect (ex-page-links-to)\n * Description:  Permite redirecionar qualquer p\u00e1gina\/post\/CPT para uma URL externa ou interna, via metabox.\n * Version:      1.0\n * Author:       Reinaldo (Neodoor.neo)\n *\/\n\nif ( ! defined( 'ABSPATH' ) ) {\n    exit;\n}\n\nclass Neodoor_Page_Redirect {\n\n    private static $instance = null;\n    private $meta_key = '_neodoor_redirect_url';\n\n    public static function get_instance() {\n        if ( null === self::$instance ) {\n            self::$instance = new self();\n        }\n        return self::$instance;\n    }\n\n    private function __construct() {\n        add_action( 'add_meta_boxes', [ $this, 'add_meta_box' ] );\n        add_action( 'save_post', [ $this, 'save_redirect_url' ] );\n        add_action( 'template_redirect', [ $this, 'do_redirect' ] );\n    }\n\n    \/**\n     * Adiciona a metabox na tela de edi\u00e7\u00e3o de posts\/p\u00e1ginas\/CPTs\n     *\/\n    public function add_meta_box() {\n        $screens = get_post_types( [ 'public' => true ], 'names' );\n        foreach ( $screens as $screen ) {\n            add_meta_box(\n                'neodoor_redirect_meta_box',\n                'Redirecionar para URL externa',\n                [ $this, 'render_meta_box' ],\n                $screen,\n                'side',\n                'default'\n            );\n        }\n    }\n\n    \/**\n     * Renderiza o campo da metabox\n     *\/\n    public function render_meta_box( $post ) {\n        $value = get_post_meta( $post->ID, $this->meta_key, true );\n        wp_nonce_field( 'neodoor_redirect_nonce', 'neodoor_redirect_nonce_field' );\n        echo '<label for=\"neodoor_redirect_url\">URL de redirecionamento:<\/label>';\n        echo '<input type=\"text\" id=\"neodoor_redirect_url\" name=\"neodoor_redirect_url\" value=\"' . esc_attr( $value ) . '\" style=\"width:100%;\" \/>';\n        echo '<p class=\"description\">Ex: https:\/\/exemplo.com ou \/contato. Deixe vazio para desativar.<\/p>';\n    }\n\n    \/**\n     * Salva o valor do campo ao salvar o post\n     *\/\n    public function save_redirect_url( $post_id ) {\n        if ( ! isset( $_POST['neodoor_redirect_nonce_field'] ) ) return;\n        if ( ! wp_verify_nonce( $_POST['neodoor_redirect_nonce_field'], 'neodoor_redirect_nonce' ) ) return;\n        if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) return;\n        if ( ! current_user_can( 'edit_post', $post_id ) ) return;\n\n        if ( isset( $_POST['neodoor_redirect_url'] ) ) {\n            $url = esc_url_raw( trim( $_POST['neodoor_redirect_url'] ) );\n            if ( ! empty( $url ) ) {\n                update_post_meta( $post_id, $this->meta_key, $url );\n            } else {\n                delete_post_meta( $post_id, $this->meta_key );\n            }\n        }\n    }\n\n    \/**\n     * Executa o redirecionamento no frontend (hook template_redirect)\n     *\/\n    public function do_redirect() {\n        \/\/ N\u00e3o redirecionar no admin, feeds, rob\u00f4s, etc.\n        if ( is_admin() || is_feed() || is_robots() || is_trackback() ) {\n            return;\n        }\n\n        \/\/ Verifica se \u00e9 um post singular (p\u00e1gina, post, CPT)\n        if ( ! is_singular() ) {\n            return;\n        }\n\n        $post_id = get_queried_object_id();\n        if ( ! $post_id ) {\n            return;\n        }\n\n        $redirect_url = get_post_meta( $post_id, $this->meta_key, true );\n        if ( empty( $redirect_url ) ) {\n            return;\n        }\n\n        \/\/ Se a URL n\u00e3o come\u00e7ar com http:\/\/ ou https:\/\/ nem com \/, assume-se que \u00e9 um caminho relativo\n        if ( ! preg_match( '#^(https?:\/\/|\/)#', $redirect_url ) ) {\n            $redirect_url = '\/' . ltrim( $redirect_url, '\/' );\n        }\n\n        \/\/ Redirecionamento com status 307 (tempor\u00e1rio). Para 301 (permanente), troque para 301.\n        wp_redirect( $redirect_url, 307 );\n        exit;\n    }\n}\n\nNeodoor_Page_Redirect::get_instance();\n<\/code><\/pre>\n
    Instru\u00e7\u00f5es de instala\u00e7\u00e3o<\/h3>\n
      \n
    1. Certifique-se de que o autoloader loader.php<\/code> esteja presente em \/mu-plugins\/<\/code>.<\/li>\n
    2. Crie a pasta neodoor-page-redirect<\/code> dentro de \/mu-plugins\/<\/code>.<\/li>\n
    3. Dentro dela, crie o arquivo neodoor-page-redirect.php<\/code> e cole o c\u00f3digo acima.<\/li>\n
    4. N\u00e3o \u00e9 necess\u00e1rio ativar nada \u2013 MU-Plugins carregam automaticamente.<\/li>\n
    5. Desative e remova o plugin page-links-to<\/code> se estiver instalado.<\/li>\n<\/ol>\n
      Como testar<\/h3>\n
        \n
      1. Edite qualquer p\u00e1gina ou post.<\/li>\n
      2. Na lateral direita, procure a metabox “Redirecionar para URL externa”.<\/li>\n
      3. Insira uma URL (ex: https:\/\/wordpress.org<\/code> ou \/minha-outra-pagina<\/code>).<\/li>\n
      4. Salve o post.<\/li>\n
      5. Acesse a p\u00e1gina no frontend \u2013 voc\u00ea ser\u00e1 redirecionado automaticamente.<\/li>\n
      6. Para desativar, basta remover a URL da metabox e salvar novamente.<\/li>\n<\/ol>\n
        Personaliza\u00e7\u00f5es poss\u00edveis<\/h3>\n
          \n
        • Redirecionamento permanente (301):<\/strong> Altere o c\u00f3digo wp_redirect( $redirect_url, 307 );<\/code> para wp_redirect( $redirect_url, 301 );<\/code>.<\/li>\n
        • Restringir a apenas p\u00e1ginas:<\/strong> No m\u00e9todo add_meta_box<\/code>, troque $screens = get_post_types( ... )<\/code> por $screens = [ 'page' ];<\/code>.<\/li>\n
        • Adicionar mensagem de aviso:<\/strong> Antes do redirecionamento, voc\u00ea pode exibir uma mensagem usando add_action( 'wp_head', ... )<\/code>, mas cuidado com loops.<\/li>\n<\/ul>\n
          Plugins substitu\u00eddos<\/h3>\n
            \n
          • page-links-to<\/code> \u2013 totalmente substitu\u00eddo (metabox + redirecionamento).<\/li>\n<\/ul>\n
            Observa\u00e7\u00f5es finais<\/h3>\n
              \n
            • O redirecionamento acontece no hook template_redirect<\/code>, que \u00e9 executado antes de qualquer conte\u00fado ser renderizado \u2013 ideal para evitar renderiza\u00e7\u00e3o desnecess\u00e1ria.<\/li>\n
            • URLs relativas (como \/contato<\/code>) s\u00e3o automaticamente transformadas em URLs absolutas a partir da raiz do site.<\/li>\n
            • Se voc\u00ea usar cache (ex: WP Super Cache), o redirecionamento ainda funciona, pois ele ocorre antes do cache ser servido.<\/li>\n
            • Compat\u00edvel com PHP 8.4 e WordPress 6.x.<\/li>\n<\/ul>\n
              Registro no caderno<\/h3>\n
              Data:<\/strong> <\/p>\n
              Funcionalidade:<\/strong> Redirecionamento de p\u00e1ginas\/posts para URL externa via metabox.<\/p>\n
              Plugins substitu\u00eddos:<\/strong> page-links-to.<\/p>\n
              Tempo de implementa\u00e7\u00e3o:<\/strong> ~10 minutos.<\/p>\n","protected":false},"excerpt":{"rendered":"
              Aula: Redirecionar p\u00e1gina para URL externa \u2013 substituindo o plugin “page-links-to” Objetivo: Criar um MU-Plugin leve que adiciona uma metabox na edi\u00e7\u00e3o de p\u00e1ginas, posts e custom post types, permitindo definir uma URL externa. Quando a p\u00e1gina for acessada no frontend, o usu\u00e1rio ser\u00e1 redirecionado automaticamente para essa URL, sem necessidade de plugins pesados. Contexto: […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2,4],"tags":[],"class_list":["post-321","post","type-post","status-publish","format-standard","hentry","category-lessons","category-pluginsmu"],"_links":{"self":[{"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/posts\/321","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/comments?post=321"}],"version-history":[{"count":0,"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/posts\/321\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/media?parent=321"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/categories?post=321"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/tags?post=321"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}