generarPaginador($pagina_actual, $total_paginas, $por_pagina)

 Propósito de la función

Genera un componente visual (paginador) que permite navegar entre diferentes páginas de resultados, comúnmente usado en listados de datos.

🔧 Parámetros que recibe:

  • $pagina_actual: La página en la que se encuentra el usuario

  • $total_paginas: Cuántas páginas existen en total

  • $por_pagina: Cuántos elementos se muestran por página

🧩 Estructura del paginador:

text
[«] [1] [2] [3] [4] [5] [»]

🔍 Desglose del código:

1. Botón "Anterior" (←)

php
if ($pagina_actual > 1) {
    // Habilita el botón si NO estamos en la primera página
    $html .= '<a href="?page='.($pagina_actual - 1).'">←</a>';
} else {
    // Deshabilita el botón si estamos en la primera página
    $html .= '<span class="disabled">←</span>';
}

2. Números de páginas

php
$inicio = max(1, $pagina_actual - 2);  // Muestra desde 2 páginas antes
$fin = min($total_paginas, $pagina_actual + 2);  // Hasta 2 páginas después

for ($i = $inicio; $i <= $fin; $i++) {
    if ($i == $pagina_actual) {
        // Página actual (resaltada)
        $html .= '<span class="active">'.$i.'</span>';
    } else {
        // Otras páginas (clickeables)
        $html .= '<a href="?page='.$i.'">'.$i.'</a>';
    }
}

3. Botón "Siguiente" (→)

php
if ($pagina_actual < $total_paginas) {
    // Habilita el botón si NO estamos en la última página
    $html .= '<a href="?page='.($pagina_actual + 1).'">→</a>';
} else {
    // Deshabilita el botón si estamos en la última página
    $html .= '<span class="disabled">→</span>';
}

🎯 Ejemplo práctico:

Si tenemos:

  • $pagina_actual = 3

  • $total_paginas = 10

  • $por_pagina = 20

El paginador se vería así:

text
[←] [1] [2] [3] [4] [5] [→]

URL generada: ?page=4&limit=20 (al hacer clic en la página 4)

💡 Ventajas de este diseño:

  • Navegación intuitiva con botones anterior/siguiente

  • Vista contextual - muestra páginas cercanas a la actual

  • Estado visual claro - página actual resaltada, botones deshabilitados cuando corresponda

  • Responsive - usa clases de Bootstrap para buen diseño

📊 Cómo calcular los datos para llamar la función:

php
$total_elementos = 100;  // Total de registros en la base de datos
$por_pagina = 20;        // Elementos por página
$pagina_actual = isset($_GET['page']) ? (int)$_GET['page'] : 1;
$total_paginas = ceil($total_elementos / $por_pagina);

echo generarPaginador($pagina_actual, $total_paginas, $por_pagina);

Esta función es esencial para cualquier aplicación que maneje grandes cantidades de datos y necesite dividirlos en páginas para mejor usabilidad.


  1. La función generarPaginador necesita saber el $total_paginas (que depende de $total_solicitudes) para:

    • Saber cuándo mostrar/ocultar el botón "Siguiente"

    • Saber cuántos números de página mostrar

    • Determinar si la página actual es la última

Flujo del proceso:

  1. Obtener total: $total_solicitudes = obtenerTotalSolicitudes($pdo);

  2. Calcular páginas: $total_paginas = ceil($total_solicitudes / $por_pagina);

  3. Obtener datos paginados: $solicitudes = obtenerSolicitudesPaginadas($pdo, $inicio, $por_pagina);

La función obtenerSolicitudesPaginadas solo obtiene un subconjunto de datos (los que corresponden a la página actual), mientras que $total_solicitudes representa el conjunto completo de datos, que es necesario para la lógica de paginación.

Comentarios

Publicar un comentario

Entradas más populares de este blog

token

  ¿Qué es un token? Un  token  es una cadena de caracteres que representa información específica, como credenciales de acceso, identificadores únicos o datos de sesión. Se utilizan comúnmente en: Autenticación y autorización (JWT, tokens de acceso) Protección CSRF (Cross-Site Request Forgery) Identificación única de recursos Contraseñas de un solo uso Ejemplo pequeño en PHP: Token de autenticación simple php <?php // Función para generar un token aleatorio function generarToken ( $longitud = 32 ) { return bin2hex ( random_bytes ( $longitud ) ) ; } // Generar un token $token = generarToken ( ) ; echo "Token generado: " . $token . "\n\n" ; // Simular verificación del token (en una aplicación real se guardaría en base de datos) function verificarToken ( $tokenAlmacenado , $tokenRecibido ) { return hash_equals ( $tokenAlmacenado , $tokenRecibido ) ; } // Ejemplo de uso $tokenAlmacenado = $token ; // En la práctica, esto ven...
Leer más

¿Qué es un token y cómo se utiliza en una API?

  ¿Qué es un token y cómo se utiliza en una API? ¿Qué es un token? Un  token  es una cadena de caracteres que actúa como credencial de acceso para autenticar y autorizar a un usuario o aplicación en una API. Funciona como una "llave digital" que permite acceder a recursos protegidos sin necesidad de compartir credenciales sensibles como usuario y contraseña en cada solicitud. Tipos comunes de tokens: JWT (JSON Web Token) : Token auto-contenido con información codificada Access Token : Para acceso a recursos Refresh Token : Para renovar access tokens expirados API Key : Clave simple de identificación Ejemplo con PHP usando JWT 1. Instalación de dependencias bash composer require firebase/php-jwt 2. Generar un token JWT php <?php require 'vendor/autoload.php' ; use Firebase \ JWT \ JWT ; use Firebase \ JWT \ Key ; class TokenManager { private $secretKey = "tu_clave_secreta_muy_segura" ; private $algorithm = 'HS256' ; ...
Leer más

Generación de Credenciales API

   Generación de Credenciales API Método 1: Credenciales básicas (API Key + Secret) php <?php // Generar credenciales seguras function generarCredencialesAPI ( ) { $api_key = bin2hex ( random_bytes ( 32 ) ) ; // 64 caracteres hexadecimales $api_secret = bin2hex ( random_bytes ( 64 ) ) ; // 128 caracteres hexadecimales return [ 'api_key' => $api_key , 'api_secret' => password_hash ( $api_secret , PASSWORD_DEFAULT ) ] ; } // Generar y guardar credenciales $credenciales = generarCredencialesAPI ( ) ; // Guardar en base de datos (ejemplo) // INSERT INTO api_credentials (api_key, api_secret_hash, created_at) // VALUES (:api_key, :api_secret, NOW()) ?> Método 2: Credenciales JWT php <?php use Firebase \ JWT \ JWT ; use Firebase \ JWT \ Key ; class JWTCredentials { private $secret_key ; public function __construct ( ) { $this -> secret_key = bin2hex ( r...
Leer más