Aggiungere un link arbitrario al menu di amministrazione di WordPress

Ciao @Tom,

Se ho capito correttamente la tua domanda, non hai tanto bisogno di sapere come aggiungere un link al menu (sembra che tu lo sappia già) ma piuttosto hai bisogno di imparare come fare in modo che il tuo link reindirizzi correttamente, giusto?

Reindirizzare a un URL Esterno da una Voce di Menu nell'Area di Amministrazione

Se è così, quello che devi fare è non usare la funzione della voce di menu ma invece "agganciare" WordPress abbastanza presto in modo che non abbia ancora inviato alcun output a parte eventualmente gli header HTTP. L'hook più precoce quando si chiama /wp-admin/themes.php sembra essere after_setup_theme e funziona bene.

Usa uno "Slug del Menu" per Poterlo Testare in un Hook

Ma per farlo funzionare, dobbiamo prima modificare la tua chiamata a add_theme_page nell'hook admin_menu / la tua funzione create_theme_style_page(). Abbiamo eliminato il quinto parametro (la funzione da chiamare per implementare l'opzione di amministrazione) perché non ci serve, e abbiamo cambiato il quarto parametro (lo "slug del menu") in themes.php?goto=build-styleguide-page.

Anche se avremmo potuto scegliere praticamente qualsiasi cosa per il quarto parametro, dato che stiamo per reindirizzare, ho indirizzato alla stessa pagina (themes.php) delle altre opzioni di aspetto per coerenza. Ho anche arbitrariamente scelto il nome goto perché WordPress non lo usa e sembra avere senso in questo contesto.

add_action('admin_menu', 'create_theme_style_page');
function create_theme_style_page() {
  add_theme_page(
    'Guida di Stile del Tema',
    'Guida di Stile del Tema',
    'administrator',
    'themes.php?goto=build-styleguide-page'
  );
}

BTW, abbiamo eliminato la tua funzione build_styleguide_page() perché non ci serve per questa soluzione.

Reindirizzamento nell'Hook più Precoce per themes.php: after_setup_theme

Come ultimo pezzo di codice, implementiamo il nostro hook after_setup_theme nella nostra funzione redirect_from_admin_menu(). Facciamo in modo che verifichi se la pagina corrente è themes.php e che assicuri che un parametro URL di goto sia stato passato nell'URL. Poi testa il valore di goto usando un'istruzione switch/case per vedere se ha un valore di 'build-styleguide-page'; se è così, reindirizza al tuo esempio ipotetico, ad esempio Google, altrimenti reindirizziamo semplicemente alla dashboard di amministrazione:

add_action('after_setup_theme', 'redirect_from_admin_menu');
function redirect_from_admin_menu($value) {
  global $pagenow;
  if ($pagenow=='themes.php' && !empty($_GET['goto'])) {
    switch ($_GET['goto']) {
      case 'build-styleguide-page':
        wp_redirect("http://www.google.com");
        break;
      default:
        wp_safe_redirect('/wp-admin/');
        break;
    }
    exit;
  }
}

Note:

1. Ho scelto di usare l'istruzione switch/case nell'hook after_setup_theme / funzione redirect_from_admin_menu() in modo che fosse più semplice aggiungere ulteriori reindirizzamenti goto se necessario; basta aggiungere più istruzioni case.

2. le funzioni wp_redirect() e wp_safe_redirect() non terminano effettivamente; devi emettere esplicitamente un'istruzione exit per far sì che WordPress si fermi e non sovrascriva il tuo reindirizzamento.

Spero che questo ti aiuti!