kyStaffGroup.php

<?php
require_once('kyObjectBase.php');

/**
 * Part of PHP client to REST API of Kayako v4 (Kayako Fusion).
 * Compatible with Kayako version >= 4.01.204.
 *
 * Kayako StaffGroup object.
 *
 * @link http://wiki.kayako.com/display/DEV/REST+-+StaffGroup
 * @author Tomasz Sawicki (https://github.com/Furgas)
 */
class kyStaffGroup extends kyObjectBase {

	static protected $controller = '/Base/StaffGroup';
	static protected $object_xml_name = 'staffgroup';

	private $id = null;
	private $title = null;
	private $is_admin = false;

	protected function parseData($data) {
		$this->id = intval($data['id']);
		$this->title = $data['title'];
		$this->is_admin = intval($data['isadmin']) === 0 ? false : true;
	}

	protected function buildData($method) {
		$data = array();

		//TODO: check if required parameters are present

		$data['title'] = $this->title;
		$data['isadmin'] = $this->is_admin ? 1 : 0;

		return $data;
	}

	public function toString() {
		return sprintf("%s (isadmin: %s)", $this->getTitle(), $this->getIsAdmin() ? "yes" : "no");
	}

	public function getId($complete = false) {
		return $complete ? array($this->id) : $this->id;
	}

	/**
	 * Returns title of the staff group.
	 *
	 * @return string
	 * @filterBy()
	 * @orderBy()
	 */
	public function getTitle() {
		return $this->title;
	}

	/**
	 * Sets title of the staff group.
	 *
	 * @param string $title Title of the staff group.
	 * @return kyStaffGroup
	 */
	public function setTitle($title) {
		$this->title = $title;
		return $this;
	}

	/**
	 * Returns whether staff members assigned to this group are Administrators.
	 *
	 * @return bool
	 * @filterBy()
	 * @orderBy()
	 */
	public function getIsAdmin() {
		return $this->is_admin;
	}

	/**
	 * Sets whether staff members assigned to this group are Administrators.
	 *
	 * @param bool $is_admin True, if you want staff members assigned to this group to be Administrators. False (default), otherwise.
	 * @return kyStaffGroup
	 */
	public function setIsAdmin($is_admin) {
		$this->is_admin = $is_admin;
		return $this;
	}

	/**
	 * Creates new staff group.
	 * WARNING: Data is not sent to Kayako unless you explicitly call create() on this method's result.
	 *
	 * @param string $title Title of new staff group.
	 * @param bool $is_admin True, if you want staff members assigned to this group to be Administrators. False (default), otherwise.
	 * @return kyStaffGroup
	 */
	static public function createNew($title, $is_admin = false) {
		$new_staff_group = new kyStaffGroup();
		$new_staff_group->setTitle($title);
		$new_staff_group->setIsAdmin($is_admin);
		return $new_staff_group;
	}

	/**
	 * Creates new staff user in this staff group.
	 * WARNING: Data is not sent to Kayako unless you explicitly call create() on this method's result.
	 *
	 * @param string $first_name First name of new staff user.
	 * @param string $last_name Last name of new staff user.
	 * @param string $user_name Login username of new staff user.
	 * @param string $email E-mail address of new staff user.
	 * @param string $password Password for new staff user.
	 * @return kyStaff
	 */
	public function newStaff($first_name, $last_name, $user_name, $email, $password) {
		return kyStaff::createNew($first_name, $last_name, $user_name, $email, $this, $password);
	}
}