FM Helper

Presentamos una nueva librería pensada completamente en el desarrollo de scripts para Foroactivo que contiene un montón de funcionalidad «out of the box» para que hacer códigos para tu foro sea sencillo, rápido y lleve pocas líneas.

Documentación de FM Helper

La documentación de la primera librería del blog, FM Helper. Aquí encontrarás descripciones detalladas sobre todos los métodos y propiedades disponibles, los objetos que se devuelven y cómo poder utilizarlos.

Colocar el módulo «Últimos Temas» en cualquier lugar

¿Alguna vez has intentado mover el módulo de «Últimos Temas» al tablón y has tenido problemas con el marquee, que se quedaba a mitad de camino de la pasarela?

Si te ha ocurrido alguna vez, seguro que sabrás lo frustrante que es que ocurra eso sin saber muy bien por qué pasa y cómo solucionarlo para al final acabar poniendo una barra de desplazamiento manual.

Aún teniendo en cuenta que no recomiendo el uso de barras de desplazamiento o marquees en casi ninguna situación debido a que su movimiento puede resultar molestos para los usuarios, hoy os traigo un nuevo plugin para poder mover dicho módulo de una forma muy sencilla.

Continuar leyendo “Colocar el módulo «Últimos Temas» en cualquier lugar”

Personalización de Perfiles: En pestañas y campos con clases independientes

El primer plugin que os traigo es un dos en uno. El siguiente plugin permitirá poner en tu foro:

  • Perfiles en pestañas. Podrás elegir cuántas perstañas tendrá cada perfil, qué cosa se ve en cada una de ellas y en qué orden y cuál (o cuáles) son las que se verán por defecto.
  • Campos de perfil con clases independientes. Podrás personalizar cada campo del perfil con CSS, puesto que cada uno tendrá su clase independiente. También divide cada campo en dos elementos, el título y el contenido, para una mayor personalización. Además, incluyo la posibilidad de quitar los dos puntos después de cada título.

De momento este plugin solo puede hacer esas dos cosas. Al estar hospedado en un servidor, podré añadir nuevas características en un futuro sin que tengáis que hacer nada más que activar qué nuevas características queréis para vuestro foro.

Aunque pueda parecer que instalar este plugin es muy complicado puesto que esta entrada es bastante larga, no os echéis atrás. Simplemente me he tomado la molestia de explicar hasta el más mínimo detalle para que nadie se pierda, pero tanto texto tan solo explica unos pasos que se hacen en menos de cinco minutos.

Quiero aclarar que esas dos características disponibles en el plugin no se activan al mismo tiempo. Podréis elegir cuál de las dos (o las dos) queréis aplicar en vuestro foro. El plugin está pensado pensando en la eficiencia, por lo que si una de las características no la queréis activar, no supondrá que el código se tenga que ejecutar en vuestro foro.

Instalación

Vete a la plantilla overall_header y busca:

<script src="{JQUERY_PATH}" type="text/javascript"></script>

Añade después:

<script src="https://gitcdn.xyz/repo/Flerex/cdn/master/fm/custom-profile.js" type="text/javascript"></script>

¡Ya está! El plugin está instalado.

Modificaciones

El plugin depende de mi propuesta de estructura estándar de los perfiles para poder funcionar, así que si no la tienes en tu foro, ¿a qué esperas? Lleva un minuto colocarla y te hará la vida más fácil.


Lo siguiente solo se debería instalar si tienes la intención de activar la parte del plugin «perfiles en pestañas». Vete a tu CSS y añade lo siguiente:

/**
*
* PERFILES EN PESTAÑAS
* Este código oculta todas las pestañas que no sean las activas
*
*/
.postprofile-tab-content {
   display: none;
}

.postprofile-tab-content.active {
   display: block;
}

Activación

Una vez que ya hemos instalado el plugin solo tenemos que decirle que se active. Esta es la parte que normalmente os liaría pero ya “no more”.

Añade el siguiente JS y muéstralo solo en los temas (para decirle al plugin que se active solo en los temas, que es donde están los perfiles):

$(function() {
	$('.postprofile').customProfile({
		// Aquí la configuración del plugin
	});
});

La traducción del código anterior sería más o menos lo siguiente:

Activa para los perfiles, que en mi foro se llaman “.postprofile” (por defecto en FA y en la modificación que os he dado arriba) el plugin “customProfile”, que tiene las siguientes configuración.

Si os fijáis, he dejado un comentario que dice “Aquí la configuración del plugin”. En esta parte es donde le diréis al plugin qué queréis que haga.

Campos con clases independientes

Empecemos por la parte de los campos del perfil con clases independientes. Si queréis activar esta parte tan solo tenéis que añadir a la configuración la siguiente línea:

uniqueFieldClass: true,

¿Activar las clases únicas en los campos del perfil? Sí.

Simple, ¿qué? En caso de que queráis quitar los dos puntos (es necesario tener la anterior opción activada) solo tenéis que añadir esta otra configuración:

withColon: false,

¿Los campos tienen dos puntos? No.

Perfiles en pestañas

Esta es la parte más compleja. No porque sea difícil, que no lo es, si no porque es la configuración más larga. Para activar esta parte del plugin voy a explicarme mejor con un ejemplo:

tabStructure:  [

    {
        label: 'Información',
        default: true,
        content: [
            '.postprofile-avatar',
            '.postprofile-username',
            '.postprofile-rank',
        ]
    },

    {
        label: 'Campos',
        content: [
            '.postprofile-fields',
            '.postprofile-rpg',
            '.postprofile-contact',
        ]
    }

],

La anterior configuración es la configuración para lo que yo considero una estructura «estándar» de las pestañas en los foros. Es lo que más suelo ver y básicamente tiene las siguientes características:

  • Dos pestañas.
  • Una pestaña «Información» que contiene el avatar, el rango y el nombre
  • Una pestaña «Campos» que contiene los perfiles, los botones de contacto y la hoja de personaje en caso de que el foro la tuviese.
  • La pestaña «Información» activa por defecto.

Si estás de acuerdo con esta configuración ya no deberías siquiera seguir leyendo. Copia y pega lo anterior y ya estarías listo.

En caso de que no seas tan conformista y quieras una configuración única, el funcionamiento es el siguiente:

Dentro del apartado tabStructure se van a poner distintas pestañas, las cuales están representadas por varios campos entre llaves ({, }). Todo el contenido entre estas llaves representa una pestaña y solo una. Cada pestaña tiene el campo «label», el cual se mostrará en el propio botón de la pestaña y el campo content, que a su vez contiene varios selectores que se corresponden a cada elemento que contendrá dicha pestaña.

A parte de estos dos campos, existe un tercer campo opcional llamado «default» el cual, si se le da valor true, cada vez que entres a un tema, dicha (o dichas) pestaña se mostrará activa por defecto. Sí, he dicho dichas porque no vi razón alguna para no permitir esto. Seguro que a alguien se le ocurre algo muy original con esto.

Ahora bien, en cuanto al orden en el que aparecen las pestañas… También lo he hecho muy simple. El orden en el que aparezcan en la configuración es el que se seguirá (el orden en el que aparecen las llaves correspondientes a cada pestaña).

Para el orden del contenido de cada pestaña (si el avatar va antes o después del nombre, etc.) se seguirá la lógica anterior. El orden de los selectores del campo «content» es el que se seguirá.

Si has seguido todos los pasos bien, tu código debería parecerse a este:

$(function() {
   $('.postprofile').customProfile({
        uniqueFieldClass: true,
        tabStructure:  [

            {
                label: 'Información',
                default: true,
                content: [
                    '.postprofile-avatar',
                    '.postprofile-username',
                    '.postprofile-rank',
                ]
            },

            {
                label: 'Campos',
                content: [
                    '.postprofile-fields',
                    '.postprofile-rpg',
                    '.postprofile-contact',
                ]
            }

        ],
   });
});

El resultado es el siguiente:

Quiero dejar constancia de que no he añadido ningún tipo de CSS que sea de personalización. Es por ello que las pestañas aparecerán unas encimas de otras sin ningún diseño. Si hacéis clic en ellas podréis comprobar que la lógica funciona, que es lo que yo proporciono, pero la parte de diseño os corresponde totalmente a vosotros.

Selectores

He dejado algún que otro selector muy interesante para la personalización del código:

  • .postprofile-tabs: Contenedor de las pestañas (los botones)
  • .postprofile-tab: Cada pestaña (los botones).
  • .postprofile-tab-content: Contenedor del contenido de una pestaña cualquiera
  • .postprofile-tab-content-{NOMBRE}: El contenedor del contenido específico de la etiqueta NOMBRE.
  • .postprofile-tab-content.active: Contenedor del contenido de una pestaña cualquiera que está actualmente activa
  • .postprofile-tab.active: Una pestaña que está actualmente activa

Eso es todo para el primer plugin que publico. Si tenéis cualquier tipo de duda no dudéis en enviarme un mensaje privado.

Plugins

Quería comentar que a partir de ahora voy a trabajar de una forma distinta a la hora de dar códigos, para solucionar alguno de los problemas más comunes que me he encontrado:

  • Eficiencia. Aunque siempre me planteo hacer los códigos de la forma más eficiente posible, sí es cierto que existen formas desaprovechadas de hacer que los códigos que publico carguen prácticamente al instante en vuestros foros.
  • Corrección de errores o puestas a punto. Todo el mundo tiene errores y, si en algún momento quiero corregir algo o cambiar alguna parte del código para hacerlo más eficiente, todas aquellas personas que ya lo hayan instalado en su foro no tendrán el código actualizado a no ser que lo vuelvan a hacer.
  • Abstracción. Muchas veces los códigos pueden resultar complicados y muy largos. A la vista de una persona que no entienda qué está pasando ahí, editarlos para que sean únicos a vuestro foro puede ser algo un poco complejo. A pesar de que siempre intento que mis códigos sean lo menos modificables posibles y que se adapten a los foros de forma automática, no siempre esto es posible.

Para corregir estos problemas he encontrado una solución perfecta para todos. A partir de ahora los códigos que publique tendrán un formato plugin y serán hospedados en un CDN propio. ¿Qué significa esto para los anteriores problemas?

  • En cuanto a la eficiencia, utilizar un CDN permite que cuanta más gente utilice mis códigos, menos probabilidades haya de que los códigos siquiera se tengan que cargar en tu foro. ¿Qué significa esto? Pues que si un visitante ya ha entrado a un foro que utilice cierto código mío, al entrar a tu foro no tendrá que volver a cargarlo porque ya va a estar en su ordenador. Es decir, el código cargará prácticamente al instante. Esto se lleva haciendo en el desarrollo web desde hace tiempo. Por ejemplo, Foroactivo carga jQuery de la misma forma, utiliando el CDN de Google.
  • En cuanto a la corrección de errores, tener el código hospedado en un servidor me permite corregir errores y mejorar los códigos de manera que el usuario (vosotros) no tengáis que hacer nada. Vuestros foros tendrán siempre la mejor versión de los códigos totalmente funcional sin tener que hacer nada.
  • Por último, la abstracción que permiten los plugins me permite pasar de lo que hacía hasta ahora, que era proporcionar los códigos con la parte editable y la no editable, a daros los códigos con tan sólo la parte editable. Lo he estado probando y es que es todo mucho más simple y fácil.

Por otro lado, aprovecho también para comentar algo que muchas personas me han preguntado y la verdad es que me gusta que se pregunte. Es sobre los créditos.

Veréis, a mí en este momento me dá bastante igual si me ponéis en los créditos de vuestro foro. Siempre se agradece si me enlazáis a este Tumblr, pero quiero dejar constancia que no es obligatorio. Lo que sí que no me gusta es que cambiéis partes de los códigos que hacen referencia a “flerex” o comentarios que tienen el propósito de demostrar la autoría del código. Son cosas que ningún usuario va a ver a no ser que indigue en el código fuente de la página, asi que no debería haber ningún problema.

Dicho esto, ya tengo un plugin preparado para estrenar este nuevo sistema. Esperemos que vaya todo perfecto lel.