This repository has been archived on 2024-04-08. You can view files and clone it, but cannot push or open issues or pull requests.
khosb/modules/service/classes/Model/Service.php

329 lines
7.9 KiB
PHP
Raw Normal View History

2010-11-29 22:41:08 +00:00
<?php defined('SYSPATH') or die('No direct access allowed.');
/**
* This class supports Services
*
2013-03-19 22:35:19 +00:00
* @package Service
2010-11-29 22:41:08 +00:00
* @category Models
* @author Deon George
2013-03-19 22:35:19 +00:00
* @copyright (c) 2009-2013 Open Source Billing
2010-11-29 22:41:08 +00:00
* @license http://dev.osbill.net/license.html
2011-12-16 23:31:35 +00:00
*
* Fields:
* + queue: PROVISION (to be provisioned)
2010-11-29 22:41:08 +00:00
*/
class Model_Service extends ORM_OSB {
2010-11-29 22:41:08 +00:00
// Relationships
protected $_has_one = array(
'service_billing'=>array('far_key'=>'account_billing_id','foreign_key'=>'id'),
);
2010-11-29 22:41:08 +00:00
protected $_has_many = array(
'charge'=>array('far_key'=>'id'),
'invoice_item'=>array('far_key'=>'id'),
2010-11-29 22:41:08 +00:00
'invoice'=>array('through'=>'invoice_item'),
'service_change'=>array('far_key'=>'id'),
2010-11-29 22:41:08 +00:00
);
protected $_belongs_to = array(
'product'=>array(),
'account'=>array(),
);
2011-05-14 07:35:33 +00:00
/**
* Filters used to format the display of values into friendlier values
*/
protected $_display_filters = array(
2011-07-14 09:09:03 +00:00
'date_last_invoice'=>array(
array('Config::date',array(':value')),
),
2011-05-14 07:35:33 +00:00
'date_next_invoice'=>array(
array('Config::date',array(':value')),
),
'recur_schedule'=>array(
array('StaticList_RecurSchedule::get',array(':value')),
2011-05-14 07:35:33 +00:00
),
2012-08-01 12:43:33 +00:00
'status'=>array(
array('StaticList_YesNo::get',array(':value')),
2012-08-01 12:43:33 +00:00
),
2010-11-29 22:41:08 +00:00
);
2011-07-14 09:09:03 +00:00
/**
* Get the additional charges associated with this service
2011-07-14 09:09:03 +00:00
*/
public function charges($unprocessed=TRUE,$format=FALSE) {
$result = 0;
2011-07-14 09:09:03 +00:00
foreach ($this->charge_list($unprocessed) as $co)
$result += $co->total();
return $format ? Currency::display($result) : $result;
2011-07-14 09:09:03 +00:00
}
public function charge_list($unprocessed=FALSE) {
$x = $this->charge;
2010-11-29 22:41:08 +00:00
if ($unprocessed)
$x->where_open()
->where('processed','IS',NULL)
->or_where('processed','=',FALSE)
->where_close();
2011-07-14 09:09:03 +00:00
return $x->find_all();
}
/**
* Display how much is due on this service
*/
public function due($format=FALSE) {
$total = 0;
foreach ($this->invoice_list(TRUE) as $io)
$total += $io->due();
return $format ? Currency::display($total) : $total;
}
/**
* When does this service expire
*/
public function expire($format=FALSE) {
// For plugins the plugin determins expiry
$expire = (is_null($plugin=$this->plugin()) ? NULL : $plugin->expire());
// If $expire is NULL, we'll use the next invoice date
$expire = is_null($expire) ? $this->paid_to() : $expire;
return $format ? Config::date($expire) : $expire;
}
/**
* Determine if a service expires in the next $days.
*/
public function expiring($days=0) {
return time()+$days*86400 > $this->expire();
}
/**
* Display the service number
*/
public function id() {
return sprintf('%05s',$this->id);
}
/**
* List invoices for this service
*/
public function invoice_list($due=FALSE) {
$result = array();
$x = $this->invoice->distinct('id');
// If we only want due invoices, we can speed things up by only looking for unprocessed
if ($due)
$x->where_unprocessed();
foreach ($x->find_all() as $io)
if (! $due OR $io->due())
array_push($result,$io);
return $result;
}
/**
* Show the date we are invoiced to
*/
public function invoiced_to($format=FALSE) {
$x = $this->invoice_item->order_by('date_stop','DESC')->limit(1)->find();
return $format ? $x->display('date_stop') : $x->date_stop;
}
/**
* Display the service product name
*/
public function name() {
return is_null($plugin=$this->plugin()) ? $this->product->title() : $plugin->name();
}
/**
* Returns the date that an item has been paid to
*/
public function paid_to($format=FALSE) {
$x = NULL;
foreach ($this->invoice_item->order_by('date_stop','DESC')->order_by('date_orig','DESC')->find_all() as $iio)
if ($iio->invoice->due() == 0) {
$x = $iio;
break;
}
return $format ? ($x ? $x->display('date_stop') : '&nbsp;') : ($x ? $x->date_stop : NULL);
}
/**
* Returns TRUE of this service has a planned change
*/
public function pending_change() {
return $this->service_change()->loaded() ? TRUE : FALSE;
2011-07-14 09:09:03 +00:00
}
/**
* Show the product that this service will be changed to
*/
public function pending_product() {
return $this->service_change()->product;
}
/**
* Return the object of the product plugin
*/
public function plugin($type='') {
if (! $this->product->prod_plugin_file)
return NULL;
$o = ORM::factory(Kohana::classname(sprintf('Service_Plugin_%s',$this->product->prod_plugin_file)),array('service_id'=>$this->id));
return $type ? $o->$type : $o;
}
public function service_change() {
return $this->service_change->where_active()->where_open()->and_where('complete','!=',1)->or_where('complete','IS',null)->where_close()->find();
2010-11-29 22:41:08 +00:00
}
/**
* Return a descriptive name for this service
*/
public function service_name() {
return is_null($plugin=$this->plugin()) ? $this->name() : $plugin->service_name();
}
/**
* Return the service charge
*/
public function price($tax=FALSE,$format=FALSE) {
$x = $this->product->keyget('price_group',$this->recur_schedule);
// @todo This index shouldnt be hard coded.
$p = $this->price ? $this->price : $x[$this->price_group]['price_base'];
if ($tax)
$p = Tax::add($p);
return $format ? Currency::display($p) : $p;
2011-07-14 09:09:03 +00:00
}
/**
* Render some details for specific calls, eg: invoice
*/
public function details($type) {
$plugin = $this->plugin();
2011-07-14 09:09:03 +00:00
switch ($type) {
case 'invoice_detail_items':
return is_null($plugin) ? array() : $plugin->_details($type);
case 'service_view':
return is_null($plugin) ? HTML::nbsp('') : $plugin->service_view();
2011-07-14 09:09:03 +00:00
default:
throw new Kohana_Exception('Unkown detail request :type',array(':type'=>$type));
}
}
2011-12-16 23:31:35 +00:00
/**
* Enable the plugin to store data
*/
2011-07-14 09:09:03 +00:00
public function admin_update() {
if (is_null($plugin = $this->plugin()))
return NULL;
else
2011-12-16 23:31:35 +00:00
return $plugin->admin_update();
2010-11-29 22:41:08 +00:00
}
public function transactions() {
2012-03-31 03:33:13 +00:00
return $this->invoice_item->order_by('date_start,date_stop');
}
/** LIST FUNCTIONS **/
/**
* Search for services matching a term
*/
public function list_autocomplete($term,$index,$value,array $label,array $limit=array(),array $options=NULL) {
// We only show service numbers.
if (! is_numeric($term))
return array();
$ao = Auth::instance()->get_user();
$this->clear();
$this->where_active();
// Build our where clause
$this->where_open()
->where('id','like','%'.$term.'%')
->where_close();
// Restrict results to authorised accounts
array_push($limit,array('account_id','IN',$ao->RTM->customers($ao->RTM)));
return parent::list_autocomplete($term,$index,$value,$label,$limit,$options);
}
/**
* List all products by their plugin type
*/
public function list_byplugin($plugin) {
return $this
->join('product')
->on($this->table_name().'.site_id','=','product.site_id') // @todo This should be automatic
->on($this->table_name().'.product_id','=','product.id')
->where('prod_plugin_file','=',$plugin)
->and_where('service.status','=',TRUE)
->find_all();
}
public function list_bylistgroup($cat) {
$result = array();
2013-01-11 06:03:13 +00:00
foreach ($this->list_active() as $so)
if ($so->product->prod_plugin_file == $cat)
array_push($result,$so);
Sort::MASort($result,'service_name()');
return $result;
}
/**
* List services expiring
*/
public function list_expiring($days=14) {
$result = array();
foreach ($this->list_active() as $so)
if ($so->expiring($days))
array_push($result,$so);
return $result;
}
/**
* List services that need to be billed.
*
* @param $days int Additional number of days to add to the query, above the module config.
*/
public function list_invoicesoon($days=0) {
2012-08-01 12:43:33 +00:00
return $this->_where_active()
2011-12-16 23:31:35 +00:00
->where_open()->where('suspend_billing','IS',NULL)->or_where('suspend_billing','=','0')->where_close()
2012-11-09 23:13:57 +00:00
->where('date_next_invoice','<',time()+(ORM::factory('Invoice')->config('GEN_DAYS')+$days)*86400)
2011-12-16 23:31:35 +00:00
->find_all();
}
2011-12-16 23:31:35 +00:00
/**
* List services that need to be provisioned
*/
public function list_provision() {
2012-08-01 12:43:33 +00:00
return $this->_where_active()->where('queue','=','PROVISION');
}
2010-11-29 22:41:08 +00:00
}
?>