-- ------------------------------------------
-- Friendica 2018-05-dev (The Tazmans Flax-lily)
--- DB_UPDATE_VERSION 1259
+-- DB_UPDATE_VERSION 1260
-- ------------------------------------------
--
CREATE TABLE IF NOT EXISTS `addon` (
`id` int unsigned NOT NULL auto_increment COMMENT '',
- `name` varchar(50) NOT NULL DEFAULT '' COMMENT '',
- `version` varchar(50) NOT NULL DEFAULT '' COMMENT '',
- `installed` boolean NOT NULL DEFAULT '0' COMMENT '',
- `hidden` boolean NOT NULL DEFAULT '0' COMMENT '',
- `timestamp` int unsigned NOT NULL DEFAULT 0 COMMENT '',
- `plugin_admin` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `name` varchar(50) NOT NULL DEFAULT '' COMMENT 'addon base (file)name',
+ `version` varchar(50) NOT NULL DEFAULT '' COMMENT 'currently unused',
+ `installed` boolean NOT NULL DEFAULT '0' COMMENT 'currently always 1',
+ `hidden` boolean NOT NULL DEFAULT '0' COMMENT 'currently unused',
+ `timestamp` int unsigned NOT NULL DEFAULT 0 COMMENT 'file timestamp to check for reloads',
+ `plugin_admin` boolean NOT NULL DEFAULT '0' COMMENT '1 = has admin config, 0 = has no admin config',
PRIMARY KEY(`id`),
UNIQUE INDEX `name` (`name`)
) DEFAULT COLLATE utf8mb4_general_ci;
-- TABLE attach
--
CREATE TABLE IF NOT EXISTS `attach` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
- `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
- `hash` varchar(64) NOT NULL DEFAULT '' COMMENT '',
- `filename` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `filetype` varchar(64) NOT NULL DEFAULT '' COMMENT '',
- `filesize` int unsigned NOT NULL DEFAULT 0 COMMENT '',
- `data` longblob NOT NULL COMMENT '',
- `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `edited` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `allow_cid` mediumtext COMMENT '',
- `allow_gid` mediumtext COMMENT '',
- `deny_cid` mediumtext COMMENT '',
- `deny_gid` mediumtext COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'generated index',
+ `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'Owner User id',
+ `hash` varchar(64) NOT NULL DEFAULT '' COMMENT 'hash',
+ `filename` varchar(255) NOT NULL DEFAULT '' COMMENT 'filename of original',
+ `filetype` varchar(64) NOT NULL DEFAULT '' COMMENT 'mimetype',
+ `filesize` int unsigned NOT NULL DEFAULT 0 COMMENT 'size in bytes',
+ `data` longblob NOT NULL COMMENT 'file data',
+ `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'creation time',
+ `edited` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'last edit time',
+ `allow_cid` mediumtext COMMENT 'Access Control - list of allowed contact.id \'<19><78>',
+ `allow_gid` mediumtext COMMENT 'Access Control - list of allowed groups',
+ `deny_cid` mediumtext COMMENT 'Access Control - list of denied contact.id',
+ `deny_gid` mediumtext COMMENT 'Access Control - list of denied groups',
PRIMARY KEY(`id`)
) DEFAULT COLLATE utf8mb4_general_ci;
-- TABLE challenge
--
CREATE TABLE IF NOT EXISTS `challenge` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`challenge` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`dfrn-id` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`expire` int unsigned NOT NULL DEFAULT 0 COMMENT '',
-- TABLE contact
--
CREATE TABLE IF NOT EXISTS `contact` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
- `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
+ `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'Owner User id',
`created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `self` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `self` boolean NOT NULL DEFAULT '0' COMMENT '1 if the contact is the user him/her self',
`remote_self` boolean NOT NULL DEFAULT '0' COMMENT '',
- `rel` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `rel` tinyint unsigned NOT NULL DEFAULT 0 COMMENT 'The kind of the relation between the user and the contact',
`duplex` boolean NOT NULL DEFAULT '0' COMMENT '',
- `network` char(4) NOT NULL DEFAULT '' COMMENT '',
- `name` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `nick` varchar(255) NOT NULL DEFAULT '' COMMENT '',
+ `network` char(4) NOT NULL DEFAULT '' COMMENT 'Network protocol of the contact',
+ `name` varchar(255) NOT NULL DEFAULT '' COMMENT 'Name that this contact is known by',
+ `nick` varchar(255) NOT NULL DEFAULT '' COMMENT 'Nick- and user name of the contact',
`location` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`about` text COMMENT '',
- `keywords` text COMMENT '',
+ `keywords` text COMMENT 'public keywords (interests) of the contact',
`gender` varchar(32) NOT NULL DEFAULT '' COMMENT '',
`xmpp` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`attag` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`avatar` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `photo` varchar(255) DEFAULT '' COMMENT '',
- `thumb` varchar(255) DEFAULT '' COMMENT '',
- `micro` varchar(255) DEFAULT '' COMMENT '',
+ `photo` varchar(255) DEFAULT '' COMMENT 'Link to the profile photo of the contact',
+ `thumb` varchar(255) DEFAULT '' COMMENT 'Link to the profile photo (thumb size)',
+ `micro` varchar(255) DEFAULT '' COMMENT 'Link to the profile photo (micro size)',
`site-pubkey` text COMMENT '',
`issued-id` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`dfrn-id` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`nurl` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`addr` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`alias` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `pubkey` text COMMENT '',
- `prvkey` text COMMENT '',
+ `pubkey` text COMMENT 'RSA public key 4096 bit',
+ `prvkey` text COMMENT 'RSA private key 4096 bit',
`batch` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`request` varchar(255) COMMENT '',
`notify` varchar(255) COMMENT '',
`usehub` boolean NOT NULL DEFAULT '0' COMMENT '',
`subhub` boolean NOT NULL DEFAULT '0' COMMENT '',
`hub-verify` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `last-update` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `success_update` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `failure_update` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
+ `last-update` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'Date of the last try to update the contact info',
+ `success_update` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'Date of the last successful contact update',
+ `failure_update` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'Date of the last failed update',
`name-date` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
`uri-date` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
`avatar-date` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
`term-date` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `last-item` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
+ `last-item` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'date of the last post',
`priority` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '',
`blocked` boolean NOT NULL DEFAULT '1' COMMENT '',
- `readonly` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `readonly` boolean NOT NULL DEFAULT '0' COMMENT 'posts of the contact are readonly',
`writable` boolean NOT NULL DEFAULT '0' COMMENT '',
- `forum` boolean NOT NULL DEFAULT '0' COMMENT '',
- `prv` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `forum` boolean NOT NULL DEFAULT '0' COMMENT 'contact is a forum',
+ `prv` boolean NOT NULL DEFAULT '0' COMMENT 'contact is a private group',
`contact-type` tinyint NOT NULL DEFAULT 0 COMMENT '',
`hidden` boolean NOT NULL DEFAULT '0' COMMENT '',
`archive` boolean NOT NULL DEFAULT '0' COMMENT '',
-- TABLE conv
--
CREATE TABLE IF NOT EXISTS `conv` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
- `guid` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `recips` text COMMENT '',
- `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
- `creator` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `updated` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `subject` text COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
+ `guid` varchar(255) NOT NULL DEFAULT '' COMMENT 'A unique identifier for this conversation',
+ `recips` text COMMENT 'sender_handle;recipient_handle',
+ `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'Owner User id',
+ `creator` varchar(255) NOT NULL DEFAULT '' COMMENT 'handle of creator',
+ `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'creation timestamp',
+ `updated` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'edited timestamp',
+ `subject` text COMMENT 'subject of initial message',
PRIMARY KEY(`id`),
INDEX `uid` (`uid`)
) DEFAULT COLLATE utf8mb4_general_ci;
-- TABLE conversation
--
CREATE TABLE IF NOT EXISTS `conversation` (
- `item-uri` varbinary(255) NOT NULL COMMENT '',
- `reply-to-uri` varbinary(255) NOT NULL DEFAULT '' COMMENT '',
- `conversation-uri` varbinary(255) NOT NULL DEFAULT '' COMMENT '',
- `conversation-href` varbinary(255) NOT NULL DEFAULT '' COMMENT '',
- `protocol` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '',
- `source` mediumtext COMMENT '',
- `received` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
+ `item-uri` varbinary(255) NOT NULL COMMENT 'URI of the item',
+ `reply-to-uri` varbinary(255) NOT NULL DEFAULT '' COMMENT 'URI to which this item is a reply',
+ `conversation-uri` varbinary(255) NOT NULL DEFAULT '' COMMENT 'GNU Social conversation URI',
+ `conversation-href` varbinary(255) NOT NULL DEFAULT '' COMMENT 'GNU Social conversation link',
+ `protocol` tinyint unsigned NOT NULL DEFAULT 0 COMMENT 'The protocol of the item',
+ `source` mediumtext COMMENT 'Original source',
+ `received` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'Receiving date',
PRIMARY KEY(`item-uri`),
INDEX `conversation-uri` (`conversation-uri`),
INDEX `received` (`received`)
-- TABLE event
--
CREATE TABLE IF NOT EXISTS `event` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`guid` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
- `cid` int unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'Owner User id',
+ `cid` int unsigned NOT NULL DEFAULT 0 COMMENT 'contact_id (ID of the contact in contact table)',
`uri` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `edited` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `start` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `finish` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `summary` text COMMENT '',
- `desc` text COMMENT '',
- `location` text COMMENT '',
- `type` varchar(20) NOT NULL DEFAULT '' COMMENT '',
- `nofinish` boolean NOT NULL DEFAULT '0' COMMENT '',
- `adjust` boolean NOT NULL DEFAULT '1' COMMENT '',
- `ignore` boolean NOT NULL DEFAULT '0' COMMENT '',
- `allow_cid` mediumtext COMMENT '',
- `allow_gid` mediumtext COMMENT '',
- `deny_cid` mediumtext COMMENT '',
- `deny_gid` mediumtext COMMENT '',
+ `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'creation time',
+ `edited` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'last edit time',
+ `start` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'event start time',
+ `finish` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'event end time',
+ `summary` text COMMENT 'short description or title of the event',
+ `desc` text COMMENT 'event description',
+ `location` text COMMENT 'event location',
+ `type` varchar(20) NOT NULL DEFAULT '' COMMENT 'event or birthday',
+ `nofinish` boolean NOT NULL DEFAULT '0' COMMENT 'if event does have no end this is 1',
+ `adjust` boolean NOT NULL DEFAULT '1' COMMENT 'adjust to timezone of the recipient (0 or 1)',
+ `ignore` boolean NOT NULL DEFAULT '0' COMMENT '0 or 1',
+ `allow_cid` mediumtext COMMENT 'Access Control - list of allowed contact.id \'<19><78>\'',
+ `allow_gid` mediumtext COMMENT 'Access Control - list of allowed groups',
+ `deny_cid` mediumtext COMMENT 'Access Control - list of denied contact.id',
+ `deny_gid` mediumtext COMMENT 'Access Control - list of denied groups',
PRIMARY KEY(`id`),
INDEX `uid_start` (`uid`,`start`)
) DEFAULT COLLATE utf8mb4_general_ci;
-- TABLE fcontact
--
CREATE TABLE IF NOT EXISTS `fcontact` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
- `guid` varchar(255) NOT NULL DEFAULT '' COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
+ `guid` varchar(255) NOT NULL DEFAULT '' COMMENT 'unique id',
`url` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`name` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`photo` varchar(255) NOT NULL DEFAULT '' COMMENT '',
-- TABLE gcign
--
CREATE TABLE IF NOT EXISTS `gcign` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
- `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
- `gcid` int unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
+ `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'Local User id',
+ `gcid` int unsigned NOT NULL DEFAULT 0 COMMENT 'gcontact.id of ignored contact',
PRIMARY KEY(`id`),
INDEX `uid` (`uid`),
INDEX `gcid` (`gcid`)
-- TABLE gcontact
--
CREATE TABLE IF NOT EXISTS `gcontact` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
- `name` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `nick` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `url` varchar(255) NOT NULL DEFAULT '' COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
+ `name` varchar(255) NOT NULL DEFAULT '' COMMENT 'Name that this contact is known by',
+ `nick` varchar(255) NOT NULL DEFAULT '' COMMENT 'Nick- and user name of the contact',
+ `url` varchar(255) NOT NULL DEFAULT '' COMMENT 'Link to the contacts profile page',
`nurl` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `photo` varchar(255) NOT NULL DEFAULT '' COMMENT '',
+ `photo` varchar(255) NOT NULL DEFAULT '' COMMENT 'Link to the profile photo',
`connect` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
`updated` datetime DEFAULT '0001-01-01 00:00:00' COMMENT '',
`last_failure` datetime DEFAULT '0001-01-01 00:00:00' COMMENT '',
`location` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`about` text COMMENT '',
- `keywords` text COMMENT '',
+ `keywords` text COMMENT 'puplic keywords (interests)',
`gender` varchar(32) NOT NULL DEFAULT '' COMMENT '',
`birthday` varchar(32) NOT NULL DEFAULT '0001-01-01' COMMENT '',
- `community` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `community` boolean NOT NULL DEFAULT '0' COMMENT '1 if contact is forum account',
`contact-type` tinyint NOT NULL DEFAULT -1 COMMENT '',
- `hide` boolean NOT NULL DEFAULT '0' COMMENT '',
- `nsfw` boolean NOT NULL DEFAULT '0' COMMENT '',
- `network` char(4) NOT NULL DEFAULT '' COMMENT '',
+ `hide` boolean NOT NULL DEFAULT '0' COMMENT '1 = should be hidden from search',
+ `nsfw` boolean NOT NULL DEFAULT '0' COMMENT '1 = contact posts nsfw content',
+ `network` char(4) NOT NULL DEFAULT '' COMMENT 'social network protocol',
`addr` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`notify` varchar(255) COMMENT '',
`alias` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`generation` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '',
- `server_url` varchar(255) NOT NULL DEFAULT '' COMMENT '',
+ `server_url` varchar(255) NOT NULL DEFAULT '' COMMENT 'baseurl of the contacts server',
PRIMARY KEY(`id`),
UNIQUE INDEX `nurl` (`nurl`(190)),
INDEX `name` (`name`(64)),
-- TABLE glink
--
CREATE TABLE IF NOT EXISTS `glink` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`cid` int unsigned NOT NULL DEFAULT 0 COMMENT '',
`uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
`gcid` int unsigned NOT NULL DEFAULT 0 COMMENT '',
-- TABLE group
--
CREATE TABLE IF NOT EXISTS `group` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
- `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
- `visible` boolean NOT NULL DEFAULT '0' COMMENT '',
- `deleted` boolean NOT NULL DEFAULT '0' COMMENT '',
- `name` varchar(255) NOT NULL DEFAULT '' COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
+ `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'Owner User id',
+ `visible` boolean NOT NULL DEFAULT '0' COMMENT '1 indicates the member list is not private',
+ `deleted` boolean NOT NULL DEFAULT '0' COMMENT '1 indicates the group has been deleted',
+ `name` varchar(255) NOT NULL DEFAULT '' COMMENT 'human readable name of group',
PRIMARY KEY(`id`),
INDEX `uid` (`uid`)
) DEFAULT COLLATE utf8mb4_general_ci;
-- TABLE group_member
--
CREATE TABLE IF NOT EXISTS `group_member` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
- `gid` int unsigned NOT NULL DEFAULT 0 COMMENT '',
- `contact-id` int unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
+ `gid` int unsigned NOT NULL DEFAULT 0 COMMENT 'groups.id of the associated group',
+ `contact-id` int unsigned NOT NULL DEFAULT 0 COMMENT 'contact.id of the member assigned to the associated group',
PRIMARY KEY(`id`),
INDEX `contactid` (`contact-id`),
UNIQUE INDEX `gid_contactid` (`gid`,`contact-id`)
-- TABLE gserver
--
CREATE TABLE IF NOT EXISTS `gserver` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`url` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`nurl` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`version` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`site_name` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`info` text COMMENT '',
`register_policy` tinyint NOT NULL DEFAULT 0 COMMENT '',
- `registered-users` int unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `registered-users` int unsigned NOT NULL DEFAULT 0 COMMENT 'Number of registered users',
`poco` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`noscrape` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`network` char(4) NOT NULL DEFAULT '' COMMENT '',
-- TABLE hook
--
CREATE TABLE IF NOT EXISTS `hook` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
- `hook` varbinary(100) NOT NULL DEFAULT '' COMMENT '',
- `file` varbinary(200) NOT NULL DEFAULT '' COMMENT '',
- `function` varbinary(200) NOT NULL DEFAULT '' COMMENT '',
- `priority` smallint unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
+ `hook` varbinary(100) NOT NULL DEFAULT '' COMMENT 'name of hook',
+ `file` varbinary(200) NOT NULL DEFAULT '' COMMENT 'relative filename of hook handler',
+ `function` varbinary(200) NOT NULL DEFAULT '' COMMENT 'function name of hook handler',
+ `priority` smallint unsigned NOT NULL DEFAULT 0 COMMENT 'not yet implemented - can be used to sort conflicts in hook handling by calling handlers in priority order',
PRIMARY KEY(`id`),
UNIQUE INDEX `hook_file_function` (`hook`,`file`,`function`)
) DEFAULT COLLATE utf8mb4_general_ci;
-- TABLE intro
--
CREATE TABLE IF NOT EXISTS `intro` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
`fid` int unsigned NOT NULL DEFAULT 0 COMMENT '',
`contact-id` int unsigned NOT NULL DEFAULT 0 COMMENT '',
--
CREATE TABLE IF NOT EXISTS `item` (
`id` int unsigned NOT NULL auto_increment,
- `guid` varchar(255) NOT NULL DEFAULT '' COMMENT '',
+ `guid` varchar(255) NOT NULL DEFAULT '' COMMENT 'A unique identifier for this item',
`uri` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
- `contact-id` int unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'Owner id which owns this copy of the item',
+ `contact-id` int unsigned NOT NULL DEFAULT 0 COMMENT 'contact.id',
`type` varchar(20) NOT NULL DEFAULT '' COMMENT '',
- `wall` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `wall` boolean NOT NULL DEFAULT '0' COMMENT 'This item was posted to the wall of uid',
`gravity` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '',
- `parent` int unsigned NOT NULL DEFAULT 0 COMMENT '',
- `parent-uri` varchar(255) NOT NULL DEFAULT '' COMMENT '',
+ `parent` int unsigned NOT NULL DEFAULT 0 COMMENT 'item.id of the parent to this item if it is a reply of some form; otherwise this must be set to the id of this item',
+ `parent-uri` varchar(255) NOT NULL DEFAULT '' COMMENT 'uri of the parent to this item',
`extid` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `thr-parent` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `edited` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `commented` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `received` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `changed` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `owner-id` int unsigned NOT NULL DEFAULT 0 COMMENT '',
- `owner-name` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `owner-link` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `owner-avatar` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `author-id` int unsigned NOT NULL DEFAULT 0 COMMENT '',
- `author-name` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `author-link` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `author-avatar` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `title` varchar(255) NOT NULL DEFAULT '' COMMENT '',
+ `thr-parent` varchar(255) NOT NULL DEFAULT '' COMMENT 'If the parent of this item is not the top-level item in the conversation, the uri of the immediate parent; otherwise set to parent-uri',
+ `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'Creation timestamp.',
+ `edited` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'Date of last edit (default is created)',
+ `commented` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'Date of last comment/reply to this item',
+ `received` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'datetime',
+ `changed` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'Date that something in the conversation changed, indicating clients should fetch the conversation again',
+ `owner-id` int unsigned NOT NULL DEFAULT 0 COMMENT 'Link to the contact table with uid=0 of the owner of this item',
+ `owner-name` varchar(255) NOT NULL DEFAULT '' COMMENT 'Name of the owner of this item',
+ `owner-link` varchar(255) NOT NULL DEFAULT '' COMMENT 'Link to the profile page of the owner of this item',
+ `owner-avatar` varchar(255) NOT NULL DEFAULT '' COMMENT 'Link to the avatar picture of the owner of this item',
+ `author-id` int unsigned NOT NULL DEFAULT 0 COMMENT 'Link to the contact table with uid=0 of the author of this item',
+ `author-name` varchar(255) NOT NULL DEFAULT '' COMMENT 'Name of the author of this item',
+ `author-link` varchar(255) NOT NULL DEFAULT '' COMMENT 'Link to the profile page of the author of this item',
+ `author-avatar` varchar(255) NOT NULL DEFAULT '' COMMENT 'Link to the avatar picture of the author of this item',
+ `title` varchar(255) NOT NULL DEFAULT '' COMMENT 'item title',
`content-warning` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `body` mediumtext COMMENT '',
- `app` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `verb` varchar(100) NOT NULL DEFAULT '' COMMENT '',
- `object-type` varchar(100) NOT NULL DEFAULT '' COMMENT '',
- `object` text COMMENT '',
- `target-type` varchar(100) NOT NULL DEFAULT '' COMMENT '',
- `target` text COMMENT '',
- `postopts` text COMMENT '',
- `plink` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `resource-id` varchar(32) NOT NULL DEFAULT '' COMMENT '',
- `event-id` int unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `body` mediumtext COMMENT 'item body content',
+ `app` varchar(255) NOT NULL DEFAULT '' COMMENT 'application which generated this item',
+ `verb` varchar(100) NOT NULL DEFAULT '' COMMENT 'ActivityStreams verb',
+ `object-type` varchar(100) NOT NULL DEFAULT '' COMMENT 'ActivityStreams object type',
+ `object` text COMMENT 'JSON encoded object structure unless it is an implied object (normal post)',
+ `target-type` varchar(100) NOT NULL DEFAULT '' COMMENT 'ActivityStreams target type if applicable (URI)',
+ `target` text COMMENT 'JSON encoded target structure if used',
+ `postopts` text COMMENT 'External post connectors add their network name to this comma-separated string to identify that they should be delivered to these networks during delivery',
+ `plink` varchar(255) NOT NULL DEFAULT '' COMMENT 'permalink or URL toa displayable copy of the message at its source',
+ `resource-id` varchar(32) NOT NULL DEFAULT '' COMMENT 'Used to link other tables to items, it identifies the linked resource (e.g. photo) and if set must also set resource_type',
+ `event-id` int unsigned NOT NULL DEFAULT 0 COMMENT 'Used to link to the event.id',
`tag` mediumtext COMMENT '',
- `attach` mediumtext COMMENT '',
+ `attach` mediumtext COMMENT 'JSON structure representing attachments to this item',
`inform` mediumtext COMMENT '',
`file` mediumtext COMMENT '',
- `location` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `coord` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `allow_cid` mediumtext COMMENT '',
- `allow_gid` mediumtext COMMENT '',
- `deny_cid` mediumtext COMMENT '',
- `deny_gid` mediumtext COMMENT '',
- `private` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `location` varchar(255) NOT NULL DEFAULT '' COMMENT 'text location where this item originated',
+ `coord` varchar(255) NOT NULL DEFAULT '' COMMENT 'longitude/latitude pair representing location where this item originated',
+ `allow_cid` mediumtext COMMENT 'Access Control - list of allowed contact.id \'<19><78>\'',
+ `allow_gid` mediumtext COMMENT 'Access Control - list of allowed groups',
+ `deny_cid` mediumtext COMMENT 'Access Control - list of denied contact.id',
+ `deny_gid` mediumtext COMMENT 'Access Control - list of denied groups',
+ `private` boolean NOT NULL DEFAULT '0' COMMENT 'distribution is restricted',
`pubmail` boolean NOT NULL DEFAULT '0' COMMENT '',
`moderated` boolean NOT NULL DEFAULT '0' COMMENT '',
`visible` boolean NOT NULL DEFAULT '0' COMMENT '',
`spam` boolean NOT NULL DEFAULT '0' COMMENT '',
- `starred` boolean NOT NULL DEFAULT '0' COMMENT '',
- `bookmark` boolean NOT NULL DEFAULT '0' COMMENT '',
- `unseen` boolean NOT NULL DEFAULT '1' COMMENT '',
- `deleted` boolean NOT NULL DEFAULT '0' COMMENT '',
- `origin` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `starred` boolean NOT NULL DEFAULT '0' COMMENT 'item has been favourited',
+ `bookmark` boolean NOT NULL DEFAULT '0' COMMENT 'item has been bookmarked',
+ `unseen` boolean NOT NULL DEFAULT '1' COMMENT 'item has not been seen',
+ `deleted` boolean NOT NULL DEFAULT '0' COMMENT 'item has been deleted',
+ `origin` boolean NOT NULL DEFAULT '0' COMMENT 'item originated at this site',
`forum_mode` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '',
- `mention` boolean NOT NULL DEFAULT '0' COMMENT '',
- `network` char(4) NOT NULL DEFAULT '' COMMENT '',
+ `mention` boolean NOT NULL DEFAULT '0' COMMENT 'The owner of this item was mentioned in it',
+ `network` char(4) NOT NULL DEFAULT '' COMMENT 'Network from where the item comes from',
`rendered-hash` varchar(32) NOT NULL DEFAULT '' COMMENT '',
- `rendered-html` mediumtext COMMENT '',
+ `rendered-html` mediumtext COMMENT 'item.body converted to html',
`global` boolean NOT NULL DEFAULT '0' COMMENT '',
PRIMARY KEY(`id`),
INDEX `guid` (`guid`(191)),
-- TABLE locks
--
CREATE TABLE IF NOT EXISTS `locks` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`name` varchar(128) NOT NULL DEFAULT '' COMMENT '',
`locked` boolean NOT NULL DEFAULT '0' COMMENT '',
- `pid` int unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `pid` int unsigned NOT NULL DEFAULT 0 COMMENT 'Process ID',
PRIMARY KEY(`id`)
) DEFAULT COLLATE utf8mb4_general_ci;
-- TABLE mail
--
CREATE TABLE IF NOT EXISTS `mail` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
- `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
- `guid` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `from-name` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `from-photo` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `from-url` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `contact-id` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `convid` int unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
+ `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'Owner User id',
+ `guid` varchar(255) NOT NULL DEFAULT '' COMMENT 'A unique identifier for this private message',
+ `from-name` varchar(255) NOT NULL DEFAULT '' COMMENT 'name of the sender',
+ `from-photo` varchar(255) NOT NULL DEFAULT '' COMMENT 'contact photo link of the sender',
+ `from-url` varchar(255) NOT NULL DEFAULT '' COMMENT 'profile linke of the sender',
+ `contact-id` varchar(255) NOT NULL DEFAULT '' COMMENT 'contact.id',
+ `convid` int unsigned NOT NULL DEFAULT 0 COMMENT 'conv.id',
`title` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`body` mediumtext COMMENT '',
- `seen` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `seen` boolean NOT NULL DEFAULT '0' COMMENT 'if message visited it is 1',
`reply` boolean NOT NULL DEFAULT '0' COMMENT '',
`replied` boolean NOT NULL DEFAULT '0' COMMENT '',
- `unknown` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `unknown` boolean NOT NULL DEFAULT '0' COMMENT 'if sender not in the contact table this is 1',
`uri` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`parent-uri` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
+ `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'creation time of the private message',
PRIMARY KEY(`id`),
INDEX `uid_seen` (`uid`,`seen`),
INDEX `convid` (`convid`),
-- TABLE mailacct
--
CREATE TABLE IF NOT EXISTS `mailacct` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
`server` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`port` smallint unsigned NOT NULL DEFAULT 0 COMMENT '',
-- TABLE manage
--
CREATE TABLE IF NOT EXISTS `manage` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
`mid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
PRIMARY KEY(`id`),
-- TABLE notify
--
CREATE TABLE IF NOT EXISTS `notify` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`hash` varchar(64) NOT NULL DEFAULT '' COMMENT '',
`type` smallint unsigned NOT NULL DEFAULT 0 COMMENT '',
`name` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`photo` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`date` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
`msg` mediumtext COMMENT '',
- `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
+ `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'Owner User id',
`link` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `iid` int unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `iid` int unsigned NOT NULL DEFAULT 0 COMMENT 'item.id',
`parent` int unsigned NOT NULL DEFAULT 0 COMMENT '',
`seen` boolean NOT NULL DEFAULT '0' COMMENT '',
`verb` varchar(100) NOT NULL DEFAULT '' COMMENT '',
`otype` varchar(10) NOT NULL DEFAULT '' COMMENT '',
- `name_cache` tinytext COMMENT '',
- `msg_cache` mediumtext COMMENT '',
+ `name_cache` tinytext COMMENT 'Cached bbcode parsing of name',
+ `msg_cache` mediumtext COMMENT 'Cached bbcode parsing of msg',
PRIMARY KEY(`id`),
INDEX `hash_uid` (`hash`,`uid`),
INDEX `seen_uid_date` (`seen`,`uid`,`date`),
-- TABLE notify-threads
--
CREATE TABLE IF NOT EXISTS `notify-threads` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`notify-id` int unsigned NOT NULL DEFAULT 0 COMMENT '',
`master-parent-item` int unsigned NOT NULL DEFAULT 0 COMMENT '',
`parent-item` int unsigned NOT NULL DEFAULT 0 COMMENT '',
-- TABLE oembed
--
CREATE TABLE IF NOT EXISTS `oembed` (
- `url` varbinary(255) NOT NULL COMMENT '',
- `maxwidth` mediumint unsigned NOT NULL COMMENT '',
- `content` mediumtext COMMENT '',
- `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
+ `url` varbinary(255) NOT NULL COMMENT 'page url',
+ `maxwidth` mediumint unsigned NOT NULL COMMENT 'Maximum width passed to Oembed',
+ `content` mediumtext COMMENT 'OEmbed data of the page',
+ `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'datetime of creation',
PRIMARY KEY(`url`,`maxwidth`),
INDEX `created` (`created`)
) DEFAULT COLLATE utf8mb4_general_ci;
-- TABLE parsed_url
--
CREATE TABLE IF NOT EXISTS `parsed_url` (
- `url` varbinary(255) NOT NULL COMMENT '',
- `guessing` boolean NOT NULL DEFAULT '0' COMMENT '',
- `oembed` boolean NOT NULL DEFAULT '0' COMMENT '',
- `content` mediumtext COMMENT '',
- `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
+ `url` varbinary(255) NOT NULL COMMENT 'page url',
+ `guessing` boolean NOT NULL DEFAULT '0' COMMENT 'is the \'guessing\' mode active?',
+ `oembed` boolean NOT NULL DEFAULT '0' COMMENT 'is the data the result of oembed?',
+ `content` mediumtext COMMENT 'page data',
+ `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'datetime of creation',
PRIMARY KEY(`url`,`guessing`,`oembed`),
INDEX `created` (`created`)
) DEFAULT COLLATE utf8mb4_general_ci;
-- TABLE photo
--
CREATE TABLE IF NOT EXISTS `photo` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
- `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
- `contact-id` int unsigned NOT NULL DEFAULT 0 COMMENT '',
- `guid` char(16) NOT NULL DEFAULT '' COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
+ `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'Owner User id',
+ `contact-id` int unsigned NOT NULL DEFAULT 0 COMMENT 'contact.id',
+ `guid` char(16) NOT NULL DEFAULT '' COMMENT 'A unique identifier for this photo',
`resource-id` char(32) NOT NULL DEFAULT '' COMMENT '',
- `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `edited` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
+ `created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'creation date',
+ `edited` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'last edited date',
`title` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`desc` text COMMENT '',
- `album` varchar(255) NOT NULL DEFAULT '' COMMENT '',
+ `album` varchar(255) NOT NULL DEFAULT '' COMMENT 'The name of the album to which the photo belongs',
`filename` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`type` varchar(30) NOT NULL DEFAULT 'image/jpeg',
`height` smallint unsigned NOT NULL DEFAULT 0 COMMENT '',
`data` mediumblob NOT NULL COMMENT '',
`scale` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '',
`profile` boolean NOT NULL DEFAULT '0' COMMENT '',
- `allow_cid` mediumtext COMMENT '',
- `allow_gid` mediumtext COMMENT '',
- `deny_cid` mediumtext COMMENT '',
- `deny_gid` mediumtext COMMENT '',
+ `allow_cid` mediumtext COMMENT 'Access Control - list of allowed contact.id \'<19><78>\'',
+ `allow_gid` mediumtext COMMENT 'Access Control - list of allowed groups',
+ `deny_cid` mediumtext COMMENT 'Access Control - list of denied contact.id',
+ `deny_gid` mediumtext COMMENT 'Access Control - list of denied groups',
PRIMARY KEY(`id`),
INDEX `contactid` (`contact-id`),
INDEX `uid_contactid` (`uid`,`contact-id`),
-- TABLE poll_result
--
CREATE TABLE IF NOT EXISTS `poll_result` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`poll_id` int unsigned NOT NULL DEFAULT 0,
`choice` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '',
PRIMARY KEY(`id`),
-- TABLE profile
--
CREATE TABLE IF NOT EXISTS `profile` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
- `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
- `profile-name` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `is-default` boolean NOT NULL DEFAULT '0' COMMENT '',
- `hide-friends` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
+ `uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'Owner User id',
+ `profile-name` varchar(255) NOT NULL DEFAULT '' COMMENT 'Name of the profile',
+ `is-default` boolean NOT NULL DEFAULT '0' COMMENT 'Mark this profile as default profile',
+ `hide-friends` boolean NOT NULL DEFAULT '0' COMMENT 'Hide friend list from viewers of this profile',
`name` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `pdesc` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `dob` varchar(32) NOT NULL DEFAULT '0000-00-00' COMMENT '',
+ `pdesc` varchar(255) NOT NULL DEFAULT '' COMMENT 'Title or description',
+ `dob` varchar(32) NOT NULL DEFAULT '0000-00-00' COMMENT 'Day of birth',
`address` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`locality` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`region` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`xmpp` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`photo` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`thumb` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `publish` boolean NOT NULL DEFAULT '0' COMMENT '',
- `net-publish` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `publish` boolean NOT NULL DEFAULT '0' COMMENT 'publish default profile in local directory',
+ `net-publish` boolean NOT NULL DEFAULT '0' COMMENT 'publish profile in global directory',
PRIMARY KEY(`id`),
INDEX `uid_is-default` (`uid`,`is-default`)
) DEFAULT COLLATE utf8mb4_general_ci;
-- TABLE profile_check
--
CREATE TABLE IF NOT EXISTS `profile_check` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
- `cid` int unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `cid` int unsigned NOT NULL DEFAULT 0 COMMENT 'contact.id',
`dfrn_id` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`sec` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`expire` int unsigned NOT NULL DEFAULT 0 COMMENT '',
-- TABLE push_subscriber
--
CREATE TABLE IF NOT EXISTS `push_subscriber` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
`callback_url` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`topic` varchar(255) NOT NULL DEFAULT '' COMMENT '',
-- TABLE queue
--
CREATE TABLE IF NOT EXISTS `queue` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`cid` int unsigned NOT NULL DEFAULT 0 COMMENT 'Message receiver',
`network` char(4) NOT NULL DEFAULT '' COMMENT 'Receiver\'s network',
`guid` varchar(255) NOT NULL DEFAULT '' COMMENT 'Unique GUID of the message',
-- TABLE register
--
CREATE TABLE IF NOT EXISTS `register` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`hash` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
`uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
-- TABLE search
--
CREATE TABLE IF NOT EXISTS `search` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
`term` varchar(255) NOT NULL DEFAULT '' COMMENT '',
PRIMARY KEY(`id`),
-- TABLE session
--
CREATE TABLE IF NOT EXISTS `session` (
- `id` bigint unsigned NOT NULL auto_increment COMMENT '',
+ `id` bigint unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`sid` varbinary(255) NOT NULL DEFAULT '' COMMENT '',
`data` text COMMENT '',
`expire` int unsigned NOT NULL DEFAULT 0 COMMENT '',
-- TABLE sign
--
CREATE TABLE IF NOT EXISTS `sign` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
- `iid` int unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
+ `iid` int unsigned NOT NULL DEFAULT 0 COMMENT 'item.id',
`signed_text` mediumtext COMMENT '',
`signature` text COMMENT '',
`signer` varchar(255) NOT NULL DEFAULT '' COMMENT '',
-- TABLE thread
--
CREATE TABLE IF NOT EXISTS `thread` (
- `iid` int unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `iid` int unsigned NOT NULL DEFAULT 0 COMMENT 'sequential ID',
`uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'User id',
`contact-id` int unsigned NOT NULL DEFAULT 0 COMMENT '',
- `owner-id` int unsigned NOT NULL DEFAULT 0 COMMENT '',
- `author-id` int unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `owner-id` int unsigned NOT NULL DEFAULT 0 COMMENT 'Item owner',
+ `author-id` int unsigned NOT NULL DEFAULT 0 COMMENT 'Item author',
`created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
`edited` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
`commented` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
-- TABLE user
--
CREATE TABLE IF NOT EXISTS `user` (
- `uid` mediumint unsigned NOT NULL auto_increment COMMENT '',
+ `uid` mediumint unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`parent-uid` mediumint unsigned NOT NULL DEFAULT 0 COMMENT 'The parent user that has full control about this user',
- `guid` varchar(64) NOT NULL DEFAULT '' COMMENT '',
- `username` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `password` varchar(255) NOT NULL DEFAULT '' COMMENT '',
+ `guid` varchar(64) NOT NULL DEFAULT '' COMMENT 'A unique identifier for this user',
+ `username` varchar(255) NOT NULL DEFAULT '' COMMENT 'Name that this user is known by',
+ `password` varchar(255) NOT NULL DEFAULT '' COMMENT 'encrypted password',
`legacy_password` boolean NOT NULL DEFAULT '0' COMMENT 'Is the password hash double-hashed?',
- `nickname` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `email` varchar(255) NOT NULL DEFAULT '' COMMENT '',
+ `nickname` varchar(255) NOT NULL DEFAULT '' COMMENT 'nick- and user name',
+ `email` varchar(255) NOT NULL DEFAULT '' COMMENT 'the users email address',
`openid` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `timezone` varchar(128) NOT NULL DEFAULT '' COMMENT '',
- `language` varchar(32) NOT NULL DEFAULT 'en' COMMENT '',
- `register_date` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `login_date` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `default-location` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `allow_location` boolean NOT NULL DEFAULT '0' COMMENT '',
- `theme` varchar(255) NOT NULL DEFAULT '' COMMENT '',
- `pubkey` text COMMENT '',
- `prvkey` text COMMENT '',
+ `timezone` varchar(128) NOT NULL DEFAULT '' COMMENT 'PHP-legal timezone',
+ `language` varchar(32) NOT NULL DEFAULT 'en' COMMENT 'default language',
+ `register_date` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'timestamp of registration',
+ `login_date` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'timestamp of last login',
+ `default-location` varchar(255) NOT NULL DEFAULT '' COMMENT 'Default for item.location',
+ `allow_location` boolean NOT NULL DEFAULT '0' COMMENT '1 allows to display the location',
+ `theme` varchar(255) NOT NULL DEFAULT '' COMMENT 'user theme preference',
+ `pubkey` text COMMENT 'RSA public key 4096 bit',
+ `prvkey` text COMMENT 'RSA private key 4096 bit',
`spubkey` text COMMENT '',
`sprvkey` text COMMENT '',
- `verified` boolean NOT NULL DEFAULT '0' COMMENT '',
- `blocked` boolean NOT NULL DEFAULT '0' COMMENT '',
- `blockwall` boolean NOT NULL DEFAULT '0' COMMENT '',
- `hidewall` boolean NOT NULL DEFAULT '0' COMMENT '',
- `blocktags` boolean NOT NULL DEFAULT '0' COMMENT '',
- `unkmail` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `verified` boolean NOT NULL DEFAULT '0' COMMENT 'user is verified through email',
+ `blocked` boolean NOT NULL DEFAULT '0' COMMENT '1 for user is blocked',
+ `blockwall` boolean NOT NULL DEFAULT '0' COMMENT 'Prohibit contacts to post to the profile page of the user',
+ `hidewall` boolean NOT NULL DEFAULT '0' COMMENT 'Hide profile details from unkown viewers',
+ `blocktags` boolean NOT NULL DEFAULT '0' COMMENT 'Prohibit contacts to tag the post of this user',
+ `unkmail` boolean NOT NULL DEFAULT '0' COMMENT 'Permit unknown people to send private mails to this user',
`cntunkmail` int unsigned NOT NULL DEFAULT 10 COMMENT '',
- `notify-flags` smallint unsigned NOT NULL DEFAULT 65535 COMMENT '',
- `page-flags` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '',
+ `notify-flags` smallint unsigned NOT NULL DEFAULT 65535 COMMENT 'email notification options',
+ `page-flags` tinyint unsigned NOT NULL DEFAULT 0 COMMENT 'page/profile type',
`account-type` tinyint unsigned NOT NULL DEFAULT 0 COMMENT '',
`prvnets` boolean NOT NULL DEFAULT '0' COMMENT '',
`pwdreset` varchar(255) COMMENT 'Password reset request token',
`pwdreset_time` datetime COMMENT 'Timestamp of the last password reset request',
`maxreq` int unsigned NOT NULL DEFAULT 10 COMMENT '',
`expire` int unsigned NOT NULL DEFAULT 0 COMMENT '',
- `account_removed` boolean NOT NULL DEFAULT '0' COMMENT '',
+ `account_removed` boolean NOT NULL DEFAULT '0' COMMENT 'if 1 the account is removed',
`account_expired` boolean NOT NULL DEFAULT '0' COMMENT '',
- `account_expires_on` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
- `expire_notification_sent` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT '',
+ `account_expires_on` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'timestamp when account expires and will be deleted',
+ `expire_notification_sent` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'timestamp of last warning of account expiration',
`def_gid` int unsigned NOT NULL DEFAULT 0 COMMENT '',
- `allow_cid` mediumtext COMMENT '',
- `allow_gid` mediumtext COMMENT '',
- `deny_cid` mediumtext COMMENT '',
- `deny_gid` mediumtext COMMENT '',
+ `allow_cid` mediumtext COMMENT 'default permission for this user',
+ `allow_gid` mediumtext COMMENT 'default permission for this user',
+ `deny_cid` mediumtext COMMENT 'default permission for this user',
+ `deny_gid` mediumtext COMMENT 'default permission for this user',
`openidserver` text COMMENT '',
PRIMARY KEY(`uid`),
INDEX `nickname` (`nickname`(32))
-- TABLE userd
--
CREATE TABLE IF NOT EXISTS `userd` (
- `id` int unsigned NOT NULL auto_increment COMMENT '',
+ `id` int unsigned NOT NULL auto_increment COMMENT 'sequential ID',
`username` varchar(255) NOT NULL COMMENT '',
PRIMARY KEY(`id`),
INDEX `username` (`username`(32))
`created` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'Creation date',
`pid` int unsigned NOT NULL DEFAULT 0 COMMENT 'Process id of the worker',
`executed` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'Execution date',
- `done` boolean NOT NULL DEFAULT '0' COMMENT 'Marked when the task was done, will be deleted later',
+ `done` boolean NOT NULL DEFAULT '0' COMMENT 'Marked 1 when the task was done - will be deleted later',
PRIMARY KEY(`id`),
INDEX `pid` (`pid`),
INDEX `parameter` (`parameter`(64)),
projects / friendica.git / commitdiff