extension.php

Aller à la documentation de ce fichier.

<?php
/**
 * @package     Joomla.Platform
 * @subpackage  Table
 *
 * @copyright   Copyright (C) 2005 - 2013 Open Source Matters, Inc. All rights reserved.
 * @license     GNU General Public License version 2 or later; see LICENSE
 */

defined('JPATH_PLATFORM') or die;

/**
 * Extension table
 * Replaces plugins table
 *
 * @package     Joomla.Platform
 * @subpackage  Table
 * @since       11.1
 */
class JTableExtension extends JTable
{
        /**
         * Constructor
         *
         * @param   JDatabaseDriver  $db  Database driver object.
         *
         * @since   11.1
         */
        public function __construct(JDatabaseDriver $db)
        {
                parent::__construct('#__extensions', 'extension_id', $db);
        }

        /**
         * Overloaded check function
         *
         * @return  boolean  True if the object is ok
         *
         * @see     JTable::check()
         * @since   11.1
         */
        public function check()
        {
                // Check for valid name
                if (trim($this->name) == '' || trim($this->element) == '')
                {
                        $this->setError(JText::_('JLIB_DATABASE_ERROR_MUSTCONTAIN_A_TITLE_EXTENSION'));

                        return false;
                }
                return true;
        }

        /**
         * Overloaded bind function
         *
         * @param   array  $array   Named array
         * @param   mixed  $ignore  An optional array or space separated list of properties
         * to ignore while binding.
         *
         * @return  mixed  Null if operation was satisfactory, otherwise returns an error
         *
         * @see     JTable::bind()
         * @since   11.1
         */
        public function bind($array, $ignore = '')
        {
                if (isset($array['params']) && is_array($array['params']))
                {
                        $registry = new JRegistry;
                        $registry->loadArray($array['params']);
                        $array['params'] = (string) $registry;
                }

                if (isset($array['control']) && is_array($array['control']))
                {
                        $registry = new JRegistry;
                        $registry->loadArray($array['control']);
                        $array['control'] = (string) $registry;
                }

                return parent::bind($array, $ignore);
        }

        /**
         * Method to create and execute a SELECT WHERE query.
         *
         * @param   array  $options  Array of options
         *
         * @return  string  The database query result
         *
         * @since   11.1
         */
        public function find($options = array())
        {
                // Get the JDatabaseQuery object
                $query = $this->_db->getQuery(true);

                foreach ($options as $col => $val)
                {
                        $query->where($col . ' = ' . $this->_db->quote($val));
                }

                $query->select($this->_db->quoteName('extension_id'))
                        ->from($this->_db->quoteName('#__extensions'));
                $this->_db->setQuery($query);

                return $this->_db->loadResult();
        }

        /**
         * Method to set the publishing state for a row or list of rows in the database
         * table.  The method respects checked out rows by other users and will attempt
         * to checkin rows that it can after adjustments are made.
         *
         * @param   mixed    $pks     An optional array of primary key values to update.  If not
         *                            set the instance property value is used.
         * @param   integer  $state   The publishing state. eg. [0 = unpublished, 1 = published]
         * @param   integer  $userId  The user id of the user performing the operation.
         *
         * @return  boolean  True on success.
         *
         * @since   11.1
         */
        public function publish($pks = null, $state = 1, $userId = 0)
        {
                $k = $this->_tbl_key;

                // Sanitize input.
                JArrayHelper::toInteger($pks);
                $userId = (int) $userId;
                $state = (int) $state;

                // If there are no primary keys set check to see if the instance key is set.
                if (empty($pks))
                {
                        if ($this->$k)
                        {
                                $pks = array($this->$k);
                        }
                        // Nothing to set publishing state on, return false.
                        else
                        {
                                $this->setError(JText::_('JLIB_DATABASE_ERROR_NO_ROWS_SELECTED'));

                                return false;
                        }
                }

                // Build the WHERE clause for the primary keys.
                $where = $k . '=' . implode(' OR ' . $k . '=', $pks);

                // Determine if there is checkin support for the table.
                if (!property_exists($this, 'checked_out') || !property_exists($this, 'checked_out_time'))
                {
                        $checkin = '';
                }
                else
                {
                        $checkin = ' AND (checked_out = 0 OR checked_out = ' . (int) $userId . ')';
                }

                // Update the publishing state for rows with the given primary keys.
                $query = $this->_db->getQuery(true)
                        ->update($this->_db->quoteName($this->_tbl))
                        ->set($this->_db->quoteName('enabled') . ' = ' . (int) $state)
                        ->where('(' . $where . ')' . $checkin);
                $this->_db->setQuery($query);
                $this->_db->execute();

                // If checkin is supported and all rows were adjusted, check them in.
                if ($checkin && (count($pks) == $this->_db->getAffectedRows()))
                {
                        // Checkin the rows.
                        foreach ($pks as $pk)
                        {
                                $this->checkin($pk);
                        }
                }

                // If the JTable instance value is in the list of primary keys that were set, set the instance.
                if (in_array($this->$k, $pks))
                {
                        $this->enabled = $state;
                }

                $this->setError('');

                return true;
        }
}