WordPress.org API - Ottieni i plugin preferiti degli autori

I plugin preferiti sono stati aggiunti all'API di WordPress.org. C'è una nuova funzionalità nella versione 3.5 che ti permette di accedere ai tuoi preferiti dall'installatore dei plugin.

Vedi http://core.trac.wordpress.org/ticket/22002 per informazioni su come viene utilizzato nel core.

L'API ti permette di recuperare un oggetto che contiene ogni plugin con:

• nome
• descrizione
• autore
• valutazione
• data ultimo aggiornamento
• log delle modifiche
• versione stabile
• compatibilità con la versione di wp

Per recuperare l'oggetto

Effettua una chiamata a http://api.wordpress.org/plugins/info/1.0/ utilizzando wp_remote_post passando un array di argomenti incluso l'action che sarebbe 'query_plugins' e lo username di wp.org da cui recuperare i preferiti.

$request = wp_remote_post('http://api.wordpress.org/plugins/info/1.0/', array( 'timeout' => 15, 'body' => array('action' => $action, 'request' => serialize($args))) );

Prima di ottenere un oggetto pulito e ordinato, devi gestire gli errori e fare qualche parsing. Ecco una funzione di esempio che restituirà un oggetto pulito con tutti i dettagli del plugin.

function api( $action, $args ) {
        if ( is_array( $args ) )
            $args = (object) $args;

        $request = wp_remote_post('http://api.wordpress.org/plugins/info/1.0/', array( 'timeout' => 15, 'body' => array('action' => $action, 'request' => serialize($args))) );
        if ( is_wp_error($request) ) {
            $res = new WP_Error('plugins_api_failed', __( 'Si è verificato un errore inaspettato. Potrebbe esserci un problema con WordPress.org o la configurazione di questo server. Se continui ad avere problemi, prova i <a href="http://wordpress.org/support/">forum di supporto</a>.' ), $request->get_error_message() );
        } else {
            $res = maybe_unserialize( wp_remote_retrieve_body( $request ) );
            if ( ! is_object( $res ) && ! is_array( $res ) )
                $res = new WP_Error('plugins_api_failed', __( 'Si è verificato un errore inaspettato. Potrebbe esserci un problema con WordPress.org o la configurazione di questo server. Se continui ad avere problemi, prova i <a href="http://wordpress.org/support/">forum di supporto</a>.' ), wp_remote_retrieve_body( $request ) );
        }

        return apply_filters( 'c3m_favorite_results', $res, $action, $args );
    }

Utilizzo

Questo esempio di utilizzo ti darà una lista non ordinata dei plugin preferiti insieme a un link al plugin su WordPress.org, un link all'URI dell'autore e la valutazione a stelle.

$api_data = api( 'query_plugins', array( 'user' => 'my_dot_org_username' ) );
$api_plugins = $api_data->plugins;

echo '<ul class="c3m-favorites">';
        foreach( $api_plugins as $plugin ) {

            $name = $plugin->name; ?>
            <li><strong><a target="_blank" href="http://wordpress.org/extend/plugins/<?php echo $plugin->slug ?>/"><?php echo esc_html( $name ); ?></a></strong><br>

                <div class="star-holder" title="<?php printf( _n( '(basato su %s valutazione)', '(basato su %s valutazioni)', $plugin->num_ratings ), number_format_i18n( $plugin->num_ratings ) ); ?>">
                <div class="star star-rating" style="width: <?php echo esc_attr( str_replace( ',', '.', $plugin->rating ) ); ?>px"></div></div>

                <em><?php _e('Di: ') ?></em> <?php echo links_add_target( $plugin->author, '_blank' ). '<br>'; ?>
            </li><?php
        }
        echo '</ul>';

Risultato

Screenshot del widget dal mio plugin Favorite Plugins Widget: http://wordpress.org/extend/plugins/favorite-plugins-widget/