5eae3dc351
This commit is a port from v2's 9a515b9234 ([SCHEMA] Improve timestamp storage) to v3.
As explained by Alexei Sorokin:
Avoid the use of deprecated MariaDATABASE "zero dates" globally. If they're present
as attribute defaults somewhere, they will be replaced with NULL implicitly.
The existing "zero dates" in MariaDATABASE storage will be left intact and this
should not present any issues.
The "timestamp" type in table definitions now corresponds to DATETIME in
MariaDATABASE with "DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP", which
should be close enough to the original behaviour for compatibility purposes.
It is now the recommended type for "modified" attributes, because of the
update trigger on MariaDATABASE. But there is no such trigger implemented on
PostgreSQL as of this moment.
288 lines
8.3 KiB
PHP
288 lines
8.3 KiB
PHP
<?php
|
|
|
|
// {{{ License
|
|
// This file is part of GNU social - https://www.gnu.org/software/social
|
|
//
|
|
// GNU social 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.
|
|
//
|
|
// GNU social 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 GNU social. If not, see <http://www.gnu.org/licenses/>.
|
|
// }}}
|
|
|
|
namespace App\Entity;
|
|
|
|
use DateTimeInterface;
|
|
|
|
/**
|
|
* Entity for groups a user is in
|
|
*
|
|
* @category DB
|
|
* @package GNUsocial
|
|
*
|
|
* @author Zach Copley <zach@status.net>
|
|
* @copyright 2010 StatusNet Inc.
|
|
* @author Mikael Nordfeldth <mmn@hethane.se>
|
|
* @copyright 2009-2014 Free Software Foundation, Inc http://www.fsf.org
|
|
* @author Hugo Sales <hugo@fc.up.pt>
|
|
* @copyright 2020 Free Software Foundation, Inc http://www.fsf.org
|
|
* @license https://www.gnu.org/licenses/agpl.html GNU AGPL v3 or later
|
|
*/
|
|
class Group
|
|
{
|
|
// {{{ Autocode
|
|
|
|
private int $id;
|
|
private int $profile_id;
|
|
private ?string $nickname;
|
|
private ?string $fullname;
|
|
private ?string $homepage;
|
|
private ?string $description;
|
|
private ?string $location;
|
|
private ?string $original_logo;
|
|
private ?string $homepage_logo;
|
|
private ?string $stream_logo;
|
|
private ?string $mini_logo;
|
|
private DateTimeInterface $created;
|
|
private DateTimeInterface $modified;
|
|
private ?string $uri;
|
|
private ?string $mainpage;
|
|
private ?int $join_policy;
|
|
private ?int $force_scope;
|
|
|
|
public function setId(int $id): self
|
|
{
|
|
$this->id = $id;
|
|
return $this;
|
|
}
|
|
|
|
public function getId(): int
|
|
{
|
|
return $this->id;
|
|
}
|
|
|
|
public function setProfileId(int $profile_id): self
|
|
{
|
|
$this->profile_id = $profile_id;
|
|
return $this;
|
|
}
|
|
|
|
public function getProfileId(): int
|
|
{
|
|
return $this->profile_id;
|
|
}
|
|
|
|
public function setNickname(?string $nickname): self
|
|
{
|
|
$this->nickname = $nickname;
|
|
return $this;
|
|
}
|
|
|
|
public function getNickname(): ?string
|
|
{
|
|
return $this->nickname;
|
|
}
|
|
|
|
public function setFullname(?string $fullname): self
|
|
{
|
|
$this->fullname = $fullname;
|
|
return $this;
|
|
}
|
|
|
|
public function getFullname(): ?string
|
|
{
|
|
return $this->fullname;
|
|
}
|
|
|
|
public function setHomepage(?string $homepage): self
|
|
{
|
|
$this->homepage = $homepage;
|
|
return $this;
|
|
}
|
|
|
|
public function getHomepage(): ?string
|
|
{
|
|
return $this->homepage;
|
|
}
|
|
|
|
public function setDescription(?string $description): self
|
|
{
|
|
$this->description = $description;
|
|
return $this;
|
|
}
|
|
|
|
public function getDescription(): ?string
|
|
{
|
|
return $this->description;
|
|
}
|
|
|
|
public function setLocation(?string $location): self
|
|
{
|
|
$this->location = $location;
|
|
return $this;
|
|
}
|
|
|
|
public function getLocation(): ?string
|
|
{
|
|
return $this->location;
|
|
}
|
|
|
|
public function setOriginalLogo(?string $original_logo): self
|
|
{
|
|
$this->original_logo = $original_logo;
|
|
return $this;
|
|
}
|
|
|
|
public function getOriginalLogo(): ?string
|
|
{
|
|
return $this->original_logo;
|
|
}
|
|
|
|
public function setHomepageLogo(?string $homepage_logo): self
|
|
{
|
|
$this->homepage_logo = $homepage_logo;
|
|
return $this;
|
|
}
|
|
|
|
public function getHomepageLogo(): ?string
|
|
{
|
|
return $this->homepage_logo;
|
|
}
|
|
|
|
public function setStreamLogo(?string $stream_logo): self
|
|
{
|
|
$this->stream_logo = $stream_logo;
|
|
return $this;
|
|
}
|
|
|
|
public function getStreamLogo(): ?string
|
|
{
|
|
return $this->stream_logo;
|
|
}
|
|
|
|
public function setMiniLogo(?string $mini_logo): self
|
|
{
|
|
$this->mini_logo = $mini_logo;
|
|
return $this;
|
|
}
|
|
|
|
public function getMiniLogo(): ?string
|
|
{
|
|
return $this->mini_logo;
|
|
}
|
|
|
|
public function setCreated(DateTimeInterface $created): self
|
|
{
|
|
$this->created = $created;
|
|
return $this;
|
|
}
|
|
|
|
public function getCreated(): DateTimeInterface
|
|
{
|
|
return $this->created;
|
|
}
|
|
|
|
public function setModified(DateTimeInterface $modified): self
|
|
{
|
|
$this->modified = $modified;
|
|
return $this;
|
|
}
|
|
|
|
public function getModified(): DateTimeInterface
|
|
{
|
|
return $this->modified;
|
|
}
|
|
|
|
public function setUri(?string $uri): self
|
|
{
|
|
$this->uri = $uri;
|
|
return $this;
|
|
}
|
|
|
|
public function getUri(): ?string
|
|
{
|
|
return $this->uri;
|
|
}
|
|
|
|
public function setMainpage(?string $mainpage): self
|
|
{
|
|
$this->mainpage = $mainpage;
|
|
return $this;
|
|
}
|
|
|
|
public function getMainpage(): ?string
|
|
{
|
|
return $this->mainpage;
|
|
}
|
|
|
|
public function setJoinPolicy(?int $join_policy): self
|
|
{
|
|
$this->join_policy = $join_policy;
|
|
return $this;
|
|
}
|
|
|
|
public function getJoinPolicy(): ?int
|
|
{
|
|
return $this->join_policy;
|
|
}
|
|
|
|
public function setForceScope(?int $force_scope): self
|
|
{
|
|
$this->force_scope = $force_scope;
|
|
return $this;
|
|
}
|
|
|
|
public function getForceScope(): ?int
|
|
{
|
|
return $this->force_scope;
|
|
}
|
|
|
|
// }}} Autocode
|
|
|
|
public static function schemaDef(): array
|
|
{
|
|
return [
|
|
'name' => 'group',
|
|
'fields' => [
|
|
'id' => ['type' => 'serial', 'not null' => true],
|
|
'profile_id' => ['type' => 'int', 'not null' => true, 'description' => 'foreign key to profile table'],
|
|
'nickname' => ['type' => 'varchar', 'length' => 64, 'description' => 'nickname for addressing'],
|
|
'fullname' => ['type' => 'varchar', 'length' => 191, 'description' => 'display name'],
|
|
'homepage' => ['type' => 'varchar', 'length' => 191, 'description' => 'URL, cached so we dont regenerate'],
|
|
'description' => ['type' => 'text', 'description' => 'group description'],
|
|
'is_local' => ['type' => 'bool', 'description' => 'whether this group was created in this instance'],
|
|
'location' => ['type' => 'varchar', 'length' => 191, 'description' => 'related physical location, if any'],
|
|
'original_logo' => ['type' => 'varchar', 'length' => 191, 'description' => 'original size logo'],
|
|
'homepage_logo' => ['type' => 'varchar', 'length' => 191, 'description' => 'homepage (profile) size logo'],
|
|
'stream_logo' => ['type' => 'varchar', 'length' => 191, 'description' => 'stream-sized logo'],
|
|
'mini_logo' => ['type' => 'varchar', 'length' => 191, 'description' => 'mini logo'],
|
|
'uri' => ['type' => 'varchar', 'length' => 191, 'description' => 'universal identifier'],
|
|
'mainpage' => ['type' => 'varchar', 'length' => 191, 'description' => 'page for group info to link to'],
|
|
'join_policy' => ['type' => 'int', 'size' => 'tiny', 'description' => '0=open; 1=requires admin approval'],
|
|
'force_scope' => ['type' => 'int', 'size' => 'tiny', 'description' => '0=never,1=sometimes,-1=always'],
|
|
'created' => ['type' => 'datetime', 'not null' => true, 'default' => 'CURRENT_TIMESTAMP', 'description' => 'date this record was created'],
|
|
'modified' => ['type' => 'timestamp', 'not null' => true, 'default' => 'CURRENT_TIMESTAMP', 'description' => 'date this record was modified'],
|
|
],
|
|
'primary key' => ['id'],
|
|
'unique keys' => [
|
|
'user_group_uri_key' => ['uri'],
|
|
'user_profile_id_key' => ['profile_id'],
|
|
],
|
|
'foreign keys' => [
|
|
'user_group_id_fkey' => ['profile', ['profile_id' => 'id']],
|
|
],
|
|
'indexes' => [
|
|
'user_group_nickname_idx' => ['nickname'],
|
|
'user_group_profile_id_idx' => ['profile_id'],
|
|
],
|
|
];
|
|
}
|
|
}
|