El mòdul BrigthSide Publication permet convertir un context de la web en:

• Un blog.
• Una galeria d'imatges.
• Publicacions amb subscriptors.
• Publicacions de clau interna.
• Newsletter amb contingut personalitzat.
• Newsletter d'activitat periòdica.

Les categories de publicacions

La categoria de la publicació permet filtrar el conjunt de publicacions, per decidir coses com:

• Dir si és pública o privada.
• On apareix la publicació: resums, menús de filtre, portades.
• L'enviament per cua o directe.
• Mantenir un grups de bloggers.
• Mantenir un grups de subscriptors.

Subscriptors

Les categories admeten subscriptors. Quan aquests subscriptors poden fer manteniment de la seva subscripció, o no, es decideix per categoria. En les categories públiques, els usuaris administren la seva subscripció. Les categories públiques poden també restringir l'accés per grup social; quan és així els usuaris que no siguin del grup social no podran subscriure's.

Els usuaris poden sempre demanar no rebre d'una categoria, sigui o no privada, exceptuant les notificacions de sistema.

Tipus principals de publicacions

• La Publicació , que permet escrits amb contingut multimèdia.
• La Newsletter , composada per seccions. La Publicació pot ser part d'una secció.

Ordenació

Les publicacions s'ordenen per la data de la publicació, editable, en ordre descendent. És a dir, la més nova la primera.

Els bloggers

La funcionalitat per bloggers és estrictament a nivell web i per publicacions no acceptades. No s'entra a l'aplicació.

Es poden afegir bloggers a una categoria. Els bloggers poden ser, amés, administradors de la categoria.

Per veure què es pot fer segons el rol assignat, consulteu aquesta taula:

Operació dins la categoria	Administrador	Blogger
Veure publicacions aceptades	No	No
Nova publicació	Sí	Sí
Editar publicació pròpia	Sí	Sí
Editar publicació aliena	Sí	No

Públic o privat, resum de funcionalitats

Funcionalitat per categoria	Pública	Privada
Sortir en el context de publicacions de la web	Sí	No
Subscripció administrada per usuari	Sí	No
Personalitzable amb nom, email, etc.	No	Sí

Enviament per correu

Les publicacions s'envien per correu als subscriptors. Una publicació enviada ja no es torna a enviar. L'atribut enviada és editable, així que un administrador pot controlar els enviaments i els re-enviaments.

Quan especificat, l'atribut Retenir fins controla que no es faci l'enviament fins que es compleixi la data i hora.

Llançadores de correu

La forma estàndard d'enviament de publicacions és mitjançant una tasca d'enviament. La periodicitat d'execució d'aquesta tasca és configurable. Quan la tasca troba publicacions no enviades les prepara per enviar als subscriptors de la categoria de la publicació.

Per poder enviar la publicació usant la forma estàndard, cal que l'usuari hagi confirmat els seus Agreements i haver donat conformitat a la seva subscripció en Mail queue .

Una publicació sempre pot ser enviada usant Sendables .

Les newsletter poden veure's com publicacions i també poden funcionar igual. Però són, internament, completament diferents. Així com una newsletter pot fer de publicació, al la inversa és impossible.

La composició d'una newsletter és el següent (només els camps més significatius):

Camp	Explicació
Títol	És el títol de la newsletter. Per a newsletter tipus informe, el títol de la newsletter pot contenir macros que s'expandiran en el moment de l'enviament. Això permet crear els números de newsletter a partir d'una sola maquetació.
Acceptat	Cert quan la newsletter és llesta per a ser enviada.
Categoria	Es correspon a les categories d'enviament del sistema i inclouen les categories de publicacions. Les categories són les que administren les subscripcions.
Plantilla	És el sobre que s'utilitzarà per enviar la newsletter. Per defecte és el mateix que s'utilitza per a la resta de notificacions. En la configuració bàsica s'afegeix la NoLogo, que elimina el logo inicial de la plantilla per defecte, i la Clean que només deixa el cos central de la plantilla.
Contingut estàtic	Aquest atribut controla la duració en el temps del contingut d'una newsletter. Quan el contingut és estàtic, la newsletter està pensada per a ser enviada una única vegada. Les newsletter amb contingut estàtic poden ser fàcilment substituïdes per publicacions dins newsletter sense contingut estàtic.
Vol o Podria voler	La Newsletter pot comportar-se com una notificació de sistema variant aquest atribut. Vol comprova que l'usuari tingui acceptats tots els acords de notificacions i la subscripció sigui activa. Podria voler comprova que l'usuari no hagi denegat algun acord de notificació i la subscripció sigui activa. Per a més informació, veieu Mail queue .
Seccions	Són el contingut de la newsletter. Poden ser de diferents tipus, segons la informació que continguin.

Les seccions

Les seccions tenen propietats comunes i propietats específiques segons el tipus.

Propietats comunes

Propietat	Explicació
Columna	Una secció pot ser una columna. Si es marca aquest atribut, les seccions adjacents amb el mateix atribut formen columnes.
Ample	Si la secció és una columna, aquest atribut controla l'amplada de la columna. Si no s'indica res, les columnes es distribueixen amb el mateix ample.
Disparador	Per enviaments que necessitin disparador, aquest atribut converteix la secció en un disparador només si té contingut.

Tipus de seccions

Tipus	Explicació
Text	Les seccions de tipus text són de contingut wiki. Contenen text amb format, imatges i qualsevol altre contingut multimèdia admès pel wiki.
Imatge	Les seccions d'imatge són formades per una imatge que ocuparà el 100% d'ample de la secció. La utilitat és crear banners amb facilitat.
Externa	Les seccions externes s'alimenten del contingut dels mòduls BrightSide. Una secció externa, per exemple, podria contenir publicacions, una publicació sola, un llistat de temes per fer, projectes, contractes, documents. Les seccions externes admeten crear filtres de les dades que mostren, poden fer que el contingut sigui personalitzat per a cada persona a qui s'envia.

Propietats per tipus de secció

Tipus	Propietat	Explicació
Text o Externa	Banner	És el banner que encapçalarà la secció. La newsletter proporciona un editor de banners per facilitar-ne la creació.
Imatge	Imatge	És la imatge que omplirà la secció. La imatge ocuparà l'ample total de la secció, tenint en compte si és una columna.
Imatge	Enllaç	Si es defineix un enllaç, quan es faci click sobre la imatge es navegarà fins l'enllaç.

Gràfica simplificada d'una newsletter

Les seccions externes permeten incloure contingut d'altres mòduls. La comunicació es fa via funcions macro que s'expandeixen en el contingut final. Segons els atributs, una funció pot tornar contingut específic per a cada usuari o genèric per a tots.

No cal escriure les macros senceres. La majoria funcionen correctament amb els paràmetres per defecte.

convocations

Mostra les convocatòries.

convocations([context=<String>];[count=10<Integer>];[template=summary<String>];[restricted=true<Boolean>];[public=false<Boolean>];[future=true<Boolean>])

Atributs	Descripció	Tipus	Opcions	Per defecte
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		10
template	El patró del format per mostrar els items.	<String>		summary
restricted	Cert si el que es mostra és específic per a l'usuari.	<Boolean>		true
public		<Boolean>		false
future	Cert si es mostren els items amb data futura.	<Boolean>		true

polls

Mostra les enquestes.

polls([context=<String>];[count=10<Integer>];[restricted=true<Boolean>];[active=false<Boolean>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		10
restricted	Cert si el que es mostra és específic per a l'usuari.	<Boolean>		true
active	Cert si l'item es actiu.	<Boolean>		false
template	El patró del format per mostrar els items.	<String>		summary

dossiers

Mostra els dossiers.

dossiers([status=onwork<onwork|closed|all>];[context=<String>];[categoryIds=<String>];[dossierId=0<Long>];[count=10<Integer>];[restricted=false<Boolean>];[direct=false<Boolean>];[related=false<Boolean>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
status	L'estat en que es troba l'item.	<String>	onwork|closed|all	onwork
context	Indica on porten els enllaços per llegir més.	<String>
categoryIds	Les categories a mostrar. Buit per a totes.	<String>
dossierId	L'identificador del dossier a mostrar.	<Long>		0
count	El nombre d'ítems a mostrar.	<Integer>		10
restricted	Cert si el que es mostra és específic per a l'usuari.	<Boolean>		false
direct	Cert si el que es mostra és per participació directe de l'usuari.	<Boolean>		false
related	Cert si el que es mostra es participat per membres de la mateixa empresa que l'usuari.	<Boolean>		false
template	El patró del format per mostrar els items.	<String>		summary

projects

Mostra els projectes.

projects(status=onwork<onwork|closed|all>;context=<String>;[categoryIds=<String>];[dossierId=0<Long>];[count=10<Integer>];[restricted=false<Boolean>];[direct=false<Boolean>];[related=false<Boolean>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
status	L'estat en que es troba l'item.	<String>	onwork|closed|all	onwork
context	Indica on porten els enllaços per llegir més.	<String>
categoryIds	Les categories a mostrar. Buit per a totes.	<String>
dossierId	L'identificador del dossier a mostrar.	<Long>		0
count	El nombre d'ítems a mostrar.	<Integer>		10
restricted	Cert si el que es mostra és específic per a l'usuari.	<Boolean>		false
direct	Cert si el que es mostra és per participació directe de l'usuari.	<Boolean>		false
related	Cert si el que es mostra es participat per membres de la mateixa empresa que l'usuari.	<Boolean>		false
template	El patró del format per mostrar els items.	<String>		summary

issues

Mostra els temes.

issues(status=onwork<onwork|closed|all>;context=<String>;[categoryId=0<Long>];[dossierId=0<Long>];[count=10<Integer>];[restricted=false<Boolean>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
status	L'estat en que es troba l'item.	<String>	onwork|closed|all	onwork
context	Indica on porten els enllaços per llegir més.	<String>
categoryId	La categoria que es mostrarà. Zero per a totes.	<Long>		0
dossierId	L'identificador del dossier a mostrar.	<Long>		0
count	El nombre d'ítems a mostrar.	<Integer>		10
restricted	Cert si el que es mostra és específic per a l'usuari.	<Boolean>		false
template	El patró del format per mostrar els items.	<String>		summary

workload

Mostra la càrrega de treball de l'usuari.

workload(context=<String>;[count=10<Integer>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		10
template	El patró del format per mostrar els items.	<String>		summary

kb

Mostra el contingut de la base de coneixement.

kb(context=<String>;[count=10<Integer>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		10
template	El patró del format per mostrar els items.	<String>		summary

contracts

Mostra els contractes.

contracts([status=active<active|closed|all>];[context=<String>];[count=10<Integer>];[intervention=true<Boolean>];[type=0<Integer>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
status	L'estat en que es troba l'item.	<String>	active|closed|all	active
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		10
intervention	Cert si es comprova la intervenció dins el contracte.	<Boolean>		true
type	El tipus de l'item.	<Integer>		0
template	El patró del format per mostrar els items.	<String>		summary

last-activity

Mostra la darrera activitat de tots els mòduls dirigida a l'usuari i tenint en compte els seus permisos.

last-activity([context=<String>];[count=50<Integer>];[days=7<Integer>];[path=<String>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		50
days	Nombre de dies a revisar.	<Integer>		7
path	Trajectoria de l'entitat a revisar. Buit si totes.	<String>
template	El patró del format per mostrar els items.	<String>		summary

publications

Mostra les publicacions.

publications([context=<String>];[categoryId=0<Long>];[groupId=0<Long>];[count=10<Integer>];[template=summary<String>];[notSent=false<Boolean>];[lang=<String>];[asBlogger=false<Boolean>];[future=false<Boolean>])

Atributs	Descripció	Tipus	Opcions	Per defecte
context	Indica on porten els enllaços per llegir més.	<String>
categoryId	La categoria que es mostrarà. Zero per a totes.	<Long>		0
groupId	El grup que es mostrarà. Zero per a tots.	<Long>		0
count	El nombre d'ítems a mostrar.	<Integer>		10
template	El patró del format per mostrar els items.	<String>		summary
notSent	Cert si es mostren les no enviades.	<Boolean>		false
lang	L'idiome de l'item. Buit per a tots.	<String>
asBlogger	Els items pendents de l'usuari amb el rol de blogger.	<Boolean>		false
future	Cert si es mostren els items amb data futura.	<Boolean>		false

challenges

challenges([status=active<active|closed|all>];[context=<String>];[count=10<Integer>];[restricted=false<Boolean>];[studentRelated=false<Boolean>];[challengerRelated=false<Boolean>];[responseFrom=15<Integer>];[template=summary<String>])

Atributs	Descripció	Tipus	Opcions	Per defecte
status	L'estat en que es troba l'item.	<String>	active|closed|all	active
context	Indica on porten els enllaços per llegir més.	<String>
count	El nombre d'ítems a mostrar.	<Integer>		10
restricted	Cert si el que es mostra és específic per a l'usuari.	<Boolean>		false
studentRelated		<Boolean>		false
challengerRelated		<Boolean>		false
responseFrom		<Integer>		15
template	El patró del format per mostrar els items.	<String>		summary

Per tal de cobrir tots els casos que permeten les newsletter, la tasca que llança el contingut pels subscriptors és diferent de la tasca d'enviament de publicacions.

Diferències per decidir si enviar

La llançadora de newsletter té en compte que els diferents continguts venen de diferents mòduls. Si la llançadora es defineix com a Necessita disparador, previ a l'enviament, la llançadora comprovarà que hi hagi continguts en aquelles seccions marcades com a Disparador.

Diferències en els subscriptors

Opcionalment, la llançadora pot restringir els nombre de recipients a criteris de mòdul. Un cop seleccionats els recipients, aquests passaran pel filtre de subscripció, on es diu si volen o no rebre de la categoria de la newsletter.

Tot i que és possible crear tantes newsletter com s'enviïn, l'objectiu principal és permetre usar les newsletter com eina de maquetació i captar el contingut de l'activitat dins les bases de dades.

El que segueix són exemples dels diferents tipus de newsletter segons els atributs o la llançadora que s'utilitzi.

Variacions pel contingut

Newsletter tipus informe

Valor	Explicació
Títol	Pot ser un títol normal, tipus Informe d'estat.
Estàtica/Dinàmica	El contingut no es guarda com enviat en una data determinada. Cada vegada que es consulti o s'enviï, variarà segons les dades del moment de la consulta.

Newsletter tipus publicació via números

Valor	Explicació
Títol	El títol ha de contenir el número. Aquest pot ser del format any/mes per enviaments mensuals.
Estàtica/Dinàmica	El contingut es guarda com enviat en una data determinada. Cada vegada que es consulti o s'enviï el número, es veurà el mateix que es va enviar per primer cop.

Variacions per llançadora

Newsletter periòdiques

Llançadora	Explicació
Tasca periòdica	Una tasca periòdica genera el contingut i l'envia als subscriptors.

Newsletter d'activitat

Llançadora	Explicació
Una activitat concreta	Una activitat genera el contingut i l'envia als subscriptors.

Tant les publicacions com les newsletter s'envien usant diferents mètodes. El més habitual és usar una tasca programada que faci l'enviament, però també poden ser enviades en moments concrets a usuaris determinats.

Per entendre la complexitat dels enviaments, veiem quines són les peces en joc:

Peça	Explicació
Categoria de publicacions	Poden ser públiques o privades. Les públiques són gestionades per l'usuari. Les privades les gestiona l'administrador de publicacions.
Categoria de notificacions	Són categories creades pel sistema. La divisió entre públiques i privades funciona igual que les categories de publicacions. El sistema usa les notificacions privades per enviar missatges de sistema, com per exemple, la recuperació de passwords.
Subscripcions	Per a tota categoria pública, les subscripcions són gestionades per l'usuari, podent ser restringides pel grup social. Per categories privades, l'usuari no pot subscriure's, però si demanar no rebre.
Enviables	Els enviables són qualsevol entitat que pugui ser enviada per correu. La finalitat dels enviables és poder enviar correus de manera puntual.
Acords	Els acords són acceptats o declinats per l'usuari. Hi ha dos tipus d'acord, el que restringeix l'accés a l'aplicació i el que prohibeix l'enviament de notificacions o publicacions.

Els filtres

Algunes de les peces anteriors actuen com a filtres. La següent imatge mostra els elements a lloc.

Bones pràctiques

Usar categories públiques

Les categories públiques són gestionades per l'usuari. Si no vol rebre d'una categoria, pot aturar l'enviament per configuració. Si vol subscriure's a alguna categoria, també ho pot fer per configuració.

Evitar l'ús d'enviables

Els enviables tenen com a únic filtre els acords. L'usuari és requerit a un pronunciament vers l'acord una sola vegada. Un cop accepta o declina, ja no se li recorda més. Amés, els acords són acumulables per usuari. Un acord declinat atura tot enviament. L'efecte d'això, és que l'usuari no pot aturar l'enviament per configuració i té com a única solució demanar que s'aturi tot enviament.

No fer enviaments massius fora de les tasques programades

Les tasques programades, llançadores d'enviaments de categories de publicacions o newsletter, estan optimitzades per a enviaments massius. Utilitzem tasques d'enviament per lots que eviten ser marcats com spam pel volum de correus.

Dins les tasques programades, evitar l'ús de Guardar i executar, incidint més en una programació correcte.

Tant publicacions com newsletters poden definir-se per a un idioma concret. El resultat és el següent:

Idioma	Qui ho veu
Buit o nul	Tots els visitants de la web veurien la publicació o newsletter.
Un idioma de la web	Tots els visitants si l'idioma de visualització de la web o la del seu navegador coincideixen. En la majoria de webs aquest és seleccionable pel visitant.
Un idioma no configurat a la web	Només els visitants si l'idioma del seu navegador coincideix i la seva selecció d'idioma és Configuració per defecte.

Enviaments

Pels enviaments, la diferència està en l'idioma a comparar. S'utilitza sempre la configuració regional del contacte.

Idioma	S'envia?
Buit o nul	S'envia a tots els contactes seleccionats.
Un idioma concret	S'envia exclusivament als contactes seleccionats configurats amb el mateix idioma. La resta no rebran la publicació o newsletter.

La lògica darrera els idiomes

Com a regla general, s'entén posar un idioma quan:

• la publicació o newsletter es repetirà per a la resta d'idiomes, evitant mostrar o enviar contingut repetit.
• la publicació o newsletter està pensada per a un tipus d'usuari determinat i seleccionable per l'idioma.

No posaríem idioma si:

• el contingut només existeix en un idioma.
• el visitant probablement entendrà el contingut, independentment de l'idioma.

Les publicacions són bàsicament un blog. Van lligades a una data, un autor, unes lectures, una valoració i comentaris. Les publicacions utilitzen Mail queue per gestionar les subscripcions de les categories de publicació, així que poden ser enviades per correu a tot usuari registrat que ho vulgui. Les publicacions cobreixen abastament les necessitats de comunicació més habituals, via web o correu.

Si és així, doncs perquè hauríem de voler una nova eina?

Per què usar Newsletter?

Les Newsletter entomen la casuística que comporta l'enviament per correu. Maquetació, formats i continguts sota estàndards que funcionen en qualsevol client de correu.

Les Newsletter, amés, no han vingut soles. Per tal de donar contingut a les seccions externes, s'han creat els ContentProvider. Cada mòdul pot definir els seus per dotar de contingut les Newsletter.

Comparativa per funcionalitats

Funcionalitat	Publication	Newsletter
Publicació web	Sí, és l'entorn on millor es desenvolupa.	Sí, però no hi està pensat.
Enviament per correu	Sí, envia les publicacions no enviades prèviament.	Sí.
Control de subscriptors	Sí, per categories de publicació.	Sí, per categories de publicació, de mòduls i de sistema.
Funcionalitat notificació	No.	Sí, via disparadors de secció.
Contingut personalitzat	Sí, nom, correu i enllaços actius (liveref).	Sí, igual que publicacions més contingut personalitzat de mòduls.
Contingut dinàmic	No.	Sí, una sola Newsletter pot configurar-se per a ser enviada amb resums que variaran segons el seu estat en el moment de l'enviament.

Funcionalitat per URLs esteses

Les publicacions generen una URL d'accés a la publicació sencera. Aquesta URL segueix les convencions estàndard per URLs fàcils de llegir i acceptades pels buscadors. En una primera versió, les URL són el mateix títol adaptat.

Funcionalitat afegida per imatges

Dins els templates de publicacions, s'ha afegit una convenció de directoris amb funcionalitat per a imatges.

• Les imatges a l'arrel s'afegeixen manualment.
• Les imatges del directori topmost surten després del títol, ocupant tot l'ample.
• Les imatges del directori priorized surten després del sumari, ocupant tot l'ample.
• Les imatges del directori included surten al final del cos, ocupant la meitat de l'ample.

Tant les topmost com les priorized es veuen en el llistat. Les included només quan es veu la publicació sencera.

De la mateixa manera, les topmost i les priorized s'envien dins la notificació per correu.

Funcionalitat per arxius adjunts

Dins els templates de publicacions, s'ha afegit una convenció de directoris amb funcionalitat per a documents.

• Els documents de a l'arrel s'afegeixen manualment via enllaç.
• Els documents del directori attached surten després de la publicació, quan es mostra sencera.
• Els directoris sota attached es mostren com a directoris desplegables.

Els documents dins l'arrel de attached s'envien com adjunts dins les notificacions per correu de categories marcades com Evitar la cua o usant la pestanya Enviable.