Johan de Bruin » API wordpress

Configurar el loop de wordpress

Johan — Wed, 30 Jun 2010 11:26:26 +0000

Hoy os traigo otro artículo para incorporarlo en la api de wordpress, el loop de wordpress es invocado cada vez que solicitamos articulos o páginas, en el index por ejemplo sale por defecto la solicitud de los últimos artículos publicados, en el archivo los articulos de cierto mes o cierta categoria, etc…

La api de wordpress nos permite una configuración bastante intensa de la forma de solicitar y mostrar contenido en los loops de wordpress, lo primero de todo es establecer los posts que queramos mostrar en el loop, se puede hacer usando la función query_posts();

query_posts('cat=4,5'); //Todos los que esten en la categoria 4 y 5
query_posts('tag=mitag'); //Los que tengan cierto tag...
query_posts('meta_key=nombrekey&meta_value=valorkey'); //Tenga un campo personalizado con dichos valores
 
 $categoria=$cat; // asignamos la actual categoria
 $query= 'cat=' . $categoria. '&orderby=date&order=ASC'; //ordenacion ascendente por fecha
 query_posts($query);

Como veis, tenemos mucho con que jugar a la hora de configurar el contenido del loop de wordpress, una vez hecho podemos crear el loop, tiene la siguiente estructura:

if (have_posts()) : while (have_posts()) : the_post();
//...
endwhile; else:
//...
endif;
wp_reset_query(); //Importante reiniciar loop para que wordpress funcione como habitualmente

Una vez dentro del loop podemos llamar a muchos valores de los posts, como por ejemplo el contenido, los tags, fecha, titulos, extracto, campos personalizados, la categoria… Aquí un ejemplo de como seria el código completo

query_posts('cat='.get_cat_ID('miCategoria')); //Establecemos el query con los posts de "miCategoria"
if (have_posts()) : while (have_posts()) : the_post();
     
 the_title(); ?>

      the_excerpt(); ?p>
     <p>php the_content(); ?>

$postMeta = get_post_custom_values('metaKey');
foreach ( $postMeta as $key => $value ) {
     echo "$key  => $value ('metaKey')
"; 
}
?>
endwhile; else:
    echo "No se encontraron articulos relacionados, puede que le interese alguna de las siguientes categorias"

    wp_list_categories(); ?>

endif;
wp_reset_query();

Añadir opciones a un plugin wordpress

Johan — Thu, 18 Mar 2010 14:18:29 +0000

Consta de una variable para establecer un nombre de id para establecer las opciones en la base de datos, añadir la acción al hook del menu al construir el plugin, establecer como aparecerá en la pestaña las opcinones con add_options_page, y el código que mostrará y gestionará las opciones insertadas. Aquí un ejemplo básico de como quedaría:


class miPlugin()
{
	var $db_option = 'miPlugin_Options';
 
	function miPlugin()
	{
		//Línea para incluir el menú
		add_action('miMenu', array(&$this, 'admin_menu'));
	}
 
	function miMenu()
	{
		add_options_page('Opciones del plugin', 'Algun id', 8, basename(__FILE__), array(&$this, 'opciones'));
	}
 
	function opciones()
	{
		$options = $this->get_options();
 
		if (isset($_POST['submitted'])) {
		  check_admin_referer('nonce');
		  $options = array();
		  $options['a'] = $_POST['a'];
		  $options['b'] = $_POST['b'];
		  update_option($this->db_option, $options);
		}
		// Aquí establecemos algunas variables que usaremos en el form
		$action_url = $_SERVER['REQUEST_URI'];
		$a = $options['a'];
		$b = $options['b'];
		?>
 
       	 echo $action_url ?>" method="post">
             wp_nonce_field('nonce'); ?>
             echo $a ?> /> Show Posts  

             echo $b ?> /> Show Pages  

            
       	
        
	}
}
?>

Solo decir que que las opciones se obtienen con $options = $this->get_options(); y se establecen con update_option($this->db_option, $options); Además, sirve como parametro de seguridad para cercionarnos que se está empleando el formulario correcto. Esto luego se comprueba con check_admin_referer(‘nonce’);

Integrar jquery con wordpress

Johan de Bruin — Sun, 24 Jan 2010 20:01:13 +0000

WordPress permite gracias a su api usar códigos de jquery, con esta libreria de javascript permitirás establecer una nueva forma de funcionamiento de las páginas web. Para usar jquery tendremos que invocar su código contenido en un archivo .js gracias a una serie de funciones que wordpress nos proporciona.

Para poder invocar el directorio del plugin, podemos usar el siguiente snnipet de wordpress:

$root_codigo = trailingslashit( WP_PLUGIN_URL.'/'. dirname( plugin_basename(__FILE__) ));

Ahora que ya tenemos establecida la url de la base donde se mantendrán distintos códigos, (como el .js con el jquery), podemos decir a wordpress que incluya susodicho código entre sus códigos:

function codigo() {
wp_enqueue_script('jquery');
wp_enqueue_script('un_nombre_script', $root_codigo.'/codigojquery.js', array('jquery'));
//Linea de código para pasar parametros al jquery
wp_localize_script('un_nombre_script', 'clase', array('algun_parametro' =&gt; 'valor'));
}
add_action('wp_print_scripts', 'codigo');

Usamos wp_localize_script para pasar los parámetros a la función jquery, en este caso la ruta del plugin, si quisieramos acceder en el jquery a dicho parámetro podemos usar la clase que enviamos asi: clase.algun_parametro.

Por último, un ejemplo de la estructura que podria tener codigojquery.js:

$(document).ready(function())
{
     $("a").click(function()
     {
          alert("Gracias por tu visita!");
     });
});

Por último, aquí un video de introducción sobre jquery:

Añadir codigos al header en wordpress

Johan de Bruin — Sun, 17 Jan 2010 19:20:57 +0000

A menudo querremos integrar dentro de la estructura distintos códigos para poder añadir comportamientos a la página web, (como algo de CSS o Javascript). Si no queremos andar añadiendo código al header.php del theme, podemos añadirselo gracias a un fabuloso hook que integra la API de WordPress.

function estilo_css() {
     body { background-color:#ffffff !important; }
}
add_action('admin_head', 'estilo_css');