Páginas públicas

Esta página está traducida del inglés. Leer la página en inglés

Las pantallas marcadas como public pueden abrirlas todos, también los visitantes que nunca iniciaron sesión: una página de inicio, una lista de precios, un centro de ayuda. Zeyn las sirve de modo que sean baratas de entregar y fáciles de manejar para las cachés y los buscadores.

Sin cookies para los visitantes

Una pantalla pública abierta por una petición sin sesión no establece ninguna cookie. La página lleva un token CSRF vacío, así que todos los visitantes con el mismo idioma y tema reciben los mismos bytes.

El runtime del navegador pide un token a GET /_zeyn/csrf justo antes de la primera llamada que lo necesita (un formulario, una acción, el selector de idioma). Esa llamada establece la cookie zeyn_csrf y nunca se guarda en caché. Cada POST se comprueba exactamente igual que en cualquier otra página: sin un token que coincida se rechaza con 403, y no se reintenta nada en silencio.

Los usuarios con sesión iniciada siempre reciben la cookie y el token en la página, como antes.

Caché HTTP

#[screen(route = "/pricing", public, cache = 300)]
pub fn pricing() -> Screen {
    Screen::new("Pricing")
}

cache = N permite que los navegadores y las cachés compartidas guarden la página durante N segundos (de 1 a 86400). Para una petición sin sesión, la página recibe entonces:

Una petición con un If-None-Match que coincida recibe 304 Not Modified sin cuerpo. Las pantallas cargadas por navegación dentro de la aplicación se guardan en caché de la misma manera, con su propia etiqueta.

Una petición con sesión nunca recibe cabeceras de caché públicas: la página se envía con Cache-Control: private, no-store. cache en una pantalla que no es public no compila.

La pantalla se sigue construyendo y renderizando para cada petición que llega al servidor; la etiqueta ahorra la transferencia y una caché delante de la aplicación ahorra la petición. Mantén las pantallas en caché libres de cualquier cosa que dependa del visitante: la hora del día, un contador, una elección al azar.

Buscadores y vistas previas de enlaces

#[screen(route = "/pricing", public, cache = 300)]
pub fn pricing() -> Screen {
    Screen::new(t!("pricing.title"))
        .description(t!("pricing.description"))
        .canonical("/pricing")
        .og_image("https://cdn.example.com/pricing.png")
        .robots(Robots::Index)
        .json_ld(serde_json::json!({
            "@context": "https://schema.org",
            "@type": "Product",
            "name": "Team plan",
        }))
}

Todos los valores se escapan. JSON-LD se escribe con <, > y & como <, > y &, de modo que un valor que contenga </script> no pueda terminar el elemento; el navegador nunca lo ejecuta y la política de seguridad de contenido sigue siendo tan estricta como en cualquier otra página. Las rutas de la aplicación en propiedades de dirección de JSON-LD (url, @id, image, logo, item y similares) se escriben absolutas con App::site_url, a cualquier profundidad, como esperan los buscadores.

Las URL deben ser URL https o rutas de la aplicación que empiecen por /. Cualquier otra cosa (http:, //host, javascript:, espacios, comillas) se omite con una advertencia en el registro. Las rutas de la aplicación se escriben detrás de la URL del sitio y de la ruta base:

App::new(t!("app.name")).site_url("https://shop.example.com")

Sin site_url, las etiquetas de head conservan la ruta de la aplicación, que los navegadores resuelven pero algunos rastreadores no.

La navegación dentro de la aplicación actualiza el título y todas estas etiquetas sin cargar la página.

Sitemap

#[action(public)]
pub async fn site_pages(part: SitemapPart, db: Db) -> Result<Vec<SitemapUrl>> {
    let rows = db.products_after(part.offset, part.limit).await?;
    Ok(rows.into_iter().map(|p| SitemapUrl::new(format!("/products/{}", p.slug)).lastmod(p.changed)).collect())
}

Feature::new("site").sitemap(site_pages)

/sitemap.xml pide a la acción 1.000 URL cada vez (part.offset, part.limit) y envía el XML en streaming, de modo que un sitio grande nunca se queda en memoria. Hasta 50.000 URL es un único urlset. Por encima es un índice de sitemaps de /sitemaps/1.xml, /sitemaps/2.xml y así sucesivamente, cada uno con 50.000 URL. La acción debe ser public y devolver las URL en un orden estable. Las rutas de la aplicación necesitan App::site_url, porque un sitemap contiene URL absolutas; las entradas que no sean URL https ni rutas de la aplicación se omiten. Lista solo las páginas públicas: los buscadores no pueden abrir las demás. Una feature por aplicación tiene un sitemap.

robots.txt y llms.txt

App::new(t!("app.name"))
    .robots_txt("User-agent: *\nAllow: /\nSitemap: https://shop.example.com/sitemap.xml\n")
    .llms_txt(include_str!("../llms.txt"))

Ambos se sirven como texto plano a todo el mundo.