Cum să adaugi opțiunea "Fixează acest articol pe prima pagină" în front-end?

Sunt câteva funcții care ne sunt utile aici:

• unstick_post - Anulează fixarea unui articol
• stick_post - Fixează un articol
• is_sticky - Verifică dacă un articol este fixat

Cu aceste trei funcții în minte, tot ce trebuie să facem este să le combinăm cu un pic de "clei" din bara de meniu de administrare.

În primul rând, să încapsulăm totul într-o clasă pentru distracție și profit. Această clasă va avea câteva constante pe care le vom folosi mai târziu: un nonce, o acțiune pentru anularea fixării articolului și o acțiune pentru fixarea articolului.

class WPSE_58818_Stick_Post
{
    /**
     * Ajax nonce.
     *
     * @since   1.0
     */
    const NONCE = 'wpse58818_nonce_';

    /**
     * Acțiunea Ajax pentru anularea fixării
     *
     * @since   1.0
     */
    const UNSTICK = 'wpse58818_unstick';

    /**
     * Acțiunea Ajax pentru fixare
     *
     * @since   1.0
     */
    const STICK = 'wpse58818_stick';
} // sfârșitul clasei

Apoi să adăugăm o funcție de inițializare pentru a adăuga acțiunile noastre. Prima acțiune fiind să ne conectăm la template_redirect.

<?php
class WPSE_58818_Stick_Post
{
    // tăiat tăiat

    /**
     * Adaugă acțiuni și altele.
     *
     * @since   1.0
     * @access  public
     * @uses    add_action
     */
    public static function init()
    {
        add_action(
            'template_redirect',
            array(__CLASS__, 'template_r')
        );
    }
}

NOTĂ: de acum încolo voi omite partea cu class. Puteți vedea întregul cod aici.

În funcția conectată la template_redirect, vom verifica dacă suntem pe o pagină de articol unic și dacă utilizatorul poate să-l editeze. Dacă poate, ne vom conecta la admin_bar_menu și wp_footer.

/**
 * Conectat la `template_redirect`. Adaugă butonul de fixare/anulare fixării
 * în bara de administrare dacă suntem pe o pagină de articol unic și utilizatorul curent
 * poate edita articolul
 * 
 * @since   1.0
 * @access  public
 * @uses    add_action
 */
public static function template_r()
{
    if(
        !is_single() ||
        !current_user_can('edit_post', get_queried_object_id())
    ) return; // nu este un articol unic sau utilizatorul nu poate să-l editeze

    // Conectare la admin_bar_menu pentru a adăuga elemente
    add_action(
        'admin_bar_menu',
        array(__CLASS__, 'menu'),
        100
    );

    // Conectare la subsol și afișare de JavaScript
    add_action(
        'wp_footer',
        array(__CLASS__, 'footer')
    );
}

În funcția menu, conectată la admin_bar_menu, putem adăuga noul nostru element:

/**
 * Conectat la `admin_bar_menu`. Adaugă nodul nostru de fixare/anulare fixării.
 *
 * @since   1.0
 * @access  public
 */
public static function menu($mb)
{
    // obține ID-ul articolului curent
    $post_id = get_queried_object_id();

    $mb->add_node(array(
        'id'    => 'wpse58818-sticker',
        'meta'  => array(
            'class' => 'wpse58818-sticker',
            'title' => is_sticky($post_id) ? 'anulează fixarea' : 'fixează'
        ),
        'title' => is_sticky($post_id) ? __('Anulează fixarea') : __('Fixează'),
        'href'  => self::get_url($post_id)
    ));
}

Aici avem prima "funcție utilitară" care construiește un URL pentru nodul din bara de meniu de administrare. Este doar un wrapper în jurul add_query_arg pentru a adăuga nonce și a construi un URL pe care îl vom folosi cu AJAX mai târziu:

/**
 * Obține un URL Ajax pentru a folosi pentru un articol dat
 *
 * @since   1.0
 * @access  protected
 */
protected static function get_url($post_id)
{
    return add_query_arg(array(
        'post_id' => absint($post_id),
        'action'  => is_sticky($post_id) ? self::UNSTICK : self::STICK,
        'nonce'   => wp_create_nonce(self::NONCE . $post_id)
    ), admin_url('admin-ajax.php'));
}

Funcția footer doar afișează un pic de JavaScript pentru a face apelurile AJAX. Prezentare generală: când cineva dă clic pe noul nostru link, se face o cerere GET la URL-ul dat. Dacă este reușită, se schimbă href-ul, textul și titlul linkului de (anulare) fixare.

/**
 * Conectat la `wp_footer`. Afișează un pic de JS pentru a fixa/anula fixarea unui articol
 *
 * @since   1.0
 * @access  public
 */
public static function footer()
{
    ?>
    <script type="text/javascript">
    jQuery(document).ready(function($) {
        $('.wpse58818-sticker a').on('click', function(e) {
            e.preventDefault();
            var action = $(this).attr('title');
            var that = this;
            $.get(
                $(this).attr('href'),
                {},
                function(data) {
                    if('0' == data)
                    {
                        console.log(data);
                        alert('<?php echo esc_js(__('A apărut o eroare')); ?>');
                        return;
                    }

                    $(that).attr('href', data);
                    if('fixează' == action) {
                        $(that).html('<?php echo esc_js(__('Anulează fixarea')); ?>');
                        $(that).attr('title', 'anulează fixarea');
                    } else {
                        $(that).html('<?php echo esc_js(__('Fixează')); ?>');
                        $(that).attr('title', 'fixează');
                    }
                }
            );
        });
    });
    </script>
    <?php
}

Și acum ajungem la callback-urile AJAX. Ajax în plugin-uri/teme merită citit.

Vom modifica puțin funcția noastră init pentru a adăuga încă două acțiuni:

/**
 * Adaugă acțiuni și altele.
 *
 * @since   1.0
 * @access  public
 * @uses    add_action
 */
public static function init()
{
    add_action(
        'template_redirect',
        array(__CLASS__, 'template_r')
    );

    // Acțiuni Ajax
    add_action(
        'wp_ajax_' . self::STICK,
        array(__CLASS__, 'stick')
    );

    add_action(
        'wp_ajax_' . self::UNSTICK,
        array(__CLASS__, 'unstick')
    );
}

Și callback-urile noastre AJAX. Acestea ar putea fi foarte ușor aceeași funcție. Le-am separat aici pentru că părea mai ușor de extins/modificat în viitor. Ambele verifică dacă cererea AJAX este validă, (anulează) fixează articolul în consecință și afișează noul URL pentru viitoarele operații de (anulare) fixare.

/**
 * Callback Ajax pentru funcția de fixare
 *
 * @since   1.0
 * @access  public
 */
public static function stick()
{
    $post_id = self::can_ajax();

    stick_post($post_id);

    echo self::get_url($post_id);
    die();
}

/**
 * Callback Ajax pentru funcția de anulare fixării
 *
 * @since   1.0
 * @access  public
 * @uses    unstick_post
 */
public static function unstick()
{
    $post_id = self::can_ajax();

    // nonce-urile verificate, totul este în regulă. Anulează fixarea!
    unstick_post($post_id);

    echo self::get_url($post_id);
    die();
}

Aici apare a doua noastră "funcție utilitară". can_ajax verifică nonce-urile și permisiunile utilizatorului și returnează ID-ul articolului de (anulat) fixat. Dacă orice verificare eșuează, se termină (prin die('1')).

/**
 * Verifică dacă utilizatorul curent poate folosi Ajax. Returnează ID-ul articolului
 * de fixat/anulat fixarea dacă este reușit. În caz contrar, oprește programul
 *
 * @since   1.0
 * @access  protected
 */
protected static function can_ajax()
{
    $post_id = isset($_REQUEST['post_id']) ? $_REQUEST['post_id'] : '';

    if(
        !$post_id ||
        !check_ajax_referer(self::NONCE . $post_id, 'nonce', false)
    ) die('0');

    if(!current_user_can('edit_post', $post_id))
        die('0');

    return $post_id;
}

Iată întregul mizerie ca un plugin.

Iată o soluție mult mai simplă care va face treaba folosind cârligul de filtrare the_content

add_filter('the_content','simplest_sticky_solution');
function simplest_sticky_solution($content){
    global $post;
    //ieșire rapidă dacă nu este necesar
    if (!is_single() || !current_user_can('edit_post',$post->ID)) 
        return $content;

    //verifică dacă formularul este trimis și acționează după caz
    if (isset($_POST['sticky_action']) && isset($_POST['sticky_id']) && isset($_POST['sticky_nonce']) && wp_verify_nonce($_POST['sticky_nonce'], 'StickIt')){
        if (is_sticky($post->ID)){
            stick_post($post->ID);
        }else{
            unstick_post($post->ID);
        }
    }

    //creează formularul
    $label = (is_sticky())? "Anulează fixare": "Fixează";
    $form = '
    <form action="" method="POST">
        <input type="hidden" name="sticky_id" value="'.$post->id.'">
        <input type="hidden" name="sticky_action" value="stickit">
        <input type="hidden" name="sticky_nonce" value="'.wp_create_nonce('StickIt').'">
        <input type="button" name="submit" value="'.$label.'">
    </form>';
    return $form.'<br/>'.$content;
}