← Blog

Manual

Astrolus: com hem integrat el tema

setembre 10, 2026

Tema original Astrolus en mode clar

Aquest blog servirà de manual de Nítida Clàssic. Cada entrada explicarà una peça del projecte: tema, comptabilitat, agenda, botiga o decisions tècniques. Comencem pel que es veu a tot arreu: el tema Astrolus.

Portada original d’Astrolus en mode clar
El tema original (ThemeWagon / Tailus): blobs, Urbanist, botons píndola i la barra amb el punt + barra índigo. Això és el que hem conservat.

Què és Astrolus

Astrolus és un tema HTML de ThemeWagon, basat en Tailus UI. És una landing moderna: Tailwind, tipografia Urbanist, blobs de color al fons i mode clar/fosc. El peu de Nítida encara en reconeix l’origen: Nítida Clàssic · tema Astrolus.

No el vam instal·lar com a tema WordPress acabat. El vam convertir en un tema clàssic propi, adaptat a un centre d’estètica: login, front públic, tauler intern, CRUD i WooCommerce.

Per què aquest tema

  • Interfície neta, sense un builder pesat.
  • Tailwind per CDN: no cal npm ni pas de compilació al NAS.
  • Mode clar/fosc senzill, que hem lligat a localStorage.
  • Llicència MIT, fàcil de modificar.
Portada original d’Astrolus en mode fosc
El mateix HTML en mode fosc. A Nítida el desem a localStorage.nitida-theme i l’apliquem abans de pintar la pàgina, per evitar el flash blanc.

De HTML a tema WordPress

El tema viu a wp-content/themes/astrolus/. El style.css només declara el tema (Astrolus Nítida). La lògica real està a les plantilles PHP i a functions.php: WordPress carrega el tema i nosaltres decidim quina plantilla surt segons la URL.

Estructura del tema

Fitxer Funció
front-page.php Portada: formulari d’entrar
page-front.php Catàleg públic (/front/)
page-dashboard.php Tauler de /compta/
page-compta.php Llistats i formularis CRUD
page-agenda.php Agenda setmanal de cites
page-client.php Fitxa de client amb pestanyes
page.php Cistella, caixa i compte WooCommerce
page-blog.php Índex d’aquest manual
single.php Una entrada del blog
woocommerce/ Botiga amb el mateix llenguatge visual
inc/ Dades Nítida, entitats, CRUD i sync Woo

Identitat visual que hem conservat

El header.php carrega Urbanist, Tailwind CDN i la paleta (primari #4f46e5, secundari taronja, darkMode: 'class'). La barra fixa i el peu són comuns a totes les pantalles. El que canvia és el contingut: login, front, botiga o compta.

Del catàleg Nítida a les targetes Astrolus

Al Front i a la Botiga les targetes 4:3 no són stock de ThemeWagon. Fem servir les fotos del catàleg Nítida (wp-content/uploads/catalog/), les mateixes que es veuen als productes sincronitzats a WooCommerce.

Enrutament: WordPress no mana sol

L’app no va a pàgines WP per cada mòdul. Fem servir rutes pròpies i template_include:

  • / — login (front-page.php). Si ja has entrat, redirigeix a /compta/.
  • /front/ — catàleg públic
  • /compta/ — tauler i CRUD
  • /botiga/, /cistella/, /pagament/ — WooCommerce
  • /blog/ — aquest manual, amb entrades de WordPress

functions.php llegeix la URL, omple les query vars nitida, nitida_action i nitida_id, i tria la plantilla.

WooCommerce amb cara d’Astrolus

La botiga no usa el look per defecte de Woo. Les plantilles del tema treuen sidebar, tabs i related, i pinten targetes 4:3 com el Front. El sync viu a inc/woocommerce.php: si un producte Nítida té sync_woo, es crea o actualitza el producte Woo (nom, preu, imatge del catàleg, virtual si no és cosmètica).

Com continuar el manual

Les properes entrades poden cobrir, una per una: CRUD, agenda, fitxa de client, botiga i convencions del NAS. Per afegir un capítol: WP Admin → Entrades → Afegeix, categoria Manual, amb una imatge destacada. Sortirà sola a /blog/.