streams/doc
Habeas Codice 1a5a5c7edb PostgreSQL support initial commit
There were 11 main types of changes:
- UPDATE's and DELETE's sometimes had LIMIT 1 at the end of them. This is not only non-compliant but
it would certainly not do what whoever wrote it thought it would. It is likely this mistake was just
copied from Friendica. All of these instances, the LIMIT 1 was simply removed.
- Bitwise operations (and even some non-zero int checks) erroneously rely on MySQL implicit
integer-boolean conversion in the WHERE clauses. This is non-compliant (and bad programming practice
to boot). Proper explicit boolean conversions were added. New queries should use proper conventions.
- MySQL has a different operator for bitwise XOR than postgres. Rather than add yet another dba_
func, I converted them to "& ~" ("AND NOT") when turning off, and "|" ("OR") when turning on. There
were no true toggles (XOR). New queries should refrain from using XOR when not necessary.
- There are several fields which the schema has marked as NOT NULL, but the inserts don't specify
them. The reason this works is because mysql totally ignores the constraint and adds an empty text
default automatically. Again, non-compliant, obviously. In these cases a default of empty text was
added.
- Several statements rely on a non-standard MySQL feature
(http://dev.mysql.com/doc/refman/5.5/en/group-by-handling.html). These queries can all be rewritten
to be standards compliant. Interestingly enough, the newly rewritten standards compliant queries run
a zillion times faster, even on MySQL.
- A couple of function/operator name translations were needed (RAND/RANDOM, GROUP_CONCAT/STRING_AGG,
UTC_NOW, REGEXP/~, ^/#) -- assist functions added in the dba_
- INTERVALs: postgres requires quotes around the value, mysql requires that there are not quotes
around the value -- assist functions added in the dba_
- NULL_DATE's -- Postgres does not allow the invalid date '0000-00-00 00:00:00' (there is no such
thing as year 0 or month 0 or day 0). We use '0001-01-01 00:00:00' for postgres. Conversions are
handled in Zot/item packets automagically by quoting all dates with dbescdate().
- char(##) specifications in the schema creates fields with blank spaces that aren't trimmed in the
code. MySQL apparently treats char(##) as varchar(##), again, non-compliant. Since postgres works
better with text fields anyway, this ball of bugs was simply side-stepped by using 'text' datatype
for all text fields in the postgres schema. varchar was used in a couple of places where it actually
seemed appropriate (size constraint), but without rigorously vetting that all of the PHP code
actually validates data, new bugs might come out from under the rug.
- postgres doesn't store nul bytes and a few other non-printables in text fields, even when quoted.
bytea fields were used when storing binary data (photo.data, attach.data). A new dbescbin() function
was added to handle this transparently.
- postgres does not support LIMIT #,# syntax. All databases support LIMIT # OFFSET # syntax.
Statements were updated to be standard.

These changes require corresponding changes in the coding standards. Please review those before
adding any code going forward.

Still on my TODO list:
- remove quotes from non-reserved identifiers and make reserved identifiers use dba func for quoting
- Rewrite search queries for better results (both MySQL and Postgres)
2014-11-13 12:21:58 -08:00
..
de update to German help 2014-10-24 17:08:50 +02:00
html doc updates 2014-11-01 00:36:01 -07:00
install lighttpd sample conf security enhancement 2014-10-16 22:52:28 +02:00
macros correction to addon footer 2014-10-24 17:09:37 +02:00
nb-no Removed docs that were not translated 2014-06-24 20:51:22 +02:00
about.bb merge madness 2014-10-19 16:12:05 -07:00
account_basics.bb merge madness 2014-10-19 16:12:05 -07:00
accounts.bb merge madness 2014-10-19 16:12:05 -07:00
accounts_profiles_channels_basics.bb merge madness 2014-10-19 16:12:05 -07:00
addons.bb merge madness 2014-10-19 16:12:05 -07:00
addons_gnusocial.bb merge madness 2014-10-19 16:12:05 -07:00
AdvancedSearch.md merge madness 2014-10-19 16:12:05 -07:00
api_functions.bb merge madness 2014-10-19 16:12:05 -07:00
api_posting.bb api_posting.bb is a new doco file that explains posting to the redmatrix from an external program by exampple of command line tool curl 2014-08-16 13:13:57 +02:00
bbcode.html merge madness 2014-10-19 16:12:05 -07:00
campaign.bb merge madness 2014-10-19 16:12:05 -07:00
channels.bb merge madness 2014-10-19 16:12:05 -07:00
checking_account_quota_usage.bb merge madness 2014-10-19 16:12:05 -07:00
cloud.bb merge madness 2014-10-19 16:12:05 -07:00
cloud_desktop_clients.bb merge madness 2014-10-19 16:12:05 -07:00
comanche.bb merge madness 2014-10-19 16:12:05 -07:00
Comanche.md doc updates 2014-05-14 18:21:43 -07:00
connecting_to_channels.bb merge madness 2014-10-19 16:12:05 -07:00
connecting_to_channels.md Update documentation on connecting to channels and on documentation. 2014-04-04 19:31:48 -03:00
Creating-Templates.md first draft of creating templates documentation 2014-03-01 17:44:18 -08:00
credits.bb merge madness 2014-10-19 16:12:05 -07:00
dav_dolphin.bb merge madness 2014-10-19 16:12:05 -07:00
dav_konqueror.bb merge madness 2014-10-19 16:12:05 -07:00
dav_mount.bb merge madness 2014-10-19 16:12:05 -07:00
dav_nautilus.bb merge madness 2014-10-19 16:12:05 -07:00
dav_nemo.bb merge madness 2014-10-19 16:12:05 -07:00
dav_windows.bb merge madness 2014-10-19 16:12:05 -07:00
debian_install.bb Debian doco - no longer uses dropbear. 2014-10-31 01:13:56 +00:00
DerivedTheme1.md HOWTO create a derived theme lesson 1. Do not attempt to do anything more complicated until you have successfully completed this exercise. 2014-03-08 21:13:42 -08:00
dev-function-overview.md merge madness 2014-10-19 16:12:05 -07:00
developer_function_primer.bb Doco - politics, unwritten pages, links, and stuff. Nothing major. 2014-10-22 23:13:17 +01:00
developers.bb PostgreSQL support initial commit 2014-11-13 12:21:58 -08:00
Developers.md put translate README into help docs 2013-10-18 15:57:10 -07:00
diaspora_compat.md fix url mismatches of a single trailing slash for feed author/owner comparisons; update diaspora_compat 2014-09-23 20:55:22 -07:00
encryption.bb Tidied the folder from old backups 2014-06-29 21:07:42 +02:00
external-resource-links.bb merge madness 2014-10-19 16:12:05 -07:00
extra_features.bb merge madness 2014-10-19 16:12:05 -07:00
faq_admins.bb Doco - politics, unwritten pages, links, and stuff. Nothing major. 2014-10-22 23:13:17 +01:00
faq_developers.bb merge madness 2014-10-19 16:12:05 -07:00
faq_members.bb merge madness 2014-10-19 16:12:05 -07:00
features.bb merge madness 2014-10-19 16:12:05 -07:00
Features.md comanchify the savedsearch widget 2013-12-09 21:20:55 -08:00
first-post.bb Tidied the folder from old backups 2014-06-29 21:07:42 +02:00
git_for_non_developers.bb merge madness 2014-10-19 16:12:05 -07:00
hidden_configs.bb merge madness 2014-10-19 16:12:05 -07:00
Hooks.md merge madness 2014-10-19 16:12:05 -07:00
install.bb merge madness 2014-10-19 16:12:05 -07:00
intro_for_developers.bb merge madness 2014-10-19 16:12:05 -07:00
main.bb Merge branch 'master' of https://github.com/friendica/red 2014-10-27 15:06:34 +00:00
nomadic-identity.bb Tidied the folder from old backups 2014-06-29 21:07:42 +02:00
permissions.bb merge madness 2014-10-19 16:12:05 -07:00
plugins.bb merge madness 2014-10-19 16:12:05 -07:00
Plugins.md missing ' 2014-08-31 21:25:33 +02:00
Privacy.md update nl + Terms of Service more prominent in the help files. 2014-10-27 15:05:59 +00:00
problems-following-an-update.bb merge madness 2014-10-19 16:12:05 -07:00
profiles.bb merge madness 2014-10-19 16:12:05 -07:00
README.md updated README 2014-05-30 15:52:40 -07:00
red2pi.bb Doco - politics, unwritten pages, links, and stuff. Nothing major. 2014-10-22 23:13:17 +01:00
registration.bb update nl + Terms of Service more prominent in the help files. 2014-10-27 15:05:59 +00:00
Remove-Account.md wordsmithing 2013-11-18 19:02:38 -08:00
remove_account.bb merge madness 2014-10-19 16:12:05 -07:00
roles.md add "repository" permissions role and make sure we have a sane "accept" default for the custom role. 2014-10-27 16:19:30 -07:00
Schema-development.md There was one small typo - and I'm trying with great difficulty not to use the word "user" to refer to site members - especially in public documentation. In dev forums is another matter. It does exist in function names and the string "username" isn't considered derogatory, but most other times it's considered derogatory to site members. Channel is often another acceptable replacement. 2013-11-21 14:51:12 -08:00
schema_development.bb merge madness 2014-10-19 16:12:05 -07:00
sql_conventions.bb PostgreSQL support initial commit 2014-11-13 12:21:58 -08:00
Tags-and-Mentions.md some doc updates 2014-01-08 20:20:15 -08:00
tags_and_mentions.bb merge madness 2014-10-19 16:12:05 -07:00
TermsOfService.md Doc - Make TOS include work. 2014-02-01 11:55:36 +00:00
to_do_code.bb the to-do list is getting longer again. 2014-10-24 14:31:21 -07:00
to_do_doco.bb Some doco work. Changed main.bb and added a return link to all .bb files and began planning new entries for user orientated documentation. 2014-06-29 18:32:40 +02:00
to_do_doco.md Update documentation on connecting to channels and on documentation. 2014-04-04 19:31:48 -03:00
Translations.md fix location of string file in Translations.md, fix some permissions and owner vagueness (potential bugs) in profile_tabs() 2014-01-21 23:09:33 -08:00
troubleshooting.bb Doco - politics, unwritten pages, links, and stuff. Nothing major. 2014-10-22 23:13:17 +01:00
webpages.bb merge madness 2014-10-19 16:12:05 -07:00
Webpages.md Comanche documentation and some cleanup of layout page (including link to doco) and a few other webpage related cleanups 2013-10-28 17:48:42 -07:00
what_is_zot.bb merge madness 2014-10-19 16:12:05 -07:00
Widgets.md add photo widget 2014-05-13 21:33:39 -07:00
Zot---A-High-Level-Overview.md move some zot doco to our doc area and start on zot_structures 2014-05-26 16:38:39 -07:00
zot.md Some doco work. Changed main.bb and added a return link to all .bb files and began planning new entries for user orientated documentation. 2014-06-29 18:32:40 +02:00
zot_structures.md move some zot doco to our doc area and start on zot_structures 2014-05-26 16:38:39 -07:00

the Red Matrix

The RedMatrix (aka "red") is an open source webapp platform providing a complete decentralised publishing, sharing, and communications system. It combines communications (private messaging, chat and social networking), and media management (photos, events, files, web pages, app distribution) with enough features to make your head spin.

What makes the RedMatrix unique is what we call "magic authentication" - which is based on our groundbreaking work in decentralised identity services. This ties all RedMatrix sites and channels together into a single super-network where the boundaries between different websites are blurred or seemingly non-existent; where "who you are" has nothing to do with "what computer you're connected to", and where website content can adapt itself according to who is viewing it.

Warning: After experiencing magic authentication and nomadic identity, you may find it disconcerting and a bit "primitive" to go back to the old internet. You shouldn't need hundreds of different passwords to use the web ... or be totally isolated from your friends and family because a server or router in another country is having "issues".

For the average person, the biggest advantage of decentralised identity is that you decide who you want to share your stuff with, and if somebody isn't on your list, they're not going to see it. It's all under your control (we're big on privacy). Use the RedMatrix as a social network or a business website or for personal cloud storage or media publishing - or any number of other uses; limited only by your imagination.

The Red Matrix is free and open source distributed under the MIT license.