WordPress
Añadir Shortcode
Buscar..
Sintaxis
add_shortcode( $tag , $func );
Parámetros
| Parámetro | Detalles |
|---|---|
| $ etiqueta | (cadena) (requerido) Etiqueta de código corto para buscar en el contenido de la publicación |
| $ func | (se puede llamar) (requerido) Gancho para ejecutarse cuando se encuentra el código corto |
Observaciones
- A la devolución de llamada de shortcode se le pasarán tres argumentos: los atributos de shortcode, el contenido de shortcode (si corresponde) y el nombre del shortcode.
- Solo puede haber un gancho para cada shortcode. Lo que significa que si otro complemento tiene un código abreviado similar, anulará el tuyo o el tuyo anulará el suyo, según el orden en que se incluyan o se ejecuten.
- Los nombres de atributo de Shortcode siempre se convierten en minúsculas antes de pasarlos a la función de controlador. Los valores están intactos.
- Tenga en cuenta que la función llamada por el código abreviado nunca debe producir ningún tipo de salida. Las funciones de código abreviado deben devolver el texto que se utilizará para reemplazar el código abreviado. Producir la salida directamente conducirá a resultados inesperados. Esto es similar a la forma en que deben comportarse las funciones de filtro, ya que no deben producir los efectos secundarios esperados de la llamada, ya que no puede controlar cuándo y desde dónde se llaman.
Código corto simple para la publicación reciente
add_shortcode es una palabra clave wp.
// recent-posts is going to be our shortcode.
add_shortcode('recent-posts', 'recent_posts_function');
// This function is taking action when recent post shortcode is called.
function recent_posts_function() {
query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => 1));
if (have_posts()) :
while (have_posts()) : the_post();
$return_string = '<a href="'.get_permalink().'">'.get_the_title().'</a>';
endwhile;
endif;
wp_reset_query();
return $return_string;
}
Este fragmento se puede colocar en las functions.php su tema.php.
[recent-posts] Este es un código corto para publicaciones recientes. Podemos aplicar este código abreviado en el backend (como páginas, publicaciones, widgets).
También podemos usar el mismo shortcode dentro de nuestro código. con la ayuda de do_shortcode .
P.ej. echo do_shortcode( '[recent-posts]' );
Código abreviado avanzado para publicaciones recientes
Esta función toma el parámetro de cuántas publicaciones recientes desea mostrar.
Ej: desea mostrar solo cinco publicaciones recientes. Acaba de pasar los argumentos con posts = "5" (puede pasar cualquier número de publicaciones recientes que desee mostrar).
La función busca solo cinco publicaciones recientes de la base de datos.
// recent-posts is going to be our shortcode.
add_shortcode('recent-posts', 'recent_posts_function');
// Functions takes parameter such as posts="5".
function recent_posts_function($atts){
extract(shortcode_atts(array(
'posts' => 1,
), $atts));
$return_string = '<ul>';
query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => $posts));
if (have_posts()) :
while (have_posts()) : the_post();
$return_string .= '<li><a href="'.get_permalink().'">'.get_the_title().'</a></li>';
endwhile;
endif;
$return_string .= '</ul>';
wp_reset_query();
return $return_string;
}
P.ej. echo do_shortcode( '[recent-posts posts="5"]' );