2013-10-06 12:40:53 +01:00
|
|
|
<?php
|
|
|
|
/**
|
|
|
|
* StatusNet, the distributed open-source microblogging tool
|
|
|
|
*
|
|
|
|
* Data class for Profile preferences
|
|
|
|
*
|
|
|
|
* PHP version 5
|
|
|
|
*
|
|
|
|
* LICENCE: This program is free software: you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU Affero General Public License as published by
|
|
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
|
|
* (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU Affero General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
*
|
|
|
|
* @category Data
|
2013-10-14 23:20:36 +01:00
|
|
|
* @package GNUsocial
|
2013-10-06 12:40:53 +01:00
|
|
|
* @author Mikael Nordfeldth <mmn@hethane.se>
|
|
|
|
* @copyright 2013 Free Software Foundation, Inc.
|
|
|
|
* @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
|
|
|
|
* @link http://www.gnu.org/software/social/
|
|
|
|
*/
|
|
|
|
|
|
|
|
class Profile_prefs extends Managed_DataObject
|
|
|
|
{
|
|
|
|
public $__table = 'profile_prefs'; // table name
|
|
|
|
public $profile_id; // int(4) primary_key not_null
|
2015-02-12 17:18:55 +00:00
|
|
|
public $namespace; // varchar(191) not_null
|
|
|
|
public $topic; // varchar(191) not_null
|
2013-10-06 12:40:53 +01:00
|
|
|
public $data; // text
|
|
|
|
public $created; // datetime not_null default_0000-00-00%2000%3A00%3A00
|
|
|
|
public $modified; // timestamp not_null default_CURRENT_TIMESTAMP
|
|
|
|
|
|
|
|
public static function schemaDef()
|
|
|
|
{
|
|
|
|
return array(
|
|
|
|
'fields' => array(
|
|
|
|
'profile_id' => array('type' => 'int', 'not null' => true, 'description' => 'user'),
|
2015-02-12 17:18:55 +00:00
|
|
|
'namespace' => array('type' => 'varchar', 'length' => 191, 'not null' => true, 'description' => 'namespace, like pluginname or category'),
|
|
|
|
'topic' => array('type' => 'varchar', 'length' => 191, 'not null' => true, 'description' => 'preference key, i.e. description, age...'),
|
2013-10-06 12:40:53 +01:00
|
|
|
'data' => array('type' => 'blob', 'description' => 'topic data, may be anything'),
|
|
|
|
'created' => array('type' => 'datetime', 'not null' => true, 'description' => 'date this record was created'),
|
|
|
|
'modified' => array('type' => 'timestamp', 'not null' => true, 'description' => 'date this record was modified'),
|
|
|
|
),
|
|
|
|
'primary key' => array('profile_id', 'namespace', 'topic'),
|
|
|
|
'foreign keys' => array(
|
|
|
|
'profile_prefs_profile_id_fkey' => array('profile', array('profile_id' => 'id')),
|
|
|
|
),
|
|
|
|
'indexes' => array(
|
|
|
|
'profile_prefs_profile_id_idx' => array('profile_id'),
|
|
|
|
),
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
static function getNamespacePrefs(Profile $profile, $namespace, array $topic=array())
|
|
|
|
{
|
|
|
|
if (empty($topic)) {
|
|
|
|
$prefs = new Profile_prefs();
|
2015-06-04 21:26:31 +01:00
|
|
|
$prefs->profile_id = $profile->getID();
|
2013-10-06 12:40:53 +01:00
|
|
|
$prefs->namespace = $namespace;
|
|
|
|
$prefs->find();
|
|
|
|
} else {
|
2015-06-04 21:26:31 +01:00
|
|
|
$prefs = self::pivotGet('profile_id', $profile->getID(), array('namespace'=>$namespace, 'topic'=>$topic));
|
2013-10-06 12:40:53 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
if (empty($prefs->N)) {
|
|
|
|
throw new NoResultException($prefs);
|
|
|
|
}
|
|
|
|
|
|
|
|
return $prefs;
|
|
|
|
}
|
|
|
|
|
|
|
|
static function getNamespace(Profile $profile, $namespace, array $topic=array())
|
|
|
|
{
|
|
|
|
$prefs = self::getNamespacePrefs($profile, $namespace, $topic);
|
|
|
|
return $prefs->fetchAll();
|
|
|
|
}
|
|
|
|
|
|
|
|
static function getAll(Profile $profile)
|
|
|
|
{
|
2013-10-06 15:37:51 +01:00
|
|
|
try {
|
2015-12-17 14:55:39 +00:00
|
|
|
$prefs = self::listFind('profile_id', array($profile->getID()));
|
2013-10-06 15:37:51 +01:00
|
|
|
} catch (NoResultException $e) {
|
|
|
|
return array();
|
|
|
|
}
|
2013-10-06 12:40:53 +01:00
|
|
|
|
|
|
|
$list = array();
|
|
|
|
while ($entry = $prefs->fetch()) {
|
|
|
|
if (!isset($list[$entry->namespace])) {
|
|
|
|
$list[$entry->namespace] = array();
|
|
|
|
}
|
|
|
|
$list[$entry->namespace][$entry->topic] = $entry->data;
|
|
|
|
}
|
|
|
|
return $list;
|
|
|
|
}
|
|
|
|
|
|
|
|
static function getTopic(Profile $profile, $namespace, $topic) {
|
2015-06-04 21:26:31 +01:00
|
|
|
return Profile_prefs::getByPK(array('profile_id' => $profile->getID(),
|
|
|
|
'namespace' => $namespace,
|
|
|
|
'topic' => $topic));
|
2013-10-06 12:40:53 +01:00
|
|
|
}
|
|
|
|
|
2014-07-13 15:26:08 +01:00
|
|
|
static function getData(Profile $profile, $namespace, $topic, $def=null) {
|
|
|
|
try {
|
|
|
|
$pref = self::getTopic($profile, $namespace, $topic);
|
|
|
|
} catch (NoResultException $e) {
|
|
|
|
if ($def === null) {
|
|
|
|
// If no default value was set, continue the exception.
|
|
|
|
throw $e;
|
|
|
|
}
|
|
|
|
// If there was a default value, return that.
|
|
|
|
return $def;
|
|
|
|
}
|
2013-10-06 12:40:53 +01:00
|
|
|
return $pref->data;
|
|
|
|
}
|
|
|
|
|
|
|
|
static function getConfigData(Profile $profile, $namespace, $topic) {
|
|
|
|
try {
|
|
|
|
$data = self::getData($profile, $namespace, $topic);
|
2013-11-02 12:05:08 +00:00
|
|
|
} catch (NoResultException $e) {
|
2013-10-06 12:40:53 +01:00
|
|
|
$data = common_config($namespace, $topic);
|
|
|
|
}
|
|
|
|
return $data;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Sets a profile preference based on Profile, namespace and topic
|
|
|
|
*
|
|
|
|
* @param Profile $profile Which profile this is for
|
|
|
|
* @param string $namespace Under which namespace (pluginname etc.)
|
|
|
|
* @param string $topic Preference name (think key in key-val store)
|
|
|
|
* @param string $data Data to be put into preference storage, null means delete
|
|
|
|
*
|
|
|
|
* @return true if changes are made, false if no action taken
|
|
|
|
* @throws ServerException if preference could not be saved
|
|
|
|
*/
|
|
|
|
static function setData(Profile $profile, $namespace, $topic, $data=null) {
|
|
|
|
try {
|
|
|
|
$pref = self::getTopic($profile, $namespace, $topic);
|
|
|
|
if (is_null($data)) {
|
|
|
|
$pref->delete();
|
|
|
|
} else {
|
|
|
|
$orig = clone($pref);
|
|
|
|
$pref->data = $data;
|
|
|
|
$pref->update($orig);
|
|
|
|
}
|
|
|
|
return true;
|
|
|
|
} catch (NoResultException $e) {
|
|
|
|
if (is_null($data)) {
|
|
|
|
return false; // No action taken
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
$pref = new Profile_prefs();
|
2015-06-04 21:26:31 +01:00
|
|
|
$pref->profile_id = $profile->getID();
|
2013-10-06 12:40:53 +01:00
|
|
|
$pref->namespace = $namespace;
|
|
|
|
$pref->topic = $topic;
|
|
|
|
$pref->data = $data;
|
2014-07-13 16:09:18 +01:00
|
|
|
$pref->created = common_sql_now();
|
2013-10-06 12:40:53 +01:00
|
|
|
|
2013-11-02 12:05:08 +00:00
|
|
|
if ($pref->insert() === false) {
|
2013-10-06 12:40:53 +01:00
|
|
|
throw new ServerException('Could not save profile preference.');
|
|
|
|
}
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
}
|