Cum pot forța descărcarea unui fișier în interfața de administrare WordPress?

Dacă te înțeleg corect, vrei să ai un URL similar cu următorul al cărui răspuns către browser va fi conținutul pe care îl generezi, adică fișierul tău .CSV și nu conținut generat de WordPress?

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

Cred că cauți hook-ul 'template_redirect'. Poți găsi 'template_redirect' în /wp-includes/template-loader.php, un fișier pe care toți dezvoltatorii WordPress ar trebui să-l cunoască; este scurt și la obiect și direcționează fiecare încărcare de pagină care nu este în admin, așa că asigură-te să arunci o privire.

Doar adaugă următoarele în fișierul functions.php al temei tale sau într-un alt fișier pe care îl include în 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();
  }
}

Observă testul pentru URL-ul '/downloads/data.csv' prin inspectarea $_SERVER['REQUEST_URI']. De asemenea, observă adăugarea ,true,200 la apelul tău header() unde setezi Content-type; acest lucru se datorează faptului că WordPress va fi setat codul de stare 404 "Not Found" pentru că nu recunoaște URL-ul. Nu este o problemă, deoarece true îi spune lui header() să înlocuiască 404 setat de WordPress și să folosească în schimb codul de stare HTTP 200 "Okay".

Și iată cum arată în FireFox (Notă captura de ecran nu are un director virtual /downloads/ pentru că după ce am făcut și adnotat captura de ecran, a părut o idee bună să adaug un director virtual '/downloads/'):

_{(sursa: mikeschinkel.com)}

ACTUALIZARE

Dacă dorești ca descărcarea să fie gestionată dintr-un URL prefixat cu /wp-admin/ pentru a oferi utilizatorului o indicație vizuală că este protejată de un login, poți face și asta; descrierea unei modalități urmează.

Am încapsulat de data aceasta într-o clasă, numită DownloadCSV, și am creat o "capabilitate" de utilizator numită 'download_csv' pentru rolul 'administrator' (citește despre Roluri și Capabilități aici) Ai putea pur și simplu să te bazezi pe rolul predefinit 'export' dacă dorești și, în acest caz, doar caută și înlocuiește 'download_csv' cu 'export' și elimină apelul register_activation_hook() și funcția activate(). Apropo, nevoia unui hook de activare este un motiv pentru care am mutat acest lucru într-un plugin în loc să-l păstrez în fișierul functions.php al temei.*

Am adăugat și o opțiune de meniu "Descarcă CSV" sub meniul "Unelte" folosind add_submenu_page() și am legat-o de capabilitatea 'download_csv'.

În final, am ales hook-ul 'plugins_loaded' pentru că a fost cel mai timpuriu hook adecvat pe care l-am putut folosi. Ai putea folosi 'admin_init', dar acel hook este rulat mult mai târziu (al 1130-lea apel de hook față de al 3-lea apel de hook), așa că de ce să lași WordPress să facă mai multă muncă inutilă decât este necesar? (Am folosit plugin-ul meu Instrument Hooks pentru a afla ce hook să folosesc.)

În hook, verific să mă asigur că URL-ul meu începe cu /wp-admin/tools.php prin inspectarea variabilei $pagenow, verific dacă current_user_can('download_csv') și, dacă acest lucru trece, atunci testez $_GET['download'] pentru a vedea dacă conține data.csv; dacă da, rulăm practic același cod ca înainte. Am eliminat și ,true,200 din apelul către header() din exemplul anterior pentru că aici WordPress știe că este un URL valid, așa că nu a setat încă statusul 404. Deci, iată codul tău:

<?php
/*
Plugin Name: Descarcă 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',    // Meniul Părinte
        'Descarcă CSV',                // Titlul Paginii
        'Descarcă CSV',                // Eticheta Opțiunii de Meniu
        'download_csv',                // Capabilitate
        'tools.php?download=data.csv');// URL-ul Opțiunii relativ la /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();
}

Și iată o captură de ecran a plugin-ului activat:
_{(sursa: mikeschinkel.com)}

Și în final, iată o captură de ecran a declanșării descărcării:
_{(sursa: mikeschinkel.com)}