!-------------------------------------------------------------------------!
!-------------------------------[ READ ME ]-------------------------------!
!-------------------------------------------------------------------------!

Ce patch établit le lien entre les applications open-source OpenDCIM et 
phpIPAM via la mise en place d'une liste déroulante dans le formulaire 
permettant l'édition d'une adresse IP, qui autorise phpIPAM à renseigner l'ID
d'une machine(de OpenDCIM) et à l'associer à une Ip de phpIPAM. Ensuite, un 
bouton s'ajoute aux autres sur plusieurs pages (au niveau de l'IP) lorsqu'une IDDevice 
est renseignée, ce bouton ouvre un onglet vers OpenDCIM et la device en 
question.

!-------------------------------------------------------------------------!

1) Installation et base de données phpIPAM

On part du principe que OpenDCIM est installé et fonctionnel.

Pour installer l'application phpIPAM, il suffit de suivre les informations données 
sur le site officiel (il existe deux guides différents) à l'adresse suivante :

http://phpipam.net/ 


Une fois l'application lancée, mettez en place la base de données, puis ajoutez 
une colonne ' IdDeviceOD ' à la table ' ipaddresses '.

Enfin, éditez le fichier 'patchOD/config.php' en renseignant les informations 
relatives aux 2 bases de données OpenDCIM et phpIPAM.

Pensez aussi à changer les chemins d'inclusion des fichiers dans :

'patchOD/Controller/listDevice.php' 
'patchOD/Controller/selectIdLink.php'
'patchOD/Models/Manager.php' (l'inclusion du fichier config.php se fait dans le __construct.)

Si jamais vous ne mettez pas ce dossier 'patchOD' dans '/var/www/' . 
!-------------------------------------------------------------------------!

2) La liste déroulante : 

Il faut inclure le fichier :

 - 'patchOD/Controller/listDevice.php'

dans le fichier :

 - 'phpipam/site/ipaddr/modifyIpAddress.php'

en remplacement de la ligne suivante (qui devra donc être supprimée):

 - print ' <input type="text" class="ip_addr form-control input-sm" name="'. $myField['nameNew'] .'" placeholder="'. $myField['name'] .'" value="'. $details[$myField['name']]. '" size="30" '.$delete.' rel="tooltip" data-placement="right" title="'.$myField['Comment'].'">'. "\n"; 
 - le plus simple est de repérer la lignes commentée à l'aide de la mention
   '// OpenDCIM Link' (ligne 369) dans le fichier 'patchOD/Support/liste.php' qui est 
   une copie du fichier dans lequel vous devez insérer le code et de vous 
   servir de ce fichier pour retrouver la ligne à supprimer et par la même
   l'endroit où inclure.


Cette partie permet de faire appel à la base de données OpenDCIM pour 
renseigner l'ID d'un matériel dans le chemp prévu à cet effet dans la table
' ipaddresses ' de la base de données phpIPAM via une liste déroulante.

!-------------------------------------------------------------------------!

3) Le bouton renvoyant vers OpenDCIM :

Il faut inclure le fichier:

 - 'patchOD/Controller/selectIdLink.php'

-----------------

dans le fichier:

 - 'phpipam/site/ipaddr/ipAddressPrintTable.php'

à 4 endroits :

 - le plus simple est de repérer les lignes commentées à l'aide de la mention
   '// OpenDCIM Link' (lignes 396 - 410 - 429 -444) dans le fichier 
   'patchOD/Support/bouton.php', qui est une copie du fichier dans lequel vous 
   devez insérer le code, et d'inclure aux mêmes endroits.

-----------------

dans le fichier: 

 - 'phpipam/site/ipaddr/ipDetails.php'

à 4 endroits :

 - le plus simple est de repérer les lignes commentées à l'aide de la mention
   '// OpenDCIM Link' (lignes 227 - 238 - 252 - 263) dans le fichier 
   'patchOD/Support/bouton2.php', qui est une copie du fichier dans lequel vous 
   devez insérer le code, et d'inclure aux mêmes endroits.

-----------------

dans le fichier: 

 - 'phpipam/site/tools/searchResults.php'

à 2 endroits :

 - le plus simple est de repérer les lignes commentées à l'aide de la mention
   '// OpenDCIM Link' (lignes 390 - 400) dans le fichier 
   'patchOD/Support/bouton3.php', qui est une copie du fichier dans lequel vous 
   devez insérer le code, et d'inclure aux mêmes endroits.

-----------------

Cette partie permet lorsque l'ID d'une machine a été associée à une IP de cliquer 
sur un bouton pour être redirigé vers la device correspondant à l'ID (sur OpenDCIM).

!-------------------------------------------------------------------------!