template archivos - KumbiaPHP Framework PHP en español https://kumbiaphp.com/blog/tag/template/ Web & app MVC PHP framework Tue, 21 Apr 2020 16:19:29 +0000 es hourly 1 https://wordpress.org/?v=6.8.3 https://kumbiaphp.com/blog/wp-content/uploads/2016/01/250-150x150.png template archivos - KumbiaPHP Framework PHP en español https://kumbiaphp.com/blog/tag/template/ 32 32 123854898 Exportar tabla HTML a PDF https://kumbiaphp.com/blog/2019/04/29/exportar-tabla-html-a-pdf/?utm_source=rss&utm_medium=rss&utm_campaign=exportar-tabla-html-a-pdf https://kumbiaphp.com/blog/2019/04/29/exportar-tabla-html-a-pdf/#respond Sun, 28 Apr 2019 23:29:56 +0000 https://www.kumbiaphp.com/blog/?p=2078 En esta segunda parte veremos como exportar una tabla HTML a PDF usando la librería mPDF. Si no has…

La entrada Exportar tabla HTML a PDF se publicó primero en KumbiaPHP Framework PHP en español.

]]> En esta segunda parte veremos como exportar una tabla HTML a PDF usando la librería mPDF. Si no has visto la primera parte este es el primer artículo: Crear PDF usando HTML donde aprendimos a crear un PDF usando partials y funciones en un modelo.

[Actualización: Abril 2020] Hemos creado un nuevo repositorio llamado Sandbox en Github donde van a estar todos los ejemplos y que podrán visualizar en vivo en la página KumbiaPHP Framework Examples por lo tanto el código se ha mejorado y los links han cambiado.

Template PDF

Un template permite ahorrar código que se repite en la vistas, permitiendo así un fácil mantenimiento y separación del contenido. Realizará la carga de librería, la cabecera y el pié de página y por supuesto el contenido que queremos mostrar.

Para los que aun no han visto el tema de templates en KumbiaPHP o tienen dudas de su funcionamiento los invito a leer la sección sobre el manejo de vistas en KumbiapHP. A continuación el código completo del template y más abajo con capturas se explica cada parte importante.

Archivo: app/views/_shared/templates/pdf/mpdf.phtml

<?php

use Mpdf\Mpdf;

/* Defaults */

// fileName
$fileName = $filename ?? "Reporte-de-$controller_name";

// Title
$title = $title ?? "Reporte de $controller_name";

// CSS
$css = $css ?? 'css/pdf.css';

// Destination I show in browser  D download
$destination = isset($download) && $download ? 'D' : 'I';

//Activa el almacenamiento en búfer de la salida
ob_start();

?>
<!DOCTYPE html>
<html lang="en">

<head>
    <title><?= $title ?></title>
    <link rel="stylesheet" type="text/css" href="<?= $css ?>">
    <meta name="author" content="KumbiaPHP framework">
    <meta name="description" content="PDF output example with KumbiaPHP framework">
    <meta name="keywords" content="kumbiaphp, php, pdf, mpdf, examples">

<body>
    <htmlpageheader name="myHeader1">
        <section id="page-header">
            <a href="https://www.kumbiaphp.com"><img src="img/kumbiaphp.svg" alt="Logo KumbiaPHP"></a>
            <p>Powered by</p>
        </section>
    </htmlpageheader>

    <?php View::content() ?>

    <htmlpagefooter name="myFooter1">
        <section id="page-footer">
            <div id="printed-date">{DATE d/m/Y}</div>
            <div id="page-number">{PAGENO}/{nbpg}</div>
        </section>
    </htmlpagefooter>
</body>

</html>
<?php
$html = ob_get_clean();
ob_clean();

// Crea una instancia de la clase y le pasa el directorio temporal
$mpdf = new Mpdf([
    'tempDir' => APP_PATH . 'temp/mpdf',
    'format' => 'A4',
    'title2annots' => true,  // convert headers <hx> in annotations
    'mirrorMargins' => 0,    // mirror the left and right margin values on odd and even pages 
    'exposeVersion' => false // security 
    // more variables in https://mpdf.github.io/reference/mpdf-variables/overview.html
]);

// Escribe el contenido HTML (Template + View):
$mpdf->WriteHTML($html);

// Genera el PDF, ya sea para su descarga o visualización en el navegador
$mpdf->Output("$fileName.pdf", $destination);

El proyecto ya usa el autoload de composer para tener disponible mPDF y simplemente importa Mpdf\Mpdf. Luego se definen algunas variables para personalizar el PDF y se ejecuta la función ob_start(). «Esta función activará el almacenamiento en búfer de la salida. Mientras dicho almacenamiento esté activo, no se enviará ninguna salida desde el script (aparte de cabeceras); en su lugar la salida se almacenará en un búfer interno.»

Si desean conocer como agregar encabezados y pies de páginas con mPDF un compañero realizó un manual en la Wiki de KumbiaPHP que muestra como agregarlos usando las funciones explicadas en el artículo anterior: Exportar a PDF con cabecera y pie de pagina

Ahora en el <body> definimos el contenido de la cabecera y el pie de página, y entre ellos la función View::content() que nos permite mostrar el contenido de la vista.

Contenido del Body

mPDF maneja sus propias etiquetas, van entre llaves {} y usamos algunas de ellas:

  • DATE: Para mostrar la fecha actual
  • PAGENO: Número de la página
  • nbpg: Número total de páginas del documento

Y la parte final del template es la que se encarga de unir el template con la vista, generar el PDF con ese contenido y hacer que el documento se visualice o descargue.

General el PDF con el contenido HTML

Controlador PHP

Vamos a crear una nueva vista y para ello empezamos con el método que llamaremos pdf() en el controlador templates_examples_controller.php El código se encuentra explicado entre líneas.

Archivo: app/controllers/templates_examples_controller.php

public function pdf()
{
    //Usa el tempalte 'pdf'
    View::template('pdf/mpdf');
    //Modifica el nombre del archivo a descargar
    $this->fileName = 'user-list';
    //Modifica el título del documento PDF en la cabecera
    $this->title = 'User List';
    $this->download = false;

    $this->data = User::all(); // data to show (model User from db)
}

Vista HTML

Ahora crearemos la vista la cual tendrá la tabla, recorriendo uno a uno los registro de la consulta realizada por el modelo en el controlador.

Archivo: app/views/templates_examples/pdf.phtml 

<?php if (!count($data)) : ?>
    <h2>No hay ningún registro</h2> 
<?php else : ?>
    <table class="report">
    <caption class="caption"><?= $title ?></caption>
        <thead>
            <tr>
                <th scope="col">First Name</th>
                <th scope="col">Last Name</th>
                <th scope="col">Email</th>
                <th scope="col">Birthdate</th>
            </tr>
        </thead>
        <tbody> 
            <?php foreach ($data as $item) : ?>
                <tr>
                    <td><?= $item->first_name ?></td>
                    <td><?= $item->last_name ?></td>
                    <td><?= $item->email ?></td>
                    <td><?= $item->birthdate ?></td>
                </tr>
            <?php endforeach ?>
        </tbody>
    </table>
<?php endif ?>

No hace falta explicar mucho más de la vista anterior ya que es una vista normal en KumbiaPHP, esta vista es reutilizable por ejemplo si se quiere pasar a un documento Excel o devolver la vista mediante AJAX.

Enlazar al reporte PDF

Y en donde queramos que esté el enlace al reporte PDF simplemente lo añadimos a la vista deseada, nosotros lo hemos añadio a la página de información de los ejemplos de template.

Archivo: app/views/templates_examples/info.pdf.phtml

<a href="/templates-examples/pdf" target="_blank">Export users list</a>

Y al pulsar el botón visualizaremos el documento PDF como el siguiente:

Visualización del PDF generado con HTML

Descargar código completo

Como siempre, el código completo está disponible para todos en el siguiente repositorio en Github listo para usar: https://github.com/KumbiaPHP/Sandbox/

La entrada Exportar tabla HTML a PDF se publicó primero en KumbiaPHP Framework PHP en español.

]]> https://kumbiaphp.com/blog/2019/04/29/exportar-tabla-html-a-pdf/feed/ 0 2078 Cache de template en Kumbiaphp https://kumbiaphp.com/blog/2014/04/22/cache-de-template-en-kumbiaphp/?utm_source=rss&utm_medium=rss&utm_campaign=cache-de-template-en-kumbiaphp https://kumbiaphp.com/blog/2014/04/22/cache-de-template-en-kumbiaphp/#comments Tue, 22 Apr 2014 21:34:22 +0000 http://www.kumbiaphp.com/blog/?p=727 Buenas buenas! les cuento, en la tarde del día miércoles 13 decido pasar por el IRC de #kumbiaphp, para…

La entrada Cache de template en Kumbiaphp se publicó primero en KumbiaPHP Framework PHP en español.

]]> Buenas buenas! les cuento, en la tarde del día miércoles 13 decido pasar por el IRC de #kumbiaphp, para ver si alguien me echaba una mano con una dificultad que tenía.

Conversación va, conversación viene, el gran «joanhey» expuso algunos tips sobre cache que quisiera compartir con ustedes.

Eh aquí fragmentos destacados de la charla:

matiasrosario 17:33:25
el template se cachea solo verdad? cuando el sitio está en produccion

joanhey 17:33:45
no, debes poner en el controller 17:33:56

joanhey 17:35:10
View::cache($time, 'template', $group)

matiasrosario 17:35:17
aaah ok

joanhey 17:35:25
el group es opcional pero muy util, es para agrupar los caches y poderlos borrar si es necesario

joanhey 17:36:14
por ejemplo
si pones 'posts' 17:36:24

joanhey 17:36:37
cuando creas un post nuevo puedes borrar todas las caches de posts y dejar las demas 17:37:12

matiasrosario 17:37:33
excelente!!
si yo cacheo algo y los datos que se muestra alli son dinámicos, qué sucede? 17:38:01
ejemplo, cacheo una vista que es un listado de noticias 17:38:12

joanhey 17:38:28
estara cacheado durante el tiempo que le pusiste

matiasrosario 17:38:36
se van agregando nuevas noticias, te las muestra?

joanhey 17:39:12
si esta cacheado no muestra nada nuevo mientras esta cacheado
pero puedes borrar la cache del grupo noticias 17:39:31
al crear una nueva noticia 17:39:38
y se regenerara a la proxima visita 17:39:55

joanhey 17:40:58
pero recuerda
el cache de template 17:41:02
es solo para datos publicos sin auth 17:41:11
ya que la cache de template se ejecuta lo primero de todo 17:41:24
antes del router, controller 17:41:38

joanhey 17:41:53
asi que no puedes usarlo para datos privados

matiasrosario 17:42:25
claro, entiendo
che, muchas gracias por toda esta info 17:42:35

joanhey 17:42:37
se ejecuta lo pirmero de todo y si existe devuelve el template
no sigue con el proceso del req 17:42:51

matiasrosario 17:43:29
claro, ahi está cuando se ahorra todo el tiempo

joanhey 17:43:47
es rapidisima la cache de template
pero esta pensada para webs o datos publicos 17:44:44

matiasrosario 17:45:12
claro

matiasrosario 17:58:35
cuanto tiempo cachea por defecto kumbia?

joanhey 17:58:49
por defecto KumbiaPHP no cachea nada, solo los metadatos de las tablas (en "temp/cache") para usar en el ActiveRecord 17:59:03
un fw nunca puede decidir cachear 18:01:24
es el programador el que decide que cachear 18:01:34
y por cuanto tiempo 18:01:39

joanhey 18:05:27
cachea el tipo de datos de cada campo
si es string, unique, not null, ... 18:05:45

matiasrosario 18:06:08
uuuh mirá vos todo lo que no conocia

joanhey 18:06:17
1 por cada tabla

matiasrosario 18:06:22
es super util para optimizar la velocidad del sitio todo esto

joanhey 18:06:46
no sirve para todos los casos
pero si en muchos 18:06:50
es como cachear los partials 18:07:06

matiasrosario 18:07:08
claro, siempre y cuando no haya un auth de por medio

joanhey 18:07:11
es muy util
eso es solo para la cache de template (lo de auth)
yo no suelo usar cache de template
porque KumbiaPHP es realmente rapido
pero en algunas webs si puede ser util
pero por ejemplo el cache de partials si lo uso mucho 
tengo partials que muestran RSS
otros el tiempo 18:08:46
y estan cacheados para no solicitar los datos a la web cada vez
tambien para datos de tablas 18:09:13
por ejemplo
partials para: ultimas noticias, ultimos comentarios,.... 
que van en muchas paginas 
solo si se añade una noticia 18:10:12
borro el cache de noticias
o si se añade un comentario
el cache de comentarios
el unico que no es valido con el auth es el de template 18:11:12
los demas caches si

matiasrosario 18:20:25
bárbaro hermano, esta charla se merece un post

La entrada Cache de template en Kumbiaphp se publicó primero en KumbiaPHP Framework PHP en español.

]]> https://kumbiaphp.com/blog/2014/04/22/cache-de-template-en-kumbiaphp/feed/ 1 727 Vídeo tutoriales para crear template con bootstrap https://kumbiaphp.com/blog/2013/11/13/video-tutoriales-para-crear-template-con-bootstrap/?utm_source=rss&utm_medium=rss&utm_campaign=video-tutoriales-para-crear-template-con-bootstrap https://kumbiaphp.com/blog/2013/11/13/video-tutoriales-para-crear-template-con-bootstrap/#respond Wed, 13 Nov 2013 11:14:09 +0000 http://www.kumbiaphp.com/blog/?p=710 Roosvelt nos envía 2 nuevos vídeos para crear templates con KumbiaPHP. En este ejemplo usa una plantilla de administración…

La entrada Vídeo tutoriales para crear template con bootstrap se publicó primero en KumbiaPHP Framework PHP en español.

]]> Roosvelt nos envía 2 nuevos vídeos para crear templates con KumbiaPHP. En este ejemplo usa una plantilla de administración que usa bootstrap.

Gracias a Roosvelt Artizabal de www.tutorialesvirtuales.com , que seguirá creando vídeo tutoriales de KumbiaPHP.

La entrada Vídeo tutoriales para crear template con bootstrap se publicó primero en KumbiaPHP Framework PHP en español.

]]> https://kumbiaphp.com/blog/2013/11/13/video-tutoriales-para-crear-template-con-bootstrap/feed/ 0 710