View source

{{review}}
===Syntax===
''boolean'' <nowiki> save  ($source, $order_filter='', $ignore='')</nowiki>

=== Parameters ===
{| class="wikitable"
!Argument
!Data type
!Description
!Default
|-
|$source
|array
|Source array for binding to class vars. See [[JTable/bind]].
|
|-
|$order_filter
|string
|Filter for the order updating. See [[JTable/reorder]]
|<nowiki>''</nowiki>
|-
|$ignore
|mixed
|An array or space separated list of fields not to bind. See [[JTable/bind]].
|<nowiki>''</nowiki>
|}

=== Returns ===
TRUE if completely successful, FALSE if partially or not succesful.

=== Description ===
JTable::save() - Combines several methods of the JTable Class.
# Triggers the bind() method of the object, and binds the <code> $source </code> array to the object. See [[JTable/bind]]
# Triggers the check() method of the object, and checks if all properties which have been previously been bound to the object are valid. See [[JTable/check]]
# Triggers the store() method of  the object, and updates the row defined by the table key, or inserts a new record if the value of the table key equals 0. See [[JTable/store]]
# Triggers the checkin() method of the object (only if the table has the columns <code> checked_out </code> and <code> checked_out_time </code>). See [[JTable/checkin]]
# If the <code>$order_filter</code> parameter is set, the reorder() method is triggered, compacting the ordering sequence of the selected records. The parameter <code>$order_filter</code> is used to create the <code> $where </code> parameter for the <code><nowiki>JTable::reorder($where='')</nowiki></code> method. See [[JTable/reorder]]
=== Preconditions ===
JTable is an abstract class. You need to write a child class, to use its functionality. See [[Developing a Model-View-Controller Component - Part 4 - Creating an Administrator Interface#Creating the Table Class | Part 4 of the MVC Tutorial]]

=== Source Code ===
In this particular case a look on the source code is much more self-explainatory than any example.

<source lang="php">
function save( $source, $order_filter='', $ignore='' )
{
	if (!$this->bind( $source, $ignore )) {
		return false;
	}
	if (!$this->check()) {
		return false;
	}
	if (!$this->store()) {
		return false;
	}
	if (!$this->checkin()) {
		return false;
	}
	if ($order_filter)
	{
		$filter_value = $this->$order_filter;
		$this->reorder( $order_filter ? $this->_db->nameQuote( $order_filter ).' = '.$this->_db->Quote( $filter_value ) : '' );
	}
	$this->setError('');
	return true;
}
</source>

===See also===
* [[Developing a Model-View-Controller Component - Part 4 - Creating an Administrator Interface#Creating the Table Class | Creating a JTable Child Class (MVC Tutorial Part 4)]]
* [http://api.joomla.org/Joomla-Framework/Table/JTable.html#save API Reference on JTable::save()]
<noinclude>[[Category:Development]][[Category:Framework]][[Category:JTable]]</noinclude>