View source for JTable/hit

===Description===
Method to increment the hits for a row if the necessary property/field exists.



{{subst:Description:JTable/hit}}

===Syntax===
<source lang="php">hit($pk=null)</source>

 {| class="wikitable"
|-
!Parameter Name
!Default Value
!Description
|-
| $pk
| null
|  An optional primary key value to increment. If not set the instance property value is used. 
|}

===Returns===
boolean True on success. 

===Defined in===
libraries/joomla/database/table.php
===Importing===
<source lang="php">jimport( 'joomla.database.table' );</source>

===Source Body===
<source lang="php">
public function hit($pk = null)
{
        // If there is no hits field, just return true.
        if (!property_exists($this, 'hits')) {
                return true;
        }

        // Initialise variables.
        $k = $this->_tbl_key;
        $pk = (is_null($pk)) ? $this->$k : $pk;

        // If no primary key is given, return false.
        if ($pk === null) {
                return false;
        }

        // Check the row in by primary key.
        $this->_db->setQuery(
                'UPDATE `'.$this->_tbl.'`' .
                ' SET `hits` = (`hits` + 1)' .
                ' WHERE `'.$this->_tbl_key.'` = '.$this->_db->quote($pk)
        );
        $this->_db->query();

        // Check for a database error.
        if ($this->_db->getErrorNum()) {
                $this->setError($this->_db->getErrorMsg());
                return false;
        }

        // Set table values in the object.
        $this->hits++;

        return true;
}
</source>


{{subst:SeeAlso:JTable/hit}}

===Examples===
<CodeExamplesForm />
<dpl>
 noresultsheader=\n
 category=hit
 category=JTable
 category=CodeExample
 category=MethodExample
 include=*
 format= ,,,
</dpl>