Instructivo creación de themes Wordpress
Instructivo Descripción Temas 17 Febrero 2015 Creación de themes para Wordpress El siguiente instructivo muestra com
Views 39 Downloads 0 File size 183KB
Recommend stories
- Author / Uploaded
- Hernán Alejandro Roa Reyes
Citation preview
Instructivo
Descripción
Temas
17 Febrero 2015
Creación de themes para Wordpress El siguiente instructivo muestra como desarrollar Themes sencillos en Wordpress
● ● ●
Estructura de un Theme El API de Wordpress El loop de Wordpress
Estructura de un Theme Wordpress es un CMS altamente flexible, con una curva de aprendizaje que permite avanzar muy rápido hacia un conocimiento profundo del software y para los desarrolladores web, resulta bastante amigable entrar en contacto con las funciones del API de wordpress, ya que los nombres indican exactamente lo que el código hace. Para que la creación de sitios web con wordpress pueda tener un alto grado de personalización, resaltando el aspecto gráfico como la primera línea de contacto con los usuario finales, es deseable que el diseño del sitio se pueda replicar completamente en el CMS. En el mercado existe una gran variedad de Themes gratuitos y comerciales, pero es probable que no se ajusten en un 100% a las expectativas que tenemos. Por estas razones, la creación, modificación y adaptación de themes es una materia de gran interés para quienes han elegido Wordpress como la herramienta para la creación de su sitio. Estructura de directorios y archivos Los archivos esenciales para que un theme sea reconocido como tal en wordpress son: ● ● ● ● ● ● ●
style.css index.php header.php footer.php sidebar.php screenshot.png functions.php
Ciertamente, es posible hacer themes extremadamente sencillos teniendo sólo los archivos style.css e index.php, pero ceñirse a la estructura mencionada, nos permite caminar hacia desarrollos mas elaborados. Respecto a los directorios, los elementos mas básicos son: ● ● ●
Languages Images Js (javascript)
Estructura de un Theme Al igual que mencionábamos con los archivos, también es posible obviar estos directorio o agregar mas en el caso de que alojen archivos importantes para el theme, en este sentido, es frecuente que se incorporen directorio con frameworks como Foundation o Bootstrap. Finalmente, la estructura de archivos y directorios de nuestro theme, puede ser similar a lo siguiente:
Descripción de funciones Mencionaré algunas funciones de cada archivo para resaltar su importancia. Style.css: Permite señalar información de versión, autor, sitio web del fabricante, etc. Estos datos aparecen en el comentario que antecede las reglas de estilos. Screenshot.png: Permite mostrar una miniatura de la gráfica del theme. Index.php: Continen el cuerpo de la página o llamados a incluir sus parte en el caso de haber separado enl header y footer. Functions.php: Define algunos elementos como posiciones de los sidebars, menús, tipografías, etc.
las
En la imagen se omiten los archivos header, footer y sidebar, ya que serán tratados con detalle mas adelante.
El API de Wordpress Wordpres nos entrega una serie de funciones que permiten desde obtener información del CMS hasta definir algunas funcionalidades del theme. Revisaremos los mas importantes:
get_header Incluye la plantilla de cabecera contenida por defecto en el fichero header.php del directorio de nuestro theme actual
El parámetro nombre, está referido al nombre del archivo después del guión. Esto significa que si tenemos distintas cabeceras, podemos nombrarlas de la siguiente forma: header-principal.php, header-secundaria.php, etc. Cuando hacemos la invocación basta con señalar el nombre que precede al guión, aplicado al ejemplo, si queremos ver el archivo header-principal.php, llamamos de la siguiente forma:
Si tenemos un único archivo header.php, no es necesario señalar el parámetro y el llamado puede quedar de la siguiente forma:
get_sidebar Incluye la plantilla para nuestra Barra Lateral que se encuentra por defecto en el fichero sidebar.php del directorio de nuestro theme activo
El parámetro nombre, opera con una lógica similar a la descrita en get_header. Si tenemos varias cabeceras definidas le pasamos el nombre para obtener el fichero sidebar‐[nombre].php.
El API de Wordpress get_search_form Muestra el formulario de búsqueda definido en el fichero searchform.php de nuestro Theme:
comments_template Carga la plantilla de comentarios del directorio de nuestro theme actual.
El parámetro fichero es el nombre del fichero con la plantilla que queremos cargar. El parámetro separador, corresponde a un booleano que indica si se separan o no, los comentarios por tipo de comentario, por defecto es false.
get_footer Incluye la plantilla de Pie de Página de nuestro blog que por defecto se encuentra en el fichero footer.php del directorio de nuestro theme actual
El parámetro nombre indica si le pasamos el nombre para obtener el fichero footer‐[nombre].php
El API de Wordpress Etiquetas de Información del Blog Bloginfo Muestra información sobre nuestro blog, la cual suministramos en nuestro Perfil de Usuario y Opciones Generales del Panel de Administración.
Dependiendo de lo que queramos mostrar tenemos las siguientes opciones: admin_mail: eMail del usuario Administrador atom_url: URL de nuestro Feed Atom comments_rss2_url: URL Feed RSS de Comentarios description: Descripción de nuestro blog url: URL de nuestro blog Name: Título del blog stylesheet_directory: Directorio de las hojas de estilo template_directory: URL del directorio theme activo Ejemplos: 1. Mostrar el título de nuestro Blog y su descripción
2. Mostrar un link a nuestro Feed
Etiquetas de Listas wp_list_authors Muestra una lista con los usuarios del blog y si son autores de algún post en forma de enlace a sus posts. Opcionalmente muestra el contador de posts de cada usuario.
El parámetro argumentos permite enlazar varios argumentos añadiendo “&” entre uno y otro. L lista de posibles argumentos es la siguiente: optioncount: Número de post publicados del autor exclude_admin: Excluir al usuario “admin” de la lista show_fullname: Mostrar nombre completo del autor hide_empty: No mostrar usuarios sin posts. Los parámetros tienen los posibles valores a 0 (falso – no activar) o 1 (verdad – activar esta opción) Ejemplo: 1. Mostrar el nombre completo del usuario y el número de post publicados
El API de Wordpress wp_list_categories Muestra una lista de categorías como enlaces
En este caso podemos enlazar varios argumentos añadiendo “&” entre uno y otro. Los argumentos disponibles son: orderby: Ordenar categorías alfabéticamente (name), por ID (ID) o por número de posts (count) de cada categoría. order: Orden Ascendente (ASC) o Descendente (DESC) style: Formato de lista sin numerar (list) o sin formato show_count: Mostrar no de posts de cada categoría (1) hide_empty :Mostrar categorías sin posts (1) Exclude: Excluir categorías (separar ID por comas) Include: Incluir solo las categorías indicadas (ID) Number: Número de categorías a mostrar
Ejemplos: 1. Ordenar categorías por nombre e incluir los ID 1, 2, 3 y 8 únicamente