forked from mirrors/easyappointments
590 lines
13 KiB
HTML
590 lines
13 KiB
HTML
|
<!DOCTYPE html>
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="generator" content="ApiGen 2.8.0" />
|
||
|
|
|
||
|
|
<title>Class Customers_Model</title>
|
||
|
|
|
||
|
|
<script type="text/javascript" src="resources/combined.js?955602237"></script>
|
||
|
|
<script type="text/javascript" src="elementlist.js?1576614342"></script>
|
||
|
|
<link rel="stylesheet" type="text/css" media="all" href="resources/style.css?3505392360" />
|
||
|
|
|
||
|
|
</head>
|
||
|
|
|
||
|
|
<body>
|
||
|
|
<div id="left">
|
||
|
|
<div id="menu">
|
||
|
|
<a href="index.html" title="Overview"><span>Overview</span></a>
|
||
|
|
|
||
|
|
|
||
|
|
<div id="groups">
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<div id="elements">
|
||
|
|
<h3>Classes</h3>
|
||
|
|
<ul>
|
||
|
|
<li><a href="class-Appointments.html">Appointments</a></li>
|
||
|
|
<li><a href="class-Appointments_Model.html">Appointments_Model</a></li>
|
||
|
|
<li class="active"><a href="class-Customers_Model.html">Customers_Model</a></li>
|
||
|
|
<li><a href="class-Google.html">Google</a></li>
|
||
|
|
<li><a href="class-Providers_Model.html">Providers_Model</a></li>
|
||
|
|
<li><a href="class-Roles_Model.html">Roles_Model</a></li>
|
||
|
|
<li><a href="class-Services_Model.html">Services_Model</a></li>
|
||
|
|
<li><a href="class-Settings_Model.html">Settings_Model</a></li>
|
||
|
|
<li><a href="class-Test.html">Test</a></li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div id="splitter"></div>
|
||
|
|
|
||
|
|
<div id="right">
|
||
|
|
<div id="rightInner">
|
||
|
|
<form id="search">
|
||
|
|
<input type="hidden" name="cx" value="" />
|
||
|
|
<input type="hidden" name="ie" value="UTF-8" />
|
||
|
|
<input type="text" name="q" class="text" />
|
||
|
|
<input type="submit" value="Search" />
|
||
|
|
</form>
|
||
|
|
|
||
|
|
<div id="navigation">
|
||
|
|
<ul>
|
||
|
|
<li>
|
||
|
|
<a href="index.html" title="Overview"><span>Overview</span></a>
|
||
|
|
</li>
|
||
|
|
<li class="active">
|
||
|
|
<span>Class</span> </li>
|
||
|
|
</ul>
|
||
|
|
<ul>
|
||
|
|
<li>
|
||
|
|
<a href="tree.html" title="Tree view of classes, interfaces, traits and exceptions"><span>Tree</span></a>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<ul>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div id="content" class="class">
|
||
|
|
<h1>Class Customers_Model</h1>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<dl class="tree">
|
||
|
|
<dd style="padding-left:0px">
|
||
|
|
CI_Model
|
||
|
|
|
||
|
|
|
||
|
|
</dd>
|
||
|
|
<dd style="padding-left:30px">
|
||
|
|
<img src="resources/inherit.png" alt="Extended by" />
|
||
|
|
<b><span>Customers_Model</span></b>
|
||
|
|
|
||
|
|
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<div class="info">
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<b>Located at</b> <a href="source-class-Customers_Model.html#3-283" title="Go to source code">customers_model.php</a><br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<table class="summary" id="methods">
|
||
|
|
<caption>Methods summary</caption>
|
||
|
|
<tr data-order="__construct" id="___construct">
|
||
|
|
|
||
|
|
<td class="attributes"><code>
|
||
|
|
public
|
||
|
|
|
||
|
|
|
||
|
|
</code>
|
||
|
|
</td>
|
||
|
|
|
||
|
|
<td class="name"><div>
|
||
|
|
<a class="anchor" href="#___construct">#</a>
|
||
|
|
<code><a href="source-class-Customers_Model.html#4-9" title="Go to source code">__construct</a>( )</code>
|
||
|
|
|
||
|
|
<div class="description short">
|
||
|
|
|
||
|
|
<p>Class Constructor</p>
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="description detailed hidden">
|
||
|
|
|
||
|
|
<p>Class Constructor</p>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div></td>
|
||
|
|
</tr>
|
||
|
|
<tr data-order="add" id="_add">
|
||
|
|
|
||
|
|
<td class="attributes"><code>
|
||
|
|
public
|
||
|
|
integer
|
||
|
|
|
||
|
|
</code>
|
||
|
|
</td>
|
||
|
|
|
||
|
|
<td class="name"><div>
|
||
|
|
<a class="anchor" href="#_add">#</a>
|
||
|
|
<code><a href="source-class-Customers_Model.html#11-38" title="Go to source code">add</a>( <span>array <var>$customer_data</var></span> )</code>
|
||
|
|
|
||
|
|
<div class="description short">
|
||
|
|
|
||
|
|
<p>Add a customer record to the database.</p>
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="description detailed hidden">
|
||
|
|
|
||
|
|
<p>Add a customer record to the database.</p>
|
||
|
|
|
||
|
|
<p>This method adds a customer to the database. If the customer doesn't exists
|
||
|
|
it is going to be inserted, otherwise the record is going to be updated.</p>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h4>Parameters</h4>
|
||
|
|
<div class="list"><dl>
|
||
|
|
<dt><var>$customer_data</var></dt>
|
||
|
|
<dd><code>array</code><br>$customer_data Associative array with the customer's data. Each key has the same
|
||
|
|
name with the database fields.</dd>
|
||
|
|
</dl></div>
|
||
|
|
|
||
|
|
<h4>Returns</h4>
|
||
|
|
<div class="list">
|
||
|
|
<code>integer</code><br>Returns the customer id.<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
<h4>ExpectedException</h4>
|
||
|
|
<div class="list">
|
||
|
|
ValidationException When customer's data are invalid.<br />
|
||
|
|
DatabaseException When update or insert method fails.<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div></td>
|
||
|
|
</tr>
|
||
|
|
<tr data-order="exists" id="_exists">
|
||
|
|
|
||
|
|
<td class="attributes"><code>
|
||
|
|
public
|
||
|
|
boolean
|
||
|
|
|
||
|
|
</code>
|
||
|
|
</td>
|
||
|
|
|
||
|
|
<td class="name"><div>
|
||
|
|
<a class="anchor" href="#_exists">#</a>
|
||
|
|
<code><a href="source-class-Customers_Model.html#40-69" title="Go to source code">exists</a>( <span>array <var>$customer_data</var></span> )</code>
|
||
|
|
|
||
|
|
<div class="description short">
|
||
|
|
|
||
|
|
<p>Check if a particular customer record already exists.</p>
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="description detailed hidden">
|
||
|
|
|
||
|
|
<p>Check if a particular customer record already exists.</p>
|
||
|
|
|
||
|
|
<p>This method checks wether the given customer already exists in the database.
|
||
|
|
It doesn't search with the id, but with the following fields: "email"</p>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h4>Parameters</h4>
|
||
|
|
<div class="list"><dl>
|
||
|
|
<dt><var>$customer_data</var></dt>
|
||
|
|
<dd><code>array</code><br>$customer_data Associative array with the customer's data. Each key has the same
|
||
|
|
name with the database fields.</dd>
|
||
|
|
</dl></div>
|
||
|
|
|
||
|
|
<h4>Returns</h4>
|
||
|
|
<div class="list">
|
||
|
|
<code>boolean</code><br>Returns wether the record exists or not.<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
<h4>ExpectedException</h4>
|
||
|
|
<div class="list">
|
||
|
|
InvalidArgumentException When the $customer_data array does not contain all the
|
||
|
|
necessary fields.<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div></td>
|
||
|
|
</tr>
|
||
|
|
<tr data-order="find_record_id" id="_find_record_id">
|
||
|
|
|
||
|
|
<td class="attributes"><code>
|
||
|
|
public
|
||
|
|
integer
|
||
|
|
|
||
|
|
</code>
|
||
|
|
</td>
|
||
|
|
|
||
|
|
<td class="name"><div>
|
||
|
|
<a class="anchor" href="#_find_record_id">#</a>
|
||
|
|
<code><a href="source-class-Customers_Model.html#119-154" title="Go to source code">find_record_id</a>( <span>array <var>$customer_data</var></span> )</code>
|
||
|
|
|
||
|
|
<div class="description short">
|
||
|
|
|
||
|
|
<p>Find the database id of a customer record.</p>
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="description detailed hidden">
|
||
|
|
|
||
|
|
<p>Find the database id of a customer record.</p>
|
||
|
|
|
||
|
|
<p>The customer data should include the following fields in order to get the
|
||
|
|
unique id from the database: "email"</p>
|
||
|
|
|
||
|
|
<p><strong>IMPORTANT!</strong> The record must already exists in the
|
||
|
|
database, otherwise an exception is raised.</p>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h4>Parameters</h4>
|
||
|
|
<div class="list"><dl>
|
||
|
|
<dt><var>$customer_data</var></dt>
|
||
|
|
<dd><code>array</code><br>$customer_data Array with the customer data. The keys of the array should have
|
||
|
|
the same names as the db fields.</dd>
|
||
|
|
</dl></div>
|
||
|
|
|
||
|
|
<h4>Returns</h4>
|
||
|
|
<div class="list">
|
||
|
|
<code>integer</code><br>Returns the id.<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
<h4>ExpectedException</h4>
|
||
|
|
<div class="list">
|
||
|
|
DatabaseException When the record is not found.<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div></td>
|
||
|
|
</tr>
|
||
|
|
<tr data-order="validate_data" id="_validate_data">
|
||
|
|
|
||
|
|
<td class="attributes"><code>
|
||
|
|
public
|
||
|
|
boolean
|
||
|
|
|
||
|
|
</code>
|
||
|
|
</td>
|
||
|
|
|
||
|
|
<td class="name"><div>
|
||
|
|
<a class="anchor" href="#_validate_data">#</a>
|
||
|
|
<code><a href="source-class-Customers_Model.html#156-185" title="Go to source code">validate_data</a>( <span>array <var>$customer_data</var></span> )</code>
|
||
|
|
|
||
|
|
<div class="description short">
|
||
|
|
|
||
|
|
<p>Validate customer data before the insert or update operation is executed.</p>
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="description detailed hidden">
|
||
|
|
|
||
|
|
<p>Validate customer data before the insert or update operation is executed.</p>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h4>Parameters</h4>
|
||
|
|
<div class="list"><dl>
|
||
|
|
<dt><var>$customer_data</var></dt>
|
||
|
|
<dd><code>array</code><br>$customer_data Contains the customer data.</dd>
|
||
|
|
</dl></div>
|
||
|
|
|
||
|
|
<h4>Returns</h4>
|
||
|
|
<div class="list">
|
||
|
|
<code>boolean</code><br>Returns the validation result.<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div></td>
|
||
|
|
</tr>
|
||
|
|
<tr data-order="delete" id="_delete">
|
||
|
|
|
||
|
|
<td class="attributes"><code>
|
||
|
|
public
|
||
|
|
boolean
|
||
|
|
|
||
|
|
</code>
|
||
|
|
</td>
|
||
|
|
|
||
|
|
<td class="name"><div>
|
||
|
|
<a class="anchor" href="#_delete">#</a>
|
||
|
|
<code><a href="source-class-Customers_Model.html#187-208" title="Go to source code">delete</a>( <span>integer <var>$customer_id</var></span> )</code>
|
||
|
|
|
||
|
|
<div class="description short">
|
||
|
|
|
||
|
|
<p>Delete an existing customer record from the database.</p>
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="description detailed hidden">
|
||
|
|
|
||
|
|
<p>Delete an existing customer record from the database.</p>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h4>Parameters</h4>
|
||
|
|
<div class="list"><dl>
|
||
|
|
<dt><var>$customer_id</var></dt>
|
||
|
|
<dd><code>integer</code><br>$customer_id The record id to be deleted.</dd>
|
||
|
|
</dl></div>
|
||
|
|
|
||
|
|
<h4>Returns</h4>
|
||
|
|
<div class="list">
|
||
|
|
<code>boolean</code><br>Returns the delete operation result.<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
<h4>ExpectedException</h4>
|
||
|
|
<div class="list">
|
||
|
|
InvalidArgumentException Raises when the $customer_id is not an integer.<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div></td>
|
||
|
|
</tr>
|
||
|
|
<tr data-order="get_row" id="_get_row">
|
||
|
|
|
||
|
|
<td class="attributes"><code>
|
||
|
|
public
|
||
|
|
array
|
||
|
|
|
||
|
|
</code>
|
||
|
|
</td>
|
||
|
|
|
||
|
|
<td class="name"><div>
|
||
|
|
<a class="anchor" href="#_get_row">#</a>
|
||
|
|
<code><a href="source-class-Customers_Model.html#210-223" title="Go to source code">get_row</a>( <span>integer <var>$customer_id</var></span> )</code>
|
||
|
|
|
||
|
|
<div class="description short">
|
||
|
|
|
||
|
|
<p>Get a specific row from the appointments table.</p>
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="description detailed hidden">
|
||
|
|
|
||
|
|
<p>Get a specific row from the appointments table.</p>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h4>Parameters</h4>
|
||
|
|
<div class="list"><dl>
|
||
|
|
<dt><var>$customer_id</var></dt>
|
||
|
|
<dd><code>integer</code><br>$customer_id The record's id to be returned.</dd>
|
||
|
|
</dl></div>
|
||
|
|
|
||
|
|
<h4>Returns</h4>
|
||
|
|
<div class="list">
|
||
|
|
<code>array</code><br>Returns an associative array with the selected record's data. Each key has the
|
||
|
|
same name as the database field names.<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div></td>
|
||
|
|
</tr>
|
||
|
|
<tr data-order="get_value" id="_get_value">
|
||
|
|
|
||
|
|
<td class="attributes"><code>
|
||
|
|
public
|
||
|
|
string
|
||
|
|
|
||
|
|
</code>
|
||
|
|
</td>
|
||
|
|
|
||
|
|
<td class="name"><div>
|
||
|
|
<a class="anchor" href="#_get_value">#</a>
|
||
|
|
<code><a href="source-class-Customers_Model.html#225-252" title="Go to source code">get_value</a>( <span>string <var>$field_name</var></span>, <span>integer <var>$customer_id</var></span> )</code>
|
||
|
|
|
||
|
|
<div class="description short">
|
||
|
|
|
||
|
|
<p>Get a specific field value from the database.</p>
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="description detailed hidden">
|
||
|
|
|
||
|
|
<p>Get a specific field value from the database.</p>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h4>Parameters</h4>
|
||
|
|
<div class="list"><dl>
|
||
|
|
<dt><var>$field_name</var></dt>
|
||
|
|
<dd><code>string</code><br>$field_name The field name of the value to be returned.</dd>
|
||
|
|
<dt><var>$customer_id</var></dt>
|
||
|
|
<dd><code>integer</code><br>$customer_id The selected record's id.</dd>
|
||
|
|
</dl></div>
|
||
|
|
|
||
|
|
<h4>Returns</h4>
|
||
|
|
<div class="list">
|
||
|
|
<code>string</code><br>Returns the records value from the database.<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div></td>
|
||
|
|
</tr>
|
||
|
|
<tr data-order="get_batch" id="_get_batch">
|
||
|
|
|
||
|
|
<td class="attributes"><code>
|
||
|
|
public
|
||
|
|
array
|
||
|
|
|
||
|
|
</code>
|
||
|
|
</td>
|
||
|
|
|
||
|
|
<td class="name"><div>
|
||
|
|
<a class="anchor" href="#_get_batch">#</a>
|
||
|
|
<code><a href="source-class-Customers_Model.html#254-273" title="Go to source code">get_batch</a>( <span>string <var>$where_clause</var> = <span class="php-quote">''</span></span> )</code>
|
||
|
|
|
||
|
|
<div class="description short">
|
||
|
|
|
||
|
|
<p>Get all, or specific records from appointment's table.</p>
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="description detailed hidden">
|
||
|
|
|
||
|
|
<p>Get all, or specific records from appointment's table.</p>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h4>Parameters</h4>
|
||
|
|
<div class="list"><dl>
|
||
|
|
<dt><var>$where_clause</var></dt>
|
||
|
|
<dd><code>string</code><br>$whereClause (OPTIONAL) The WHERE clause of the query to be executed. DO NOT
|
||
|
|
INCLUDE 'WHERE' KEYWORD.</dd>
|
||
|
|
</dl></div>
|
||
|
|
|
||
|
|
<h4>Returns</h4>
|
||
|
|
<div class="list">
|
||
|
|
<code>array</code><br>Returns the rows from the database.<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
<h4>Example</h4>
|
||
|
|
<div class="list">
|
||
|
|
$this->Model->getBatch('id = ' . $recordId);<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div></td>
|
||
|
|
</tr>
|
||
|
|
<tr data-order="get_customers_role_id" id="_get_customers_role_id">
|
||
|
|
|
||
|
|
<td class="attributes"><code>
|
||
|
|
public
|
||
|
|
integer
|
||
|
|
|
||
|
|
</code>
|
||
|
|
</td>
|
||
|
|
|
||
|
|
<td class="name"><div>
|
||
|
|
<a class="anchor" href="#_get_customers_role_id">#</a>
|
||
|
|
<code><a href="source-class-Customers_Model.html#275-282" title="Go to source code">get_customers_role_id</a>( )</code>
|
||
|
|
|
||
|
|
<div class="description short">
|
||
|
|
|
||
|
|
<p>Get the customers role id from the database.</p>
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="description detailed hidden">
|
||
|
|
|
||
|
|
<p>Get the customers role id from the database.</p>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h4>Returns</h4>
|
||
|
|
<div class="list">
|
||
|
|
<code>integer</code><br>Returns the role id for the customer records.<br />
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div id="footer">
|
||
|
|
API documentation generated by <a href="http://apigen.org">ApiGen 2.8.0</a>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|