Adăugarea metabox-ului „Atribute Pagină” și a șabloanelor de pagină în editorul de articole?

Nu-mi place să fiu cel care aduce vești proaste, dar WordPress codifică funcționalitatea Șablonului de Pagină doar pentru tipul de postare "page", cel puțin în versiunea 3.0 (acest lucru s-ar putea schimba în versiunile viitoare, dar nu există încă o inițiativă concretă despre care să știu. Așadar, acesta este unul dintre puținele momente când mă chinui să găsesc o soluție fără a modifica nucleul.)

Soluția pe care am găsit-o este să copiez codul relevant din nucleul WordPress și să-l modific pentru nevoile noastre. Iată pașii (numerele de linii sunt din versiunea 3.0.1):

1. Copiați funcția page_attributes_meta_box() de la linia 535 din /wp-admin/includes/meta-boxes.php și modificați-o conform nevoilor.

2. Scrieți un hook add_meta_boxes pentru a adăuga metabox-ul creat la pasul #1.

3. Copiați funcția get_page_templates() de la linia 166 din /wp-admin/includes/theme.php și modificați-o conform nevoilor.

4. Copiați funcția page_template_dropdown() de la linia 2550 din /wp-admin/includes/template.php și modificați-o conform nevoilor.

5. Adăugați un Șablon de Postare în tema dumneavoastră.

6. Scrieți un hook save_post pentru a permite salvarea numelui fișierului de șablon la salvare.

7. Scrieți un hook single_template pentru a permite încărcarea șablonului de postare pentru postările asociate.

Să începem!

1. Copiați funcția page_attributes_meta_box()

Ca prim pas, trebuie să copiați funcția page_attributes_meta_box() de la linia 535 din /wp-admin/includes/meta-boxes.php și am ales să o redenumesc post_template_meta_box(). Deoarece ați cerut doar șabloane de pagini, am omis codul pentru specificarea unei postări părinte și pentru specificarea ordinii, ceea ce simplifică codul. De asemenea, am ales să folosesc postmeta pentru aceasta în loc să încerc să reutilizez proprietatea page_template pentru a evita potențiale incompatibilități. Iată codul:

function post_template_meta_box($post) {
  if ( 'post' == $post->post_type && 0 != count( get_post_templates() ) ) {
    $template = get_post_meta($post->ID,'_post_template',true);
    ?>
<label class="screen-reader-text" for="post_template"><?php _e('Șablon de Postare') ?></label><select name="post_template" id="post_template">
<option value='default'><?php _e('Șablon Implicit'); ?></option>
<?php post_template_dropdown($template); ?>
</select>
<?php
  } ?>
<?php
}

2. Scrieți un hook add_meta_boxes

Următorul pas este să adăugați metabox-ul folosind hook-ul add_meta_boxes:

add_action('add_meta_boxes','add_post_template_metabox');
function add_post_template_metabox() {
    add_meta_box('postparentdiv', __('Șablon de Postare'), 'post_template_meta_box', 'post', 'side', 'core');
}

3. Copiați funcția get_page_templates()

Am presupus că ar avea sens să diferențiem între șabloanele de pagini și cele de postări, de unde necesitatea unei funcții get_post_templates() bazată pe get_page_templates() de la linia 166 din /wp-admin/includes/theme.php. În loc să folosim markerul Template Name: pe care îl folosesc șabloanele de pagini, această funcție folosește un marker Post Template:, așa cum vedeți mai jos.

De asemenea, am filtrat inspectarea functions.php (nu sunt sigur cum a funcționat vreodată corect get_page_templates() fără asta, dar în fine!). Singurul lucru rămas este să schimbăm referințele la cuvântul page în post pentru lizibilitate în viitor:

function get_post_templates() {
  $themes = get_themes();
  $theme = get_current_theme();
  $templates = $themes[$theme]['Template Files'];
  $post_templates = array();

  if ( is_array( $templates ) ) {
    $base = array( trailingslashit(get_template_directory()), trailingslashit(get_stylesheet_directory()) );

    foreach ( $templates as $template ) {
      $basename = str_replace($base, '', $template);
      if ($basename != 'functions.php') {
        // nu permite fișiere de șablon în subdirectoare
        if ( false !== strpos($basename, '/') )
          continue;

        $template_data = implode( '', file( $template ));

        $name = '';
        if ( preg_match( '|Post Template:(.*)$|mi', $template_data, $name ) )
          $name = _cleanup_header_comment($name[1]);

        if ( !empty( $name ) ) {
          $post_templates[trim( $name )] = $basename;
        }
      }
    }
  }

  return $post_templates;
}

4. Copiați funcția page_template_dropdown()

La fel, copiați page_template_dropdown() de la linia 2550 din /wp-admin/includes/template.php pentru a crea post_template_dropdown() și schimbați-o să apeleze get_post_templates():

function post_template_dropdown( $default = '' ) {
  $templates = get_post_templates();
  ksort( $templates );
  foreach (array_keys( $templates ) as $template )
    : if ( $default == $templates[$template] )
      $selected = " selected='selected'";
    else
      $selected = '';
  echo "\n\t<option value='".$templates[$template]."' $selected>$template</option>";
  endforeach;
}

5. Adăugați un Șablon de Postare

Următorul pas este să adăugați un șablon de postare pentru testare. Folosind markerul Post Template: menționat la pasul #3, copiați single.php din tema dumneavoastră în single-test.php și adăugați următorul antet de comentariu (asigurați-vă că modificați ceva în single-test.php pentru a putea observa că se încarcă în loc de single.php):

/**
 * Post Template: Șablonul Meu de Test
 */

După ce ați finalizat pașii #1 până la #5, puteți vedea metabox-ul "Șabloane de Postare" apărând în editorul de postări:

_{(sursa: mikeschinkel.com)}

6. Scrieți un hook save_post

Acum că editorul este configurat, trebuie să salvați numele fișierului de șablon în postmeta când utilizatorul apasă "Publică". Iată codul pentru asta:

add_action('save_post','save_post_template',10,2);
function save_post_template($post_id,$post) {
  if ($post->post_type=='post' && !empty($_POST['post_template']))
    update_post_meta($post->ID,'_post_template',$_POST['post_template']);
}

7. Scrieți un hook single_template

În final, trebuie să determinați WordPress să folosească noile șabloane de postare. Faceți acest lucru prin conectarea la hook-ul single_template și returnarea numelui de șablon dorit pentru postările care au unul asignat:

add_filter('single_template','get_post_template_for_template_loader');
function get_post_template_for_template_loader($template) {
  global $wp_query;
  $post = $wp_query->get_queried_object();
  if ($post) {
    $post_template = get_post_meta($post->ID,'_post_template',true);
    if (!empty($post_template) && $post_template!='default')
      $template = get_stylesheet_directory() . "/{$post_template}";
  }
  return $template;
}

Și asta e tot!

NOTĂ că nu am luat în considerare Tipurile Personalizate de Postare, doar post_type=='post'. În opinia mea, abordarea tipurilor personalizate de postare ar necesita diferențierea între diferitele tipuri de postări și, deși nu este foarte dificil, nu am încercat asta aici.