5 agosto 2012

Network Latest Posts

Logotipo de NLPosts

Logotipo de NLPosts

Una de las necesidades que surgió a raíz de la separación de las instalaciones de WordPress para L’Elite Network fue la de mostrar los artículos recientes creados en todos los blogs pertenecientes a la red en la página principal del sitio base.

Luego de realizar una búsqueda bastante detallada, me encontré con extensiones realizadas para WordPress MU que no ofrecen la flexibilidad que necesitaba para mis sitios. Al final decidí probar WPMU Recent Posts Widget escrito por Angelo de Bitfreedom.com. Si bien esta extensión cumplía su cometido, era bastante limitada y no se ajustaba a lo que requería.

Finalmente, decidí tomar su código y adaptarlo a WordPress 3.0, sin embargo ya que utilizaba funciones antiguas y debido al éxito que tuvo Network Latest Posts entre la comunidad mundial de usuarios de WordPress, los requerimientos fueron aumentando y la extensión comenzó a convertirse en un monstruo de mil cabezas lleno de hacks y soluciones muy chapuceras, sin embargo así llegó a la versión 2.0.4.

Luego de muchos dolores de cabeza y frustración decidí que ya no podía seguir manteniendo el código de esa manera, había que volver a escribir todo desde cero!, comenzar con buenas prácticas y hacer todo bien desde la base. Lamentablemente no tenía el tiempo necesario para poder hacerlo, por ello todo tuvo que esperar hasta ahora.

Hoy me complace anunciar la versión 3.0 de Network Latest Posts, un salto mayor a nivel de código y funcionalidad, completamente nuevo, escrito desde la base y utilizando las funciones internas de WordPress para incrementar la velocidad y facilidad de mantenimiento. Esta nueva versión incluye nuevas funciones y desecha algunos parámetros que resultaría inútil seguir proveyendo.

También incluye estilos por defecto para aquellas personas que no tengan suficientes conocimientos de hojas de estilo CSS e incluso los Shortcodes ahora pueden ser creados a partir de un formulario al cual se accede a través de un botón integrado al editor de artículos y páginas TinyMCE. Esta versión ha sido pensada para todo el mundo, proporcionando funcionalidad y versatilidad para los usuarios más avanzados y comodidad y simpleza para los menos avanzados.

Bien, basta de introducciones, vamos a ver qué sorpresas incluye Network Latest Posts version 3.0:

  • @title : Título principal para la sección donde se muestre el Widget o Shortcode
  • @number_posts : Número de artículos a tomar POR blog. Ej: 10 significa, consigue los 10 artículos más recientes de cada uno de los blogs de la red
  • @time_frame : Periodo de tiempo en días para el cual obtener los artículos. Ej: 5 significa, consultar todos los artículos escritos desde hace 5 días hasta hoy
  • @title_only : Mostrar sólo los títulos de los artículos, cuando se desactiva se muestran los extractos de los artículos
  • @display_type : Presentación de los artículos: Listas desordenadas (ulist), listas ordenadas (olist), bloques (block)
  • @blog_id : Ninguno o varios ID de blogs para mostrar. Ej: 1,2 significa, mostrar los artículos de los blogs 1 y 2 solamente
  • @ignore_blog : Este parámetro funciona a la inversa de blog_id. Ej: 1,2 significa, mostrar los artículos de TODOS los blogs EXCEPTO los de 1 y 2
  • @thumbnail : Cuando este parámetro es activado (true) se muestran las imágenes miniatura de los artículos, si los artículos no contienen imágenes miniatura, una imagen de reemplazo será insertada en su lugar
  • @thumbnail_wh : Dimensiones de las imágenes miniatura, este valor es expresado en Ancho x Alto. Ej: 80×80 (valor por defecto)
  • @thumbnail_class : Clase CSS personalizada para las imágenes miniatura (alignleft, alignright, center, etc)
  • @thumbnail_filler : Imágenes de reemplazo cuando no se encuentran imágenes miniatura en los artículos, hay tres opciones: Cuadro gris con el título del artículo (placeholder), gatitos (kittens) y perritos (puppies) (¿Qué?, yo también puedo ser gracioso a veces :)), Placeholder se utiliza por defecto (para mantener la seriedad ;))
  • @custom_post_type : Puedes especificar un tipo de artículo para mostrar: artículo (post), página (page) o cualquier otro que hayas inventado
  • @category : Una o varias categorías para las cuales mostrar los artículos. Ej: perros,gatos significa, mostrar todos los artículos creados en las categorías perros y gatos. Si ningún artículo se corresponde a la(s) categoría(s) especificadas, todos los artículos que correspondan al resto de criterios serán mostrados
  • @tag : Las etiquetas se tratan igual que las categorías en WordPress, por ende este valor es similar al de category. Ej: topos,castores significa, mostrar todos los artículos etiquetados como topos y castores. Si ningún artículo corresponde a la(s) etiqueta(s) especificadas, todos los artículos que correspondan al resto de criterios serán mostrados
  • @paginate : Mostrar los resultados por páginas, cuando se activa (true), el parámetro posts_per_page debe contener un valor de lo contrario no se paginará nada
  • @posts_per_page : Cantidad de artículos a mostrar por página (el parámetro paginate debe estar activo (true))
  • @excerpt_length : Limitar la longitud del extracto. Ej: 40 significa, limitar el extracto a 40 palabras (40 es el valor por defecto)
  • @auto_excerpt : Cuando este valor se activa (true) se generará automáticamente un extracto a partir del contenido del artículo (este parámetro es especialmente útil para las personas que olvidan utilizar el campo Extracto en la página de edición de artículos)
  • @excerpt_trail : Cola del extracto, es el texto que se agrega al final del extracto para seguir leyendo, dos valores son aceptados: text (texto) e image (imagen), el texto por defecto es ‘…leer el resto’, la imagen se llama excerpt_trail.png y se encuentra dentro del directorio img de la extensión
  • @full_meta : Mostrar la fecha completa y el autor del artículo, la fecha y hora mostradas tomarán el formato de fecha y hora utilizados en el blog donde fue publicado el artículo
  • @sort_by_date : Ordenar por fechas, este es uno de los parámetros más deseados, cuando se activa, los artículos serán ordenados por fechas independientemente del blog de donde fueron obtenidos
  • @sorting_order : Si se activa la ordenación por fechas, este parámetro permite ordenar los artículos desde los más recientes (newer) a los más antiguos o desde los más antiguos (older) hasta los más recientes. Newer es el valor por defecto
  • @sorting_limit : Limitar la cantidad de artículos a mostrar, este parámetro no tiene ninguna relación con number_posts. Ej: 10 significa, mostrar 10 artículos (independientemente de si se encontraron 30 en todos los blogs, solo serán mostrados los primeros 10)
  • @post_status : Estado de los artículos que se quieren publicar, los valores son: publish (publicar), new (nuevo), pending (pendiente), draft (borrador), auto-draft (borrador automático), future (futuro), private (privado), inherit (heredado), trash (basura)
  • @css_style : Este parámetro recibe el nombre del fichero (sin su extensión) de hojas de estilo CSS personalizado, este fichero debe ser creado en el directorio donde se encuentra la hoja de estilo del tema de WordPress utilizado en ese momento. Cuando se usan múltiples instancias de shortcode/widgets en una misma página, basta con especificar este valor una sola vez, ya que la hoja de estilos se cargará una sola vez para dicha página
  • @instance : Network Latest Posts 3.0 es multi-instancias, quiere decir que puede ser usado sin límites en una misma página, por ende, este valor recibe el nombre de identificación para cada una de las instancias creadas. Esto permite que el sistema de paginación asíncrono funcione correctamente, si se usan varios Shortcodes en una misma página este parámetro es obligatorio. Para los Widgets este parámetro se pasa automáticamente a partir del identificador de añadidura de Widgets de WordPress

Instalación

1. Subir la carpeta `network-latest-posts` al directorio `/wp-content/plugins/` o ve al panel de Administrador de la Rede > Extensiones > Añadir Nueva y busca Network Latest Posts
2. Activa la extensión para la red usando el menú ‘Extensiones’ del panel de Administrador de la Red
3. Si quieres usar el Widget ve al menú ‘Apariencia Widgets
4. Si quieres usar el Shortcode, haz clic en el icono de NLPosts Icono de NLPosts  integrado en el editor TinyMCE o escribe [nlposts] en el contenido del artículo o página (eso es todo, ¡de verdad!)

Parámetros del Shortcode

[nlposts title=NULL
         number_posts=10
         time_frame=0
         title_only=TRUE
         display_type=ulist
         blog_id=NULL
         ignore_blog=NULL
         thumbnail=FALSE
         thumbnail_wh=80x80
         thumbnail_class=NULL
         thumbnail_filler=placeholder
         custom_post_type=post
         category=NULL
         tag=NULL
         paginate=FALSE
         posts_per_page=NULL
         excerpt_length=NULL
         auto_excerpt=FALSE
         excerpt_trail=text
         full_meta=FALSE
         sort_by_date=FALSE
         sorting_order=NULL
         sorting_limit=NULL
         post_status=publish
         css_style=NULL
         instance=NULL
]

Capturas de Pantalla

Shortcode

NLPosts en Editar Página

NLPosts en Editar Página

NLPosts Insertar Shortcode

NLPosts Insertar Shortcode

Resultados usando Shortcodes

Resultados usando Shortcodes

Paginación usando Shortcodes

Paginación usando Shortcodes

___________________________________________________

Widget

NLPosts en Zonas de Widgets

NLPosts en Zonas de Widgets

Algunas Opciones del Widget

Algunas Opciones del Widget

Resultados usando NLPosts Widgets

Resultados usando NLPosts Widgets

NLPosts Widgets en Pié de Página

NLPosts Widgets en Pié de Página

_______________________________________________

Idiomas RTL (derecha a izquierda)

NLPosts en Panel de Control RTL

NLPosts en Panel de Control RTL

NLPosts en modo RTL

NLPosts en modo RTL

__________________________________________________________________

Ejemplos

Puedes visitar mi la página principal de mi sitio web www.8elite.com para verlo en funcionamiento, si quieres ejemplos más avanzados visita Network Latest Posts Test Lab.

Descarga

Descarga la versión más reciente desde el repositorio oficial de WordPress: Network Latest Posts

Idiomas

Esta extensión está disponible en Español, Inglés y Francés porque son los únicos idiomas que hablo, si quieres contribuir con este proyecto puedes usar el fichero languages.pot ubicado en la carpeta languages dentro del directorio de Network Latest Posts. Utiliza Poedit para crear los archivos de traducción, una vez tengas los ficheros .mo y .po envíamelos por correo electrónico a opensource[arroba]laelite.info; no olvides poner tu nombre y dirección de tu página web (si tienes) para darte crédito en la lista de contribuidores.

Donaciones

Si consideras que esta extensión es genial, hace tu vida más fácil y tu blog más atractivo; considera realizar una donación, $1 o 1€ pueden ayudar bastante :)!




email