Come posso forzare il download di un file nel backend di WordPress?

Se ho capito correttamente, vuoi avere un URL simile al seguente la cui risposta al browser sarà il contenuto che generi, cioè il tuo file .CSV e nessun contenuto generato da WordPress?

http://example.com/download/data.csv

Penso che tu stia cercando l'hook 'template_redirect'. Puoi trovare 'template_redirect' in /wp-includes/template-loader.php che è un file che tutti gli sviluppatori WordPress dovrebbero conoscere; è breve e semplice e gestisce ogni caricamento di pagina non amministrativo, quindi assicurati di darci un'occhiata.

Aggiungi semplicemente il seguente codice al file functions.php del tuo tema o in un altro file che includi in functions.php:

add_action('template_redirect','yoursite_template_redirect');
function yoursite_template_redirect() {
  if ($_SERVER['REQUEST_URI']=='/downloads/data.csv') {
    header("Content-type: application/x-msdownload",true,200);
    header("Content-Disposition: attachment; filename=data.csv");
    header("Pragma: no-cache");
    header("Expires: 0");
    echo 'data';
    exit();
  }
}

Nota il test per l'URL '/downloads/data.csv' controllando $_SERVER['REQUEST_URI']. Nota anche l'aggiunta di ,true,200 alla tua chiamata header() dove imposti il Content-type; questo perché WordPress avrà impostato il codice di stato 404 "Non trovato" poiché non riconosce l'URL. Non è un problema però, poiché true dice a header() di sostituire il 404 impostato da WordPress e di utilizzare invece il codice di stato HTTP 200 "OK".

Ecco come appare in FireFox (Nota lo screenshot non ha una directory virtuale /downloads/ perché dopo aver scattato e annotato lo screenshot è sembrata una buona idea aggiungere una directory virtuale '/downloads/'):

_{(fonte: mikeschinkel.com)}

AGGIORNAMENTO

Se vuoi che il download venga gestito da un URL con prefisso /wp-admin/ per dare all'utente un'indicazione visiva che è protetto da un login, puoi farlo anche così; segue la descrizione di un modo per farlo.

Questa volta ho incapsulato il tutto in una classe chiamata DownloadCSV e ho creato una "capability" utente chiamata 'download_csv' per il ruolo 'administrator' (leggi su Ruoli e Capability qui) Potresti semplicemente sfruttare il ruolo predefinito 'export' se preferisci e, in tal caso, cerca e sostituisci 'download_csv' con 'export' e rimuovi la chiamata register_activation_hook() e la funzione activate(). A proposito, la necessità di un activation hook è uno dei motivi per cui ho spostato questo in un plugin invece di lasciarlo nel file functions.php del tema.*

Ho anche aggiunto un'opzione di menu "Download CSV" sotto il menu "Strumenti" usando add_submenu_page() e l'ho collegata alla capability 'download_csv'.

Infine ho scelto l'hook 'plugins_loaded' perché era l'hook appropriato più precoce che potevo usare. Potresti usare 'admin_init' ma quell'hook viene eseguito molto più tardi (1130° chiamata di hook rispetto alla 3° chiamata) quindi perché far fare a WordPress più lavoro inutile del necessario? (Ho usato il mio plugin Instrument Hooks per capire quale hook usare.)

Nell'hook verifico che il mio URL inizi con /wp-admin/tools.php controllando la variabile $pagenow, verifico che current_user_can('download_csv') e se tutto passa, allora controllo $_GET['download'] per vedere se contiene data.csv; se sì, eseguiamo praticamente lo stesso codice di prima. Ho anche rimosso ,true,200 dalla chiamata a header() nell'esempio precedente perché qui WordPress sa che è un URL valido quindi non ha ancora impostato lo status 404. Ecco il tuo codice:

<?php
/*
Plugin Name: Download CSV
Author: Mike Schinkel
Author URI: http://mikeschinkel.com
 */
if (!class_exists('DownloadCSV')) {
  class DownloadCSV {
    static function on_load() {
      add_action('plugins_loaded',array(__CLASS__,'plugins_loaded'));
      add_action('admin_menu',array(__CLASS__,'admin_menu'));
      register_activation_hook(__FILE__,array(__CLASS__,'activate'));
    }
    static function activate() {
      $role = get_role('administrator');
      $role->add_cap('download_csv');
    }
    static function admin_menu() {
      add_submenu_page('tools.php',    // Menu Genitore
        'Download CSV',                // Titolo Pagina
        'Download CSV',                // Etichetta Menu
        'download_csv',                // Capability
        'tools.php?download=data.csv');// URL Opzione relativo a /wp-admin/
    }
    static function plugins_loaded() {
      global $pagenow;
      if ($pagenow=='tools.php' && 
          current_user_can('download_csv') && 
          isset($_GET['download'])  && 
          $_GET['download']=='data.csv') {
        header("Content-type: application/x-msdownload");
        header("Content-Disposition: attachment; filename=data.csv");
        header("Pragma: no-cache");
        header("Expires: 0");
        echo 'data';
        exit();
      }
    }
  }
  DownloadCSV::on_load();
}

Ed ecco uno screenshot del plugin attivato:
_{(fonte: mikeschinkel.com)}

E infine ecco uno screenshot del download in corso:
_{(fonte: mikeschinkel.com)}