Els mòduls són una de les millors possibilitats d'expansió que presenta el PostNuke. Es tracta d'un conjunt de fitxers agrupats (de codi php, imatges, html) concebuts per fer una tasca concreta dins de l'entorn. Un mòdul pot incloure també blocs que s'hi relacionen.

Tots els fitxers del mòdul s'instal·len dins d'una carpeta amb el seu nom que es copia dins de la carpeta modules. Podeu veure a continuació els que el PostNuke aporta per defecte:

Figura 8.6.1

Exemples de mòduls són, doncs: Notícies (News), Estadístiques (Stats), Enllaços web (Web_Links), Descàrregues (Download), etc.

Gràcies a la possibilitat de crear mòduls, han aparegut funcionalitats que el PostNuke no portava de sèrie, com per exemple: galeries d'imatges, agenda, fòrums, comerç electrònic, jocs, xat, etc. Si algú amb coneixements del PHP troba a faltar alguna cosa, sempre podrà afegir aquestes funcionalitats creant un mòdul nou.

Un aspecte que s'ha de destacar és que el PostNuke permet, des de l'administració, la instal·lació, desinstal·lació i eliminació de qualsevol mòdul que segueixi la seva API sense que això tingui cap efecte col·lateral en el sistema.

Tot seguit, farem dues pràctiques: veurem com funciona el mòdul de publicació de notícies i després veurem el procés d'instal·lació d'un mòdul extern.

Veurem tot el procés d'entrada de notícies mitjançant el mòdul News, que és un dels principals mòduls per a la gestió de notícies que envien els usuaris. És interessant, també, perquè permet la moderació de continguts, és a dir, les notícies entrades pels usuaris queden a l'espera que algun administrador n'autoritzi la publicació.

En el nostre cas, simularem que som alhora l'usuari i l'administrador. En una situació real, si fóssim l'administrador, podríem entrar directament una notícia des de l'apartat d'administració amb l'opció Afegir notícia (Add story, en la versiò anglesa).

El primer pas en aquest procés és el de l'entrada de la notícia per part de l'usuari. Això es pot fer clicant sobre l'opció Submit News del Main menu...

Figura 8.6.2

Ens portarà a la pantalla següent:

Figura 8.6.3

Els camps que s'han d'omplir són:

• Títol: el títol de la notícia que enviem.
• Tema: cal que triem el tema (topic) al qual assignem la notícia.
• Idioma: la notícia que entrem només apareixerà quan tinguem l'idioma que li assignem com a idioma del portal.
• Text d'article: aquí hi podem entrar el text de la notícia que apareixerà a la portada.
• Text estès: en aquesta casella hi podem posar, si cal, l'ampliació de la notícia (no sortirà a la portada).

Cal tenir en compte, tal com hem comentat a la pràctica 4, que si entreu una notícia des de l'editor visual (WYSIWYG), quan es mostri a la pantalla de notícies només s'interpretaran aquelles etiquetes html que hagueu autoritzat expressament a la taula que trobareu al final de Settings (Configuració en la traducció al català). Es poden autoritzar només les etiquetes (sense paràmetres) o també amb paràmetres. Es tracta d'una mesura de seguretat més.

Un cop hem omplert tots els camps, podem clicar sobre el botó Vista prèvia i es mostrarà com quedarà, aproximadament, la notícia un cop publicada:

Figura 8.6.4

Ara podem o bé rectificar alguna cosa o bé enviar la notícia clicant al botó OK del final. Si fem això darrer, observarem dues coses. Per una banda, apareix un missatge notificant que s'ha rebut la notícia:

Figura 8.6.5

Per l'altra, observeu que a sota del bloc del menú (Main menu) ha aparegut un nou bloc amb el nom d'Incoming en què es notifica que hi ha una notícia en espera de publicació.

Figura 8.6.6

Aquest bloc només apareix si estem identificats com a administradors; si us desconnecteu, veureu que el bloc desapareix.

Fins aquí el procés d'entrada de la notícia per part de l'usuari.

Les notícies en espera de ser publicades es mostren en el bloc Incoming que acabem de veure; però també tenim la possibilitat que el sistema ens enviï automàticament un missatge de correu electrònic que informa que hi ha ha noves trameses. Això ho podeu fer des de la pàgina d'administració a l'opció Submit News, on podreu definir si voleu que us enviï el missatge, a quina adreça i quin contingut tindrà.

Per veure el contingut que hi ha en espera, doncs, accediu al bloc Incoming i cliqueu sobre Notícies. Això us portarà a la pantalla que veieu a continuació:

Figura 8.6.7

Aquí podeu triar entre veure la notícia o arxivar-la. Si trieu la primera opció, arribarem a la pantalla en què podrem editar les notícies enviades:

Figura 8.6.8

En aquesta pantalla cal comentar el següent:

• Podem editar el contingut que ens han enviat: modificar coses, canviar el tema (topic), idioma.
• A la primera part, podem també:
  • assignar la notícia a una categoria (que a més podem definir si no ho està)
  • seleccionar si volem que la notícia aparegui a primera plana o no
  • seleccionar si admetem comentaris a la notícia o no
• A la part final, podem també activar una opció molt interessant que consisteix a programar la publicació de la notícia per una data i hora determinades.
• Finalment, en el desplegable del costat del botó OK podem triar entre Esborrar notícia, tornar a fer una vista prèvia per veure possibles modificacions amb Vista prèvia de la notícia o Enviar notícia, és a dir, publicar-la.

Trieu aquesta darrera opció i veureu, d'entrada, que el bloc Incoming ja ha desparegut perquè ja no hi ha res en espera de ser publicat.

Accediu ara a l'opció Home del Main menu i observeu com la vostra notícia surt ja a la portada del web:

Veurem ara el procés d'instal·lació d'un mòdul no estàndard: el Postguestbook. Es tracta de la versió 0.60 d'un llibre de visites que instal·larem en el nostre web de proves i que permetrà, com ja sabeu, que qualsevol usuari deixi un missatge o un record del seu pas pel portal, de manera similar a com es fa en els llibres de signatures que podem trobar en alguns llocs.

Aquest mòdul, a més, té la possibilitat de mostrar en un bloc les darreres intervencions. Per altra part, no té la traducció al català, cosa que ens permetrà practicar la creació d'alguns fitxers traduïts.

Tinguem present, finalment, que el procés d'instal·lació que farem tot seguit seria vàlid per a qualsevol mòdul que segueixi les directrius del PostNuke i, per tant, aquesta instal·lació és extrapolable a d'altres mòduls. Malgrat tot, sempre és bo llegir els documents d'instal·lació que acompanyen els mòduls per si hi hagués alguna cosa singular.

En els llocs de suport del PN, podeu trobar apartats dedicats als mòduls, amb una petita descripció de les seves funcionalitats. A més, contínuament s'anuncia la creació de nous mòduls o l'aparició de noves versions.

Per facilitar les coses, hem posat a punt el fitxer postguestbook_0.6.0.zip perquè el pugueu baixar al vostre ordinador.

Descomprimiu el fitxer en un directori temporal i veureu que conté dues carpetes: includes i modules. Ara copieu el contingut d'aquestes carpetes a la corresponent de la instal·lació que hem fet del nostre web, tal com podeu veure a la imatge:

Figura 8.6.10

Figura 8.6.11

Ara ja esteu en disposició de començar la instal·lació pròpiament dita.

Si no estem identificats com a administradors, la primera cosa que hem de fer és aquesta. Llavors, accediu a la pàgina d'administració mitjançant l'opció Administration del Main menu.

Tot seguit, trieu la icona Mòduls que us permetrà administrar tot allò relacionat amb els mòduls i, és clar, també instal·lar-los.

Figura 8.6.12

Observeu que apareix una pantalla gairebé buida amb només dues opcions:

• Llista. Amb aquesta opció es mostraran tots els mòduls que estan actius en aquest moment i podríem editar-los. Com que volem instal·lar un mòdul nou, aquesta opció de moment no ens interessa.
  
• Regenerar. Amb aquesta opció s'engega un recorregut per la carpeta modules cercant carpetes noves (per tant, mòduls nous) perquè el PostNuke les tingui en compte. Dit d'una altra manera, posarà al dia el registre de mòduls de la instal·lació. Cliqueu sobre aquesta opció que és la que ens interessa ara.

Apareix, aleshores, una taula llarga amb tots els mòduls continguts en la nostra instal·lació del PostNuke, tant si estan actius com no:

Figura 8.6.13

Observeu que els mòduls admeten tres estats: Actiu, Inactiu i Sense inicialitzar. A la banda dreta hi ha les opcions que permeten fer canviar aquests estats.

La manera més fàcil de cridar un mòdul és creant una entrada en un bloc de menú. Aprofitarem el Main Menu que ja tenim definit i li afegirem una opció al final per anar al Llibre de visites.

Torneu a la pantalla principal d'administració i cliqueu sobre la icona de Blocs que ja coneixem de la pràctica anterior.

Figura 8.6.17

Així arribareu a la taula dels blocs actius i podreu editar el primer bloc de l'esquerra, el Main Menu.

Observeu com està definit el menú i fixeu-vos que en l'apartat de Modules les crides als diferents mòduls es fan d'una manera simplificada, posant el nom del mòdul entre []. Per exemple: [Top_List]

Figura 8.6.18

El nom del mòdul ha de ser el mateix que té la carpeta que el conté, dins de la carpeta modules.

Així, podeu omplir l'última fila de manera semblant a la imatge, cosa que farà aparèixer una darrera opció, Llibre de visites, al menú.

Figura 8.6.19

Comproveu el funcionament clicant sobre la nova opció i apreixerà el llibre de visites a punt de rebre els missatges dels vostres visitants.

Figura 8.6.21

Tenim un problema, però: els missatges, o no surten traduïts (_PGB_TITLE), o surten traduïts a l'anglès. Això vol dir que la traducció al català no es troba a la carpeta pnlang del mòdul que hem instal·lat.

Arribats a quest punt, podem fer dues coses: veure si algú ha fet la traducció i està penjada en algun lloc, o, si ens hi veiem amb cor, fer la traducció nosaltres mateixos i posar-la a disposició de la comunitat.