En el artículo anterior vimos como se podía crear un tipo de entrada o módulo parecido a páginas o entradas pero que sirviese para gestionar otro tipo de contenido y que a este contenido se le conoce como entradas personalizadas. Ahora vamos a ver como podemos mostrarlo en nuestro sitio.
Recuperando entradas
Para poder filtrar que datos queremos mostrar en un lugar concreto de nuestra web debemos usar el bucle personalizado wp_query().
$args = array ('posts_per_page' => '-1', 'post_type' => 'productos', 'tax_query' => array(array('taxonomy'=>'category','field'=>'slug','terms'=>'señales')));
$misProductos = new WP_query($args);
En este ejemplo, el bucle de WordPress solo devolverá las entradas de tipo PRODUCTO, y que estén asociadas a la categoría => SEÑALES.
Parámetros de una entrada
Post_type: se establece el nombre del módulo del que queremos extraer entradas, por ejemplo si tengo un nuevo módulo de entradas personalizadas llamado testimonios tendría que indicar que quiero extraer ese tipo de entradas.
Tax_query: permite diferentes valores, que sirven para filtrar por taxonomías (categorías o etiquetas, en el próximo artículo comentare como crear otros tipos a medida) y dentro de 1 taxonomía filtrar por un término concreto o varios.
Post_per_page: cuantas entradas queremos mostrar.
Como existen muchas posibilidades y van cambiando lo mejor es consultar el codex de WordPress. https://codex.wordpress.org/Class_Reference/WP_Query, consulta los parámetros.
Donde mostrar el contenido
Podemos incluir el nuevo contenido tanto en un widget como en una plantilla usando el filtrado y con un poco de programación y maquetación HTML.
Además si a la hora de crear el nuevo módulo hemos indicado el atributo has_archive como true, podemos crear 2 páginas en nuestra plantilla de WordPress que automáticamente se llamarán para:
- Mostrar un listado de todas las entradas: archive-(nombreModulo).php
- Mostrar una entrada concreta: single-(nombreModulo).php
Funciones especiales para entradas personalizadas
Get_post_types($parametros): devuelve todos los módulos o tipos de entrada registrados y se usa para ver los nombres registrados.
$args = array('public' => true, '_builtin' => false);
$articulos=get_post_types($args, 'names', 'and');
foreach ($articulos as $articulo){
echo "<p>".$articulo."</p>";
}
Podemos ver un listado de los tipos de entrada registrados activados y que no sean (_builtin=false) entradas o páginas. En este caso quiero ver los que estén registrados con el nombre productos y en segundo lugar indicamos que los argumentos son AND.
Get_post_type(id): devuelve el nombre del modulo de una entrada concreta.
$post=35; get_post_type($post);
Dado un id de una entrada puedo saber a que tipo pertenece.
post_type_exists(): Comprueba si existe el tipo de entrada.
if (post_type_exists('productos')){
echo "Existen entradas de productos.";
}
add_post_type_ support($tipoEntrada,$parametros): se usa para añadir nuevos campos (no establecido en el plugin o código fuente) a un módulo. Es muy útil para modificar un plugin que genere un módulo sin tocar el código fuente del mismo. Por ejemplo, si un módulo de un plugin crea un módulo de entradas sin opción a añadir comentarios, podemos modificar lo desde nuestro plugin usando esta función.
add_post_type_support('productos', array('comments'));
En este ejemplo añadimos que el tipo de entrada productos permita introducir comentarios.
set_post_type($idEntrada, $tipoEntrada): se usa para para cambiar el tipo de entrada de una a otra.
set_post_type('13','productos');
En este ejemplo la entrada 13 pasará a ser del tipo de entrada productos.
Como siempre recomendamos usar el codex de WordPress para aprender las diferentes etiquetas existentes para las múltiplesfunciones: https://codex.wordpress.org/Function_Reference/register_post_type