WP Manifestindependent plugin directory
manifest / content / wpplugin_aside

[Óscar Pérez Gómez] Aside

Gestiona y muestra bloques del aside. Usa el shortcode [aside] para mostrarlo en cualquier página o entrada.

by Óscar Pérez · github.com/oscarpg41/wpplugin_aside · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/oscarpg41/wpplugin_aside/archive/refs/heads/master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/oscarpg41/wpplugin_aside ↗

Bloques Aparte (Aside)

Developer: Óscar Pérez (www.oscarperez.es)
Tested up to: 6.6
Stable tag: 2.0.0
License: GPLv2 or later

Descripción

Plugin de WordPress para gestionar y mostrar un listado de bloques de contenido aparte (aside), con soporte para imagen, texto, URL y orden de visualización.

Características:

  • Panel de administración con alta, edición y borrado de bloques aparte.
  • Shortcode [aside] para mostrar el listado en cualquier página o entrada.
  • Atributo opcional columnas (1 a 4, por defecto 1): [aside columnas="2"].
  • Soporte para imagen, nombre, URL, texto descriptivo y orden de visualización.

Estructura de ficheros

  • aside.php — fichero principal del plugin.
  • uninstall.php — elimina la tabla de base de datos al desinstalar el plugin.
  • includes/db.php — acceso a base de datos (creación de tabla vía dbDelta, CRUD).
  • includes/admin.php — menú, formulario y listado de administración.
  • includes/public.php — shortcode y carga de assets públicos.
  • includes/views/ — plantillas PHP usadas por admin.php y public.php.
  • assets/css/, assets/js/ — estilos y scripts de administración y públicos.
  • img/ — imágenes para botones de administración.

Base de datos

Tabla: wp_opg_plugin_aside

Campo Tipo Descripción
idAside INT(11) ID principal, autoincremento
name VARCHAR(100) Nombre del bloque aparte
url VARCHAR(140) URL de referencia
txt VARCHAR(255) Texto descriptivo
num_order INT(3) Número de orden (para reordenar en frontend)
image VARCHAR(140) URL de la imagen del bloque

Uso del shortcode

En cualquier página o entrada, usa:

[aside]

Con atributo de columnas:

[aside columnas="2"]

El número de columnas puede ser entre 1 y 4. La visualización es responsive y en dispositivos móviles siempre muestra 1 columna.

Ejemplo de uso

  1. Activa el plugin.
  2. Ve a Oscar Pérez Plugins → Bloques aparte.
  3. Haz clic en Añadir un nuevo bloque aparte.
  4. Completa:
    • Nombre: p.ej. "Centro de Visitantes"
    • URL: p.ej. "https://ejemplo.com"
    • Texto: p.ej. "Información y horarios"
    • Orden: p.ej. "1" (para mostrar primero)
    • Imagen: selecciona una imagen de tu biblioteca de medios
  5. Haz clic en Enviar.
  6. Crea una página/entrada en la que quieras mostrar los bloques y añade el shortcode [aside columnas="2"].

Configuración de seguridad

  • Se utilizan nonces (wp_nonce_field, check_admin_referer) para proteger las acciones POST.
  • Se utilizan funciones de sanitización (sanitize_text_field, esc_url_raw) en todos los inputs.
  • Se utilizan funciones de escape (esc_html, esc_attr) en todas las salidas.
  • Las queries SQL usan $wpdb->prepare() para evitar inyecciones.

Cambios desde v1.0

  • Refactorización completa a arquitectura modular (db.php, admin.php, public.php).
  • Nuevo shortcode [aside] para mostrar bloques en el frontend.
  • Mejora de seguridad: nonces, sanitización y validación.
  • Uso de dbDelta() para gestión de BD más robusta.
  • Estilos CSS separados y responsive.
  • Scripts JavaScript mejorados y modularizados.
  • Documentación actualizada en README.md.

Nota de compatibilidad

Este plugin mantiene la tabla wp_opg_plugin_aside del mismo nombre histórico para garantizar que los datos existentes no se pierdan durante la actualización de versiones anteriores.