easyappointments/doc/code/php/class-Providers_Model.html

804 lines
18 KiB
HTML
Raw Normal View History

<!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 Providers_Model</title>
<script type="text/javascript" src="resources/combined.js?955602237"></script>
<script type="text/javascript" src="elementlist.js?679583101"></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">
<h3>Namespaces</h3>
<ul>
<li class="active"><a href="namespace-None.html">None</a>
</li>
<li><a href="namespace-PHP.html">PHP</a>
</li>
</ul>
</div>
<hr />
<div id="elements">
<h3>Classes</h3>
<ul>
<li><a href="class-Admins_Model.html">Admins_Model</a></li>
<li><a href="class-Appointments.html">Appointments</a></li>
<li><a href="class-Appointments_Model.html">Appointments_Model</a></li>
<li><a href="class-Backend.html">Backend</a></li>
<li><a href="class-Backend_api.html">Backend_api</a></li>
<li><a href="class-Customers_Model.html">Customers_Model</a></li>
<li><a href="class-Errors.html">Errors</a></li>
<li><a href="class-Google.html">Google</a></li>
<li class="active"><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-Secretaries_Model.html">Secretaries_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>
<li><a href="class-User.html">User</a></li>
<li><a href="class-User_Model.html">User_Model</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>
<a href="namespace-None.html" title="Summary of None"><span>Namespace</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 Providers_Model</h1>
<div class="description">
<p>Providers_Model Class</p>
<p>Contains the database operations for the service provider users of
Easy!Appointmenst.</p>
<p>Data Structure: 'fist_name' 'last_name' (required) 'email' (required)
'mobile_number' 'phone_number' (required) 'address' 'city' 'state' 'zip_code'
'notes' 'id_roles' 'services' &gt;&gt; array that contains the ids that the
provider can provide 'settings' 'username' 'password' 'notifications'
'working_plan' 'google_sync' 'google_token' 'sync_past_days'
'sync_future_days'</p>
</div>
<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>Providers_Model</span></b>
</dd>
</dl>
<div class="info">
<b>Located at</b> <a href="source-class-Providers_Model.html#3-516" title="Go to source code">providers_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-Providers_Model.html#33-38" 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-Providers_Model.html#40-64" title="Go to source code">add</a>( <span>array <var>$provider</var></span> )</code>
<div class="description short">
<p>Add (insert - update) a service provider record.</p>
</div>
<div class="description detailed hidden">
<p>Add (insert - update) a service provider record.</p>
<p>If the record already exists (id value provided) then it is going to be
updated, otherwise inserted into the database.</p>
<h4>Parameters</h4>
<div class="list"><dl>
<dt><var>$provider</var></dt>
<dd><code>array</code><br>$provider Contains the service provider data.</dd>
</dl></div>
<h4>Returns</h4>
<div class="list">
<code>integer</code><br>Returns the record id.<br />
</div>
<h4>Throws</h4>
<div class="list">
<code><code><a href="class-Exception.html">Exception</a></code></code><br>When the record data validation 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-Providers_Model.html#66-89" title="Go to source code">exists</a>( <span>array <var>$provider</var></span> )</code>
<div class="description short">
<p>Check whether a particular provider record already exists in the
database.</p>
</div>
<div class="description detailed hidden">
<p>Check whether a particular provider record already exists in the
database.</p>
<h4>Parameters</h4>
<div class="list"><dl>
<dt><var>$provider</var></dt>
<dd><code>array</code><br>$provider Contains the provider data. The 'email' value is required in order to
check for a provider.</dd>
</dl></div>
<h4>Returns</h4>
<div class="list">
<code>boolean</code><br>Returns whether the provider record exists or not.<br />
</div>
<h4>Throws</h4>
<div class="list">
<code><code><a href="class-Exception.html">Exception</a></code></code><br>When the 'email' value is not provided.<br />
</div>
</div>
</div></td>
</tr>
<tr data-order="insert" id="_insert">
<td class="attributes"><code>
public
integer
</code>
</td>
<td class="name"><div>
<a class="anchor" href="#_insert">#</a>
<code><a href="source-class-Providers_Model.html#91-124" title="Go to source code">insert</a>( <span>array <var>$provider</var></span> )</code>
<div class="description short">
<p>Insert a new provider record into the database.</p>
</div>
<div class="description detailed hidden">
<p>Insert a new provider record into the database.</p>
<h4>Parameters</h4>
<div class="list"><dl>
<dt><var>$provider</var></dt>
<dd><code>array</code><br>$provider Contains the provider data (must be already validated).</dd>
</dl></div>
<h4>Returns</h4>
<div class="list">
<code>integer</code><br>Returns the new record id.<br />
</div>
<h4>Throws</h4>
<div class="list">
<code><code><a href="class-Exception.html">Exception</a></code></code><br>When the insert operation fails.<br />
</div>
</div>
</div></td>
</tr>
<tr data-order="update" id="_update">
<td class="attributes"><code>
public
integer
</code>
</td>
<td class="name"><div>
<a class="anchor" href="#_update">#</a>
<code><a href="source-class-Providers_Model.html#126-158" title="Go to source code">update</a>( <span>array <var>$provider</var></span> )</code>
<div class="description short">
<p>Update an existing provider record in the database.</p>
</div>
<div class="description detailed hidden">
<p>Update an existing provider record in the database.</p>
<h4>Parameters</h4>
<div class="list"><dl>
<dt><var>$provider</var></dt>
<dd><code>array</code><br>$provider Contains the provider data.</dd>
</dl></div>
<h4>Returns</h4>
<div class="list">
<code>integer</code><br>Returns the record id.<br />
</div>
<h4>Throws</h4>
<div class="list">
<code><code><a href="class-Exception.html">Exception</a></code></code><br>When the update operation fails.<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-Providers_Model.html#160-186" title="Go to source code">find_record_id</a>( <span>array <var>$provider</var></span> )</code>
<div class="description short">
<p>Find the database record id of a provider.</p>
</div>
<div class="description detailed hidden">
<p>Find the database record id of a provider.</p>
<h4>Parameters</h4>
<div class="list"><dl>
<dt><var>$provider</var></dt>
<dd><code>array</code><br>$provider Contains the provider data. The 'email' value is required in order to
find the record id.</dd>
</dl></div>
<h4>Returns</h4>
<div class="list">
<code>integer</code><br>Returns the record id.<br />
</div>
<h4>Throws</h4>
<div class="list">
<code><code><a href="class-Exception.html">Exception</a></code></code><br>When the provider's email value is not provided.<br />
</div>
</div>
</div></td>
</tr>
<tr data-order="validate" id="_validate">
<td class="attributes"><code>
public
boolean
</code>
</td>
<td class="name"><div>
<a class="anchor" href="#_validate">#</a>
<code><a href="source-class-Providers_Model.html#188-245" title="Go to source code">validate</a>( <span>array <var>$provider</var></span> )</code>
<div class="description short">
<p>Validate provider data before the insert or update operation is executed.</p>
</div>
<div class="description detailed hidden">
<p>Validate provider data before the insert or update operation is executed.</p>
<h4>Parameters</h4>
<div class="list"><dl>
<dt><var>$provider</var></dt>
<dd><code>array</code><br>$provider Contains the provider 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-Providers_Model.html#247-265" title="Go to source code">delete</a>( <span>numeric <var>$provider_id</var></span> )</code>
<div class="description short">
<p>Delete an existing provider record from the database.</p>
</div>
<div class="description detailed hidden">
<p>Delete an existing provider record from the database.</p>
<h4>Parameters</h4>
<div class="list"><dl>
<dt><var>$provider_id</var></dt>
<dd><code>numeric</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>Throws</h4>
<div class="list">
<code><code><a href="class-Exception.html">Exception</a></code></code><br>When the provider id value is not numeric.<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-Providers_Model.html#267-304" title="Go to source code">get_row</a>( <span>integer <var>$provider_id</var></span> )</code>
<div class="description short">
<p>Get a specific provider record from the database.</p>
</div>
<div class="description detailed hidden">
<p>Get a specific provider record from the database.</p>
<h4>Parameters</h4>
<div class="list"><dl>
<dt><var>$provider_id</var></dt>
<dd><code>integer</code><br>$provider_id The id of the record 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>
<h4>Throws</h4>
<div class="list">
<code><code><a href="class-Exception.html">Exception</a></code></code><br>When the selected record does not exist in database.<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-Providers_Model.html#306-340" title="Go to source code">get_value</a>( <span>string <var>$field_name</var></span>, <span>numeric <var>$provider_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>$provider_id</var></dt>
<dd><code>numeric</code><br>$provider_id Record id of the value to be returned.</dd>
</dl></div>
<h4>Returns</h4>
<div class="list">
<code>string</code><br>Returns the selected record value from the database.<br />
</div>
<h4>Throws</h4>
<div class="list">
<code><code><a href="class-Exception.html">Exception</a></code></code><br>When the $field_name argument is not a valid string.<br />
<code><code><a href="class-Exception.html">Exception</a></code></code><br>When the $admin_id is not a valid numeric.<br />
<code><code><a href="class-Exception.html">Exception</a></code></code><br>When the admin record does not exist in the database.<br />
<code><code><a href="class-Exception.html">Exception</a></code></code><br>When the selected field value is not present on 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-Providers_Model.html#342-383" title="Go to source code">get_batch</a>( <span>mixed <var>$where_clause</var> = <span class="php-quote">''</span></span> )</code>
<div class="description short">
<p>Get all, or specific records from provider's table.</p>
</div>
<div class="description detailed hidden">
<p>Get all, or specific records from provider's table.</p>
<h4>Parameters</h4>
<div class="list"><dl>
<dt><var>$where_clause</var></dt>
<dd><code>mixed</code><br>$where_clause (OPTIONAL) The WHERE clause of the query to be executed. NOTICE:
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-&gt;Model-&gt;get_batch('id = ' . $recordId);<br />
</div>
</div>
</div></td>
</tr>
<tr data-order="get_providers_role_id" id="_get_providers_role_id">
<td class="attributes"><code>
public
integer
</code>
</td>
<td class="name"><div>
<a class="anchor" href="#_get_providers_role_id">#</a>
<code><a href="source-class-Providers_Model.html#425-432" title="Go to source code">get_providers_role_id</a>( )</code>
<div class="description short">
<p>Get the providers role id from the database.</p>
</div>
<div class="description detailed hidden">
<p>Get the providers role id from the database.</p>
<h4>Returns</h4>
<div class="list">
<code>integer</code><br>Returns the role id for the provider records.<br />
</div>
</div>
</div></td>
</tr>
<tr data-order="get_setting" id="_get_setting">
<td class="attributes"><code>
public
string
</code>
</td>
<td class="name"><div>
<a class="anchor" href="#_get_setting">#</a>
<code><a href="source-class-Providers_Model.html#434-446" title="Go to source code">get_setting</a>( <span>string <var>$setting_name</var></span>, <span>integer <var>$provider_id</var></span> )</code>
<div class="description short">
<p>Get a providers setting from the database.</p>
</div>
<div class="description detailed hidden">
<p>Get a providers setting from the database.</p>
<h4>Parameters</h4>
<div class="list"><dl>
<dt><var>$setting_name</var></dt>
<dd><code>string</code><br>$setting_name The setting name that is going to be returned.</dd>
<dt><var>$provider_id</var></dt>
<dd><code>integer</code><br>$provider_id The selected provider id.</dd>
</dl></div>
<h4>Returns</h4>
<div class="list">
<code>string</code><br>Returs the value of the selected user setting.<br />
</div>
</div>
</div></td>
</tr>
<tr data-order="set_setting" id="_set_setting">
<td class="attributes"><code>
public
</code>
</td>
<td class="name"><div>
<a class="anchor" href="#_set_setting">#</a>
<code><a href="source-class-Providers_Model.html#448-460" title="Go to source code">set_setting</a>( <span>string <var>$setting_name</var></span>, <span>string <var>$value</var></span>, <span>numeric <var>$provider_id</var></span> )</code>
<div class="description short">
<p>Set a provider's setting value in the database.</p>
</div>
<div class="description detailed hidden">
<p>Set a provider's setting value in the database.</p>
<p>The provider and settings record must already exist.</p>
<h4>Parameters</h4>
<div class="list"><dl>
<dt><var>$setting_name</var></dt>
<dd><code>string</code><br>$setting_name The setting's name.</dd>
<dt><var>$value</var></dt>
<dd><code>string</code><br>$value The setting's value.</dd>
<dt><var>$provider_id</var></dt>
<dd><code>numeric</code><br>$provider_id The selected provider id.</dd>
</dl></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>