<?php
/*
 * @version $Id$
 -------------------------------------------------------------------------
 GLPI - Gestionnaire Libre de Parc Informatique
 Copyright (C) 2003-2010 by the INDEPNET Development Team.

 http://indepnet.net/   http://glpi-project.org
 -------------------------------------------------------------------------

 LICENSE

 This file is part of GLPI.

 GLPI is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2 of the License, or
 (at your option) any later version.

 GLPI is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with GLPI; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 --------------------------------------------------------------------------
 */

// ----------------------------------------------------------------------
// Original Author of file:
// Purpose of file:
// ----------------------------------------------------------------------

// Hook called on profile change
// Good place to evaluate the user right on this plugin
// And to save it in the session
function plugin_change_profile_example() {

   // For example : same right of computer
   if (Session::haveRight('computer','w')) {
      $_SESSION["glpi_plugin_example_profile"] = array('example' => 'w');

   } else if (Session::haveRight('computer','r')) {
      $_SESSION["glpi_plugin_example_profile"] = array('example' => 'r');

   } else {
      unset($_SESSION["glpi_plugin_example_profile"]);
   }
}


// Define dropdown relations
function plugin_example_getDatabaseRelations() {
   return array("glpi_plugin_example_dropdowns" => array("glpi_plugin_example" => "plugin_example_dropdowns_id"));
}


// Define Dropdown tables to be manage in GLPI :
function plugin_example_getDropdown() {
   // Table => Name
   return array('PluginExampleDropdown' => "Plugin Example Dropdown");
}

////// SEARCH FUNCTIONS ///////(){

// Define Additionnal search options for types (other than the plugin ones)
function plugin_example_getAddSearchOptions($itemtype) {
   global $LANG;

   $sopt = array();
   if ($itemtype == 'Computer') {
         // Just for example, not working...
         $sopt[1001]['table']     = 'glpi_plugin_example_dropdowns';
         $sopt[1001]['field']     = 'name';
         $sopt[1001]['linkfield'] = 'plugin_example_dropdowns_id';
         $sopt[1001]['name']      = 'Example plugin';
   }
   return $sopt;
}


function plugin_example_giveItem($type,$ID,$data,$num) {

   $searchopt = &Search::getOptions($type);
   $table = $searchopt[$ID]["table"];
   $field = $searchopt[$ID]["field"];

   switch ($table.'.'.$field) {
      case "glpi_plugin_example_examples.name" :
         $out = "<a href='".Toolbox::getItemTypeFormURL('PluginExampleExample')."?id=".$data['id']."'>";
         $out .= $data["ITEM_$num"];
         if ($_SESSION["glpiis_ids_visible"] || empty($data["ITEM_$num"])) {
            $out .= " (".$data["id"].")";
         }
         $out .= "</a>";
         return $out;
   }
   return "";
}

function plugin_example_displayConfigItem($type, $ID, $data, $num) {

   $searchopt = &Search::getOptions($type);
   $table = $searchopt[$ID]["table"];
   $field = $searchopt[$ID]["field"];


   // Example of specific style options
   // No need of the function if you do not have specific cases
   switch ($table.'.'.$field) {
      case "glpi_plugin_example_examples.name" :
         return " style=\"background-color:#DDDDDD;\" ";
         break;
   }
   return "";
}

function plugin_example_addDefaultJoin($type, $ref_table, &$already_link_tables) {

   // Example of default JOIN clause
   // No need of the function if you do not have specific cases
   switch ($type) {
//       case "PluginExampleExample" :
      case "MyType" :
         return Search::addLeftJoin($type, $ref_table, $already_link_tables,
                                       "newtable", "linkfield");
         break;
   }
   return "";
}

function plugin_example_addDefaultSelect($type) {

   // Example of default SELECT item to be added
   // No need of the function if you do not have specific cases
   switch ($type) {
//       case "PluginExampleExample" :
      case "MyType" :
         return "`mytable`.`myfield` = 'myvalue' AS MYNAME, ";
         break;
   }
   return "";
}

function plugin_example_addDefaultWhere($type) {

   // Example of default WHERE item to be added
   // No need of the function if you do not have specific cases
   switch ($type) {
//       case "PluginExampleExample" :
      case "MyType" :
         return " `mytable`.`myfield` = 'myvalue' ";
         break;
   }
   return "";
}


function plugin_example_addLeftJoin($type,$ref_table,$new_table,$linkfield) {

   // Example of standard LEFT JOIN  clause but use it ONLY for specific LEFT JOIN
   // No need of the function if you do not have specific cases
   switch ($new_table) {
      case "glpi_plugin_example_dropdowns" :
         return " LEFT JOIN `$new_table` ON (`$ref_table`.`$linkfield` = `$new_table`.`id`) ";
   }
   return "";
}


function plugin_example_forceGroupBy($type) {

   switch ($type) {
      case 'PluginExampleExample' :
         // Force add GROUP BY IN REQUEST
         return true;
   }
   return false;
}


function plugin_example_addWhere($link,$nott,$type,$ID,$val) {

   $searchopt = &Search::getOptions($type);
   $table = $searchopt[$ID]["table"];
   $field = $searchopt[$ID]["field"];

   $SEARCH = Search::makeTextSearch($val,$nott);

   // Example of standard Where clause but use it ONLY for specific Where
   // No need of the function if you do not have specific cases
    switch ($table.".".$field) {
       /*case "glpi_plugin_example.name" :
          $ADD = "";
          if ($nott && $val!="NULL") {
             $ADD = " OR `$table`.`$field` IS NULL";
          }
          return $link." (`$table`.`$field` $SEARCH ".$ADD." ) ";*/
         case "glpi_plugin_example_examples.serial" :
            return $link." `$table`.`$field` = '$val' ";
    }
   return "";
}


// This is not a real example because the use of Having condition in this case is not suitable
function plugin_example_addHaving($link,$nott,$type,$ID,$val,$num) {

   $searchopt = &Search::getOptions($type);
   $table = $searchopt[$ID]["table"];
   $field = $searchopt[$ID]["field"];

   $SEARCH = Search::makeTextSearch($val,$nott);

   // Example of standard Having clause but use it ONLY for specific Having
   // No need of the function if you do not have specific cases
   switch ($table.".".$field) {
      case "glpi_plugin_example.serial" :
         $ADD = "";
         if (($nott && $val!="NULL")
             || $val == '^$') {
            $ADD = " OR ITEM_$num IS NULL";
         }
         return " $LINK ( ITEM_".$num.$SEARCH." $ADD ) ";
   }
   return "";
}


function plugin_example_addSelect($type,$ID,$num) {

   $searchopt = &Search::getOptions($type);
   $table = $searchopt[$ID]["table"];
   $field = $searchopt[$ID]["field"];

// Example of standard Select clause but use it ONLY for specific Select
// No need of the function if you do not have specific cases
// switch ($table.".".$field) {
//    case "glpi_plugin_example.name" :
//       return $table.".".$field." AS ITEM_$num, ";
// }
   return "";
}


function plugin_example_addOrderBy($type,$ID,$order,$key=0) {

   $searchopt = &Search::getOptions($type);
   $table = $searchopt[$ID]["table"];
   $field = $searchopt[$ID]["field"];

// Example of standard OrderBy clause but use it ONLY for specific order by
// No need of the function if you do not have specific cases
// switch ($table.".".$field) {
//    case "glpi_plugin_example.name" :
//       return " ORDER BY $table.$field $order ";
// }
   return "";
}


//////////////////////////////
////// SPECIFIC MODIF MASSIVE FUNCTIONS ///////

// Define actions :
function plugin_example_MassiveActions($type) {
   global $LANG;

   switch ($type) {
      // New action for core and other plugin types : name = plugin_PLUGINNAME_actionname
      case 'Computer' :
         return array("plugin_example_DoIt" => "plugin_example_DoIt");

      // Actions for types provided by the plugin
      case 'PluginExampleExample' :
         return array("add_document" => $LANG["document"][16],         // GLPI core one
                      "do_nothing"   => 'Do Nothing - just for fun');  // Specific one
   }
   return array();
}


// How to display specific actions ?
// options contain at least itemtype and and action
function plugin_example_MassiveActionsDisplay($options=array()) {
   global $LANG;

   switch ($options['itemtype']) {
      case 'Computer' :
         switch ($options['action']) {
            case "plugin_example_DoIt" :

               echo "&nbsp;<input type='hidden' name='toto' value='1'><input type='submit' name='massiveaction' class='submit' value='".
                     $LANG["buttons"][2]."'>&nbsp;but do nothing :)";
            break;
         }
         break;

      case 'PluginExampleExample' :
         switch ($options['action']) {
            // No case for add_document : use GLPI core one
            case "do_nothing" :
               echo "&nbsp;<input type='submit' name='massiveaction' class='submit' value='".
                     $LANG["buttons"][2]."'>&nbsp;but do nothing :)";
            break;
         }
         break;
   }
   return "";
}


// How to process specific actions ?
function plugin_example_MassiveActionsProcess($data) {
   global $LANG;

   switch ($data['action']) {
      case 'plugin_example_DoIt' :
         if ($data['itemtype'] == 'Computer') {
            $comp = new Computer;
            addMessageAfterRedirect("Right it is the type I want...");
            addMessageAfterRedirect("But... I say I will do nothing for :");
            foreach ($data['item'] as $key => $val) {
               if ($val == 1) {
                  if ($comp->getFromDB($key)) {
                     addMessageAfterRedirect("- ".$comp->getField("name"));
                  }
               }
            }
         }
         break;

      case 'do_nothing' :
         if ($data['itemtype'] == 'PluginExampleExample') {
            $ex = new PluginExampleExample();
            addMessageAfterRedirect("Right it is the type I want...");
            addMessageAfterRedirect("But... I say I will do nothing for :");
            foreach ($data['item'] as $key => $val) {
               if ($val == 1) {
                  if ($ex->getFromDB($key)) {
                     addMessageAfterRedirect("- ".$ex->getField("name"));
                  }
               }
            }
         }
         break;
   }
}


// How to display specific update fields ?
// options must contain at least itemtype and options array
function plugin_example_MassiveActionsFieldsDisplay($options=array()) {
   //$type,$table,$field,$linkfield

   $table = $options['options']['table'];
   $field = $options['options']['field'];
   $linkfield = $options['options']['linkfield'];
   if ($table == getTableForItemType($options['itemtype'])) {

      // Table fields
      switch ($table.".".$field) {
         case 'glpi_plugin_example_examples.serial' :
            echo "Not really specific -  Just for example&nbsp;";
            //autocompletionTextField($linkfield,$table,$field);
            // Dropdown::showYesNo($linkfield);
            // Need to return true if specific display
            return true;
      }

   } else {
      // Linked Fields
      switch ($table.".".$field) {
         case "glpi_plugin_example_dropdowns.name" :
            echo "Not really specific - Just for example&nbsp;";
            // Need to return true if specific display
            return true;
      }
   }
   // Need to return false on non display item
   return false;
}

// How to display specific search fields or dropdown ?
// options must contain at least itemtype and options array
// MUST Use a specific AddWhere & $tab[X]['searchtype'] = 'equals'; declaration
function plugin_example_searchOptionsValues($options=array()) {
   global $LANG;

   $table = $options['searchoption']['table'];
   $field = $options['searchoption']['field'];

    // Table fields
   switch ($table.".".$field) {

      case "glpi_plugin_example_examples.serial" :
            echo "Not really specific -  Use your own dropdown  - Just for example&nbsp;";
            Dropdown::show(getItemTypeForTable($options['searchoption']['table']),
                                    array('value'    => $options['value'],
                                          'name'     => $options['name'],
                                          'comments' => 0));
            // Need to return true if specific display
            return true;
   }
   return false;
}


//////////////////////////////

// Hook done on before update item case
function plugin_pre_item_update_example($item) {

   /* Manipulate data if needed
   if (!isset($item->input['comment'])) {
      $item->input['comment'] = addslashes($item->fields['comment']);
   }
   $item->input['comment'] .= addslashes("\nUpdate: ".date('r'));
   */
   addMessageAfterRedirect("Pre Update Computer Hook",true);
}


// Hook done on update item case
function plugin_item_update_example($item) {

   addMessageAfterRedirect("Update Computer Hook (".implode(',',$item->updates).")",true);
   return true;
}

// Hook done on get empty item case
function plugin_item_empty_example($item) {

   addMessageAfterRedirect("Empty Computer Hook",true);
   return true;
}


// Hook done on before delete item case
function plugin_pre_item_delete_example($object) {

   // Manipulate data if needed
   addMessageAfterRedirect("Pre Delete Computer Hook",true);
}


// Hook done on delete item case
function plugin_item_delete_example($object) {

   addMessageAfterRedirect("Delete Computer Hook",true);
   return true;
}


// Hook done on before purge item case
function plugin_pre_item_purge_example($object) {

   // Manipulate data if needed
   addMessageAfterRedirect("Pre Purge Computer Hook",true);
}


// Hook done on purge item case
function plugin_item_purge_example($object) {

   addMessageAfterRedirect("Purge Computer Hook",true);
   return true;
}


// Hook done on before restore item case
function plugin_pre_item_restore_example($item) {

   // Manipulate data if needed
   addMessageAfterRedirect("Pre Restore Computer Hook");
}


// Hook done on before restore item case
function plugin_pre_item_restore_example2($item) {

   // Manipulate data if needed
   addMessageAfterRedirect("Pre Restore Phone Hook");
}

// Hook done on restore item case
function plugin_item_restore_example($item) {

   addMessageAfterRedirect("Restore Computer Hook");
   return true;
}


// Hook done on restore item case
function plugin_item_transfer_example($parm) {

   addMessageAfterRedirect("Transfer Computer Hook ".$parm['type']." ".$parm['id']." -> ".
                           $parm['newID']);

   return false;
}


// Parm contains begin, end and who
// Create data to be displayed in the planning of $parm["who"] or $parm["who_group"] between $parm["begin"] and $parm["end"]

function plugin_planning_populate_example($parm) {

   // Add items in the items fields of the parm array
   // Items need to have an unique index beginning by the begin date of the item to display
   // needed to be correcly displayed

   $parm["items"][$parm["begin"]."$$$"."plugin_example1"]["plugin"] = "example";
   $parm["items"][$parm["begin"]."$$$"."plugin_example1"]["begin"]  = date("Y-m-d 17:00:00");
   $parm["items"][$parm["begin"]."$$$"."plugin_example1"]["end"]    = date("Y-m-d 18:00:00");
   $parm["items"][$parm["begin"]."$$$"."plugin_example1"]["name"]   = "test planning example 1 ";
   // Set the ID using the ID of the item in the database to have unique ID
   $ID = date("Ymd"); // Current date for example
   $parm["items"][$parm["begin"]."$$$"."plugin_example1"]["planningID"] = "plugin_example".$ID;

   return $parm;
}


// Display the planning item
function plugin_display_planning_example($parm) {
   global $LANG;

   // $parm["type"] say begin end in or from type
   // Add items in the items fields of the parm array
   switch ($parm["type"]) {
      case "in" :
         echo date("H:i",strtotime($parm["begin"]))." -> ".date("H:i",strtotime($parm["end"])).": ";
         break;

      case "from" :
         break;

      case "begin" :
         echo $LANG["buttons"][33]." ".date("H:i",strtotime($parm["begin"])).": ";
         break;

      case "end" :
         echo $LANG["buttons"][32]." ".date("H:i",strtotime($parm["end"])).": ";
         break;
   }
   echo $parm["name"];
}


// Define headings added by the plugin
function plugin_get_headings_example($item, $withtemplate) {

   switch (get_class($item)) {
      case 'Profile' :
         $prof = new Profile();
         if ($item->fields['interface'] == 'central') {
            return array(1 => "Test PLugin");
         } else {
            return array();
         }

      case 'Computer' :
         // new object / template case
         if ($withtemplate) {
            return array();
            // Non template case / editing an existing object
         } else {
            return array(1 => "Test PLugin");
         }

      case 'ComputerDisk' :
      case 'Supplier' :
         if ($item->getField('id')) { // Not in create mode
            return array(1 => "Test PLugin",
                         2 => "Test PLugin 2");
         }
         break;

      case 'Central' :
      case 'Preference':
      case 'Notification':
         return array(1 => "Test PLugin");
   }
   return false;
}


// Define headings actions added by the plugin
function plugin_headings_actions_example($item) {

   switch (get_class($item)) {
      case 'Profile' :
      case 'Computer' :
         return array(1 => "plugin_headings_example");

      case 'ComputerDisk' :
      case 'Supplier' :
         return array(1 => "plugin_headings_example",
                      2 => "plugin_headings_example");

      case 'Central' :
      case 'Preference' :
      case 'Notification' :
         return array(1 => "plugin_headings_example");
   }
   return false;
}


// Example of an action heading
function plugin_headings_example($item, $withtemplate=0) {
   global $LANG;

   if (!$withtemplate) {
      echo "<div class='center'>";
      switch (get_class($item)) {
         case 'Central' :
            echo "Plugin central action ".$LANG['plugin_example']["test"];
            break;

         case 'Preference' :
            // Complete form display
            $data = plugin_version_example();

            echo "<form action='Where to post form'>";
            echo "<table class='tab_cadre_fixe'>";
            echo "<tr><th colspan='3'>".$data['name']." - ".$data['version'];
            echo "</th></tr>";

            echo "<tr class='tab_bg_1'><td>Name of the pref</td>";
            echo "<td>Input to set the pref</td>";

            echo "<td><input class='submit' type='submit' name='submit' value='submit'></td>";
            echo "</tr>";

            echo "</table>";
            echo "</form>";
            break;

         case 'Notification' :
            echo "Plugin mailing action ".$LANG['plugin_example']["test"];
            break;

         default :
            echo "Plugin function with headings CLASS=".get_class($item)." id=".$item->getField('id');
            break;
      }
      echo "</div>";
   }
}


// Do special actions for dynamic report
function plugin_example_dynamicReport($parm) {

   if ($parm["item_type"] == 'PluginExampleExample') {
      // Do all what you want for export depending on $parm
      echo "Personalized export for type ".$parm["display_type"];
      echo 'with additional datas : <br>';
      echo "Single data : add1 <br>";
      print $parm['add1'].'<br>';
      echo "Array data : add2 <br>";
      printCleanArray($parm['add2']);
      // Return true if personalized display is done
      return true;
   }
   // Return false if no specific display is done, then use standard display
   return false;
}


// Add parameters to printPager in search system
function plugin_example_addParamFordynamicReport($itemtype) {

   if ($itemtype == 'PluginExampleExample') {
      // Return array data containing all params to add : may be single data or array data
      // Search config are available from session variable
      return array('add1' => $_SESSION['glpisearch'][$itemtype]['order'],
                   'add2' => array('tutu'=>'Second Add',
                                   'Other Data'));
   }
   // Return false or a non array data if not needed
   return false;
}


// Install process for plugin : need to return true if succeeded
function plugin_example_install() {
   global $DB;

   if (!TableExists("glpi_plugin_example_examples")) {
      $query = "CREATE TABLE `glpi_plugin_example_examples` (
                  `id` int(11) NOT NULL auto_increment,
                  `name` varchar(255) collate utf8_unicode_ci default NULL,
                  `serial` varchar(255) collate utf8_unicode_ci NOT NULL,
                  `plugin_example_dropdowns_id` int(11) NOT NULL default '0',
                  `is_deleted` tinyint(1) NOT NULL default '0',
                  `is_template` tinyint(1) NOT NULL default '0',
                  `template_name` varchar(255) collate utf8_unicode_ci default NULL,
                PRIMARY KEY (`id`)
               ) ENGINE=MyISAM  DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci";

      $DB->query($query) or die("error creating glpi_plugin_example_examples ". $DB->error());

      $query = "INSERT INTO `glpi_plugin_example_examples`
                       (`id`, `name`, `serial`, `plugin_example_dropdowns_id`, `is_deleted`,
                        `is_template`, `template_name`)
                VALUES (1, 'example 1', 'serial 1', 1, 0, 0, NULL),
                       (2, 'example 2', 'serial 2', 2, 0, 0, NULL),
                       (3, 'example 3', 'serial 3', 1, 0, 0, NULL)";
      $DB->query($query) or die("error populate glpi_plugin_example ". $DB->error());
   }

   if (!TableExists("glpi_plugin_example_dropdowns")) {
      $query = "CREATE TABLE `glpi_plugin_example_dropdowns` (
                  `id` int(11) NOT NULL auto_increment,
                  `name` varchar(255) collate utf8_unicode_ci default NULL,
                  `comment` text collate utf8_unicode_ci,
                PRIMARY KEY  (`id`),
                KEY `name` (`name`)
               ) ENGINE=MyISAM  DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci";

      $DB->query($query) or die("error creating glpi_plugin_example_dropdowns". $DB->error());

      $query = "INSERT INTO `glpi_plugin_example_dropdowns`
                       (`id`, `name`, `comment`)
                VALUES (1, 'dp 1', 'comment 1'),
                       (2, 'dp2', 'comment 2')";

      $DB->query($query) or die("error populate glpi_plugin_example_dropdowns". $DB->error());

   }

   // To be called for each task the plugin manage
   // task in class
   CronTask::Register('PluginExampleExample', 'Sample', DAY_TIMESTAMP, array('param' => 50));
   return true;
}


// Uninstall process for plugin : need to return true if succeeded
function plugin_example_uninstall() {
   global $DB;


   $notif = new Notification();
   $options = array('itemtype' => 'Ticket',
                    'event'    => 'plugin_example',
                    'FIELDS'   => 'id');
   foreach ($DB->request('glpi_notifications', $options) as $data) {
      $notif->delete($data);
   }
   // Old version tables
   if (TableExists("glpi_dropdown_plugin_example")) {
      $query = "DROP TABLE `glpi_dropdown_plugin_example`";
      $DB->query($query) or die("error deleting glpi_dropdown_plugin_example");
   }
   if (TableExists("glpi_plugin_example")) {
      $query = "DROP TABLE `glpi_plugin_example`";
      $DB->query($query) or die("error deleting glpi_plugin_example");
   }
   // Current version tables
   if (TableExists("glpi_plugin_example_example")) {
      $query = "DROP TABLE `glpi_plugin_example_example`";
      $DB->query($query) or die("error deleting glpi_plugin_example_example");
   }
   if (TableExists("glpi_plugin_example_dropdowns")) {
      $query = "DROP TABLE `glpi_plugin_example_dropdowns`;";
      $DB->query($query) or die("error deleting glpi_plugin_example_dropdowns");
   }
   return true;
}


function plugin_example_AssignToTicket($types) {

   $types['PluginExampleExample'] = "Example";
   return $types;
}

function plugin_example_get_events(NotificationTargetTicket $target) {
   $target->events['plugin_example'] = "Example event";
}

function plugin_example_get_datas(NotificationTargetTicket $target) {
   $target->datas['##ticket.example##'] = "Example datas";
}

function plugin_example_postinit() {
   global $CFG_GLPI;

   // All plugins are initialized, so all types are registered
   foreach ($CFG_GLPI["infocom_types"] as $type) {
      // do something
   }
}
?>