Plugin VR-Frases
Plugin VR-Frases:
El plugin VR-Frases, una vez instalado, te permite organizar una colección de frases y citas célebres, con la posibilidad de clasificarlas y etiquetarlas según tus criterios y, además, actualizar los datos de los autores para mostrarlos cuando se realizan búsquedas filtradas por un autor concreto.
Puedes utilizar diversos shortcodes para mostrar la información almacenada: frases, autores, clases y temas.
Detalles del plugin:
Author: Vicente Ruiz https://www.vruiz.net (webmaster@vruiz.net)
Contributors: vruizg
Tags: quotes, random, frases, citas
Requires at least: 5.5
Tested up to: 6.8.1
Stable tag: 4.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Objetivo del Plugin
Este plugin te permite organizar una colección de frases y citas célebres, con la posibilidad de clasificarlas y etiquetarlas según tus criterios y, además, actualizar los datos de los autores para mostrarlos cuando se realizan búsquedas filtradas por un autor concreto.
Puedes mostrar todas las citas en una página (o publicación) y buscarlas por autor, clase o tema. Además, puedes colocar una frase aleatoria en tu plantilla o barra lateral (widget) que cambiará al actualizar la página.
Al instalar, el plugin se crearán algunas nuevas tablas en tu base de datos para guardar los datos de: frase o cita, autor, clase y tema. Tanto las clases como los temas pueden ser de tu elección.
Las frases se pueden mostrar como:
- Una frase aleatoria en cualquier parte de tu blog usando el shortcode
no se han encontrado imágenes
- En la barra lateral usando el widget «VR-frases».
- En una página que muestra todas las citas, y permite filtrarlas por autor, tema, etc.
A través del panel de control puedes agregar nuevas citas, autores, clases y temas, y editarlos o eliminarlos.
Puedes utilizar diversos shortcodes para mostrar la información almacenada: frases, autores, clases y temas.
Nueva instalación:
- Sube la carpeta
/vr-frases/al directorio/wp-content/plugins/o bien sube el archivo .zip y descomprímelo en la carpeta/wp-content/plugins/ - Activa el plugin a través del menú ‘Plugins’ en WordPress.
- Actualiza la configuración (enlace: Configuración / Activar / Eliminar).
Actualización:
- Desactiva el plugin.
- Elimina todos los archivos y carpetas antiguos, pero no borres las tablas de la baser de datos.
- Sube la carpeta z
/vr-frases/al directorio/wp-content/plugins/o bien sube el archivo .zip y descomprímelo en la carpeta/wp-content/plugins/ - Activa el plugin a través del menú Plugins en WordPress.
- Actualiza la configuración (enlace: Configuración / Activar / Eliminar).
- El plugin buscará las tablas antiguas y las actualizará si es necesario.
Actualizaciones desde versiones antiguas:
- Desde la versión 2.0.1 no puedes actualizar desde la versión 1.4. En ese caso, primero [actualiza manualmente]* a la versión 1.5.x, y luego a la última versión 4.0.x.
- Toda la estructura de archivos y carpetas ha cambiado. Si actualizas manualmente, primero elimina todos los archivos y carpetas porque algunos archivos ahora tienen nuevos nombres, luego sube todo el contenido a una carpeta llamada
vr-frasesen tu directorio/wp-content/plugins/. - No te preocupes, ¡tus datos no se perderán!
* En la página del plugin cambia a vista avanzada, al final de la página tienes un selector para descargar versiones anteriores.
- Para conservar los datos, es importante usar la opción de actualizar, si borras el plugin también se borrarán las bases de datos asociadas y, por tanto, toda tu información guardada.
Versión 4.0.5 (22/05/2025)
- Nuevo: Añadida una nueva opción para verificar el borrado total del plugin, y evitar la eliminación por error de todos los datos.
- Nuevo: Añadido una nueva pestaña en la página de Opciones, con una breve descripción de las funcionrs, Widgets y Shortcodes definiedos en este Plugin.
- Corregido: Error al paginar la lista de autores en Administrar Autores.
Versión 4.0.4 (18/05/2025)
- Versión estable 4.0.4
- Compatibilidad verificada con la versión 6.8.1 de WordPress.
- Añadido: enlace a la página de Autores en el Widget del escritorio
- Modificado: readme.txt ahora incluye información más detallada y nuevas capturas de pantalla.
Versión 4.0.3 (05/05/2025)
- Versión estable 4.0.3
- Nuevo: En la búsqueda de frases por autor, ahora se muestra un breve dato sobre el autor en la página de administración y en la página del usuario (página ‘slug’).
- Corregido: Errores menores de sintaxis.
Versión 4.0.2 (03/05/2025)
- Versión estable 4.0.2
- Corregido: Errores menores de sintaxis.
- Nuevo: Se añadió un enlace al autor en Wikipedia en la página de inicio.
- Nuevo: El archivo vr-frases.php ha sido desagregado en varios archivos en la carpeta
/includes/y los archivos de administración se han movido a la carpeta/admin/.
Versión 4.0 (28/02/2024)
- Versión estable 4.0
- Compatibilidad verificada con la versión 6.8 de WordPress.
- Corregido: Las páginas no se cargan correctamente en versiones antiguas de WordPress.
- Nuevo: Se añadió AJAX para gestionar algunas funciones.
- Nuevo: Ahora puedes importar citas y autores desde un archivo *.csv o *.txt.
- Nuevo: Controles Select2 para gestionar o actualizar: Citas, Autores, Clases y Temas.
- Nuevo: Se añadió la tabla de Autores para gestionar autores y enlazarlos a Wikipedia.
- Nuevo: Nueva tabla para guardar las taxonomías de Citas y Clases.
Versión 3.0.1 (11/03/2017)
- Corregido: Error en las funciones de búsqueda.
Versión 3.0.0 (23/02/2017)
- Compatibilidad verificada con la versión 4.7.2 de WP.
- Se reubicó la página de configuración en el menú principal de VR-Frases.
- Cambiado: CSS para la página principal.
- Corregido: Corrección de errores menor.
Versión 2.0.2 (09/09/2011)
- Nuevo: Aviso de advertencia al intentar actualizar desde la versión más antigua.
Versión 2.0.1 (01/09/2011)
- Corregido: Errores menores en el widget del panel: Algunos enlaces no funcionan, no muestran la versión instalada y el texto dice ‘de’ en lugar de ‘y’.
- Nuevo: Busca instalaciones anteriores al activar el plugin, y actuar en consecuencia.
- Cambiado: No se admiten actualizaciones de la versión 1.4 y anteriores.
Versión 2.0 (31/08/2011)
- Nuevas mejoras en esta versión:
- Reescritura del código para optimizar funciones y consultas a la base de datos.
- Módulos separados para incluir solo los archivos necesarios en las páginas de administración o principales.
- Se añadieron nuevas funciones en el área de administración para editar y eliminar elementos.
- Formulario de búsqueda incluido para el área de administración (solo en la página de Frases).
- Eliminar múltiples elementos a través de una casilla de verificación.
- Nuevo widget añadido al escritorio: De un vistazo…
- En ambas páginas (administración y principal), el formulario de búsqueda ahora incluye los resultados combinados.
- Hojas de estilo CSS para la página principal (ahora puedes personalizar la salida).
Capturas de pantalla de las diferentes funcionalidades del plugin:
Procedimientos del panel de Administración
- Gestionar Frases
Es el panel principal del Plugin donde se muestran todas las frases, y los resultados que coincidan con los parámetros de la búsqueda, ordenados por el criterio que elijas. Se pueden combinar todos los criterios entre sí.
La Edición rápida te permite modificar sólo la Clase y los Temas, mientras que la función Editar, te permite modificar todos los campos.
- Añadir nueva frase
Este formulario se usa para añadir frases individualmente. Se deben rellenar todos los campos.
Si algún elemento está duplicado (Frase y Autor) se mostrará un mensaje de error y NO se procesará
- Gestionar Autores
Este panel muestra un listado de todos los autores que tengamos registrados en la base de datos.
Cada registro de Autor se crea automáticamente al añadir una nueva Frase, al modificar una Frase existente y después de procesar un elemento de la tabla de frases importadas.
La Edición rápida te permite añadir o modificar los datos asociados al Autor: Lugar de nacimiento y fechas de nacimiento y defunción, además de un breve dato de la biografía.
Para las fechas anteriores a Cristo, se debe marcar la opción ‘AC‘ e introducir la fecha como ‘01/01/AAAA’, que mostrará la fecha como ‘YYYY AC’
Cuando no hay autor conocido (p.ej. refranes, proverbios, etc.) en las fechas de nacimiento y defunción pondremos 01/01/0001, eso hará que el campo se muestre en blanco en el listado, pero tendrá asignado un valor a efectos de filtros.
Tienes un cuadro desplegable que te permite filtrar los Autores que tienen todos los datos y los que todavía están pendientes de completar la información.
- Gestionar Clases y Gestionar Temas
Estos paneles te permiten añadir o modificar las Clases y Temas de tu elección.
Las Clases actúan como categorías y los Temas como etiquetas
En el campo Añadir puedes introducir varios valores separados por comas (,)
Si algún elemento está duplicado se mostrará un mensaje de error y NO se procesará.
- Importar Frases
Este panel te permite subir un archivo con formato .CSV o .TXT con los campos «Frase» y «Autor» entre comillas y separados por comas (,)
Al importar el archivo, se copian los datos a una tabla intermedia desde donde podrás procesar cada registro, debes añadir una Clase y uno o varios Temas, al grabar los datos la Frase pasa a la tabla principal y el Autor pasa a la tabla de autores donde podrás añadir los datos biográficos.
Si algún elemento está duplicado se mostrará un mensaje de error, durante la importación de datos, y NO se procesará.
- Gestionar Opciones
En este panel puedes modificar ls opciones del Plugin, cada campo tiene una leyenda descriptiva de la opción a configurar, por lo que te será sencillo ajustarlo a tus preferencias.
La opción más importante es la del ‘slug‘ de la página donde mostrarás tus frases al usuario.
Crea una página en blanco con el nombre que hayas elegido en la opción ‘slug‘ e inserta el shortcode [vr frases]* y ya estará listo para funcionar.
Informar sobre VR.Frases
Utiliza este enlace para comunicar errores que hayas encontrado en VR-Frases, o para solicitar la inclusión de nuevas funciones.
- VR-frases – VR-Frases Widget (VR_Frases_Widget): Muestra una frase aleatoria en cada recarga de página.
- Take a look for VR-frases – VR-Frases Dashboard Widget (vr_frases_dash_widget): Muestra en el panel de administración de WordPress un resumen de los datos (total de frases, autores, temas, clases), una frase aleatoria de ejemplo y la versión del plugin.
Shortcodes incluidos en el plugin
[vr frases]*
Muestra el contenido de la página principal del plugin y el formulario de búsqueda.
[ran dom frase]*
Incluye una frase aleatoria en el contenido de una entrada o página.
En tus plantillas puedes usar el código:<?php echo vr_frases_random_frase (); ?>
[frases count]*Devuelve un número entero con el total de frases almacenadas.
[autores count]*
Devuelve un número entero con el total de autores almacenados.
* El nombre de los shortcodes debe insertarse sin espacios. Se escribe así para evitsr que se procese el código.
Informar sobre VR-Frases
Utiliza este enlace para comunicar errores que hayas encontrado en VR-Frases, o para solicitar la inclusión de nuevas funciones.