Share
La API de código breve de WordPress se introdujo en WordPress en la versión 2.5. Desde entonces, se ha convertido en un método ampliamente utilizado para permitir una rápida personalización del diseño e insertar ciertos fragmentos de formato. Pero los códigos cortos pueden ser igualmente útiles al crear temas de WordPress: aquí se explica cómo puede utilizarlos al máximo.!
Los códigos cortos tienen muchos beneficios si se usan correctamente en archivos de temas. Si está familiarizado con las macros del preprocesador en C / C ++, los códigos cortos pueden cumplir una función similar en WordPress. El propósito básico de usar un shortcode es reemplazar el marcador de posición con su propio código HTML personalizado cuando el servidor envía la página al lado del cliente. Los pasos involucrados en la creación e implementación de códigos cortos son los siguientes.
En este Consejo rápido, usaremos códigos cortos para mostrar publicaciones personalizadas. He dado una explicación detallada sobre cómo crear tipos de publicaciones personalizadas y usar temas en blanco en Nettuts +, pero para este ejemplo, modificaremos el tema predeterminado de TwentyTen proporcionado por WordPress.
La función que creas para tu shortcode realmente define el propósito del shortcode. Una función básica se puede definir de la siguiente manera (puede agregar todo el código en la parte inferior de su archivo functions.php):
Accentsconagua
// Definiendo la función utilizada para mostrar la Publicación de Proyecto Personalizada. function project_shortcode ($ atts) // Extracción de los argumentos para el shortcode. extraer (shortcode_atts (array ('limit' => '10', 'orderby' => 'date',), $ atts)); / * Esto es donde escribiremos el código para obtener datos * y compilaremos la estructura HTML que se devolverá en la variable $ output * / $ output = 'Esto contendrá la salida HTML final para su ciclo de proyecto personalizado.'; devuelve $ output; Solo asegúrese de no dejar espacios en blanco al final del archivo functions.php, ya que puede causar un problema. Ahora agreguemos algo de código para obtener la publicación personalizada 'proyecto' y construyamos la estructura HTML que reemplazará nuestro código abreviado.
function project_shortcode ($ atts) extract (shortcode_atts (array ('limit' => '10', 'orderby' => 'date',), $ atts)); // Creando una consulta personalizada para obtener la publicación personalizada del tipo de proyecto. $ loop = new WP_Query (array ('post_type' => 'project', 'posts_per_page' => $ limit, 'orderby' => $ orderby)); // Recorriendo las publicaciones y construyendo la estructura HTML. if ($ loop) while ($ loop-> have_posts ()) $ loop-> the_post (); $ salida. = ''.get_the_title ().'
'; $ salida. = ''.get_the_excerpt ().''; else else output = 'Lo sentimos, no hay proyectos todavía. Vuelve pronto.'; // Ahora estamos devolviendo el código HTML al lugar desde donde se llamó el código abreviado. devuelve $ output; Los '$ atts' son los atributos proporcionados junto con el shortcode. El método de extracción de PHP se usa para dividir los elementos de la matriz en variables para que puedan usarse directamente dentro de la función.
En este ejemplo, estamos utilizando los atributos pasados en la función para crear una consulta personalizada para obtener los datos de publicación personalizados del "proyecto". Entonces estamos recorriendo todas las publicaciones del proyecto devueltas.
Dentro del ciclo, estamos obteniendo y agregando los datos a la variable de salida con las etiquetas HTML apropiadas. Una vez que se completa el ciclo, la variable de salida contiene el código HTML completo para nuestra lista de proyectos. Este código HTML se devuelve y el código abreviado utilizado en el tema se reemplaza por este cuando se carga la página..
Ahora que hemos creado la función, tenemos que registrarla en la base de datos junto con el código corto que se utilizará para ello. Podemos hacer esto con el
Método register_shortcode proporcionado por WordPress.
add_shortcode ('projects', 'project_shortcode'); El primer argumento en este método es el nombre del shortcode que usaremos en el tema, y el segundo argumento es el nombre de la función (que definimos anteriormente) relacionada con ese shortcode. Así es como WordPress sabrá qué hacer cuando se analice o encuentre ese shortcode.
WordPress proporciona un método de análisis de código corto que muy pocos desarrolladores consideran usar con tanta frecuencia. El método do_shortcode se puede usar para insertar códigos cortos dentro de los propios archivos de temas.
La sintaxis de shortcode es similar a lo que insertaría en el editor de back-end. En este caso, estamos pasando los atributos para el límite de cantidad de publicaciones que se mostrarán y cómo ordenarlas. Como estamos mostrando las publicaciones personalizadas del "proyecto", crearemos una nueva plantilla de página dedicada y usaremos el código corto en eso. Cree una plantilla llamada 'page-project.php' y use lo siguiente:
Ahora para ver la plantilla que acaba de crear, cree una página llamada "Proyecto". Obviamente, cree también algunas publicaciones de "Proyecto" de demostración.!
Voila! El código corto muestra las publicaciones personalizadas con éxito..
Como puede ver, el método anterior de crear un código abreviado para publicaciones personalizadas y usarlas en nuestro tema nos ayuda a mantener los archivos de temas manejables y limpios. Esto también tiene un beneficio adicional de que cualquiera puede insertar el bucle de publicación personalizado desde el editor de back-end de WordPress también..
El ejemplo anterior muestra cómo podemos usar códigos cortos durante el desarrollo del tema de una manera eficiente. Hay muchas formas innovadoras y productivas de usar códigos cortos en los temas de WordPress. Siéntase libre de compartir sus propias ideas en los comentarios.!
