/wp_boilerplate

Boilerplate para la creación desde cero de Wordpress Themes

Primary LanguageJavaScriptMIT LicenseMIT

Wordpress Boilerplate

Introducción

Esta es una plantilla básica, que tiene como objetivo ayudar a la gente que comienza recién a crear plantillas para Wordpress. Incorpora algunas de las últimas tecnologías implementadas por el equipo de Wordpress y también otras que le entregarán a los desarrolladores una base mínima para crear exitosamente un Theme.

Uso de Paginación

En la versión 1.1 se ha agregado la posibilidad de agregar paginación, para esos casos donde se desea mostrar más de los 10 posts que muestra por defecto Wordpress.

Para utilizar la paginación debemos llamar a la función the_pagination(). Y en el caso de utilizar la paginación en un Custom Post Type, deberemos entregar como parámetro el resultado de la búsqueda, así como se especifica en el siguiente código.

<?php
	$arg = array(
		'post_type'		 => 'custom_post_name',
		'paged'			 => $paged
	);
	
	$get_arg = new WP_Query( $arg );
	
	while ( $get_arg->have_posts() ) {
		$get_arg->the_post();
	?>
		
		<!-- Aquí agregar contenido a mostrar por el loop -->
	
	<?php } 
?>

<?php the_pagination( $get_arg ); ?>

Además es importante que dentro de los parámetros de búsqueda sea incorporado el key paged junto con el valor $paged, para que nuestra paginación pueda funcionar correctamente.

Uso de Flickity

En la versión 1.3.0 se ha agregado Flickity como opción a Flexslider. Un versátil plugin de Javascript que contiene menos errores que el anterior, se encuentra más actualizado y además con más opciones de visualización. Para obtener información de cómo implementar Flickity, por favor revisar la documentación correspondiente.

Archivo de opciones

En la versión 1.4.3 se creó la variable $theme_options que contendrá todas las configuraciones necesarias para el theme. Dentro de los parámetros que contiene se encuentran opciones para saber si WooCommerce esta activo, obtener accesos a las carpetas de funciones y el key slider contiene dos nuevos parámetros. Estos permiten a través de un valor booleano activar o desactivar cada uno de los sliders disponibles en la plantilla.

Botón Home en navbar

En la versión 1.5.2 se agregó la posibilidad de agregar al principio del menú un botón que dirija a la página de inicio, su objetivo es agregar un link hacia ésta página en el caso de estar utilizando los archivos index.php o home.php. Por defecto esta deshabilitado, sin embargo se puede hacer aparecer desde el archivo de opciones (functions/__options.php).

Bootstrap 3 & 4

En la versión 1.6.0 se agregó soporte para las versiones 3.4.0 & 4.2.1 de Bootstrap. Si bien por defecto no viene activado, se puede cambiar en el archivo de opciones functions/__options.php. Por otro lado, junto con agregar el mencionado framework, se agregó también soporte para el menú de navegación. Para cambiar los estilos del navbar es solo cosa de modificar y utilizar el template part correspondiente a la versión activada y que se encuentran en la carpeta de includes.