Bannières

De ISPWiki.

La bannière est un élément de l'interface qui s'affiche au-dessus de l'écran et informe un utilisateur indépendamment de tout module.

Pour créer une nouvelle bannière en utilisant votre propre gestionnaire, veuillez créer un élément XML comme suit:

<xs:element name="banner">
  <xs:complexType>
      <xs:attribute name="id" use="required"/>
      <xs:attribute name="status" use="required"/>
      <xs:attribute name="infotype"/>
      <xs:attribute name="info"/>
      <xs:attribute name="nodismiss"/>
  </xs:complexType>
</xs:element>

Cet élément (banner) contient le message qui est destiné à l'utilisateur.

attribut - id

il s'agit du nom de bannière (l'identificateur unique).

attribut - status

il s'agit de la priorité (l'importance).

attribut - infotype

il s'agit du mode d'information du lien "En savoir plus" qui est situé sur la bannière.

attribut - info

il s'agit des informations permettant de créer un lien "En savoir plus".

attribut - nodismiss

si cet attribut a lieu, la lien 'Cacher' ne s'affiche pas sur la bannière.

L'attribut 'status' a des valeurs suivantes:

1

Information sensible. La bannière s'affiche en rouge.

2

Information alerte. La bannière s'affiche en jaune.

3

Information utile. La bannière s'affiche en vert.

L'attribut 'infotype' a des valeurs suivantes:

help

Le lien pointe vers la documentation. Vous pouvez trouver le nom de la section dans l'attribut 'info'.

url

Le lien facultatif qui est situé dans l'attribut 'info'.

func

Le lien pointe vers un autre module de l'interface. Vous pouvez trouver son nom on dans l'attribut 'info'.

formfunc

Le lien vers un autre module de l'interface. Vous pouvez trouver son nom on dans l'attribut 'info'.

S'il y a plusieurs bannières créées, vous verrez celle qui a la priorité plus élevée . Si la priorité est identique, vous verrez la bannière qui a été créée la première.

Utilisez les fonctionnalités suivantes afin de gérer les bannières depuis les applications externes dans ISPmanager (version 4.3.53 et celles plus élevées): Use the functions below for managing banners from external applications in ISPmanager (version 4.3.53 and higher):

• banner.new - installez la bannière:
  • elid - l'identificateur unique de bannière;
  • status - regardez ci-dessus. La valeur par défaut - 2;
  • infotype - regardez ci-dessus. La valeur par défaut - help;
  • info - regardez ci-dessus;
  • param - identificateur unique de bannière;
• banner.del - supprimer la bannière:
  • elid - l'identificateur unique de bannière;
• dismiss - cacher la bannièreр:
  • elid - l'identificateur unique de bannière;

Une bannière sera installée pour l'utilisateur actuel identifié. Exemple: pour installer la bannière pour root, exécutez la commande suivante sous accès root:

/usr/local/ispmgr/sbin/mgrctl banner.new elid=oldpasswd status=1

pour cacher

/usr/local/ispmgr/sbin/mgrctl dismiss elid=oldpasswd