Pour commencer

IMPORTANT

Ce tutoriel a été écrit par ZygOm4t1k que nous remercions vivement. Vous pouvez retrouver l’original ici

Voici un petit TP pour expliquer comment créer un plugin. Pour l’exemple nous allons créer un plugin qui retourne une phrase du site viedemerde.fr .(Le plugin sera évolutif)

Il ne remplace en aucun cas la documentation officielle

Créer la base du plugin

Pour commencer il faut déterminer un nom et un id (qui ne doit pas exister)

Nom : Vie de Merde Id : vdm

Télécharger le plugin template pour avoir la base

Dé zipper le fichier. Vous obtiendrez un dossier « plugin-template-master » contenant des dossiers 3rparty, core, desktop…

On y va.

Renommez le dossier « plugin-template-master » en « vdm » (l’id) du plugin.

1/ Ouvrir le fichier plugin_info/info.json et éditer le.

{
  "id" : "vdm",
  "name" : "Vie de Merde",
  "description" : "Plugin pour récupérer les dernières vdm",
  "licence" : "AGPL",
  "author" : "Zyg0m4t1k",
  "require" : "3.3.39",
  "category" : "monitoring",
  "changelog" : "",
  "documentation" : "",
  "language" : "",
  "compatibility" : ""
}

Copiez collez le code ci-dessus.

J’ai changé l’id (vdm), le nom, ajouté une description, l’auteur et la catégorie.

require : version minimale de jeedom pour avoir accès au plugin sur le market.

Changelog, documentation, language, compatibility nuls pour le moment. J’y reviendrai plus tard

2/ Nous allons renommer les fichiers nécessaires pour que le plugin soit reconnu par Jeedom

• Renommez le fichier core/ajax/template.ajax.php en vdm.ajax.php

• Renommez le fichier core/class/template.class.php en vdm.class.php et ouvrez le pour l’éditer.

Remplacez

class template extends eqLogic

par

class vdm extends eqLogic

class templateCmd extends cmd

par

class vdmCmd extends cmd

• Renommez le fichier core/php/template.inc.php en core/php/vdm.inc.php
• Renommez le fichier desktop/php/template.php en desktop /php/vdm.php et ouvrez le

Remplacez :

$plugin = plugin::byId('template');

Par

$plugin = plugin::byId('vdm');

<legend><i class="fas fa-table"></i> {{Mes templates}}</legend>

Par

<legend><i class="fas fa-table"></i> {{Mes équipements}}</legend>

<?php include_file('desktop', 'template', 'js', 'template');?>

Par

<?php include_file('desktop', 'vdm', 'js', 'vdm');?>

Et rien d’autre , ne changez pas la ligne <?php include_file('core', 'plugin.template', 'js');?>.

• Renommez le fichier desktop/modal/modal.template.php en desktop/modal/modal.vdm.php

• Renommez le fichier desktop/js/template.js en desktop/js/ vdm.js

• Ouvrir le fichier plugin_info/install.php et renommez les fonctions comme suit

function vdm_install() {
}

function vdm_update() {
}

function vdm_remove() {
}

Voilà le plugin est prêt mais il reste la customisation et l’icône à mettre à jour : Documentation développeurs - Icône de plugin

Ajoutez l’icône dans le dossier plugin_info sous le nom vdm_icon.png

dans mon cas

Maintenant on peut copier le dossier vdm dans le dossier plugin de Jeedom et aller dans la gestion des plugins. On retrouve bien le plugin.

On l’active et ensuite plugins/Monitoring/Vie de Merde

Voilà la base est prête. Vous devriez avoir le plugin d’actif mais pour le moment il ne fait rien.

Les commandes

Le but du plugin sera de récupérer une vdm aléatoire et l’afficher sur le dashboard.

Il faut donc créer une commande de type info pour stocker cette information. Elle sera de sous-type « string » car c’est une chaîne de caractère.

Pour l’exemple nous allons ajouter une commande qui rafraîchit l’information. Ce sera donc une commande de type action et sous-type other

-Créez un équipement « vdm1 » en cliquant sur le +. Activez le et rendez le visible. Choisissez un objet et l’équipement doit apparaître sur le dashboard (selon l’objet).

A ce moment, il n’y a pas de commandes qui apparaissent dans l’onglet commandes, ni sur le widget.

Ouvrir le fichier core/class/vdm.class.php et chercher la fonction postSave() (Lire la doc du plugin template si pas encore fait)

On crée les 2 commandes

public function postSave() {
  $info = $this->getCmd(null, 'story');
  if (!is_object($info)) {
    $info = new vdmCmd();
    $info->setName(__('Histoire', __FILE__));
  }
  $info->setLogicalId('story');
  $info->setEqLogic_id($this->getId());
  $info->setType('info');
  $info->setSubType('string');
  $info->save();

  $refresh = $this->getCmd(null, 'refresh');
  if (!is_object($refresh)) {
    $refresh = new vdmCmd();
    $refresh->setName(__('Rafraichir', __FILE__));
  }
  $refresh->setEqLogic_id($this->getId());
  $refresh->setLogicalId('refresh');
  $refresh->setType('action');
  $refresh->setSubType('other');
  $refresh->save();
}

• Créez un autre équipement « vdm2 » en cliquant sur le +. Dans l’onglet commandes, les commandes sont apparues. Activez le et rendez le visible. Choisissez un objet parent et allez voir ce que ça donne sur le dashboard.

• Enregistrez le premier équipement « vdm1 » pour créer les commandes. Voir le rendu sur le widget aussi.

Dans l’onglet commandes, vous devriez voir.

Ouvrir desktop/php/vdm.php pour trouver le code html de ce tableau.

<!-- Onglet des commandes de l'équipement -->
<div role="tabpanel" class="tab-pane" id="commandtab">
<a class="btn btn-default btn-sm pull-right cmdAction" data-action="add" style="margin-top:5px;"><i class="fas fa-plus-circle"></i> {{Ajouter une commande}}</a>
<br/><br/>
<div class="table-responsive">
<table id="table_cmd" class="table table-bordered table-condensed">
<thead>
<tr>
<th>{{Id}}</th>
<th>{{Nom}}</th>
<th>{{Type}}</th>
<th>{{Paramètres}}</th>
<th>{{Options}}</th>
<th>{{Action}}</th>
</tr>
</thead>
<tbody>
</tbody>
</table>
</div>
</div><!-- /.tabpanel #commandtab-->

Au moment de l’affichage , c’est le script desktop/js/vdm.js qui est appelé et lance la fonction addCmdToTable.

/* Fonction permettant l'affichage des commandes dans l'équipement */
function addCmdToTable(_cmd) {
  if (!isset(_cmd)) {
    var _cmd = { configuration: {} };
  }
  if (!isset(_cmd.configuration)) {
    _cmd.configuration = {};
  }
  var tr = '<tr class="cmd" data-cmd_id="' + init(_cmd.id) + '">';
  tr += '<td style="width:60px;">';
  tr += '<span class="cmdAttr" data-l1key="id"></span>';
  tr += '</td>';
  tr += '<td style="min-width:300px;width:350px;">';
  tr += '<div class="row">';
  tr += '<div class="col-xs-7">';
  tr += '<input class="cmdAttr form-control input-sm" data-l1key="name" placeholder="{{Nom de la commande}}">';
  tr += '<select class="cmdAttr form-control input-sm" data-l1key="value" style="display : none;margin-top : 5px;" title="{{Commande information liée}}">';
  tr += '<option value="">{{Aucune}}</option>';
  tr += '</select>';
  tr += '</div>';
  tr += '<div class="col-xs-5">';
  tr += '<a class="cmdAction btn btn-default btn-sm" data-l1key="chooseIcon"><i class="fas fa-flag"></i> {{Icône}}</a>';
  tr += '<span class="cmdAttr" data-l1key="display" data-l2key="icon" style="margin-left : 10px;"></span>';
  tr += '</div>';
  tr += '</div>';
  tr += '</td>';
  tr += '<td>';
  tr += '<span class="type" type="' + init(_cmd.type) + '">' + jeedom.cmd.availableType() + '</span>';
  tr += '<span class="subType" subType="' + init(_cmd.subType) + '"></span>';
  tr += '</td>';
  tr += '<td style="min-width:150px;width:350px;">';
  tr += '<input class="cmdAttr form-control input-sm" data-l1key="configuration" data-l2key="minValue" placeholder="{{Min.}}" title="{{Min.}}" style="width:30%;display:inline-block;"/> ';
  tr += '<input class="cmdAttr form-control input-sm" data-l1key="configuration" data-l2key="maxValue" placeholder="{{Max.}}" title="{{Max.}}" style="width:30%;display:inline-block;"/> ';
  tr += '<input class="cmdAttr form-control input-sm" data-l1key="unite" placeholder="{{Unité}}" title="{{Unité}}" style="width:30%;display:inline-block;"/>';
  tr += '</td>';
  tr += '<td style="min-width:80px;width:350px;">';
  tr += '<label class="checkbox-inline"><input type="checkbox" class="cmdAttr" data-l1key="isVisible" checked/>{{Afficher}}</label>';
  tr += '<label class="checkbox-inline"><input type="checkbox" class="cmdAttr" data-l1key="isHistorized" checked/>{{Historiser}}</label>';
  tr += '<label class="checkbox-inline"><input type="checkbox" class="cmdAttr" data-l1key="display" data-l2key="invertBinary"/>{{Inverser}}</label>';
  tr += '</td>';
  tr += '<td style="min-width:80px;width:200px;">';
  if (is_numeric(_cmd.id)) {
    tr += '<a class="btn btn-default btn-xs cmdAction" data-action="configure"><i class="fas fa-cogs"></i></a> ';
    tr += '<a class="btn btn-default btn-xs cmdAction" data-action="test"><i class="fas fa-rss"></i> Tester</a>';
  }
  tr += '<i class="fas fa-minus-circle pull-right cmdAction cursor" data-action="remove"></i></td>';
  tr += '</tr>';
  $('#table_cmd tbody').append(tr);
  var tr = $('#table_cmd tbody tr').last();
  jeedom.eqLogic.builSelectCmd({
    id: $('.eqLogicAttr[data-l1key=id]').value(),
    filter: { type: 'info' },
    error: function (error) {
      $('#div_alert').showAlert({ message: error.message, level: 'danger' });
    },
    success: function (result) {
      tr.find('.cmdAttr[data-l1key=value]').append(result);
      tr.setValues(_cmd, '.cmdAttr');
      jeedom.cmd.changeType(tr, init(_cmd.subType));
    }
  });
}

Cela se fait automatiquement.

Voilà il reste à récupérer une vdm aléatoire et à utiliser les commandes.

Récupération des informations

Pour récupérer une vdm de manière aléatoire.

$url = "http://www.viedemerde.fr/aleatoire";
$data = file_get_contents($url);
@$dom = new DOMDocument();
libxml_use_internal_errors(false);
$dom->loadHTML('<?xml encoding="UTF-8">' .$data);
libxml_use_internal_errors(true);
$xpath = new DOMXPath($dom);
$divs = $xpath->query('//article[@class="art-panel col-xs-12"]//div[@class="panel-content"]//p//a');
return $divs[0]->nodeValue ;

Ouvrir le fichier core/class/vdm.class.php et pour la class vdm qui hérite des méthodes egLogic, je crée une fonction randomVdm

public function randomVdm() {
  $url = "http://www.viedemerde.fr/aleatoire";
  $data = file_get_contents($url);
  @$dom = new DOMDocument();
  libxml_use_internal_errors(true);
  $dom->loadHTML($data);
  libxml_use_internal_errors(false);
  $xpath = new DOMXPath($dom);
  $divs = $xpath->query('//article[@class="art-panel col-xs-12"]//div[@class="panel-content"]//p//a');
  return $divs[0]->nodeValue ;
}

Maintenant on va mettre à jour la commande info(story) avec cette information en lançant la commande action(refresh). Toujours dans core/class/vdm.class.php pour la class vdmCmd on va utiliser la méthode execute

public function execute($_options = array()) {
}

C’est ici qu’on va définir ce qu’il va se passer quand on actionne la commande « Rafraîchir ». La classe vdmCmd a hérité de toutes les méthodes de la class cmd (Core jeedom)

On vérifie le logicalId de la commande lancée et si « refresh » on lance les actions

switch ($this->getLogicalId()) {
  case 'refresh': //LogicalId de la commande rafraîchir que l’on a créé dans la méthode Postsave de la classe vdm .
  //code pour rafraîchir ma commande
  break;
}

Maintenant il reste à exécuter la fonction randomVdm(). On récupère pour cela l’eqLogic (l’équipement) de la commande et on exécute la fonction.

$eqlogic = $this->getEqLogic(); //Récupération de l’eqlogic
$info = $eqlogic->randomVdm() ; //Lance la fonction et stocke le résultat dans la variable $info

On met à jour la commande « story » avec la variable $info. On va utiliser la méthode checkAndUpdateCmd de la class eqlogic

$eqlogic->checkAndUpdateCmd('story', $info);

Ce qui donne au final

public function execute($_options = array()) {
  $eqlogic = $this->getEqLogic(); //récupère l'éqlogic de la commande $this
  switch ($this->getLogicalId()) { //vérifie le logicalid de la commande
    case 'refresh': // LogicalId de la commande rafraîchir que l’on a créé dans la méthode Postsave de la classe vdm .
    $info = $eqlogic->randomVdm(); //On lance la fonction randomVdm() pour récupérer une vdm et on la stocke dans la variable $info
    $eqlogic->checkAndUpdateCmd('story', $info); //on met à jour la commande avec le LogicalId "story"  de l'eqlogic
    break;
  }
}

Maintenant allez dans un équipement créé et lancez la commande Rafraichir. Puis la commande « Histoire » qui doit être à jour.

Sur le Dashboard, les informations apparaissent. Cliquez sur l’icône refresh pour changer l’information.

On va définir ensuite la taille du widget et le customiser un peu puis automatiser le refresh.

Update des informations (cron)

Le plugin est fonctionnel mais pour l’instant il ne fait pas grand-chose. Si vous cliquez sur la commande « refresh » , la commande « story » se met à jour mais sinon rien.

A noter que pour la commande je la nomme par logicalId. Et c’est important. Avoir un logicalId unique par équipement (eqLogic) simplifie les choses.

On va voir maintenant comment mettre à jour la commande en utilisant les fonctions natives du core : Les crons

Il y en a plusieurs :

• cron : rafraichissement toutes les minutes
• cron5 : rafraichissement toutes les 5 minutes
• cron15 : rafraichissement toutes les 15 minutes
• cron30 : rafraichissement toutes les 30 minutes
• cronHourly : toutes les heures
• cronDaily : 1/jour

Vu le plugin on va effectuer une mise à jour toutes les heures (soyons fous). On va donc utiliser la fonction cronHourly().

On va donc ouvrir le fichier vdm.class.php et chercher

/*
* Fonction exécutée automatiquement toutes les heures par Jeedom
public static function cronHourly() {
}
*/

Décommentez le code

public static function cronHourly() {
}

Notre fonction est opérationnelle

Maintenant il faut récupérer tous les équipements actifs de notre plugin,

self::byType('vdm', true) //array contenant tous les équipements du plugin, le deuxième argument, un boolean, permet de ne récupérer que les équipements actifs si true ou tous les équipements si false (défaut)

et les parcourir 1 par 1

foreach (self::byType('vdm', true) as $vdm) {
}

Voila maintenant on recherche la commande « refresh » de l’équipement (eqLogic)

$cmd = $vdm->getCmd(null, 'refresh');

Si elle n’existe pas on continue la boucle (foreach) sinon on l’éxécute

if (!is_object($cmd)) {
  continue;
}
$cmd->execCmd();

Ce qui donne au final

public static function cronHourly () {
  foreach (self::byType('vdm', true) as $vdm) { //parcours tous les équipements actifs du plugin vdm
    $cmd = $vdm->getCmd(null, 'refresh'); //retourne la commande "refresh" si elle existe
    if (!is_object($cmd)) { //Si la commande n'existe pas
    continue; //continue la boucle
  }
  $cmd->execCmd(); //la commande existe on la lance
}
}

Pour tester, dans jeedom, allez dans configuration/moteur de tâches et lancer le cron de class « plugin » fonction « cronHourly » L’information se met à jour.

C’est bien mais ça ne me convient pas. A la création de l’équipement, la commande « story » ne se met pas à jour.

On améliore donc le code.

Pour la création des commandes nous avons utilisé la méthode postSave(). On va utiliser la méthode postUpdate() pour mettre à jour l’information.

La manière la plus simple vu qu’il n’y a qu’une commande et qu’elle est créé en postSave

public function postUpdate() {
  $cmd = $this->getCmd(null, 'refresh'); //On recherche la commande refresh de l’équipement
  if (is_object($cmd)) { //elle existe et on lance la commande
    $cmd->execCmd();
  }
}

Il faut tester, ça fonctionne?

Mais voici une alternative qui peut s’avérer plus utile dans des cas plus complexe

Dans la fonction postUpdate() , on lance la function cronHourly() avec l’id de l’équipement

public function postUpdate() {
  self::cronHourly($this->getId()); //lance la fonction cronHourly avec l’id de l’eqLogic
}

Mais dans ce cas on change la fonction cronHourly()

public static function cronHourly($_eqLogic_id = null) {
  if ($_eqLogic_id == null) { //La fonction n’a pas d’argument donc on recherche tous les équipements du plugin
    $eqLogics = self::byType('vdm', true);
    } else { //La fonction a l’argument id(unique) d’un équipement(eqLogic)
      $eqLogics = array(self::byId($_eqLogic_id));
    }

    foreach ($eqLogics as $vdm) {
      $cmd = $vdm->getCmd(null, 'refresh'); //retourne la commande "refresh si elle existe
      if (!is_object($cmd)) { //Si la commande n'existe pas
      continue; //continue la boucle
    }
    $cmd->execCmd(); //la commande existe on la lance
  }
}

Après vous pouvez changer la fréquence du cron selon l’importance de vos informations à récupérer.

Je ne peux que vous invitez à prendre le temps d’aller sur cette page pour en savoir plus ==> ici

Et encore mieux d’aller sur le github du core ==> ICI

Mettez le nez de dedans pour maîtriser encore plus .

Le plugin est fonctionnel en l’état.

Je prendrai le temps d’ajouter la façon de mettre en place un cron personnalisé selon l’équipement .

Le widget

Pas une mince affaire le widget mais on va rester sur le widget par défaut pour le moment.

Si vous n’avez rien touché, équipement activé et visible, le widget prend toute la largeur de l’écran. On va donc le changer.

La commande qui apparaît est la commande «story» de type info, sous-type string.

Mon plaisir est de me lever le matin est de lire une vdm au réveil. Ça me permet de voir qu’il y a pire que moi :D

Mais je n’ai pas mes lunettes et actuellement le rendu sur le widget ne me permet pas de le lire…

Donc on va changer le style en affectant un template à la commande « story»

Rien de plus simple.

Je vais voir ==> ICI

Je cherche un template pour cmd.info.string( notre commande est de type info sous-type string) .Pas difficile il y en a que deux (default ou tile)

J’applique le template « cmd.info.string.tile.html » à ma commande.

Pour cela j’ouvre le fichier vdm.class.php , fonction postSave() et j’ajoute le template « tile » pour la commande « story » en appliquant la méthode setTemplate()

$info = $this->getCmd(null, 'story');
if (!is_object($info)) {
  $info = new vdmCmd();
  $info->setName(__('Histoire', __FILE__));
}
$info->setLogicalId('story');
$info->setEqLogic_id($this->getId());
$info->setType('info');
$info->setTemplate('dashboard','tile');//template pour le dashboard
$info->setSubType('string');
$info->save();

Rafraîchir le dashboard.

C’est mieux mais le widget prend toujours la largeur du dashboard. On va donc corriger. Par défaut la largeur du widget de l’équipement(eqLogic) et la hauteur sont à « auto ».

On va donc changer la largeur du widget(équipement => eqLogic) en utilisant la méthode setDisplay() héritée de la class eqLogic .On laisse la hauteur en auto.

Pour cela il suffit d’ajouter

$this->setDisplay("width","800px");

Oui, mais !! Car il y a un mais. Essayez d’ajouter ça dans la fonction postsave() ou postUpdate() et ça ne prends pas en compte le changement. Pourquoi ? Ben faut lire la doc du plugin template ==>ICI

Maintenant que vous avez bien lu vous savez qu’Il faut utiliser la méthode preSave()

public function preSave() {
  $this->setDisplay("width","800px");
}

Enregistrez un équipement et rafraîchissez le dashboard.

Les paramètres. Les options

IMPORTANT

C’est un chapitre important et il faut le comprendre avant de passer à la suite.

Pour le moment, nous avons donc utiliser 3 classes du core de jeedom : EqLogic, cmd, cron. Aller pour info, on en ajoute une 4eme avec la class plugin dans le fichier vdm.php que vous ouvrez et laissez ouvert car on va l’éditer.

$plugin = plugin::byId('vdm'); // appelle la classe plugin du core

Il faut comprendre que tout est fait pour nous faciliter la tâche.

Pour un paramètre/une option interne au plugin, on va utiliser une des méthodes de la class eqLogic du core: setConfiguration() en y ajoutant les paramètres que l’on souhaite. Par exemple:

$this->setConfiguration("type","mon_type"); // si on veut définir un paramètre type de valeur mon_type. Comme on a défini la largeur du widget via la méthode setDisplay()

Pour laisser le choix à l’utilisateur, on retourne sur le fichier desktop.php que vous avez laissé ouvert car vous suivez ce TP au pied de la lettre :D

Cherchez

<input type="text" class="eqLogicAttr form-control" data-l1key="configuration" data-l2key="city" placeholder="param1"/>

Et remplacez par

<input type="text" class="eqLogicAttr form-control" data-l1key="configuration" data-l2key="type" placeholder="option"/> //Important de laisser la classe eqLogicAttr

Enregistrez et allez sur un équipement du plugin que vous avez déjà créé en suivant ce TP (Rafraichir si besoin).

Dans le champs «Paramètre» d’un équipement, tapez «aléatoire» et sauvegardez.

Parfait le paramètre est sauvegardé.

C’est simple,non? . C’est pourquoi il ne faut surtout pas toucher à cette ligne de code comme indiqué dans le premier menu « test ». C’est lui qui fait tout le travail

<?php include_file('core', 'plugin.template', 'js');?> //Chargement du fichier core/js/plugin.template.js (en partant de la racine du site)

Si vous regardez de plus près le fichier desktop.php il y a

<input type="text" class="eqLogicAttr form-control" data-l1key="id" style="display:none;" /> // retourne l’id(unique) de l’eqLogic(équipement) que l’on va pouvoir récupérer via $this->getId() ;

<input type="text" class="eqLogicAttr form-control" data-l1key="name" placeholder="{{Nom de l'équipement}}"/>// retourne le nom de l’eqLogic(équipement) que l’on va pouvoir récupérer via $this->getName();

Etc…

Si vous avez bien assimilé tout ça on va pouvoir passer à la suite. Mais avant on va changer dans le fichier desktop.php

<label class="col-sm-3 control-label">{{Paramètre}}</label>

Par

<label class="col-sm-3 control-label">{{Type de vdm}}</label>

Important : Le texte entre accolades correspond au texte qui sera traduit si vous poussez le plugin sur le market.

Pour la suite, on va faire évoluer le plugin en choisissant un type de vdm(aléatoire ou épicées ou tops) que l’on souhaite ainsi qu’un cron personnalisé pour chaque équipement.

Utilisation des options/paramètres

Pour aller plus loin et bien comprendre le chapitre précédent, on va permettre à l’utilisateur de choisir un type de vdm (aleatoire ou epicees ou tops)

On pourrait le laisser taper dans l’input « Type de vdm » : aleatoire ou epicees ou tops mais on va faire autrement en le laissant choisir via une balise select

Si vous avez tout suivi, vous devriez avoir dans le fichier desktop.php

<div class="form-group">
  <label class="col-sm-3 control-label">{{Type de vdm}}</label>
  <div class="col-sm-3">
    <input type="text" class="eqLogicAttr form-control" data-l1key="configuration" data-l2key="type" placeholder="option"/>
  </div>
</div>

Qu’on va remplacer par

<div class="form-group">
  <label class="col-sm-3 control-label" >{{ Type de vdm }}</label>
  <div class="col-sm-3">
    <select class="form-control eqLogicAttr" data-l1key="configuration" data-l2key="type ">
      <option value="aleatoire">{{Aleatoire}}</option>
      <option value="epicees">{{Coquin}}</option>
      <option value="tops">{{Best}}</option>
    </select>
  </div>
</div>

Ici le paramètre «type» prendra la valeur du select choisi soit aleatoire ou epicees ou tops.

Maintenant on va tenir compte de notre paramètre dans la fonction randomVdm() dans le fichier vdm.class.php

Cherchez

$url = "http://www.viedemerde.fr/aleatoire";

Et remplacez par

$type = $this->getConfiguration("type", "aleatoire"); //si le paramètre est vide ou n’existe pas, on prends le type aleatoire
$url = "http://www.viedemerde.fr/{$type}";

Maintenant changez la valeur du select sur un équipement, sauvegardez et allez sur le dashboard pour voir ce que cela donne.