...
- le portail parcourt le fichier dlm.xml pour savoir quels fragments lui attribuer (en fonction des règles d'audience indiquées dans la balise <dlm/audience>)
- ensuite il va voir le détail du profil de chaque propriétaire (layout owner) concerné (voir gestion des fragments) et attribue la partie de profil (onglet, groupe d'onglets) a l'utilisateur connecté.
- les fragments sont classés et affichés selon l'ordre indiqué dans l'attribut precedence
- pour finir le portail applique les personnalisations faites par l'utilisateur lors de ses connexions précédentes (déplacement, modification, suppression de fragment, ajouts d'onglets et de canaux...)
Le fichier
...
dlm.xml
Il se trouve dans le dossier properties du portail. On définit dans ce fichier la position des fragments et leur visibilité pour les utilisateurs. Le contenu des fragments (canaux) est précisé ailleurs, dans les fichiers d'import de fragments ou par l'interface graphique (voir gestion des fragments)
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0"?>
<!-- $Header$ -->
<managedLayoutFragments xmlns:dlm="http://org.jasig.portal.layout.dlm.config">
<dlm:property name='defaultLayoutOwner' value='fragmentTemplate'/>
<!-- <dlm:property name='layoutDecorator' value='someClass'/> -->
<!-- Controls clearing of dlm fragment cache. This allows changes made to layout
owners to be reflected once the cache has been updated. Specified in minutes. -->
<dlm:property name='org.jasig.portal.layout.dlm.RDBMDistributedLayoutStore.fragment_cache_refresh' value="5"/>
<dlm:fragment name='Guests' ownerID='guest-lo' precedence='100'>
<dlm:audience evaluatorFactory='org.jasig.portal.layout.dlm.providers.GuestUserEvaluatorFactory'/>
</dlm:fragment>
<dlm:fragment name='Scolarite' ownerID='scolarite-lo' precedence='50'>
<dlm:audience evaluatorFactory='org.jasig.portal.layout.dlm.providers.GroupMembershipEvaluatorFactory'>
<paren mode="AND">
<attribute mode='deepMemberOf' name='LDAP Tous les etudiants'/>
</paren>
</dlm:audience>
</dlm:fragment>
<dlm:fragment name='Personnels' ownerID='personnel-lo' precedence='50'>
<dlm:audience evaluatorFactory='org.jasig.portal.layout.dlm.providers.GroupMembershipEvaluatorFactory'>
<paren mode="AND">
<attribute mode='deepMemberOf' name='LDAP Tout le personnel'/>
</paren>
</dlm:audience>
<dlm:fragment name='Admin' ownerID='admin-lo' precedence='10'>
<dlm:audience evaluatorFactory='org.jasig.portal.layout.dlm.providers.PersonEvaluatorFactory'>
<paren mode="AND">
<attribute name="username" mode='equals' value='admin'/>
</paren>
</dlm:audience>
</dlm:fragment>
</dlm:fragment></managedLayoutFragments>
|
...
- L'utilisateur par défaut (dont tout le monde hérite) : defaultLayoutOwner
- le temps pendant lequel ce fichier est caché : org.jasig.portal.layout.dlm.RDBMDistributedLayoutStore.fragment_cache_refreshunmigrated-wiki-markup
- tous les fragments *<dlm:fragment> \ [...\] </dlm:fragment>*
Modification du fichier dlm.xml
...
Définition d'un fragment
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<dlm:fragment name='Scolarite' ownerID='scolarite-lo' precedence='50'>
<dlm:audience evaluatorFactory='org.jasig.portal.layout.dlm.providers.GroupMembershipEvaluatorFactory'>
<paren mode="AND">
<attribute mode='deepMemberOf' name='LDAP Tous les etudiants'/>
</paren>
</dlm:audience>
</dlm:fragment>
|
On retrouve :
...
nom
...
[name
...
]
Uniquement utilisé dans ce fichier pour les distinguer
...
propriétaire
...
[ownerID
...
]
C'est le layout owner (par convention on suffixe le login de ces utilisateurs par -lo pour les distinguer des utilisateurs classiques).
...
emplacement
...
de
...
gauche
...
a
...
droite
...
[precedence
...
]
Détermine la place du fragment de gauche a droite par rapport aux autres.
C'est un numérique ; plus il est grand plus il se trouve a gauche.
Les precedences sont évaluées entre différents fragments.
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<dlm:fragment name='Testing' ownerID='test-lo' precedence='90'> ... <dlm:fragment name='Other' ownerID='other-lo' precedence='100'> |
...
En cas de conflit c'est l'ordre de définition dans le fichier dlm.xml qui tranchera.
...
ciblage
...
[audience
...
]
Va déterminer à qui doit être attribué le fragment.unmigrated-wiki-markup
On paramètre une classe java qui va faire l'évaluation \ [evaluatorFactory\].
On dispose de plusieurs classes java de base dans le portail :
...
Il y a un fichier par fragment. Par convention, on donne au fichier le nom de son propriétaire (guest-lo pour le propriétaire guest-lo), l'extension du fichier est .fragment-layout
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<layout script="classpath://org/jasig/portal/io/import-layout_v3-0.crn" username="guest-lo">
<root unremovable="Y" immutable="N" hidden="N" name="Root folder">
<header unremovable="Y" immutable="Y" hidden="N" name="Header folder">
<channel unremovable="" immutable="" hidden="" fname="header"/>
<channel unremovable="" immutable="" hidden="" fname="portal/login/general"/>
<channel unremovable="" immutable="" hidden="" fname="session-locales-selector"/>
<channel unremovable="" immutable="" hidden="" fname="fragment-admin-exit"/>
</header>
<footer unremovable="N" immutable="N" hidden="N" name="Footer folder">
<channel unremovable="" immutable="" hidden="" fname="footer"/>
</footer>
<tab unremovable="" immutable="N" hidden="N" name="ESUP Portail">
<column unremovable="" immutable="N" hidden="N" name="Column 1">
<structure-attribute type="folder">
<name>width</name>
<value>100%</value>
</structure-attribute>
<channel unremovable="" immutable="" hidden="" fname="esup-portail.org"/>
</column>
</tab>
</root>
<profile name="HTML browser profile">
<description>A sample profile for common web browsers</description>
<structure name="DLM Tabs and columns"/>
<theme name="DLM XHTML"/>
</profile>
</layout>
|
...
- name : Nom de l'onglet affiché à l'écranunmigrated-wiki-markup
- mutable : \ [true\|false\] est-il déplaçable ?unmigrated-wiki-markup
- hidden : \ [true\|false\] est-il affiché ?
Balise Wiki - removable : \ [true\|false\] est-il supprimable ?
column
Contient des canaux, qui seront affichés les uns en dessous des autres. Si plusieurs colonnes sont définies pour un onglet, elles seront affichées côte à côte.
...