blog

Estrucutra de Carpetas de un Pluging en WordPress

Si nuestro plugin va a contener varios archivos, lo ideal es crear una estructura de carpetas siguiendo las buenas prácticas de la documentación de desarrolladores de WordPress (no es obligatorio, pero si aconsejable, ayuda mucho para el trabajo en equipo).


/nombre-plugin
-nombre-plugin.php
-uninstall.php
-index.php
-readme.txt
-/languages
-/includes
-/admin
--/js
--/css
--/images
-/public
-/js
-/css
-/images

  • ‘nombre-plugin.php’: Es el archivo principal del plugin. Contiene una cabecera estándar con los datos mínimos que WordPress necesita para realizar la instalación del plugin. Además, se definen las constantes y se realizan acciones iniciales.
  • ‘uninstall.php’: Es el fichero que define los métodos y acciones de limpieza para una correcta desinstalación del plugin.
  • ‘index.php’: Es un fichero PHP vacío con el único propósito de ocultar la estructura de carpetas. Si un usuario entra en la ruta de la carpeta del plugin se encontrará una página en blanco. Si se elimina aparecerá la estructura de carpetas.
  • readme.txt’: Es un fichero con un formato concreto que se requiere solo si el plugin se va a subir al repositorio oficial de WordPress.
  • ‘admin’: Directorio que contiene subdirectorios con los archivos *.php, *.css, *.js, *.html que se encargan del back-end del plugin.
  • Directorio ‘languages’: Directorio que contiene los archivos de internacionalización y localización del plugin.
  • Directorio ‘includes’: Los archivos *.php auxiliares que “incluyas” desde la sentencia include de PHP a tu complemento.
  • Directorio ‘public’: Directorio que contiene subdirectorios con los archivos *.php, *.css, *.js, *.html que se encargan del front-end del plugin.

Cambiar separador de listas para archivos csv

Las configuraciones regionales de Windows  es donde está especificado el separador de listas que se utiliza en todas las aplicaciones instaladas. Para ver las configuraciones que tengo en mi Equipo debo ir al Panel de Control y dentro de la sección Reloj, idioma y región seleccionar la opción Cambiar formato de fecha, hora o número.

Observa que el Formato seleccionado para mi Equipo es Español (México) y al pulsar el botón Configuración adicional podrás ver que el carácter utilizado para el separador de listas es la coma (,).

Excel toma esta configuración de Windows para separar los argumentos de las funciones y por esa razón observarás que en mis ejemplos de funciones siempre se muestra la coma (,). Esta diferencia se da principalmente con España donde se utiliza el punto y coma (;) como separador de lista mientras que en los países latinoamericanos se utiliza la coma (,).

Así que, si sigues este sitio Web desde España debes estar consiente de esta diferencia que encontrarás en los artículos. De igual manera, es posible que estés en Latinoamérica pero si el equipo donde estas trabajando tiene la configuración regional para España también observarás esta diferencia en Excel.

Añadir un shortcode a tu PHP de WordPress

Bien usados, los shortcodes pueden ser grandes aliados para ahorrar tiempo y código en nuestros proyectos.

En la píldora anterior veíamos cómo crear un shortcode y como introducirlo en páginas y posts usando el editor WYSIWYG de WordPress. Pero qué ocurre si necesitamos ejecutar un shortcode en alguna parte concreta de nuestro theme, por ejemplo en el footer, o en una front-page que hemos creado de forma manual.

Pues es tan sencillo como añadir esta línea de código dónde necesites ejecutar el shortcode:

echo do_shortcode( ' [nombre_shortcode] ' );

Esto también es muy útil cuando tenemos que añadir funcionalidad de otros plugins para WordPress que nos permiten usar shortcodes para añadir el contenido. Es muy habitual el uso de esta técnica para añadir formularios de contacto creados por plugin como Ninja Forms o Contact Form 7, en los cuales añadimos los formularios que hemos creado previamente usando shortcodes, por ejemplo:

<?php echo do_shortcode( '[contact-form-7 404 "Not Found"]' ); ?>

¿Cómo se deciden las versiones del software?

Existen muchas formas de asignar una versión al software, cada empresa pueda generar sus reglas y está bien, pero como todo en este mundo se busca generar unas reglas y pautas que sirvan como guía.

Algo que sucede normalmente en el mundo del desarrollo es que buscamos maneras para mejorar y optimizar el código, los proyectos y aplicaciones. El detalle es que cosas buenas que ya existen al ser simples suelen pasar desapercibidas. Una de ellas es el versionamiento del Software, versionado de software o simplemente, asignar versión de software. Depende del país o región.

Existen muchas formas de asignar una versión al software, cada empresa pueda generar sus reglas y está bien, pero como todo en este mundo se busca generar unas reglas y pautas que sirvan como guía.

Antes de continuar es importante tener en cuenta que existen diferentes propuestas para asignar versiones y cada quien puede seguir las que desee.

Versiones por número.
Algo común es realizar el manejo de versiones mediante 3 números: X.Y.Z y cada uno indica una cosa diferente:

El primero (X) se le conoce como versión mayor y nos indica la versión principal del software. Ejemplo: 1.0.0, 3.0.0
El segundo (Y) se le conoce como versión menor y nos indica nuevas funcionalidades. Ejemplo: 1.2.0, 3.3.0
El tercero (Z) se le conoce como revisión y nos indica que se hizo una revisión del código por algun fallo. Ejemplo: 1.2.2, 3.3.4
Ahora que conocemos el significado de cada número, viene una pregunta importante: ¿cómo sabemos cuando cambiarlos y cuál cambiar?

Versión mayor o X, cuando agreguemos nuevas funcionalidades importantes, puede ser como un nuevo modulo o característica clave para la funcionalidad.
Versión menor o Y, cuando hacemos correcciones menores, cuando arreglamos un error y se agregan funcionalidades que no son cruciales para el proyecto.
Revisión o Z, cada vez que entregamos el proyecto.
Versiones por estabilidad.
Además de tener las versiones por números podemos agregar una clasificación por estabilidad del proyecto.

Las opciones que tenemos para esto son: Alpha, Beta.

Alpha es una versión inestable que es muy probable que tenga muchas opciones que mejorar, pero queremos que sea probada para encontrar errores y poder poner a prueba funcionalidades, en la mayoría de los casos podemos decir que esta casi listo el producto. Ejemplo: 1.0Alpha, 1.0a1,1.0a2.

Beta una versión mas estable que Alpha en la que contamos con el producto en su totalidad, y se desea realizar pruebas de rendimiento, usabilidad y funcionamiento de algunos módulos para ver cómo funciona bajo un ambiente no tan controlado. Aquí aperece el nombre de Beta Tester que escuchamos mucho en el mundo del software. Ejemplo: 2.0Beta, 2.0b, 2.0b1

El siguiente paso es RC (Release Candidate), que es el último toque fino del software antes de salir y después de pasar por Beta. Ejemplo: 3.0-RC o también 3.0-RC1.

Mas cosas que manejar con Versiones.
En el mundo del software sabemos que además de los programas que usamos habitualmente existe software más complejo como los videojuegos y sistemas operativos, en ambos casos se necesita considerar los casos de los parches y las fechas de lanzamientos, ambos elementos que también pueden influir en el control de versiones.

Versión de parche.
En el caso de los parches podemos agregar un dígito para señalar el parche, ya teníamos algo así: X.Y.Z y ahora tendríamos algo así: X.Y.Z.P así que P sería el número del parche:

Ejemplo: 1.2.5.2, 02.03.03.01

Versión por fecha.
En algunos necesitamos saber exactamente la fecha en que se publicó el software, entonces podremos utilizar el manejo de versiones por fecha. Este tiene muchas variaciones, se puede tener diferente orden del año, mes y día.

Ejemplo: 1.2.3.1543 donde 15 es el año 2015, 4 es el mes y 3 el día, como ya mencione anteriormente se podrían tener diferentes acomodos y formatos: 1.2.3.4315 o 1.2.3.201543, 1.2.3.1534

Conclusión:
No existe una regla o estándar oficial para normar las versiones de software, existen diferentes propuestas que podemos aplicar, pero siempre es un buen ejercicio que después de leer este artículo pongas atención a las versiones de librerías, software, sistemas operativos, juegos y parches para que veas como lo están haciendo los gigantes de la industria.

wordpress – Que es un shortcode y como crearlo

Qué es un shortcode de WordPress

Un shortcode es una herramienta que nos permite añadir funcionalidad al editor de publicación WYSIWYG (What you see is what you get) de WordPress.

Digamos que es un alias o un atajo de texto que permite lanzar cierta funcionalidad cuando sea ejecutado por WordPress, y generalmente se representa con el nombre del shortcode entre corchetes. Por ejemplo así: [nombre_shortcode].

Así, cuando nosotros escribimos en el editor de texto un shortcode, se ejecutará lo que hayamos definido para ese elemento.

Usos de un shortcode

El principal uso de un shortcode es el de agilizar la tarea de creación de contenidos muy repetitivos en un sitio. Por ejemplo, imagina que tienes un blog y todas las entradas las acabas con el mismo párrafo de despedida. En ese caso quizá una buena idea crear un shortcode. Pero no solo por no tener que escribir siempre el mismo párrafo: sobretodo por si algún día lo quieres modificar. Si has creado un shortcode, ese texto se actualizará automáticamente en todos los posts donde haya sido representado.

¿Empiezas a ver ya el poder de todo esto? Pues venga, vamos a crear un shortcode para WordPress:

Cómo crear un shortcode

Vamos a crear un shortcode de ejemplo donde agradecemos a nuestro usuario que haya leído nuestro artículo y le informamos que puede escuchar nuestro podcast, por ejemplo:

function shortcode_despedida() {
return '<p>Gracias por haber leído la píldora de hoy, y recuerda que puedes escucharme en el podcast de <strong>Product Designer</strong>, donde hablamos de diseño, desarrollo y marketing.</p>';
}
add_shortcode('despedida', 'shortcode_despedida');

Esta función que acabamos de crear puedes añadirla en el archivo functions.php de tu tema, o mejor aún, en un plugin externo donde desarrollar toda la funcionalidad de tu sitio.

Para aplicar el shortcode, tan solo tenemos que escribir el nombre del mismo entre corchetes en el editor de textos de WordPress, ya sea para un post, o en una página. En nuestro ejemplo escribiremos [despedida] en el editor. Y aparecerá esto en todos los sitios donde hayamos escrito ese shortcode:

Problemas de los shortcode

Cuando utilizamos un shortcode, estamos añadiendo contenido en nuestro sitio que será interpretado y ejecutado si la función para ese shortcode existe. Pero si nuestro usuario o nosotros mismo cambiamos de theme, y el shortcode está definido en el propio theme tendremos un problema en el contenido del sitio. Ya que todos esos shortcodes que hacían cosas chulas y útiles, de repente se transforman en un texto del tipo: [boton_principal] así, tal cual, arruinando el aspecto y el contenido del sitio web.

Por eso te recomiendo que si usas temas comprados en sitios como Themeforest y compañía: no uses sus shortcodes, ya que cuando cambies de tema, tendrás un problema.

el bief

Que es el brif y que contiene?

La palabra brief es un anglicismo de la palabra briefing, es por ello que muchas personas dicen brief y otras personas lo denominan briefing pero básicamente significa lo mismo, la palabra briefing traduce del inglés “instrucciones”, ya con esta traducción puedes ir descifrando el significado de la palabra brief y más o menos su papel en el mundo de la publicidad.

¿Qué es un brief o briefing?

El brief o briefing es un documento informativo que contiene la información imprescindible para poder empezar a planificar o ejecutar un proyecto. Se trata de un documento muy habitual en el mundo de la publicidad y la comunicación, aunque también se ve en otro tipo de sectores, en el que el cliente, a través de este documento, describe sus necesidades y deseos para la realización de un proyecto a una agencia o proveedor.

¿Cómo hacer un buen briefing?

La clave de este documento no está solamente en hacerlo, sino en hacerlo bien. Si lo conseguimos, nuestros proveedores nos lo agradecerán, el trabajo con ellos será más eficaz y los resultados más rápidos y mejores. Por el contrario, las consecuencias de hacer un mal briefing pueden llevar a retrasar los tiempos de ejecución de la campaña o el proyecto, multiplicar las horas de trabajo y quemar al proveedor. Hay que tener en cuenta que el briefing sirve como documento de punto de partida para empezar a trabajar y, por tanto, si no está correctamente planteado provocará que se dediquen horas y esfuerzo en una línea de trabajo que realmente no es la adecuada.

Para evitar estos problemas, a continuación vamos a describir el contenido necesario para hacer un buen briefing.

Contenido del briefing

1 – Objetivo de la campaña o proyecto

En primer lugar es imprescindible transmitir el objetivo de la campaña para poder trazar una estrategia adecuada que permita cumplir con los mismos. Este punto condiciona de forma importante el planteamientos, por lo que es fundamental que esté claramente especificado.

2 – Público al que va dirigido

El público al que está destinada la campaña o proyecto también es muy importante ya que puede influir para que el lenguaje, estilo o diseño del mismo tenga unas características u otras. También influirá en la elección de los canales y medios, en caso de que se trata de una campaña de publicidad o relacionada con contenido, por lo que tener claro este aspecto es fundamental y uno de los puntos más importantes junto con los objetivos.

3 – Descripción de la empresa

Incluir una breve descripción de la empresa en el briefing es muy útil para conocer el enfoque y valores de la misma. Detalles que son muy importantes a la hora de realizar una propuesta creativa o en la que la comunicación y el diseño tengan un papel importante.

4 – Necesidades específicas

En ocasiones, el cliente ya tiene claras algunas de las características u orientación del proyecto que se quiere lanzar. Si es así, el cliente deberá especificarlo en el briefing para que el proveedor lo tenga en cuenta a la hora de plantear su propuesta o ejecutar el proyecto.

5 – KPIs

Los “Key Performance Indicators”, conocidos habitualmente como KPIs, ayudan a medir la eficacia del trabajo realizado. En ocasiones, se desarrollan proyectos con el fin de conseguir unos objetivos específicos. Por ejemplo, desarrollar una campaña de publicidad con la que conseguir generar X miles de euros en ventas o conseguir X número de visitas. Cuando esos objetivos se pueden medir con un indicador claro y están dentro de las expectativas del cliente, deben estar incluidas en este briefing.

6 – Condiciones o limitaciones

Ocasionalmente puede suceder que, por la industria o sector del cliente, su historia, valores, etc haya algunas limitaciones o condiciones en el desarrollo del proyecto. Si el proveedor no las conoce o no tiene porqué conocerlas, es importante dejarlas por escrito. De esta forma nos aseguraremos que la propuesta que recibamos estará en línea con lo que buscamos.

7 – Estimación presupuestaria

En caso de que ya haya un presupuesto definido para el proyecto, es importante reflejarlo para que la propuesta se adecue a lo que el cliente puede pagar. Sin embargo, no es imprescindible ya que muchas veces lo que se busca es tener diferentes propuestas con su correspondiente presupuesto.

8 – Timming

Por supuesto, a la hora de valorar un proyecto es muy importante tener en cuenta cuáles son los plazos de ejecución del mismo. Esta información permite al proveedor valorar mejor los recursos que necesitará y facilita su planificación y organización.

Además de estos puntos, en caso de ser un briefing creativo es recomendable incluir también cierta información relevante para proyectos en los que el diseño es una parte importante del mismo.

9 – Look&Feel o estilo con ejemplos

Si como cliente tenemos una idea de la estética que estamos buscando, debemos señalarla en el briefing. Si además podemos incluir ejemplos de diseños similares, serán una buena referencia para el proveedor y será más fácil que el resultado se acerque a lo que estamos buscando.

10 – Formato de entrega con las especificaciones técnicas necesarias

El diseño debe adecuarse al formato en el que se vaya a presentar, por ello es importante señalar las especificaciones técnicas del diseño que queremos que se nos entregue o, si desconocemos estos detalles, señalar que uso se va a dar al diseño: impresión, web, ubicación, etc.

Media Querys css3 tamaños de pantalla

Lo más común es que usemos las Media Queries para detectar las dimensiones de la pantalla, a continuación un ejemplo con los tamaños más comunes usando min-width el cual determina el tamaño mínimo de la pantalla o usando max-width para el tamaño máximo de la pantalla donde se aplicara la regla de estilo.

@media (min-width: 320px) { .rd5_search__form .rd5_search__buttons .rd5_search__advance a { padding: 2.2rem 0; } }

@media (min-width: 480px) { .rd5_search__form .rd5_search__buttons .rd5_search__advance a { padding: 2.5rem 0; } }

@media (min-width: 768px) { .rd5_search__form .rd5_search__buttons .rh_prop_search__advance a { padding: 2.7rem 0; } }

@media (min-width: 1024px) { .rd5_search__form .rd5_search__buttons .rd5_search__advance a { padding: 3.3rem 0; } }

@media (min-width: 1140px) { .rd5_search__form .rd5_search__buttons .rd5_search__advance a { padding: 2.85rem 0; } }

@media (min-width: 1280px) { .rd5_search__form .rd5_search__buttons .rd5_search__advance a { padding: 3.6rem 0; } }

Cuando dierentes Media Queries son válidas para un entorno y surgen conflictos, éstos se resolverían por la norma de la cascada, de tal manera que las últimas reglas de estilo definidas serían las que se tendrían en cuenta.

SEO Para las imágenes

Aumenta el tráfico de tu blog con el SEO para imágenes de Google.

Nombra las imágenes adecuadamente

Las imágenes han de tener un nombre relevante, que sea descriptivo de las mismas. En definitiva, hay que poner la keyword a posicionar…o de lo que estemos hablando, es decir… si estamos hablando de posicionar curso de SEO… la imagen debería ser curso-seo.jpg todos estamos hartos de ver cómo las imágenes de una web se suelen llamar «imagen1.jpg»; esta mala costumbre tienes que evitarla a toda costa.

Cuida el formato de las imágenes

Para Google son muy imortantes estos 3 formatos: jpg, png y gif. Por tanto, cíñete a ellos y olvídate de .bmp, .tiff o rarezas varias. Por si te sirve de ayuda, aquí te dejo un conversor que te permitirá adaptarlas al formato que desees http://imagen.online-convert.com/es

Cuanto menos peso tengas las imágenes ¡MEJOR!

Sabemos que la velocidad de carga de una web depende en gran parte del peso de sus imágenes, pero esto no debe impedir que utilicemos fotos con cierta calidad, que se visualicen adecuadamente y exista la posibilidad de ampliar para conocer más detalles del producto. Recuerda que se trata de una poderosa arma de venta, al mismo tiempo que información relevante para tu página. Pero, teniendo en cuenta estas premisas, debes reducir la imagen a lo máximo que se pueda, cuanto menos pese mejor, pero que sea visible. Aquí te dejo un software donde puedes reducir las imágenes con porcentajes de cuanto lo reduce y con diferentes calidades: http://tools.dynamicdrive.com/imageoptimizer/ es muy fácil de usar, pruébalo y verás.

Dale a Google las dimensiones de tu imagen

Dimensiones de la Imagen: A google le interesa saber cuánto mide cada imagen, le resulta útil para no tener que calcularlo. Incluir esta información no cuesta nada, simplemente lo pones mediante el width y el height. ej:  Ten en cuenta que cuanto más fácil se lo pongas a Google, mejor valorará tu site.

El texto ALTernativo es indispensable

Etiqueta «alt», o texto aternativo. Google no es capaz de interpretar la información que ofrecen las imágenes; es por ello que hay que usar el atributo ALT. Como su nombre indica, se trata del texto que se muestra en la web en caso de que el navegador no sea capaz de visualizar la imagen, esta situación es muy común en los dispositivos móviles. Pues bien, esta etiqueta debe contener las palabras clave que definen a la imagen, además de ser descriptivas de la misma. Aquí conviene especificar lo que queremos posicionar, la keyword o de lo que se esté hablando… es decir… si estamos hablando de curso de seo… el alt sería: «curso de SEO».

Etiqueta tus imágenes con el «famoso» TITLE

Etiqueta «title» o título de la imagen. Nunca está de más poner el título a las imágenes. Debemos poner algo descriptivo de lo que se está hablando. Se trata del texto que se mostrará cuando sitúes el cursor encima de la foto, por ello debe incluir una descripción de la misma; siguiendo con el ejemplo anterior, sería

El atributo «Longdesc»

Como su propio nombre indica, sirve para incrustar una descripción larga. Es un modo de complementar el atributo alt y permite vincular la imagen con mayor contenido descriptivo. Siguiendo con el ejemplo:

Rodea la imagen con contenido relacionado

A la hora de posicionar una imagen quizás ésta sea una de las partes más importantes. Rodea la imagen de texto relevante, de la keyword a posicionar y de contenido que aporte y de valor. Si el contenido que rodea a la imagen contiene frases en negrita y títulos, mejor que mejor. Las imágenes deben ser de la misma temática que tu web. No tiene sentido que pongas imágenes de flores, categorizadas como tales, en una web de productos deportivos (si lo consideras oportuno, este tipo de imágenes pueden estar, pero en un segundo plano). Google relaciona el contenido de las imágenes con la información que le rodea para determinar su relevancia. En este caso tienen especial interés las fotos de producto, que deben aparecer al lado de una completa descripción del producto que muestran.

¡Hay que ser Ordenado!

Es recomendable almacenar todas las imágenes dentro de una misma carpeta, es decir, dentro de nuestro servidor tener una carpeta llamada /imagenes/ y tener todas las imágenes ahí almacenadas. Según Google esto afectará positivamente a nuestro Site y hará que su robot, GoogleBot trabaje más rápidamente.

El Linkbuilding, también existe en imágenes

Al igual que en el SEO tradicional, cuantos más links apunten a la imagen a posicionar, más relevancia y popularidad tendrá, y obtendrá una mejor posición. En este aspecto, puedes utilizar las plataformas de imágenes como Pinterest o Flirck como enlaces entrantes. También otras redes sociales como Tumblr te pueden ayudar a dar más relevancia a la imagen.

Scroll al inicio