Compare commits

...
Sign in to create a new pull request.

210 commits

Author SHA1 Message Date
Philipp
5e407ba2b0
Merge pull request #15356 from annando/features
Small fixes to PR 15284
2025-12-28 11:33:09 +01:00
05bbee9c27 Small fixes to PR 15284 2025-12-26 19:37:54 +00:00
Michael Vogel
cbb628b055
Merge pull request #15284 from randompenguin1/2025.07-rc
Sortable Widgets and Timelines
2025-12-26 09:18:52 +01:00
Random Penguin
1a1d3c088b
Fix for top menu tabs with custom channels
With custom channels the array key does not match the tab code string so now it checks for a match against either.
2025-12-25 20:49:00 -06:00
Marcus Funch
363a35d180 Messages, code style 2025-12-24 17:18:12 +01:00
Random Penguin
9ee88721c7 (bool)$v changed to just $v 2025-12-24 17:16:12 +01:00
Random Penguin
e027aa46f9 fixed css so reset checkbox field does not adopt sortable list styling 2025-12-24 17:16:12 +01:00
Random Penguin
8da2af6b82 reset checkbox now uses checkbox template 2025-12-24 17:16:12 +01:00
Random Penguin
da71e2b0ce added template variable for sort key check against constant string 2025-12-24 17:16:12 +01:00
Random Penguin
894e36cea5 Update features.tpl
Changed so reset checkbox uses checkbox template.
$key is now checked against a constant instead of string
2025-12-24 17:16:12 +01:00
Random Penguin
3fbb884b81 Update Features.php
* switched key name substring check to $key variable
* added template variables for reset checkbox
2025-12-24 17:16:12 +01:00
Random Penguin
dd4635b847 reset checkboxes now use checkbox template 2025-12-24 17:16:12 +01:00
Random Penguin
57a49985be changed reset checkboxes to use checkbox template 2025-12-24 17:16:12 +01:00
Random Penguin
4e32c35773 Update Display.php
Added missing sortable list processing.

Switched template vars so resets now use checkbox template.
2025-12-24 17:16:12 +01:00
Marcus Funch
f0333f52b9 Update messages, code style 2025-12-24 17:16:11 +01:00
Marcus Funch
121f6fbde7 Adjustments after review 2025-12-24 17:14:32 +01:00
Marcus Funch
cb197dafcc Use constants from Feature.php 2025-12-24 17:14:32 +01:00
Random Penguin
099b858f10 Removed link loading global.css for each notification
global.css is _already_ loaded in the page head. Loading it over and over again with each notification item overrrides theme styling on the /notifications/system page, which messes up the styling of the Notifications drop-down under the bell icon too (but only on this page). Affects ALL themes because currently *none* of them include an override for this template.
2025-12-24 17:14:32 +01:00
Random Penguin
6cb63233cd added empty div fix
Makes sure last item in sortable widgets list has rounded bottom corners. Makes sure any floated elements above it get cleared.
2025-12-24 17:14:32 +01:00
Random Penguin
0d9bb703e3 :last-of-type to :nth-last-of-type(2)
:last-of-type would work if list was ul > li but it is div > div and :last-of-type goes by element not class
2025-12-24 17:14:32 +01:00
Random Penguin
40523d42fc code standards fixes 2025-12-24 17:14:32 +01:00
Random Penguin
cd4fd03896 fixed template array vars
accidentally added array items instead of editing values of existing ones.
2025-12-24 17:14:32 +01:00
Random Penguin
24ca3b7069 Changes for sortable widgets 2025-12-24 17:14:32 +01:00
Random Penguin
8dda4a97bb Scripts and styling for sortable lists 2025-12-24 17:14:32 +01:00
Random Penguin
60d94ed981 Changes for sortable widgets 2025-12-24 17:14:32 +01:00
Random Penguin
c8e2d3622f Sortable timelines
Swaps table for sortable lists
2025-12-24 17:14:32 +01:00
Random Penguin
43f229c251 Changes for sortable timelines 2025-12-24 17:14:31 +01:00
7e311148d6
Merge pull request #15343 from annando/remote-media
Config option to show or hide media for visitors
2025-12-24 11:30:03 +01:00
72b63da0b3 Config option to show or hide media for visitors 2025-12-24 10:15:26 +00:00
Michael Vogel
f7e0b5e71b
Merge pull request #15339 from Raroun/contact-blocklist-csv
Add CSV import/export for contact blocklist
2025-12-23 17:01:00 +01:00
Raroun
942c30ffb3
Merge branch '2025.07-rc' into contact-blocklist-csv 2025-12-23 11:22:54 +01:00
“Raroun”
7cf8ebf021 Limit export to federated protocols, remove DID handling 2025-12-23 11:12:12 +01:00
Michael Vogel
c211b81277
Merge pull request #15352 from mfxa/calendar_dropdown
Calendar dropdown adjustments and hover indication
2025-12-23 06:44:26 +01:00
Philipp
651b9b485e
Merge pull request #15347 from annando/issue-15344
Issue 15344: Fix contact suggestion
2025-12-21 01:03:02 +01:00
Michael Vogel
4737835640
Merge pull request #15351 from mfxa/photos_ux_ui_minor_improvements
Photos: Small UI/UX adjustments
2025-12-19 09:24:13 +01:00
Marcus Funch
3c8aff5f58 Photos: Minor UI/UX adjustments 2025-12-18 21:35:06 +01:00
Marcus Funch
d6cb3aae5f Calendar dropdown improvements and hover indication 2025-12-18 21:23:29 +01:00
0a95b91cc7 Update messages.po 2025-12-18 09:50:37 +01:00
“Raroun”
319b5948ef Add missing export route 2025-12-18 09:46:42 +01:00
“Raroun”
a10a6ca9f3 Use /export path instead of ?export=1 query parameter 2025-12-18 09:41:34 +01:00
“Raroun”
b3d96934c4 Rename Worker BlockFromCSV to BlockByUrl for broader use 2025-12-18 09:36:42 +01:00
668d29e90f Update messages.po again 2025-12-18 09:36:42 +01:00
Raroun
9c2ae9e941 Fix code style (binary_operator_spaces, line endings) 2025-12-18 09:36:42 +01:00
17574b52e5 Update messages.po 2025-12-18 09:36:42 +01:00
Raroun
669218175c Fix code style (binary_operator_spaces, line endings) 2025-12-18 09:36:42 +01:00
Raroun
c7c137fd27 Use worker for CSV import to avoid timeouts 2025-12-18 09:36:42 +01:00
8014c9b7a2 Update messages.po 2025-12-18 09:36:28 +01:00
Raroun
33a5a5375c Add async CSV import for contact blocklist 2025-12-18 09:36:09 +01:00
Raroun
97a04394a5 Add CSV import/export for contact blocklist 2025-12-18 09:36:09 +01:00
3e3f898f04 Issue 15344: Fix contact suggestion 2025-12-18 08:31:14 +00:00
Michael Vogel
3f38997424
Merge pull request #15309 from mfxa/frio_notifications_ui_view_all
Notifications: Add link to all (system) notification, UI adjustments (Frio)
2025-12-18 07:41:07 +01:00
Marcus Funch
d401a14ce0 Notifications: Further adjustments 2025-12-17 20:39:07 +01:00
Marcus Funch
2e19463cf6 Notifications: Adjustments for dark theme 2025-12-17 20:38:00 +01:00
Marcus Funch
fab1c7c41a Notifications: Add link to all, UI adjustments (Frio) 2025-12-17 20:38:00 +01:00
Michael Vogel
0800b67bab
Merge pull request #15336 from mfxa/update_notifications_ui
Update notifications view, make intros work better on small screens
2025-12-17 20:32:35 +01:00
Marcus Funch
f2e6ce3095 Update notifications view, make intros work better in mobile 2025-12-17 20:01:14 +01:00
Philipp
1d41a8e661
Merge pull request #15341 from annando/remote-media
Don't display remote media
2025-12-04 23:43:11 +01:00
c59e5e9886 Don't display remote media 2025-12-04 21:10:19 +00:00
Philipp
74cc48cab7
Merge pull request #15335 from annando/fix-fatal
Fix possible fatal error when fetching missing replies
2025-12-01 18:13:58 +01:00
376a9218a6 Fix possible fatal error when fetching missing replies 2025-12-01 16:59:44 +00:00
Philipp
ff58ecfd74
Merge pull request #15333 from annando/fep-044f
Issue 15096: Support for FEP-044f
2025-12-01 07:11:02 +01:00
fd8395a930 Issue 15096: Support for FEP-044f 2025-12-01 03:43:01 +00:00
Michael Vogel
2f0518a38c
Merge pull request #15334 from Raroun/post-published-alert
Show alert with link after posting instead of scrolling
2025-11-30 16:13:20 +01:00
5254f79d77 Show alert with link after posting instead of scrolling 2025-11-30 15:31:58 +01:00
Philipp
315f959d76
Merge pull request #15332 from Raroun/frio-reload-timeline
Show new posts immediately after posting
2025-11-27 17:49:39 +01:00
“Raroun”
6019a7c01a Show new posts immediately after posting 2025-11-27 12:39:52 +01:00
Philipp
61ab07d618
Merge pull request #15329 from annando/oembed-priority
Fetch oembed url from provider list first
2025-11-26 08:32:55 +01:00
Michael Vogel
c7eab73902
Merge pull request #15331 from randompenguin1/patch-2
file browser attachment icon size
2025-11-26 05:50:02 +01:00
Michael Vogel
e329cf50d6
Merge pull request #15330 from randompenguin1/patch-1
fix file browser icons
2025-11-26 05:48:49 +01:00
110a1f8ec5 Fetch oembed url from provider list first 2025-11-25 21:49:12 +00:00
Random Penguin
b6d81e94be
file browser attachment icon size
Sets file browser attachment icon size to 16x16 pixels rather than loading the 16x16 sized image so themes can override for other sizes.
2025-11-25 15:41:30 -06:00
Random Penguin
aba5f5392f
fix file browser icons
In the file browser when viewing attachments the icons are missing. This was due to a misplaced parenthesis and "icon" instead of "icons" (plural) in the image path. My change does not load the 16x16 pixel image but the 72x72, which IMO should then be scaled to the desired size in global.css, so it can be overridden in a theme stylesheet and not be stuck with a tiny image that is blurry if you make it bigger.

Despite my opinion that this feature either needs to be removed or the file manager finished so you can at least organize/delete files, and until that happens people should be discouraged from using it all, at the very least it should display the file type icons.
2025-11-25 15:37:42 -06:00
Michael Vogel
261cc5108d
Merge pull request #15327 from mfxa/frio_settings_restore_save
Settings: Restore save in the admin theme settings
2025-11-25 21:13:24 +01:00
Marcus Funch
48a0850a00 Settings: Restore save in the admin theme settings 2025-11-25 18:10:29 +01:00
Philipp
c3ff455c11
Merge pull request #15328 from annando/mails
Fix message transmission to Diaspora
2025-11-25 06:59:15 +01:00
ee05436788 Fix message transmission to Diaspora 2025-11-24 22:11:24 +00:00
Michael Vogel
97a36b7f5f
Merge pull request #15326 from mfxa/theme_selection_minor_adjustment_frio
Settings: Theme - Minor adjustment to accent colour selection
2025-11-24 18:09:22 +01:00
Marcus Funch
a8eba85b57 Settings: Theme - Minor adjustment to accent colour selection 2025-11-24 12:34:54 +01:00
Philipp
2c8fd2e758
Merge pull request #15299 from annando/known-media
Hide HLS video if it can't be loaded
2025-11-22 08:46:02 +01:00
Philipp
690e6fc5c8
Merge pull request #15317 from annando/issue-14850
Issue 14850: Fetch all posts of a thread
2025-11-22 08:22:36 +01:00
57a646b9ac Issue 14850: Fetch all posts of a thread 2025-11-21 23:14:17 +00:00
2576202459 Only add audio and video mimetypes 2025-11-21 18:29:29 +00:00
Philipp
6f8395f71e
Merge pull request #15322 from annando/issue-15321
Issue 15321: Fetch the latest posts from contacts
2025-11-21 08:00:33 +01:00
Philipp
2cbd1d2fb0
Merge pull request #15323 from annando/language-quality
Check for the language quality for subscribed tags
2025-11-21 07:58:17 +01:00
ae857ff98f Check for the language quality for subscribed tags 2025-11-20 06:13:38 +00:00
88440436b7 Issue 15321: Fetch the latest posts from contacts 2025-11-19 21:01:16 +00:00
Philipp
3ce6f51122
Merge pull request #15315 from mfxa/join_theme_sections_frio
Settings: Join theme sections + UI polish (frio)
2025-11-18 21:31:40 +01:00
Marcus Funch
4379da6c57 Settings: Theme - Switch to checkmark for choosing accent color 2025-11-16 15:52:52 +01:00
Marcus Funch
88fe1d166b Help.php: Also use ucFirst instead of mb_ucfirst as it's a recent PHP feature 2025-11-16 15:29:51 +01:00
Marcus Funch
461980a7c5 Settings: Theme - Final adjustments 2025-11-16 15:29:51 +01:00
Marcus Funch
0da8f08a00 Settings: Themes - Move away from the JS approach again 2025-11-15 18:57:33 +01:00
Marcus Funch
d355b0a425 Settings: Join theme sections, with UI adjustments (Frio) 2025-11-15 18:57:33 +01:00
Philipp
83aa88ba37
Merge pull request #15310 from annando/issue-15302
Issue 15302: Display link to profile page
2025-11-13 18:14:09 +01:00
Philipp
43493e5dd6
Merge pull request #15311 from annando/fixes
Fix some IDE warnings
2025-11-13 18:03:19 +01:00
Philipp
53f7ce4f66
Merge pull request #15296 from annando/mitra
Fix the processing of Mitra accounts
2025-11-13 08:32:02 +01:00
b7928a7f0c Issue 15302: Display link to profile page 2025-11-13 05:24:46 +00:00
01ba6bdf17 Fix some IDE warnings 2025-11-12 21:32:54 +00:00
Philipp
369c095eb0
Merge pull request #15308 from mfxa/more_sysmsg_notify_to_text_on_page
More sysmsg notifications -> text on page
2025-11-12 20:49:31 +01:00
Marcus Funch
1eb0c5287f More sysmsg notifications to text on page 2025-11-12 18:31:56 +01:00
Philipp
702f9c096e
Merge pull request #15294 from annando/issue-15291
Issue 15291: Fix numeric date formats
2025-11-10 00:13:53 +01:00
2d37a84fc0 Issue 15291: Fix numeric date formats 2025-11-09 20:12:33 +00:00
Philipp
177cf13d1b
Merge pull request #15298 from annando/issue-15128
Issue 15128: The maximum banner width can now be adjusted
2025-11-09 09:21:40 +01:00
Philipp
4c5cc9bcb5
Merge pull request #15297 from annando/issue-14723
Issue 14723: Fix empty post in Iceshrimp or Misskey
2025-11-09 09:19:55 +01:00
5a6dc1771c Fix the processing of Mitra accounts 2025-11-08 21:35:47 +00:00
Philipp
2a409ed985
Merge pull request #15295 from annando/event-timezone
Display the timezone at events
2025-11-08 22:23:44 +01:00
Philipp
21acaa11db
Merge pull request #15293 from annando/no-video
Improved detection of audio-only videos
2025-11-08 22:23:14 +01:00
c1b090df39 Issue 15128: The maximum banner width can now be adjusted 2025-11-08 20:30:16 +00:00
14c4d82b50 Issue 14723: Fix empty post in Iceshrimp or Misskey 2025-11-08 20:17:43 +00:00
77980625dd Display the timezone at events 2025-11-08 13:00:33 +00:00
ed3bd702ce Improved detection of audio-only videos 2025-11-08 09:39:50 +00:00
Philipp
eade8f33cd
Merge pull request #15290 from mfxa/docs_updates_v5
Docs: Move db docs to en/spec/database, use standard header formatting
2025-11-06 07:52:47 +01:00
Marcus Funch
f4cc6d3b60 Docs: Docs table formatting (Frio) 2025-11-05 23:17:36 +01:00
Marcus Funch
ee8e333e12 Docs: Use dashes in docs filenames to match convention 2025-11-05 14:18:25 +01:00
Marcus Funch
5cc7b87227 Docs: Remove db_host and db_conversation docs as those tables no longer exist 2025-11-05 14:05:45 +01:00
Marcus Funch
4fdf12606d Docs: Move database docs to en/spec/database, use standard header formatting 2025-11-04 20:16:11 +01:00
Philipp
3e5a8bc22a
Merge pull request #15282 from annando/drop-index
Fixes "Cannot drop index 'quote-uri-id'"
2025-11-03 18:53:29 +01:00
e7eec32dbf Fixes "Cannot drop index 'quote-uri-id'" 2025-11-03 14:07:52 +00:00
Philipp
79fac6afdf
Merge pull request #15277 from annando/issue-15100
Issue 15100: Increased summary field size
2025-11-03 12:14:00 +01:00
Philipp
d7759a9489
Merge pull request #15267 from annando/country-county
Further improvements to the list of countries and counties
2025-11-03 12:13:09 +01:00
Philipp
32a7fd6b21
Merge pull request #15271 from annando/quote-2
Improved support for Pixelfed capabilities and GotoSocial interactions
2025-11-03 12:12:23 +01:00
Philipp
8c79b955db
Merge pull request #15279 from mfxa/docs_updates_v4
Docs updates v4
2025-11-03 12:11:26 +01:00
fd692761e1 Improved support for Pixelfed capabilities and GotoSocial interactions 2025-11-03 06:45:15 +00:00
Marcus Funch
edd1bba9be Console: Move commands into sections in the help (credit to nupplaphil) 2025-11-02 23:31:27 +01:00
Marcus Funch
f4c031feb8 Docs: Add consistent link back to /help, remove manual references
And additionally: Limit the width of iframes in the quick start guide to the parent container
2025-11-02 23:30:05 +01:00
Marcus Funch
78c74249f2 Docs: Capitalize HTML titles 2025-11-02 22:31:06 +01:00
Philipp
9adf7ad70e
Merge pull request #15278 from annando/issue-15276
Issue 15276: Fixes "Undefined array key ‘post-reason’"
2025-11-02 18:08:12 +01:00
3d8082c6eb Issue 15276: Fixes "Undefined array key ‘post-reason’" 2025-11-02 13:57:56 +00:00
e3932de5e3 Issue 15100: Increased summary field size 2025-11-02 11:51:11 +00:00
1d901456ac Further improvements to the list of countries and counties 2025-11-02 11:07:24 +00:00
Philipp
b7f71dd626
Merge pull request #15229 from mfxa/reports_fix_missing_report_category
Add missing moderation report category
2025-11-02 07:44:48 +01:00
Philipp
eb526a9834
Merge pull request #15242 from mfxa/docs_updates_directory_structure
Docs updates 3: Directory structure and more
2025-11-02 07:44:30 +01:00
Philipp
1c803b1ef0
Merge pull request #15275 from annando/video-size
Simplified video size display
2025-11-02 07:39:27 +01:00
db895f5636 Simplified video size display 2025-11-02 01:01:55 +00:00
Philipp
08b119d75d
Merge pull request #15273 from annando/nullable
Fix "implicitly nullable parameters are deprecated" warning
2025-11-01 23:05:38 +01:00
Philipp
acf9909500
Merge pull request #15272 from annando/issue-15263
Issue 15263: Fix "Query parameters mismatch"
2025-11-01 23:03:57 +01:00
56c98b4354 Fix "implicitly nullable parameters are deprecated" warning 2025-11-01 13:42:01 +00:00
295b75d6a1 Issue 15263: Fix "Query parameters mismatch" 2025-11-01 13:17:37 +00:00
Philipp
a71b5b7abe
Merge pull request #15261 from annando/quote-support
Partial support for Mastodon's way of quoting posts
2025-10-31 14:20:37 +01:00
924b078ba4 Partial support for Mastodon's way of quoting posts 2025-10-31 06:10:21 +00:00
Marcus Funch
c3ed5c29c8 Docs: Update README on contributing to docs 2025-10-29 19:47:37 +01:00
Marcus Funch
9a91b53d06 Docs: Remove dangling license file, as the related file is no longer there 2025-10-29 19:47:37 +01:00
Marcus Funch
fa886170a9 Docs: English capitalization, add monitoring page to overview, consistency 2025-10-29 19:47:37 +01:00
Marcus Funch
57d455b6fc Docs: Rename doc on account types, final references 2025-10-29 19:47:37 +01:00
Marcus Funch
7989426432 Docs: Move theme docs to user section, fix addons link, mark English docs 2025-10-29 19:41:48 +01:00
Marcus Funch
d1b94d3d6d Docs: Remove manual TOC on FAQ pages when the side menu serves that purpose 2025-10-29 19:41:44 +01:00
Marcus Funch
d3b6e21aea Moderation reports: Create ReportUtil class, add category name function 2025-10-29 19:37:04 +01:00
Marcus Funch
4c4c720b0b Add missing moderation report category 2025-10-29 19:22:17 +01:00
Michael Vogel
84c4073992
Merge pull request #15266 from annando/warning
Fix warning "foreach() argument must be of type array|object, null given"
2025-10-28 23:04:16 +01:00
f4438cae16 Fix warning "foreach() argument must be of type array|object, null given" 2025-10-28 22:02:22 +00:00
Philipp
16d511ca4e
Merge pull request #15265 from annando/photo
Always fetch the photo with the highest resolution
2025-10-27 23:59:16 +01:00
420792307a Always fetch the photo with the highest resolution 2025-10-27 20:31:04 +00:00
Michael Vogel
1b433dc4c0
Merge pull request #15260 from annando/fix-warning
Fix warning "E_WARNING: Undefined array key"
2025-10-26 14:46:39 +01:00
98998524b2 Fix warning "E_WARNING: Undefined array key" 2025-10-26 13:40:42 +00:00
Philipp
6ea4f9014a
Merge pull request #15258 from annando/callstack
The callstack now is more readable
2025-10-26 10:08:54 +01:00
Philipp
5c21f5a30c
Merge pull request #15259 from loma-one/2025.07-rc
Include 'mark' in open_close_elements array
2025-10-26 10:07:07 +01:00
Philipp
d7d6045793
Merge pull request #15257 from annando/no-media
Don't display media for visitors
2025-10-26 10:06:19 +01:00
loma-one
e9df54e572
Include 'mark' in open_close_elements array
Mit dem BBCode 'mark' können einzelne Worte oder Textpassagen farbig hervorgehoben werden.
2025-10-26 07:39:24 +01:00
f5dcd5ad23 Don't display media for visitors 2025-10-25 13:32:09 +00:00
Philipp
fe993c9aaf
Merge pull request #15256 from annando/regions
Updated lists of counties and countries
2025-10-25 15:26:13 +02:00
37723d16a1 The callstack now is more readable 2025-10-25 11:54:18 +00:00
732825e13f Updated lists of counties and countries 2025-10-25 00:07:16 +00:00
Michael Vogel
f27e7293b8
Merge pull request #15255 from nupplaphil/ci/fix
[CI] Fix release script
2025-10-24 20:56:21 +02:00
Philipp
8e987cb200
Merge pull request #15251 from randompenguin1/2025.07-rc
Show Scheduled Post Previews Instead of a Table
2025-10-24 14:55:32 +02:00
philipp
7d66dd83c2
Fix Codestyle 2025-10-24 12:04:01 +00:00
1a21aa58fc
Update messages.po 2025-10-24 13:59:03 +02:00
Random Penguin
aae3dacc53
adding schedule.tpl
Because the new way does not work in this old theme so show a table instead of previews.
2025-10-24 11:50:13 +00:00
Random Penguin
b77107c9fd
Create schedule.tpl 2025-10-24 11:50:13 +00:00
Random Penguin
d87d277196
add schedule.tpl
Ensures this theme shows Scheduled Posts the old way in a table because the new way is broken in this theme
2025-10-24 11:50:13 +00:00
Random Penguin
0315d07c5c
Add schedule.tpl
This ensures the theme will continue to show Scheduled Posts the old way in a table because the new way is broken in this theme.
2025-10-24 11:50:12 +00:00
Random Penguin
a77f8baaf4
Scheduled Post Previews
Shows scheduled post previews instead of just a table listing scheduled posts.
2025-10-24 11:50:12 +00:00
Random Penguin
e37304a5f9
Scheduled Post Previews
Shows actual post previews instead of just a table listing posts and scheduled times. ONLY WORKS WITH VIER!
2025-10-24 11:50:11 +00:00
Random Penguin
ba0686d505
Add data for scheduled previews
Adds template data for showing post previews in scheduled posts instead of a table.
2025-10-24 11:50:11 +00:00
philipp
8a8fdd48e5
[CI] Fix release script 2025-10-24 11:18:03 +02:00
Philipp
6055af9685
Merge pull request #15254 from annando/issue-15253
Issue 15253: Updated list of counties in the UK
2025-10-24 09:47:56 +02:00
2e6a7eb36b Issue 15253: Updated list of counties in the UK 2025-10-24 04:30:08 +00:00
Philipp
67df3b99e9
Merge pull request #15247 from annando/video-js
Possibility to use Video.js as alternate video player
2025-10-24 00:53:15 +02:00
Philipp
af63bcbf2c
Merge pull request #15252 from annando/auto-preview-size
Automatic preview size size detection
2025-10-24 00:52:04 +02:00
Philipp
904dcd9b00
Merge pull request #15246 from annando/add.only-single-media
Attach single media to post
2025-10-24 00:47:33 +02:00
1d5ff8389f Possibility to use Video.js as alternate video player 2025-10-22 19:28:51 +00:00
d21e319bef Automatic preview size size detection 2025-10-22 19:26:22 +00:00
319cdbe443 Attach single media to post 2025-10-22 19:25:50 +00:00
Philipp
67f1ca963b
Merge pull request #15245 from annando/no-peertube-mp4
Don't store MP4 video when processing HLS video
2025-10-21 23:53:33 +02:00
95613cf4e8 Don't store MP4 video when processing HLS video 2025-10-21 20:48:18 +00:00
Philipp
38b0e5d2a4
Merge pull request #15244 from annando/no-additional-media
Don't display additional media links when page is a media page
2025-10-21 18:27:26 +02:00
Philipp
310dc9c943
Merge pull request #15238 from annando/issue-14782
Issue 14782: Disable private message to group
2025-10-21 18:20:24 +02:00
Philipp
4bd313704b
Merge pull request #15227 from annando/iframes
Improved iframe handling
2025-10-21 18:16:49 +02:00
Philipp
edee159f7c
Merge pull request #15250 from annando/issue-15191
Issue 15191: Fix poll frequency calculation
2025-10-21 18:13:51 +02:00
d286f6ba9c Issue 15191: Fix poll frequency calculation 2025-10-21 05:07:33 +00:00
55271fcd14 Improved iframe handling 2025-10-21 04:01:27 +00:00
69cb52f60e Issue 14782: Disable private message to group 2025-10-19 10:22:17 +00:00
00397a34b5 Don't display additional media links when page is a media page 2025-10-19 05:55:45 +00:00
Marcus Funch
c7ba9ac95d Docs: Update directory structure (credits to nupplaphil) 2025-10-15 20:47:11 +02:00
Philipp
c9c863dbe6
Merge pull request #15239 from mfxa/docs_typo
Docs: Missing non-lowercase references to docs
2025-10-14 15:44:11 +02:00
Marcus Funch
d2706b8f93 Docs: Missing non-lowercase references to docs 2025-10-14 11:39:21 +02:00
Philipp
d37549d2b7
Merge pull request #15240 from mfxa/docs_updates_v2
Docs updates: Restructuring, code blocks, quick start guide markdown links
2025-10-14 08:43:32 +02:00
Marcus Funch
7404b3a230 Docs updates: Restructuring, code blocks, quick start guide markdown links 2025-10-14 00:59:39 +02:00
Philipp
9cecc6ca2d
Merge pull request #15237 from mfxa/docs_naming_consistency
Docs updates: Mostly file naming consistency
2025-10-13 11:59:10 +02:00
Philipp
6502ad1c4a
Merge pull request #15235 from mfxa/mods_create_users_invitation_only
Allow user creation by mods/admins when invitation_only is enabled
2025-10-12 19:44:56 +02:00
Marcus Funch
64a21f212b Update outside references to docs 2025-10-12 18:58:26 +02:00
Marcus Funch
8ad361d2ef Move spec/ to doc/spec/protocol 2025-10-12 17:33:45 +02:00
Marcus Funch
a46450a575 Docs: Final cleanup 2025-10-12 17:10:57 +02:00
Marcus Funch
6a451b49f6 Allow user creation by mods/admins when invitation_only is enabled 2025-10-12 17:09:08 +02:00
Marcus Funch
3113f0bcba Docs: Remove dysfunctional internal links from installation guide 2025-10-12 16:52:08 +02:00
Marcus Funch
9cdda90168 Docs: Update Help.php to point to the new name 2025-10-12 16:52:08 +02:00
Marcus Funch
692a12d562 Docs: Update filenames inside docs after rename 2025-10-12 16:52:08 +02:00
Marcus Funch
62e2edb90b Docs: Rename docs to lowercase, dash separated (credit nupplaphil) 2025-10-12 16:51:58 +02:00
Michael Vogel
608471d598
Merge pull request #15232 from mfxa/docs_default_theme_frio
Minor update to docs to say frio is the default theme
2025-10-11 11:53:20 +02:00
Marcus Funch
2807e2747b Minor update to docs to say frio is the default theme 2025-10-11 11:35:36 +02:00
Michael Vogel
48a9e0e9b3
Merge pull request #15228 from mfxa/moderation_add_user_item_source
Moderation: Create user UI/UX improvements and consistency, item source consistency
2025-10-11 11:21:45 +02:00
Marcus Funch
58078912c0 Moderation create user improvements and consistency, item source consistency 2025-10-10 23:34:08 +02:00
384 changed files with 7657 additions and 5235 deletions

View file

@ -260,6 +260,11 @@ path = "view/js/hls/**"
SPDX-FileCopyrightText = "2017 Dailymotion (http://www.dailymotion.com)"
SPDX-License-Identifier = "Apache-2.0"
[[annotations]]
path = "view/js/videojs/**"
SPDX-FileCopyrightText = "Copyright 2010-present Video.js contributors"
SPDX-License-Identifier = "Apache-2.0"
[[annotations]]
path = [ "images/rm-16.png", "images/rhash-16.png"]
SPDX-FileCopyrightText = "Red Matrix Project"

View file

@ -1,6 +1,6 @@
-- ------------------------------------------
-- Friendica 2025.07-rc (Interrupted Fern)
-- DB_UPDATE_VERSION 1582
-- DB_UPDATE_VERSION 1584
-- ------------------------------------------
@ -1275,7 +1275,7 @@ CREATE TABLE IF NOT EXISTS `post-collection` (
CREATE TABLE IF NOT EXISTS `post-content` (
`uri-id` int unsigned NOT NULL COMMENT 'Id of the item-uri table entry that contains the item uri',
`title` varchar(255) NOT NULL DEFAULT '' COMMENT 'item title',
`content-warning` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`content-warning` varchar(500) NOT NULL DEFAULT '' COMMENT '',
`body` mediumtext COMMENT 'item body content',
`raw-body` mediumtext COMMENT 'Body without embedded media links',
`quote-uri-id` int unsigned COMMENT 'Id of the item-uri table that contains the quoted uri',
@ -1368,12 +1368,14 @@ CREATE TABLE IF NOT EXISTS `post-history` (
`uri-id` int unsigned NOT NULL COMMENT 'Id of the item-uri table entry that contains the item uri',
`edited` datetime NOT NULL DEFAULT '0001-01-01 00:00:00' COMMENT 'Date of edit',
`title` varchar(255) NOT NULL DEFAULT '' COMMENT 'item title',
`content-warning` varchar(255) NOT NULL DEFAULT '' COMMENT '',
`content-warning` varchar(500) NOT NULL DEFAULT '' COMMENT '',
`body` mediumtext COMMENT 'item body content',
`raw-body` mediumtext COMMENT 'Body without embedded media links',
`quote-uri-id` int unsigned COMMENT 'Id of the item-uri table that contains the quoted uri',
`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',
`language` text COMMENT 'Language information about this post',
`sensitive` boolean COMMENT 'If true, this post contains sensitive content',
`app` varchar(255) NOT NULL DEFAULT '' COMMENT 'application which generated this item',
`rendered-hash` varchar(32) NOT NULL DEFAULT '' COMMENT '',
`rendered-html` mediumtext COMMENT 'item.body converted to html',
@ -1384,7 +1386,9 @@ CREATE TABLE IF NOT EXISTS `post-history` (
`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',
`plink` varbinary(383) NOT NULL DEFAULT '' COMMENT 'permalink or URL to a displayable copy of the message at its source',
PRIMARY KEY(`uri-id`,`edited`),
FOREIGN KEY (`uri-id`) REFERENCES `item-uri` (`id`) ON UPDATE RESTRICT ON DELETE CASCADE
INDEX `quote-uri-id` (`quote-uri-id`),
FOREIGN KEY (`uri-id`) REFERENCES `item-uri` (`id`) ON UPDATE RESTRICT ON DELETE CASCADE,
FOREIGN KEY (`quote-uri-id`) REFERENCES `item-uri` (`id`) ON UPDATE RESTRICT ON DELETE CASCADE
) DEFAULT COLLATE utf8mb4_general_ci COMMENT='Post history';
--
@ -1436,6 +1440,8 @@ CREATE TABLE IF NOT EXISTS `post-media` (
`embed-html` text COMMENT 'HTML embed code for this media',
`embed-height` smallint unsigned COMMENT 'Height of the embed',
`embed-width` smallint unsigned COMMENT 'Width of the embed',
`page-type` varchar(30) COMMENT 'Type of the page (e.g. article, website)',
`schematypes` varchar(255) COMMENT 'Schema types of the page as JSON string',
`language` char(3) COMMENT 'Language information about this media in the ISO 639 format',
`published` datetime COMMENT 'Publification date of this media',
`modified` datetime COMMENT 'Modification date of this media',

View file

@ -1,82 +0,0 @@
Help
====
**User Manual**
* General functions - first steps
* [Account Basics](help/Account-Basics)
* [New User Quick Start](help/Quick-Start-guide)
* [Creating posts](help/Text_editor)
* [BBCode tag reference](help/BBCode)
* [Comment, sort and delete posts](help/Text_comment)
* [Accesskey reference](help/Accesskeys)
* [Events](help/events)
* You and other users
* [Connectors](help/Connectors)
* [Making Friends](help/Making-Friends)
* [Safety](help/Safety)
* [Circles and Privacy](help/Circles-and-Privacy)
* [Tags and Mentions](help/Tags-and-Mentions)
* [Community Groups](help/Groups)
* [Channels](help/Channels)
* [Chats](help/Chats)
* Further information
* [Move your account](help/Move-Account)
* [Export / Import of followed Contacts](help/Export-Import-Contacts)
* [Delete your account](help/Remove-Account)
* [Frequently asked questions (FAQ)](help/FAQ)
**Admin Manual**
* [Install](help/Install)
* [Update](help/Update)
* [Settings & Admin Panel](help/Settings)
* [Installing Connectors](help/Installing-Connectors)
* [Install an ejabberd server (XMPP chat) with synchronized credentials](help/install-ejabberd)
* [Using SSL with Friendica](help/SSL)
* [Config values that can only be set in config/local.config.php](help/Config)
* [Improve Performance](help/Improve-Performance)
* [Migrate](help/Migrate)
* [Administration Tools](help/tools)
* [Admin FAQ](help/FAQ-admin)
**Developer Manual**
* [Get started](help/Developers-Intro)
* Set up development environment
* [Help on GitHub](help/GitHub)
* [Help on Vagrant](help/Vagrant)
* [Bugs and Issues](help/Bugs-and-Issues)
* Code structure
* [Domain-Driven-Design](help/Developer-Domain-Driven-Design)
* [Addon Development](help/Addons)
* [Theme Development](help/themes)
* [Smarty 3 Templates](help/smarty3-templates)
* [Storage backend addon](help/AddonStorageBackend)
* How To
* [Translate Friendica](help/translations)
* [Use Composer](help/Composer)
* [Move classes to `src`](help/Developer-How-To-Move-Classes-to-src)
* [Run tests](help/Tests)
* Reference
* [API endpoints](help/api)
* [Code (Doxygen generated - sets cookies)](doc/html/)
* [Protocol Documentation](help/Protocol)
* [Database schema documentation](help/database)
* [Class Autoloading](help/autoloader)
**Links**
* Website: [https://friendi.ca](https://friendi.ca)
* Help Group: [@helpers@forum.friendi.ca](https://forum.friendi.ca/~helpers)
* XMPP: [support@forum.friendi.ca](xmpp:support@forum.friendi.ca?join)
* IRC: [https://web.libera.chat/?channels=#friendica](https://web.libera.chat/?channels=#friendica)
* Matrix: [https://matrix.to/#/#friendi.ca:matrix.org](https://matrix.to/#/#friendi.ca:matrix.org)
* Mailing List: [https://mailman.friendi.ca/mailman/listinfo/support-friendi.ca](http://mailman.friendi.ca/mailman/listinfo/support-friendi.ca)
**About**
* [Server Information](friendica)
* [Terms of Service](tos)
* [Credits](credits)

View file

@ -1,10 +0,0 @@
Keyboard shortcuts in Friendica
=======================
* [Home](help)
General
-------
* j: Scroll to next thread
* k: Scroll to previous thread

View file

@ -1,14 +0,0 @@
And that brings the Quick Start to an end.
Here are some more things to help get you started:
**Groups**
- <a href="https://forum.friendi.ca/profile/helpers">Friendica Support</a> - problems? This is the place to ask.
**Documentation**
- <a href="help/Connectors">Connecting to more networks</a>
- <a href="help">Help Index</a>

View file

@ -1,32 +0,0 @@
Comment, sort and delete posts
==============
* [Home](help)
Here you can find an overview of the different ways to comment and sort existing posts. <span style="color: red;">Attention: we've used the <b>"diabook"</b> theme. If you're using another theme, some of the icons may be different.</span>
<img src="doc/img/diabook.png" width="308" height="42" alt="diabook" >
<i>The different icons</i>
<img src="doc/img/post_thumbs_up.png" width="27" height="32" alt="post_thumbs_up.png" align="left" style="padding-bottom: 10px;"> This symbol is used to indicate that you like the post. Click it twice to undo your choice.<p style="clear:both;"></p>
<img src="doc/img/post_thumbs_down.png" width="27" height="32" alt="post_thumbs_down.png" align="left" style="padding-bottom: 10px;"> This symbol is used to indicate that you <b>dislike</b> the post. Click it twice to undo your choice.
<p style="clear:both;"></p>
<img src="doc/img/post_share.png" width="27" height="32" alt="post_share.png" align="left" style="padding-bottom: 10px;"> This symbol is used to share a post. A copy of this post will automatically appear in your status editor and add a link to the original post.
<p style="clear:both;"></p>
<img src="doc/img/post_mark.png" width="27" height="32" alt="post_mark.png" align="left" style="padding-bottom: 10px;"> This symbol is used to mark a post. Marked posts will appear on your network page at the "starred" tab (from "star"). Click it twice to undo your choice.
<p style="clear:both;"></p>
<img src="doc/img/post_tag.png" width="27" height="41" alt="post_tag.png" align="left" style="padding-bottom: 10px;"> This symbol is used to tag a post with a self-chosen keyword. When you click at the word, you'll get a list of all posts with this tag. Attention: you can't delete the tag once you've set one.
<p style="clear:both;"></p>
<img src="doc/img/post_categorize.png" width="27" height="32" alt="post_categorize.png" align="left" style="padding-bottom: 20px;"> This symbol is used to categorize posts. Choose an existing folder or create a new one. You'll find the created folder on your network page under the "saved folders" tab.
<p style="clear:both;"></p>
<img src="doc/img/post_delete.png" width="27" height="32" alt="post_delete.png" align="left"> This symbol is used to delete your own post or to remove a post of another person from your stream.
<P style="clear: both;"></p>
<img src="doc/img/post_choose.png" width="27" height="32" alt="post_choose.png" align="left"> This symbol is used to choose more than one post to delete in a single step. After selecting all posts, go to the end of the page and click "Delete Selected Items".<P style="clear: both;"></p>

View file

Before

Width:  |  Height:  |  Size: 47 KiB

After

Width:  |  Height:  |  Size: 47 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 596 B

After

Width:  |  Height:  |  Size: 596 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 356 B

After

Width:  |  Height:  |  Size: 356 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 1.7 KiB

After

Width:  |  Height:  |  Size: 1.7 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 7.6 KiB

After

Width:  |  Height:  |  Size: 7.6 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 6.5 KiB

After

Width:  |  Height:  |  Size: 6.5 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 6.5 KiB

After

Width:  |  Height:  |  Size: 6.5 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 336 B

After

Width:  |  Height:  |  Size: 336 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 796 B

After

Width:  |  Height:  |  Size: 796 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 451 B

After

Width:  |  Height:  |  Size: 451 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 617 B

After

Width:  |  Height:  |  Size: 617 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 393 B

After

Width:  |  Height:  |  Size: 393 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 448 B

After

Width:  |  Height:  |  Size: 448 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 452 B

After

Width:  |  Height:  |  Size: 452 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 321 B

After

Width:  |  Height:  |  Size: 321 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 378 B

After

Width:  |  Height:  |  Size: 378 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 483 B

After

Width:  |  Height:  |  Size: 483 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 560 B

After

Width:  |  Height:  |  Size: 560 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 422 B

After

Width:  |  Height:  |  Size: 422 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 482 B

After

Width:  |  Height:  |  Size: 482 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 489 B

After

Width:  |  Height:  |  Size: 489 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 484 B

After

Width:  |  Height:  |  Size: 484 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 1.8 KiB

After

Width:  |  Height:  |  Size: 1.8 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 503 B

After

Width:  |  Height:  |  Size: 503 B

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 1.1 KiB

After

Width:  |  Height:  |  Size: 1.1 KiB

Before After
Before After

View file

@ -1,97 +0,0 @@
Database Tables
===============
* [Home](help)
| Table | Description |
|-------|-------------|
| [2fa_app_specific_password](help/database/db_2fa_app_specific_password) | Two-factor app-specific _password |
| [2fa_recovery_codes](help/database/db_2fa_recovery_codes) | Two-factor authentication recovery codes |
| [2fa_trusted_browser](help/database/db_2fa_trusted_browser) | Two-factor authentication trusted browsers |
| [account-suggestion](help/database/db_account-suggestion) | Account suggestion |
| [account-user](help/database/db_account-user) | Remote and local accounts |
| [apcontact](help/database/db_apcontact) | ActivityPub compatible contacts - used in the ActivityPub implementation |
| [application](help/database/db_application) | OAuth application |
| [application-marker](help/database/db_application-marker) | Timeline marker |
| [application-token](help/database/db_application-token) | OAuth user token |
| [arrived-activity](help/database/db_arrived-activity) | Id of arrived activities |
| [attach](help/database/db_attach) | file attachments |
| [cache](help/database/db_cache) | Stores temporary data |
| [channel](help/database/db_channel) | User defined Channels |
| [check-full-text-search](help/database/db_check-full-text-search) | Check for a full text search match in user defined channels before storing the message in the system |
| [config](help/database/db_config) | main configuration storage |
| [contact](help/database/db_contact) | contact table |
| [contact-relation](help/database/db_contact-relation) | Contact relations |
| [conv](help/database/db_conv) | private messages |
| [delayed-post](help/database/db_delayed-post) | Posts that are about to be distributed at a later time |
| [delivery-queue](help/database/db_delivery-queue) | Delivery data for posts for the batch processing |
| [diaspora-contact](help/database/db_diaspora-contact) | Diaspora compatible contacts - used in the Diaspora implementation |
| [diaspora-interaction](help/database/db_diaspora-interaction) | Signed Diaspora Interaction |
| [endpoint](help/database/db_endpoint) | ActivityPub endpoints - used in the ActivityPub implementation |
| [event](help/database/db_event) | Events |
| [fetch-entry](help/database/db_fetch-entry) | |
| [fetched-activity](help/database/db_fetched-activity) | Id of fetched activities |
| [fsuggest](help/database/db_fsuggest) | friend suggestion stuff |
| [group](help/database/db_group) | privacy circles, circle info |
| [group_member](help/database/db_group_member) | privacy circles, member info |
| [gserver](help/database/db_gserver) | Global servers |
| [gserver-tag](help/database/db_gserver-tag) | Tags that the server has subscribed |
| [hook](help/database/db_hook) | addon hook registry |
| [inbox-entry](help/database/db_inbox-entry) | Incoming activity |
| [inbox-entry-receiver](help/database/db_inbox-entry-receiver) | Receiver for the incoming activity |
| [inbox-status](help/database/db_inbox-status) | Status of ActivityPub inboxes |
| [intro](help/database/db_intro) | |
| [item-uri](help/database/db_item-uri) | URI and GUID for items |
| [key-value](help/database/db_key-value) | A key value storage |
| [locks](help/database/db_locks) | |
| [mail](help/database/db_mail) | private messages |
| [mailacct](help/database/db_mailacct) | Mail account data for fetching mails |
| [manage](help/database/db_manage) | table of accounts that can manage each other |
| [notification](help/database/db_notification) | notifications |
| [notify](help/database/db_notify) | [Deprecated] User notifications |
| [notify-threads](help/database/db_notify-threads) | |
| [openwebauth-token](help/database/db_openwebauth-token) | Store OpenWebAuth token to verify contacts |
| [parsed_url](help/database/db_parsed_url) | cache for 'parse_url' queries |
| [pconfig](help/database/db_pconfig) | personal (per user) configuration storage |
| [permissionset](help/database/db_permissionset) | |
| [photo](help/database/db_photo) | photo storage |
| [post](help/database/db_post) | Structure for all posts |
| [post-activity](help/database/db_post-activity) | Original remote activity |
| [post-category](help/database/db_post-category) | post relation to categories |
| [post-collection](help/database/db_post-collection) | Collection of posts |
| [post-content](help/database/db_post-content) | Content for all posts |
| [post-counts](help/database/db_post-counts) | Original remote activity |
| [post-delivery](help/database/db_post-delivery) | Delivery data for posts for the batch processing |
| [post-delivery-data](help/database/db_post-delivery-data) | Delivery data for items |
| [post-engagement](help/database/db_post-engagement) | Engagement data per post |
| [post-history](help/database/db_post-history) | Post history |
| [post-link](help/database/db_post-link) | Post related external links |
| [post-media](help/database/db_post-media) | Attached media |
| [post-origin](help/database/db_post-origin) | Posts from local users |
| [post-question](help/database/db_post-question) | Question |
| [post-question-option](help/database/db_post-question-option) | Question option |
| [post-searchindex](help/database/db_post-searchindex) | Content for all posts |
| [post-tag](help/database/db_post-tag) | post relation to tags |
| [post-thread](help/database/db_post-thread) | Thread related data |
| [post-thread-user](help/database/db_post-thread-user) | Thread related data per user |
| [post-user](help/database/db_post-user) | User specific post data |
| [post-user-notification](help/database/db_post-user-notification) | User post notifications |
| [process](help/database/db_process) | Currently running system processes |
| [profile](help/database/db_profile) | user profiles data |
| [profile_field](help/database/db_profile_field) | Custom profile fields |
| [register](help/database/db_register) | registrations requiring admin approval |
| [report](help/database/db_report) | |
| [report-post](help/database/db_report-post) | Individual posts attached to a moderation report |
| [report-rule](help/database/db_report-rule) | Terms of service rule lines relevant to a moderation report |
| [search](help/database/db_search) | |
| [session](help/database/db_session) | web session storage |
| [storage](help/database/db_storage) | Data stored by Database storage backend |
| [subscription](help/database/db_subscription) | Push Subscription for the API |
| [tag](help/database/db_tag) | tags and mentions |
| [user](help/database/db_user) | The local users |
| [user-contact](help/database/db_user-contact) | User specific public contact data |
| [user-gserver](help/database/db_user-gserver) | User settings about remote servers |
| [userd](help/database/db_userd) | Deleted usernames |
| [verb](help/database/db_verb) | Activity Verbs |
| [worker-ipc](help/database/db_worker-ipc) | Inter process communication between the frontend and the worker |
| [workerqueue](help/database/db_workerqueue) | Background tasks queue entries |

View file

@ -1,30 +0,0 @@
Table conversation
===========
Raw data and structure information for messages
Fields
------
| Field | Description | Type | Null | Key | Default | Extra |
| ----------------- | -------------------------------------------------------------------- | ---------------- | ---- | --- | ------------------- | ----- |
| item-uri | Original URI of the item - unrelated to the table with the same name | varbinary(255) | NO | PRI | NULL | |
| reply-to-uri | URI to which this item is a reply | varbinary(255) | NO | | | |
| conversation-uri | GNU Social conversation URI | varbinary(255) | NO | | | |
| conversation-href | GNU Social conversation link | varbinary(255) | NO | | | |
| protocol | The protocol of the item | tinyint unsigned | NO | | 255 | |
| direction | How the message arrived here: 1=push, 2=pull | tinyint unsigned | NO | | 0 | |
| source | Original source | mediumtext | YES | | NULL | |
| received | Receiving date | datetime | NO | | 0001-01-01 00:00:00 | |
Indexes
------------
| Name | Fields |
| ---------------- | ---------------- |
| PRIMARY | item-uri |
| conversation-uri | conversation-uri |
| received | received |
Return to [database documentation](help/database)

View file

@ -1,23 +0,0 @@
Table host
===========
Hostname
Fields
------
| Field | Description | Type | Null | Key | Default | Extra |
| ----- | ------------- | ---------------- | ---- | --- | ------- | -------------- |
| id | sequential ID | tinyint unsigned | NO | PRI | NULL | auto_increment |
| name | The hostname | varchar(128) | NO | | | |
Indexes
------------
| Name | Fields |
| ------- | ------------ |
| PRIMARY | id |
| name | UNIQUE, name |
Return to [database documentation](help/database)

View file

@ -1,76 +0,0 @@
Hilfe
=====
**Dokumentation für Benutzer**
* Allgemeine Funktionen - Erste Schritte
* [Account - Basics](help/Account-Basics)
* [Schnellstart für neue Benutzer](help/Quick-Start-guide)
* [Beiträge erstellen](help/Text_editor)
* [Referenz der BBCode Elemente](help/BBCode)
* [Beiträge kommentieren, einordnen und löschen](help/Text_comment)
* [Referenz der Accesskeys](help/Accesskeys)
* [Veranstaltungen](help/events)
* Du und andere Nutzer
* [Konnektoren (Connectors)](help/Connectors)
* [Freunde finden](help/Making-Friends)
* [Circles und Privatsphäre](help/Circles-and-Privacy)
* [Tags und Erwähnungen](help/Tags-and-Mentions)
* [Community-Gruppen](help/Groups)
* [Kanäle (Channels)](help/Channels)
* [Chats](help/Chats)
* Weiterführende Informationen
* [Account umziehen](help/Move-Account)
* [Export / Import gefolgter Kontakte](help/Export-Import-Contacts)
* [Account löschen](help/Remove-Account)
* [Bugs und Probleme](help/Bugs-and-Issues)
* [Häufig gestellte Fragen (FAQ)](help/FAQ)
**Dokumentation für Administratoren**
* [Installation](help/Install)
* [Update](help/Update) (EN)
* [Konfigurationen & Admin-Panel](help/Settings)
* [Addons](help/Addons)
* [Konnektoren (Connectors) installieren](help/Installing-Connectors)
* [Installation eines ejabberd Servers (XMPP-Chat) mit synchronisierten Anmeldedaten](help/install-ejabberd) (EN)
* [Betreibe deine Seite mit einem SSL-Zertifikat](help/SSL)
* [Konfigurationswerte, die nur in der config/local.config.php gesetzt werden können](help/Config) (EN)
* [Performance verbessern](help/Improve-Performance)
* [Administration Werkzeuge](help/tools) (EN)
* [Admin FAQ](help/FAQ-admin)
**Dokumentation für Entwickler**
* [Entwickler](help/Developers)
* [Where to get started?](help/Developers-Intro) (EN)
* [Help on Github](help/Github)
* [Help on Vagrant](help/Vagrant)
* [How to translate Friendica](help/translations) (EN)
* [Bugs and Issues](help/Bugs-and-Issues)
* [Addon Development](help/Addons)
* [Theme Development](help/themes)
* [Smarty 3 Templates](help/smarty3-templates)
* [Protokoll Dokumentation](help/Protocol) (EN)
* [Datenbank-Schema](help/database)
* [Class Autoloading](help/autoloader) (EN)
* [Using Composer](help/Composer) (EN)
* [Code-Referenz (mit doxygen generiert - setzt Cookies)](doc/html/)
* [API Dokumentation](help/api) (EN)
* [Translation of Friendica](help/translations) (EN)
* [Run tests](help/Tests) (EN)
**Links**
* Website: [https://friendi.ca](https://friendi.ca)
* Help Group: [@helpers@forum.friendi.ca](https://forum.friendi.ca/~helpers)
* XMPP: [support@forum.friendi.ca](xmpp:support@forum.friendi.ca?join)
* IRC: [https://web.libera.chat/?channels=#friendica](https://web.libera.chat/?channels=#friendica)
* Matrix: [https://matrix.to/#/#friendi.ca:matrix.org](https://matrix.to/#/#friendi.ca:matrix.org)
* Mailing List: [https://mailman.friendi.ca/mailman/listinfo/support-friendi.ca](http://mailman.friendi.ca/mailman/listinfo/support-friendi.ca)
**Über**
* [Server Information](friendica)
* [Nutzungsbedingungen](tos)
* [Mitwirkende](credits)

View file

@ -1,18 +0,0 @@
... und zuletzt
===============
Und damit sind wir auch schon am Ende der Schnellstartanleitung.
Hier sind noch einige weitere Dinge, die Dir den Start vereinfachen können.
**Gruppen**
- <a href="http://forum.friendi.ca/profile/helpers">Friendica Support</a> - Probleme? Dann ist das der Platz, um zu fragen!
**Dokumentation**
- <a href="help/Connectors">Zu weiteren Netzwerken verbinden</a>
- <a href="help">Zur Startseite der Hilfe</a>

View file

@ -1,51 +0,0 @@
Beiträge erstellen
=================
* [Zur Startseite der Hilfe](help)
Hier findest du eine Übersicht über die verschiedenen Möglichkeiten, deinen Beitrag zu bearbeiten.
<span style="color: red;">
Achtung: für dieses Beispiel wurde das Thema <b>"Diabook"</b> genutzt.
Wenn du ein anderes Design benutzt, wirst du manche dieser Symbole gar nicht oder in anderer Form vorfinden.
</span>
<img src="doc/img/friendica_rich_editor.png" width="538" height="218" alt="editor">
<i>Die einzelnen Symbole</i>
<img src="doc/img/camera.png" alt="editor" align="left" style="margin: 0 10px 10px 0;"> Wenn du auf dieses Symbol klickst, dann kannst du ein Bild von deinem Computer hinzufügen.
Wenn du eine Internetadresse (URL) eingeben willst, dann kannst du das "Baum"-Symbol im oberen Teil des Editors nutzen.
Wenn du ein Bild ausgewählt hast, dann erscheint eine Miniaturdarstellung des Bildes im Editor.*
<p style="clear:both;"></p>
<img src="doc/img/paper_clip.png" alt="paper_clip" align="left" style="margin: 0 10px 10px 0;"> Wenn du dieses Symbol anklickst, dann kannst du weitere Dateien von deinem Computer einfügen. Eine Vorschau des Dateiinhalts erfolgt nicht.*
<p style="clear:both;"></p>
<img src="doc/img/chain.png" alt="chain" align="left" style="margin: 0 10px 10px 0;"> Wenn du die Kette anklickst, dann kannst du eine Internetadresse (URL) einfügen.
Im Editor erscheint automatisch eine kurze Information zum eingefügten Link.*
<p style="clear:both;"></p>
<img src="doc/img/video.png" alt="video" align="left" style="margin: 0 10px 10px 0;"> Mit dieser Funktion kannst du die Internetadresse (URL) einer Videodatei einfügen.
Das Video erscheint dann mit einem Player in deinem Beitrag.
Da Friendica zur Einbindung [HTML5](http://en.wikipedia.org/wiki/HTML5_video) verwendet, werden je nach Browser verschiedene Videoformate unterstützt (z.B. WebM oder MP4).
Außerdem kannst du hier die URLs von Videos auf Youtube, Vimeo und manchen anderen Videohostern eingeben.
Die Videos werden dann mit Vorschaubild angezeigt, nach einem Klick öffnet sich ein eingebetteter Player.*
<p style="clear:both;"></p>
<img src="doc/img/mic.png" alt="mic" align="left" style="margin: 0 10px 10px 0;"> Mit dieser Funktion kannst du die Internetadresse (URL) einer Sound-Datei einfügen.
Da Friendica zur Einbindung [HTML5](http://en.wikipedia.org/wiki/HTML5_video) verwendet, werden je nach Browser und Betriebssystem MP3, Ogg oder AAC unterstützt.
Außerdem kannst du hier auch URLs von manchen Audiohostern wie Soundcloud eingeben, um eine dort gespeicherte Audiodatei mit Player in deinem Beitrag anzuzeigen.*
<p style="clear:both;"></p>
<img src="doc/img/globe.png" alt="globe" align="left" style="margin: 0 10px 10px 0;"> Wenn du dieses Symbol wählst, dann kannst du deinen Standort festlegen.
Hier reicht schon eine Angabe wie "Berlin" oder "10775".
Dieser Eintrag führt anschließend zu einer Suchanfrage bei Google Maps.
<p style="clear:both;"></p>
<i>* wie du Dateien hochladen kannst, erfährst du [hier](help/FAQ#upload)</i>
**Im Folgenden findest du Symbole weiterer Themen**
Frio <img src="doc/img/editor_frio.png" alt="frio.png" style="padding-left: 44px; vertical-align:middle;">
Vier <img src="doc/img/editor_vier.png" alt="vier.png" style="padding-left: 44px; vertical-align:middle;">

View file

@ -1,25 +1,13 @@
Häufig gestellte Fragen (Admin) - FAQ
==============
# Häufig gestellte Fragen (Admin) - FAQ
* [Zur Startseite der Hilfe](help)
* **[Kann ich mehrere Domains mit den selben Dateien aufsetzen?](help/FAQ-admin#multiple)**
* **[Wo kann ich den Quellcode von Friendica, Addons und Themes finden?](help/FAQ-admin#sources)**
* **[Ich habe meine E-Mail Adresse geändern und jetzt ist das Admin Panel verschwunden?](help/FAQ-admin#adminaccount1)**
* **[Kann es mehr als einen Admin auf einer Friendica Instanz geben?](help/FAQ-admin#adminaccount2)**
* **[Die Datenbank Struktur schein nicht aktuell zu sein. Was kann ich tun?](help/FAQ-admin#dbupdate)**
<a name="multiple"></a>
### Kann ich mehrere Domains mit den selben Dateien aufsetzen?
## Kann ich mehrere Domains mit den selben Dateien aufsetzen?
Ja, das ist möglich.
Es ist allerdings nicht möglich, eine Datenbank durch zwei Domains zu nutzen.
Solange Du Deine config/local.config.php allerdings so einrichtest, dass das System nicht versucht, eine Installation durchzuführen, kannst Du die richtige Config-Datei in include/$hostname/config/local.config.php hinterlegen.
Alle Cache-Aspekte und der Zugriffsschutz können pro Instanz konfiguriert werden.
<a name="sources"></a>
### Wo kann ich den Quellcode von Friendica, Addons und Themes finden?
## Wo kann ich den Quellcode von Friendica, Addons und Themes finden?
Du kannst den Friendica-Quellcode [hier](https://github.com/friendica/friendica) finden.
Dort findest Du immer die aktuellste stabile Version von Friendica.
@ -29,13 +17,11 @@ Addons findest Du auf [dieser Seite](https://github.com/friendica/friendica-addo
Wenn Du neue Themen suchst, findest Du sie auf [github.com/bkil/friendica-themes](https://github.com/bkil/friendica-themes).
<a name="adminaccount1"></a>
### Ich habe meine E-Mail Adresse geändern und jetzt ist das Admin Panel verschwunden?
## Ich habe meine E-Mail Adresse geändern und jetzt ist das Admin Panel verschwunden?
Bitte aktualisiere deine E-Mail Adresse in der <tt>config/local.config.php</tt> Datei.
<a name="adminaccount2"></a>
### Kann es mehr als einen Admin auf einer Friendica Instanz geben?
## Kann es mehr als einen Admin auf einer Friendica Instanz geben?
Ja.
Du kannst in der <tt>config/local.config.php</tt> Datei mehrere E-Mail Adressen auflisten.
@ -45,8 +31,7 @@ Die aufgelisteten Adressen werden wie folgt durch Kommas voneinander getrennt:
'admin_email' => 'mail1@example.com,mail2@example.com',
```
<a name="dbupdate"></a>
### Die Datenbank Struktur schein nicht aktuell zu sein. Was kann ich tun?
## Die Datenbank Struktur schein nicht aktuell zu sein. Was kann ich tun?
Rufe bitte im Admin Panel den Punkt [DB Updates](/admin/dbsync/) auf und folge dem Link *Datenbank Struktur überprüfen*.
Damit wird ein Hintergrundprozess gestartet der die Struktur deiner Datenbank überprüft und gegebenenfalls aktualisiert.

View file

@ -1,7 +1,4 @@
How-to: Performance verbessern
==========
* [Zur Startseite der Hilfe](help)
# How-to: Performance verbessern
Eine kleine Anleitung, um die Performance einer Friendica-Seite zu verbessern.
@ -9,27 +6,25 @@ Eine kleine Anleitung, um die Performance einer Friendica-Seite zu verbessern.
Wenn du Fragen zu den folgenden Anweisungen oder zu anderen Themen hast, dann kannst du jederzeit beim Friendica-Support unter https://forum.friendi.ca/profile/helpers nachfragen.
Systemeinstellungen
---------------
## Systemeinstellungen
Geh auf /admin/site in deinem System und ändere die folgenden Werte:
Geh auf `/admin/site` in deinem System und ändere die folgenden Werte:
setze "Qualität des JPEG Bildes" auf 50.
Dieser Wert reduziert die Daten, die vom Server an den Client geschickt werden.
Dieser Wert reduziert die Daten, die vom Server an den Client geschickt werden.
50 ist ein Wert, der die Bildqualität nicht zu stark beeinflusst.
setze "Intervall zum Vervollständigen von OStatus Unterhaltungen" auf "niemals"
Wenn du viele OStatus-Kontakte hast, dann kann die Vervollständigung von Unterhaltungen sehr zeitraubend sein.
Wenn du viele OStatus-Kontakte hast, dann kann die Vervollständigung von Unterhaltungen sehr zeitraubend sein.
Der Nachteil: Du siehst nicht jede Antwort einer OStatus-Unterhaltung. Aus diesem Grund ist die Option "Beim Empfang von Nachrichten" in der Regel ein guter Kompromiss.
setze "Nutze MySQL full text engine".
Wenn du MyISAM (Standardeinstellung) oder InnoDB mit MariaDB 10 nutzt, dann beschleunigt dies die Suche.
Addons
--------
## Addons
Aktiviere die folgenden Addons:
@ -55,8 +50,7 @@ Wenn es aktiviert ist, dann siehst du Werte wie die folgenden auf jeder deiner S
Diese Werte zeigen deine Performance-Probleme.
Webserver
----------
## Webserver
Wenn du einen Apache-Webserver nutzt, aktiviere bitte die folgenden Module:
@ -80,7 +74,7 @@ Weitere Informationen findest du hier: http://httpd.apache.org/docs/2.2/mod/mod_
Dieses Modul komprimiert den Datenverkehr (Traffic) zwischen dem Webserver und dem Client.
Aktiviere das Modul "mod_deflate" durch die Eingabe "a2enmod deflate" als root.
Aktiviere das Modul `mod_deflate` durch die Eingabe `a2enmod deflate` als root.
Weitere Informationen findest du hier: http://httpd.apache.org/docs/2.2/mod/mod_deflate.html
@ -89,9 +83,9 @@ Weitere Informationen findest du hier: http://httpd.apache.org/docs/2.2/mod/mod_
**FCGI**
Wenn du Apache nutzt, dann denk darüber nach, FCGI zu nutzen.
Wenn du Apache nutzt, dann denk darüber nach, FCGI zu nutzen.
Wenn du eine Debian-basierte Distribution nutzt, dann wirst du die Pakete "php5-cgi" und "libapache2-mod-fcgid" benötigen.
Nutze externe Dokumente, um eine detailiertere Erklärung für die Einrichtung eines Systems auf FCGI-Basis zu erhalten.
Nutze externe Dokumente, um eine detailliertere Erklärung für die Einrichtung eines Systems auf FCGI-Basis zu erhalten.
### Database

View file

@ -1,9 +1,6 @@
Friendica Installation
==========
# Friendica Installation
* [Zur Startseite der Hilfe](help)
Wir haben hart daran gearbeitet, um Friendica auf vorgefertigten Hosting-Plattformen zum Laufen zu bringen - solche, auf denen auch Wordpress Blogs und Drupal-Installationen laufen.
Wir haben hart daran gearbeitet, um Friendica auf vorgefertigten Hosting-Plattformen zum Laufen zu bringen - solche, auf denen auch WordPress Blogs und Drupal-Installationen laufen.
Wir bieten eine manuelle und eine automatische Installation an.
Aber bedenke, dass Friendica mehr als eine einfache Webanwendung ist.
Es handelt sich um ein komplexes Kommunikationssystem, das eher an einen Email-Server erinnert als an einen Webserver.
@ -12,7 +9,7 @@ Diese Funktionalität benötigt ein wenig mehr als die normalen Blogs.
Nicht jeder PHP/MySQL-Hosting-Anbieter kann Friendica unterstützen.
Viele hingegen können es. Aber **bitte** prüfe die Voraussetzungen deines Servers vor der Installation.
Wenn dir Fehler während der Installation auffallen, sag uns bitte über [Helper](http://forum.friendi.ca/profile/helpers) oder die [Entwickler Gruppe](https://forum.friendi.ca/profile/developers) Bescheid oder [erstelle ein Issue](https://github.com/friendica/friendica/issues).
Wenn dir Fehler während der Installation auffallen, sag uns bitte über [Helper](https://forum.friendi.ca/profile/helpers) oder die [Entwickler Gruppe](https://forum.friendi.ca/profile/developers) Bescheid oder [erstelle ein Issue](https://github.com/friendica/friendica/issues).
Gib uns bitte so viele Infos zu deinem System, wie du kannst, und beschreibe den Fehler mit allen Details und Fehlermeldungen, so dass wir den Fehler zukünftig verhindern können.
Aufgrund der großen Anzahl an verschiedenen Betriebssystemen und PHP-Plattformen haben wir nur geringe Kapazitäten, um deine PHP-Installation zu debuggen oder fehlende Module zu ersetzen, aber wir tun unser Bestes, um allgemeine Code-Fehler zu beheben.
@ -21,10 +18,9 @@ Dinge verändern sich und einige deiner Freunde haben möglicherweise Probleme,
Wir planen, diese Einschränkung in einer zukünftigen Version zu beheben.
Requirements
---
## Requirements
* Apache mit einer aktiverten mod-rewrite-Funktion und dem Eintrag "Options All", so dass du die lokale .htaccess-Datei nutzen kannst
* Apache mit einer aktiverten mod-rewrite-Funktion und dem Eintrag "Options All", so dass du die lokale `.htaccess`-Datei nutzen kannst
* PHP 7.4+
* PHP *Kommandozeilen*-Zugang mit register_argc_argv auf "true" gesetzt in der php.ini-Datei
* Curl, GD, GMP, PDO, mbstrings, MySQLi, hash, xml, zip, IntlChar, IDN und OpenSSL-Erweiterung
@ -35,8 +31,7 @@ Requirements
* die Möglichkeit, wiederkehrende Aufgaben mit cron (Linux/Mac) oder "Scheduled Tasks" einzustellen (Windows) [Beachte: andere Optionen sind in Abschnitt 7 dieser Dokumentation zu finden]
* Installation in einer Top-Level-Domain oder Subdomain (ohne eine Verzeichnis/Pfad-Komponente in der URL) wird bevorzugt. Verzeichnispfade sind für diesen Zweck nicht so günstig und wurden auch nicht ausführlich getestet.
Installation
---
## Installation
### Alternative Wege um Friendica zu Installieren
@ -56,38 +51,44 @@ Entpacke die Friendica-Daten in das Quellverzeichnis (root) des Dokumentenbereic
Wenn du die Möglichkeit hierzu hast, empfehlen wir dir "git" zu nutzen, um die Daten direkt von der Quelle zu klonen, statt die gepackte .tar- oder .zip-Datei zu nutzen.
Das macht die Aktualisierung wesentlich einfacher.
Der Linux-Code, mit dem man die Dateien direkt in ein Verzeichnis wie "meinewebseite" kopiert, ist
git clone https://github.com/friendica/friendica.git -b stable mywebsite
cd mywebsite
bin/composer.phar run install:prod
```sh
git clone https://github.com/friendica/friendica.git -b stable mywebsite
cd mywebsite
bin/composer.phar run install:prod
```
Stelle sicher, dass der Ordner *view/smarty3* existiert and von dem Webserver-Benutzer beschreibbar ist
mkdir view/smarty3
chmod 775 view/smarty3
```sh
mkdir view/smarty3
chmod 775 view/smarty3
```
Falls Addons installiert werden sollen: Gehe in den Friendica-Ordner
cd mywebsite
```sh
cd mywebsite
```
Und die Addon Repository klonst:
git clone https://github.com/friendica/friendica-addons.git -b stable addon
```sh
git clone https://github.com/friendica/friendica-addons.git -b stable addon
```
Um das Addon-Verzeichnis aktuell zu halten, solltest du in diesem Pfad ein "git pull"-Befehl eintragen
```sh
cd meinewebseite/addon
git pull
```
cd meinewebseite/addon
git pull
Wenn du den Verzeichnispfad auf deinen Webserver kopierst, dann stelle sicher, dass du auch die .htaccess kopierst, da "Punkt"-Dateien oft versteckt sind und normalerweise nicht direkt kopiert werden.
Wenn du den Verzeichnispfad auf deinen Webserver kopierst, dann stelle sicher, dass du auch die `.htaccess` kopierst, da "Punkt"-Dateien oft versteckt sind und normalerweise nicht direkt kopiert werden.
Wenn du die Entwickler Version von Friendica verwenden möchtest kannst du auf den develop Branch im git Repository wechseln.
Dies tust du mit den folgenden Befehlen
git checkout develop
bin/composer.phar run install:prod
cd addon
git checkout develop
```sh
git checkout develop
bin/composer.phar run install:prod
cd addon
git checkout develop
```
Die Entwickler Version kann nach einem fehlerhaften Commit vorübergehend Probleme haben oder gar nicht mehr funktionieren.
Sollte dir so etwas passieren, lass es uns bitte wissen, damit der Fehler behoben werden kann.
@ -101,8 +102,9 @@ Friendica benötigt die Berechtigungen um neue Felder in dieser Datenbank zu ert
Mit neueren Versionen von MySQL (5.7.17+) musst du den `sql_mode` zu `''` (blank) setzen.
Benutze diese Einstellung, wenn der Installer nicht in der Lage ist, die Tabellen aufgrund eines Timestamp-Format Problems zu erstellen.
Falls dem so ist, finde den `[mysqld]` Bereich in deiner `my.conf` Datei und füge diese Zeile hinzu:
sql_mode = ''
```
sql_mode = ''
```
Starte MySQL dann neu und es sollte klappen.
@ -126,39 +128,42 @@ Du kannst bei Bedarf die Datei config/local.config.php verschieben/umbenennen un
### Option B: Starte das automatische Installationsscript
Es existieren folgende Varianten zur automatischen Installation von Friendica:
- Eine vorgefertigte Konfigurationsdatei erstellen (z.B. `prepared.config.php`)
- Verwendung von Umgebungsvariablen (z.B. `MYSQL_HOST`)
- Verwendung von Optionen (z.B. `--dbhost <host>`)
- Eine vorgefertigte Konfigurationsdatei erstellen (z.B. `prepared.config.php`)
- Verwendung von Umgebungsvariablen (z.B. `MYSQL_HOST`)
- Verwendung von Optionen (z.B. `--dbhost <host>`)
Umgebungsvariablen und Optionen können auch kombiniert werden.
Dabei ist jedoch darauf zu achten, dass etwaige Optionen immer die zugehörigen Umgebungsvariablen überschreiben.
Für mehr Informationen kannst du diese Option verwenden:
bin/console autoinstall -v
```sh
bin/console autoinstall -v
```
Falls du alle optionalen Checks ausfürehn lassen möchtest, benutze diese Option:
bin/console autoinstall -a
```sh
bin/console autoinstall -a
```
*Wenn* die automatisierte Installation aus irgendeinem Grund fehlschlägt, dann prüfe das Folgende:
* Existiert die `config/local.config.php`? Falls ja, wird die automatisierte Installation nicht gestartet.
* Sind Einstellungen in der `config/local.config.php` korrekt? Falls nicht, bitte bearbeite diese Datei erneut.
* Ist die leere MySQL-Datenbank erstellt? Falls nicht, erstelle diese.
* Existiert die `config/local.config.php`? Falls ja, wird die automatisierte Installation nicht gestartet.
* Sind Einstellungen in der `config/local.config.php` korrekt? Falls nicht, bitte bearbeite diese Datei erneut.
* Ist die leere MySQL-Datenbank erstellt? Falls nicht, erstelle diese.
#### B.1: Konfigurationsdatei
Für diese Variante muss ein Konfigurationsdatei bereits vor der Installation fertig definiert sein (z.B. [local-sample.config.php](config/local-sample.config.php).
Gehe im Anschluss in den Friendica-Hauptordner und führe den Kommandozeilen Befehl aus:
bin/console autoinstall -f <prepared.config.php>
```sh
bin/console autoinstall -f <prepared.config.php>
```
#### B.2: Umgebungsvariablen
Es existieren Zwei Arten von Umgebungsvariablen in Friendica:
- Jene, die auch im normalen Betrieb verwendet werden können (derzeit ausschließlich **Datenbank Einstellungen**)
- Jene, die nur während der Installation verwedent werden können (im normalen Betrieb werden sie ignoriert)
- Jene, die auch im normalen Betrieb verwendet werden können (derzeit ausschließlich **Datenbank Einstellungen**)
- Jene, die nur während der Installation verwedent werden können (im normalen Betrieb werden sie ignoriert)
Umgebungsvariablen können auch durch adäquate Optionen (z.B. `--dbhost <hostname>`)übersteuert werden.
@ -166,57 +171,62 @@ Umgebungsvariablen können auch durch adäquate Optionen (z.B. `--dbhost <hostna
Nur wenn die Option `--savedb` gesetzt ist, werden diese Umgebungsvariablen auch in `config/local.config.php` gespeichert!
- `MYSQL_HOST` Der Host der MySQL/MariaDB Datenbank
- `MYSQL_PORT` Der Port der MySQL/MariaDB Datenbank
- `MYSQL_USERNAME` Der Benutzername des MySQL Datenbanklogins (MySql - Variante)
- `MYSQL_USER` Der Benutzername des MariaDB Datenbanklogins (MariaDB-Variante)
- `MYSQL_PASSWORD` Das Passwort der MySQL/MariaDB Datenbanklogins
- `MYSQL_DATABASE` Der Name der MySQL/MariaDB Datenbank
- `MYSQL_HOST` Der Host der MySQL/MariaDB Datenbank
- `MYSQL_PORT` Der Port der MySQL/MariaDB Datenbank
- `MYSQL_USERNAME` Der Benutzername des MySQL Datenbanklogins (MySql - Variante)
- `MYSQL_USER` Der Benutzername des MariaDB Datenbanklogins (MariaDB-Variante)
- `MYSQL_PASSWORD` Das Passwort der MySQL/MariaDB Datenbanklogins
- `MYSQL_DATABASE` Der Name der MySQL/MariaDB Datenbank
**Friendica Einstellungen**
Diese Umgebungsvariablen können nicht während des normalen Friendica Betriebs verwendet werden.
Sie werden stattdessen direkt in `config/local.config.php` gespeichert.
- `FRIENDICA_PHP_PATH` Der Pfad zur PHP-Datei
- `FRIENDICA_ADMIN_MAIL` Die Admin E-Mail Adresse dieses Friendica Knotens (wird auch für den Admin-Zugang benötigt)
- `FRIENDICA_TZ` Die Zeitzone von Friendica
- `FRIENDICA_LANG` Die Sprache von Friendica
- `FRIENDICA_PHP_PATH` Der Pfad zur PHP-Datei
- `FRIENDICA_ADMIN_MAIL` Die Admin E-Mail Adresse dieses Friendica Knotens (wird auch für den Admin-Zugang benötigt)
- `FRIENDICA_TZ` Die Zeitzone von Friendica
- `FRIENDICA_LANG` Die Sprache von Friendica
Gehe im Anschluss in den Friendica-Hauptordner und führe den Kommandozeilen Befehl aus:
bin/console autoinstall [--savedb]
```sh
bin/console autoinstall [--savedb]
```
#### B.3: Optionen
Alle Optionen werden in `config/local.config.php` gespeichert und überschreiben etwaige, zugehörige Umgebungsvariablen.
- `-H|--dbhost <host>` Der Host der MySQL/MariaDB Datenbank (env `MYSQL_HOST`)
- `-p|--dbport <port>` Der Port der MySQL/MariaDB Datenbank (env `MYSQL_PORT`)
- `-U|--dbuser <username>` Der Benutzername des MySQL/MariaDB Datenbanklogins (env `MYSQL_USER` or `MYSQL_USERNAME`)
- `-P|--dbpass <password>` Das Passwort der MySQL/MariaDB Datenbanklogins (env `MYSQL_PASSWORD`)
- `-d|--dbdata <database>` Der Name der MySQL/MariaDB Datenbank (env `MYSQL_DATABASE`)
- `-b|--phppath <path>` Der Pfad zur PHP-Datei (env `FRIENDICA_PHP_PATH`)
- `-A|--admin <mail>` Die Admin E-Mail Adresse dieses Friendica Knotens (env `FRIENDICA_ADMIN_MAIL`)
- `-T|--tz <timezone>` Die Zeitzone von Friendica (env `FRIENDICA_TZ`)
- `-L|--lang <language>` Die Sprache von Friendica (env `FRIENDICA_LANG`)
- `-H|--dbhost <host>` Der Host der MySQL/MariaDB Datenbank (env `MYSQL_HOST`)
- `-p|--dbport <port>` Der Port der MySQL/MariaDB Datenbank (env `MYSQL_PORT`)
- `-U|--dbuser <username>` Der Benutzername des MySQL/MariaDB Datenbanklogins (env `MYSQL_USER` or `MYSQL_USERNAME`)
- `-P|--dbpass <password>` Das Passwort der MySQL/MariaDB Datenbanklogins (env `MYSQL_PASSWORD`)
- `-d|--dbdata <database>` Der Name der MySQL/MariaDB Datenbank (env `MYSQL_DATABASE`)
- `-b|--phppath <path>` Der Pfad zur PHP-Datei (env `FRIENDICA_PHP_PATH`)
- `-A|--admin <mail>` Die Admin E-Mail Adresse dieses Friendica Knotens (env `FRIENDICA_ADMIN_MAIL`)
- `-T|--tz <timezone>` Die Zeitzone von Friendica (env `FRIENDICA_TZ`)
- `-L|--lang <language>` Die Sprache von Friendica (env `FRIENDICA_LANG`)
Gehe in den Friendica-Hauptordner und führe den Kommandozeilen Befehl aus:
bin/console autoinstall [options]
```sh
bin/console autoinstall [options]
```
### Einen Worker einrichten
Erstelle einen Cron job oder einen regelmäßigen Task, um den Poller alle 5-10 Minuten im Hintergrund ablaufen zu lassen.
Beispiel:
cd /base/directory; /path/to/php bin/console.php worker
```sh
cd /base/directory; /path/to/php bin/console.php worker
```
Ändere "/base/directory" und "/path/to/php" auf deine Systemvorgaben.
Wenn du einen Linux-Server nutzt, benutze den Befehl "crontab -e" und ergänze eine Zeile wie die Folgende; angepasst an dein System
`*/10 * * * * cd /home/myname/mywebsite; /usr/bin/php bin/console.php worker`
```crontab
*/10 * * * * cd /home/myname/mywebsite; /usr/bin/php bin/console.php worker
```
Du kannst den PHP-Pfad finden, indem du den Befehl „which php“ ausführst.
Wenn du Schwierigkeiten mit diesem Schritt hast, kannst du deinen Hosting-Anbieter kontaktieren.

View file

@ -1,7 +1,4 @@
Konnektoren installieren
==================================================
* [Zur Startseite der Hilfe](help)
# Konnektoren installieren
Friendica verwendet Konnektoren, um sich mit einigen Netzwerken zu verbinden, wie Tumblr oder Bluesky.
@ -19,8 +16,7 @@ Andere Konnektoren, wie Bluesky, benötigen überhaupt keinen API-Schlüssel.
Weitere Informationen zu den spezifischen Anforderungen findest du auf der Einstellungsseite des jeweiligen Addons, entweder auf der Verwaltungsseite oder auf der Benutzerseite.
Bluesky Jetstream
---
## Bluesky Jetstream
Um die Konnektivität mit Bluesky weiter zu verbessern, kann die „Jetstream“-Konnektivität aktiviert werden.
Jetstream ist ein Dienst, der sich mit dem Bluesky-Firehose verbindet.

View file

@ -1,7 +1,5 @@
# Settings
* [Zur Startseite der Hilfe](help)
Wenn du der Administrator einer Friendica-Instanz bist, hast du Zugriff auf das so genannte **Admin Panel** in dem du die Friendica-Instanz konfigurieren kannst,
Auf der Startseite des Admin Panels werden die Informationen zu der Instanz zusammengefasst.
@ -41,16 +39,15 @@ Sie wird verwendet, wenn es Friendica nicht gelingt die Spracheinstellungen des
Nutzer können diese Auswahl in den Einstellungen des Benutzerkontos überschreiben.
Die Friendica Gemeinschaft bietet einige Übersetzungen an, von denen einige mehr andere weniger komplett sind.
Mehr Informationen zum Übersetzungsprozess von Friendica findest du [auf dieser Seite](/help/translations) der Dokumentation.
Mehr Informationen zum Übersetzungsprozess von Friendica findest du [auf dieser Seite](/help/developer/translations) der Dokumentation.
#### Systemweites Theme
Hier kann das Theme bestimmt werden, welches standardmäßig zum Anzeigen der Seite verwendet werden soll.
Nutzer können in ihren Einstellungen andere Themes wählen.
Derzeit ist das "vier" Theme das vorausgewählte Theme.
Derzeit ist das "frio" Theme das vorausgewählte Theme.
Für mobile Geräte kannst du ein spezielles Theme wählen, wenn das Standardtheme ungeeignet für mobile Geräte sein sollte.
Das `vier` Theme z.B. unterstützt kleine Anzeigen und benötigt kein zusätzliches mobiles Theme.
### Registrierung
@ -66,7 +63,7 @@ Dabei kannst du zwischen den folgenden Optionen wählen:
##### Einladungen
Zusätzlich zu den oben genannten Möglichkeiten, kann die Registrierung eines neuen Nutzerkontos an eine Einladung durch einen bestehenden Nutzer gekoppelt werden.
Hierzu muss in der [config/local.config.php](/help/Config) Datei die Option `invitation_only` aktiviert und als Registrierungsmethode entweder *Offen* oder *Bedarf der Zustimmung* gewählt werden.
Hierzu muss in der [config/local.config.php](/help/admin/config) Datei die Option `invitation_only` aktiviert und als Registrierungsmethode entweder *Offen* oder *Bedarf der Zustimmung* gewählt werden.
#### Namen auf Vollständigkeit überprüfen
@ -106,7 +103,7 @@ Falls ein solches verwendet wird, sei an dieser Stelle nur auf deren Dokumentati
Die Grundeinstellung ist 'Datenbank (legacy)': Dies ist die alte Methode von Friendica Daten direkt in der Datenbank abzulegen.
Bestehende Daten können zum aktuell ausgewählten Backend verschoben werden.
Hierfür kann der ['storage move'](help/tools) Befehl der Friendica Konsole verwendet werden.
Hierfür kann der ['storage move'](help/admin/tools) Befehl der Friendica Konsole verwendet werden.
Sollte das ausgewählte Speicher Backand zusätzliche Konfigurationsparameter besitzen, werden nach der Auswahl des Backends hier weitere Felder angezeigt.
@ -335,10 +332,12 @@ Du solltest deshalb einen Dienst zur [log rotation](https://en.wikipedia.org/wik
Normalerweise werden Fehler- und Warnmeldungen von PHP unterdrückt.
Wenn du sie aktivieren willst, musst du folgendes in der `config/local.config.php` Datei eintragen um die Meldungen in die Datei `php.out` zu speichern
error_reporting(E_ERROR | E_WARNING | E_PARSE );
ini_set('error_log','php.out');
ini_set('log_errors','1');
ini_set('display_errors', '0');
```
error_reporting(E_ERROR | E_WARNING | E_PARSE );
ini_set('error_log','php.out');
ini_set('log_errors','1');
ini_set('display_errors', '0');
```
Die Datei `php.out` muss vom Webserver schreibbar sein und sollte ebenfalls außerhalb der Webverzeichnisse liegen.
Es kommt gelegentlich vor, dass nicht deklarierte Variablen referenziert werden, dehalb raten wir davon ab `E_NOTICE` oder `E_ALL` zu verwenden.
@ -367,13 +366,15 @@ Dies sind die Datenbank Einstellungen, die Administrator Accounts, der PHP Pfad
Mit den folgenden Einstellungen kannst du die Zugriffsdaten für den Datenbank Server festlegen.
'database' => [
'hostname' => 'localhost',
'username' => 'mysqlusername',
'password' => 'mysqlpassword',
'database' => 'mysqldatabasename',
'charset' => 'utf8mb4',
],
```
'database' => [
'hostname' => 'localhost',
'username' => 'mysqlusername',
'password' => 'mysqlpassword',
'database' => 'mysqldatabasename',
'charset' => 'utf8mb4',
],
```
Sollten alle der folgenden Environment-Variablen gesetzt sein, wird Friendica diese anstatt der vorher konfigurierten Werte nutzen.
@ -390,18 +391,22 @@ Normalerweise trifft dies auf den ersten Account zu, der nach der Installation a
Die Liste der E-Mail Adressen kann aber einfach erweitert werden.
Mit keiner der angegebenen E-Mail Adressen können weitere Accounts registriert werden.
'config' => [
'admin_email' => 'you@example.com, buddy@example.com',
],
```
'config' => [
'admin_email' => 'you@example.com, buddy@example.com',
],
```
## PHP Pfad
Einige Prozesse von Friendica laufen im Hintergrund.
Für diese Prozesse muss der Pfad zu der PHP Version gesetzt sein, die verwendet werden soll.
'config' => [
'php_path' => '/usr/bin/php',
],
```
'config' => [
'php_path' => '/usr/bin/php',
],
```
## Unterverzeichnis Konfiguration
@ -409,11 +414,13 @@ Man kann Friendica in ein Unterverzeichnis des Webservers installieren.
Wir raten allerdings dringen davon ab, da es die Interoperabilität mit anderen Netzwerken (z.B. Diaspora, GNU Social, Hubzilla) verhindert.
Mal angenommen, du hast ein Unterverzeichnis tests und willst Friendica in ein weiteres Unterverzeichnis installieren, dann lautet die Konfiguration hierfür:
'system' => [
'url' => 'https://example.com/tests/friendica',
],
```
'system' => [
'url' => 'https://example.com/tests/friendica',
],
```
## Weitere Ausnahmen
Es gibt noch einige experimentelle Einstellungen, die nur in der ``config/local.config.php`` Datei konfiguriert werden können.
Im [Konfigurationswerte, die nur in der config/local.config.php gesetzt werden können (EN)](help/Config) Artikel kannst du mehr darüber erfahren.
Im [Konfigurationswerte, die nur in der config/local.config.php gesetzt werden können (EN)](help/admin/config) Artikel kannst du mehr darüber erfahren.

View file

@ -1,7 +1,4 @@
Friendica mit SSL nutzen
=====================================
* [Zur Startseite der Hilfe](help)
# Friendica mit SSL nutzen
## Disclaimer
@ -47,9 +44,9 @@ Wenn ja, dann lies weiter.
Wenn du einen eigenen Server betreibst und den Nameserver kontrollierst, könnte auch die Initiative "Let's encrypt" interessant für dich werden.
Sie bietet nicht nur freie SSL Zertifikate sondern auch einen automatisierten Prozess zum Erneuern der Zertifikate.
Um letsencrypt Zertifikate verwenden zu können, musst du dir einen Client auf deinem Server installieren.
Eine Anleitung zum offiziellen Client findet du [hier](https://certbot.eff.org/).
Falls du dir andere Clients anschauen willst, kannst du einen Blick in diese [Liste von alternativen letsencrypt Clients](https://letsencrypt.org/docs/client-options/).
Um LetsEncrypt Zertifikate verwenden zu können, musst du dir einen Client auf deinem Server installieren.
Eine Anleitung zum offiziellen Client findest du [hier](https://certbot.eff.org/).
Falls du dir andere Clients anschauen willst, kannst du einen Blick in diese [Liste von alternativen LetsEncrypt Clients](https://letsencrypt.org/docs/client-options/).
## Webserver-Einstellungen
@ -62,32 +59,37 @@ Wenn du fertig bist, kannst du auf der Testseite [SSL-Labs](https://www.ssllabs.
## Friendica Konfigurieren
Wenn du deine Friendica Instanz über https erreichen kannst solltest du ein paar Einstellungen vornehmen um sicher zu stellen, dass deine Nutzer ausschließlich über https zugreifen können.
Wenn du deine Friendica Instanz über https erreichen kannst solltest du ein paar Einstellungen vornehmen um sicherzustellen, dass deine Nutzer ausschließlich über https zugreifen können.
### Webserver-Umleitungen
Dies ist der einfachste Weg den Zugriff für die ganze Webseite abzusichern.
Jedes Mal wenn ein Nutzer Friendica aufruft wird er permanent vom Webserver auf die abgesicherte Seite umgeleitet.
Jedes Mal, wenn ein Nutzer Friendica aufruft wird er permanent vom Webserver auf die abgesicherte Seite umgeleitet.
Wenn du den Apache Webserver verwendest, aktiviere die Module rewrite und ssl (bei einem Shared-Hosting Prider sollte dies bereits der Fall sein):
sudo a2enmod rewrite ssl
```sh
sudo a2enmod rewrite ssl
```
und füge die folgenden Zeilen zur .htaccess Datei im Wurzelverzeichnis deiner Friendica Instanz hinzu:
und füge die folgenden Zeilen zur `.htaccess` Datei im Wurzelverzeichnis deiner Friendica Instanz hinzu:
RewriteEngine On
RewriteCond %{SERVER_PORT} 80
RewriteRule ^(.*)$ https://your.friendica.domain/$1 [R=301,L]
```
RewriteEngine On
RewriteCond %{SERVER_PORT} 80
RewriteRule ^(.*)$ https://your.friendica.domain/$1 [R=301,L]
```
(Dank an [url=https://github.com/AlfredSK]AlfredSK[/url]).
Bei nginx solltest du deinen Server folgendermaßen konfigurieren ([documentation](https://www.nginx.com/blog/creating-nginx-rewrite-rules/)):
server {
listen 80;
server_name your.friendica.domain;
return 301 https://$server_name$request_uri;
}
```
server {
listen 80;
server_name your.friendica.domain;
return 301 https://$server_name$request_uri;
}
```
### SSL Einstellungen

View file

@ -1,7 +1,4 @@
Friendica Addon/Entwicklung
==============
* [Zur Startseite der Hilfe](help)
# Friendica Addon/Entwicklung
Bitte schau dir das Beispiel-Addon "randplace" für ein funktionierendes Beispiel für manche der hier aufgeführten Funktionen an.
Das Facebook-Addon bietet ein Beispiel dafür, die "addon"- und "module"-Funktion gemeinsam zu integrieren.
@ -28,15 +25,14 @@ Registriere deine Addon-Hooks während der Installation.
\Friendica\Core\Hook::register($hookname, $file, $function);
$hookname ist ein String und entspricht einem bekannten Friendica-Hook.
`$hookname` ist ein String und entspricht einem bekannten Friendica-Hook.
$file steht für den Pfadnamen, der relativ zum Top-Level-Friendicaverzeichnis liegt.
Das *sollte* "addon/addon_name/addon_name.php' sein.
$file steht für den Pfadnamen, der relativ zum Top-Level-Friendica-Verzeichnis liegt.
Das *sollte* `addon/addon_name/addon_name.php` sein.
$function ist ein String und der Name der Funktion, die ausgeführt wird, wenn der Hook aufgerufen wird.
Argumente
---
## Argumente
Deine Hook-Callback-Funktion wird mit höchstens einem Argumenten aufgerufen
@ -51,8 +47,7 @@ Diese Information ist speziell auf den Hook bezogen, der aktuell bearbeitet wird
Achte darauf, diese mit "&" zu deklarieren, wenn du sie bearbeiten willst.
Module
---
## Module
Addons können auch als "Module" agieren und alle Seitenanfragen für eine bestimte URL abfangen.
Um ein Addon als Modul zu nutzen, ist es nötig, die Funktion "addon_name_module()" zu definieren, die keine Argumente benötigt und nichts weiter machen muss.
@ -72,8 +67,7 @@ Sie können auch `addon_name_post()` umfassen, welches vor der content-Funktion
Du kannst ebenso `addon_name_init()` nutzen, was oft frühzeitig aufgerufen wird und das Modul initialisert.
Derzeitige Hooks
---
## Derzeitige Hooks
**'authenticate'** - wird aufgerufen, wenn sich der User einloggt.
$b ist ein Array
@ -189,8 +183,7 @@ Dieser Hook kann dafür verwendet werden, alternative Erkennungsfunktionen einzu
- wird aufgerufen nachdem in include/nav,php der Inhalt des Navigations Menüs erzeugt wurde.
- $b ist ein Array, das $nav wiederspiegelt.
Komplette Liste der Hook-Callbacks
---
## Komplette Liste der Hook-Callbacks
Eine komplette Liste aller Hook-Callbacks mit den zugehörigen Dateien (am 01-Apr-2018 generiert): Bitte schau in die Quellcodes für Details zu Hooks, die oben nicht dokumentiert sind.

View file

@ -1,7 +1,4 @@
Friendica - Entwickler-Guide
==========
* [Zur Startseite der Hilfe](help)
# Friendica - Entwickler-Guide
Hier erfährst Du, wie Du bei uns mitmachen kannst:
@ -9,19 +6,19 @@ Zunächst erstelle Dir per 'git clone https://github.com/friendica/friendica.git
Erstelle Deine eigene Kopie (fork) der Ursprungsdaten auf Github, an der Du dann entspannt arbeiten kannst.
Deine Arbeiten sollten mit einem neuen Arbeitszweig (branch) beginnen, den du vom develop Zweig des Repositories beginnst.
Die Anleitung unter [http://help.github.com/fork-a-repo/](http://help.github.com/fork-a-repo/) erklärt Dir genau, wie Du das tun musst.
Die Anleitung unter [http://help.github.com/fork-a-repo/](http://help.github.com/fork-a-repo/) erklärt dir genau, wie du das tun musst.
Gehe dann nach getaner Arbeit zu Deiner Github-Seite und erstelle eine "Pull request", um Deine Änderungen in das Hauptprojekt einzugliedern (merge).
Solltest du keine Idee haben, an welcher Stelle du einsteigen könntest.
Solltest du keine Idee haben, an welcher Stelle du einsteigen könntest?
Wir haben einige Aufgaben auf github mit dem Schlagwort *Junior Job* versehen.
Bei diesen Aufgaben gehen wir davon aus, dass sie geeignete Einstiegsstellen sind.
Du musst dich aber natürlich nicht mit diesen Aufgaben beschäftigen um den Friendica Code zu verbeesern.
Du musst dich aber natürlich nicht mit diesen Aufgaben beschäftigen um den Friendica Code zu verbessern.
**Wichtig**
Bitte hole Dir alle Änderungen aus dem Projektverzeichnis und führe sie mit Deiner Arbeit zusammen, **bevor** Du Deine "pull request" erstellst. Wir behalten es uns vor, Patches abzulehnen, die eine große Anzahl an Fehlern hervorrufen.
Dies gilt vor allem für Übersetzungen, da wir hier möglicherweise nicht alle feinen Unterschiede in konfliktären Versionen erkennen können.
Dies gilt vor allem für Übersetzungen, da wir hier möglicherweise nicht alle feinen Unterschiede in konfliktähren Versionen erkennen können.
Außerdem: **teste Deine Änderungen!** Vergiss nicht, dass eine simple Fehlerlösung einen anderen Fehler auslösen kann.
Lass Deine Änderungen von einem erfahrenen Friendica-Entwickler gegenprüfen.

View file

@ -1,26 +0,0 @@
Erste Schritte...
==========
* [Zur Startseite der Hilfe](help)
Das Erste zum Anfang: geh sicher, dass du schon eingeloggt bist.
Wenn du noch nicht eingeloggt bist, kannst du das in dem Fenster unten machen.
Sobald du eingeloggt bist (oder wenn du bereits eingeloggt bist), kannst du unten nun auf deine Profilseite schauen.
Hier sieht es ein wenig wie auf deiner Facebook-Seite aus.
Hier findest du alle deine Statusmeldungen und Nachrichten deiner Freunde, die direkt auf deine Seite ("Wall") geschrieben haben.
Um deinen Status einzutragen, klicke einfach auf die Box oben, in der "Teilen" steht.
Wenn du das machst, vergrößert sich die Box.
Nun kannst du einige Formatierungsoptionen wie Fett, kursiv, unterstrichen auswählen und ebenfalls Bilder und Links hinzufügen.
Unten findest du in diesem Feld weitere Links, mit denen du Bilder und Dateien von deinem Computer hochladen, Webseiten mit einem Kurztext teilen und Video- und Audiodateien aus dem Internet einfügen kannst.
Außerdem kannst du hier eintragen, wo du gerade bist.
Wenn du deinen Beitrag ("Post") geschrieben hast, kannst du auf das "Schloss"-Symbol klicken und festlegen, wer deinen Beitrag sehen kann.
Wenn du dieses Symbol nicht anklickst, ist dein Beitrag öffentlich.
Das bedeutet, dass jeder, der dein Profil ansieht, der auf dem "Community"-Tab deines Servers oder auf dem "Netzwerk"-Tab ("Beiträge deiner Kontakte") eines befreundeten Kontakts ist, den Beitrag sehen kann.
Probiere es doch einfach mal aus. Wenn du fertg bist, schauen wir uns den <a href="help/network">"Netzwerk"-Tab</a> an.
<iframe src="login" width="950" height="600"></iframe>

72
doc/de/home.md Normal file
View file

@ -0,0 +1,72 @@
# Hilfe
## Dokumentation für Benutzer
* Allgemeine Funktionen - Erste Schritte
* [Account - Basics](help/user/account-basics)
* [Schnellstart für neue Benutzer](help/user/quick-start/guide)
* [Beiträge erstellen](help/user/text-editor)
* [Referenz der BBCode Elemente](help/user/bbcode)
* [Beiträge kommentieren, einordnen und löschen](help/user/text-comment)
* [Referenz der Accesskeys](help/user/access-keys) (EN)
* [Veranstaltungen](help/user/events)
* [Themes](help/user/themes) (EN)
* Du und andere Nutzer
* [Konnektoren (Connectors)](help/user/connectors)
* [Freunde finden](help/user/making-friends)
* [Circles und Privatsphäre](help/user/circles-and-privacy)
* [Tags und Erwähnungen](help/user/tags-and-mentions)
* [Accountypen: Gruppen und Seiten](help/user/accounts-groups-pages)
* [Kanäle (Channels)](help/user/channels)
* [Chats](help/user/chats)
* Weiterführende Informationen
* [Häufig gestellte Fragen (FAQ)](help/user/faq)
* [Account umziehen](help/user/move-account)
* [Export / Import gefolgter Kontakte](help/user/export-import-contacts)
* [Account löschen](help/user/delete-account)
* [Bugs und Probleme](help/user/bugs-and-issues)
## Dokumentation für Administratoren
* [Installation](help/admin/install)
* [Update](help/admin/update) (EN)
* [Häufig gestellte Fragen FAQ](help/admin/faq)
* [Konfigurationen & Admin-Panel](help/admin/settings)
* [Konnektoren (Connectors) installieren](help/admin/installing-connectors)
* [Installation eines ejabberd Servers (XMPP-Chat) mit synchronisierten Anmeldedaten](help/admin/install-ejabberd) (EN)
* [Betreibe deine Seite mit einem SSL-Zertifikat](help/admin/ssl)
* [Konfigurationswerte, die nur in der config/local.config.php gesetzt werden können](help/admin/config) (EN)
* [Performance verbessern](help/admin/improve-performance)
* [Administration Werkzeuge](help/admin/tools) (EN)
## Dokumentation für Entwickler
* [Guide](help/developer/guide)
* [Where to get started?](help/developer/index) (EN)
* [On GitHub](help/developer/github) (EN)
* [On Vagrant](help/developer/vagrant) (EN)
* [Translate Friendica](help/developer/translations) (EN)
* [Addon Development](help/developer/addon-development)
* [Smarty 3 Templates](help/developer/smarty3-templates) (EN)
* [Protokoll Dokumentation](help/spec/protocol/protocol) (EN)
* [Datenbank-Schema](help/spec/database/index) (EN)
* [Class Autoloading](help/developer/autoloader) (EN)
* [Using Composer](help/developer/composer) (EN)
* [Code-Referenz (mit doxygen generiert - setzt Cookies)](doc/html/)
* [API Dokumentation](help/spec/api/index) (EN)
* [Run tests](help/developer/tests) (EN)
## Links
* Website: [https://friendi.ca](https://friendi.ca)
* Help Group: [@helpers@forum.friendi.ca](https://forum.friendi.ca/~helpers)
* XMPP: [support@forum.friendi.ca](xmpp:support@forum.friendi.ca?join)
* IRC: [https://web.libera.chat/?channels=#friendica](https://web.libera.chat/?channels=#friendica)
* Matrix: [https://matrix.to/#/#friendi.ca:matrix.org](https://matrix.to/#/#friendi.ca:matrix.org)
* Mailing List: [https://mailman.friendi.ca/mailman/listinfo/support-friendi.ca](http://mailman.friendi.ca/mailman/listinfo/support-friendi.ca)
## Über
* [Server Information](friendica)
* [Nutzungsbedingungen](tos)
* [Mitwirkende](credits)

View file

@ -1,9 +1,8 @@
Friendica-doc-german
====================
# Friendica-doc-german
Friendica - doc - german
Hier findest du die deutsche Version der Friendica-Hilfedateien.
Es handelt sich um eine selbst erstellte, öffentlich freigegebene Arbeit mit dem Ziel, Friendica durch deutsche Hilfedateien für weitere Personen zugänglich zu machen, die dem Englischen nicht ausreichend mächtig sind.
Hier findest du die deutsche Version der Friendica-Hilfedateien.
Es handelt sich um eine selbst erstellte, öffentlich freigegebene Arbeit mit dem Ziel, Friendica durch deutsche Hilfedateien für weitere Personen zugänglich zu machen, die dem Englischen nicht ausreichend mächtig sind.
Die Daten basieren auf dem offiziellen Friendica-Github https://github.com/friendica/friendica (Stand: 03.11.12)

View file

@ -1,14 +1,11 @@
Friendica Nachrichtenfluss
==============
# Friendica Nachrichtenfluss
* [Zur Startseite der Hilfe](help)
Diese Seite soll einige Infos darüber dokumentieren, wie Nachrichten innerhalb von Friendica von einer Person zur anderen übertragen werden.
Es gibt verschiedene Pfade, die verschiedene Protokolle und Nachrichtenformate nutzen.
Diese Seite soll einige Infos darüber dokumentieren, wie Nachrichten innerhalb von Friendica von einer Person zur anderen übertragen werden.
Es gibt verschiedene Pfade, die verschiedene Protokolle und Nachrichtenformate nutzen.
Diejenigen, die den Nachrichtenfluss genauer verstehen wollen, sollten sich mindestens mit dem DFRN-Protokoll ([Dokument mit den DFRN Spezifikationen](https://github.com/friendica/friendica/blob/stable/spec/dfrn2.pdf)) und den Elementen zur Nachrichtenverarbeitung des OStatus Stack informieren (salmon und Pubsubhubbub).
Wenn eine Nachricht veröffentlicht wird, werden alle Übermittlungen an alle Netzwerke mit include/notifier.php durchgeführt, welche entscheidet, wie und an wen die Nachricht geliefert wird.
Wenn eine Nachricht veröffentlicht wird, werden alle Übermittlungen an alle Netzwerke mit include/notifier.php durchgeführt, welche entscheidet, wie und an wen die Nachricht geliefert wird.
Diese Datei bindet dabei die lokale Bearbeitung aller Übertragungen ein inkl. dfrn-notify.
mod/dfrn_notify.php handhabt die Rückmeldung (remote side) von dfrn-notify.
@ -22,40 +19,40 @@ PuSh-Feeds (pubsubhubbub) kommen via mod/pubsub.php an.
DFRN-poll Feed-Imports kommen via src/Worker/OnePoll.php als geplanter Task an, das implementiert die lokale Bearbeitung (local side) des DFRN-Protokolls.
### Szenario #1. Bob schreibt eine öffentliche Statusnachricht
## Szenario #1. Bob schreibt eine öffentliche Statusnachricht
Dies ist eine öffentliche Nachricht ohne begrenzte Nutzerfreigabe, so dass keine private Übertragung notwendig ist.
Es gibt zwei Wege, die genutzt werden können - als bbcode an DFRN-Clients oder als durch den Server konvertierten HTML-Code (mit PuSH; pubsubhubbub).
Wenn ein PuSH-Hub einsatzfähig ist, nutzen DFRN-Poll-Clients vorrangig die Informationen, die durch den PuSH-Kanal kommen.
Sie fallen zurück auf eine tägliche Abfrage, wenn der Hub Übertragungsschwierigkeiten hat (das kann vorkommen, wenn der standardmäßige Google-Referenzhub genutzt wird).
Wenn kein spezifizierter Hub oder Hubs ausgewählt sind, werden DFRN-Clients in einer pro Kontakt konfigurierbaren Rate mit bis zu 5-Minuten-Intervallen abfragen.
Dies ist eine öffentliche Nachricht ohne begrenzte Nutzerfreigabe, so dass keine private Übertragung notwendig ist.
Es gibt zwei Wege, die genutzt werden können - als bbcode an DFRN-Clients oder als durch den Server konvertierten HTML-Code (mit PuSH; pubsubhubbub).
Wenn ein PuSH-Hub einsatzfähig ist, nutzen DFRN-Poll-Clients vorrangig die Informationen, die durch den PuSH-Kanal kommen.
Sie fallen zurück auf eine tägliche Abfrage, wenn der Hub Übertragungsschwierigkeiten hat (das kann vorkommen, wenn der standardmäßige Google-Referenzhub genutzt wird).
Wenn kein spezifizierter Hub oder Hubs ausgewählt sind, werden DFRN-Clients in einer pro Kontakt konfigurierbaren Rate mit bis zu 5-Minuten-Intervallen abfragen.
Feeds, die via DFRN-Poll abgerufen werden, sind bbcode und können auch private Unterhaltungen enthalten, die vom Poller auf ihre Zugriffsrechte hin geprüft werden.
### Szenario #2. Jack antwortet auf Bobs öffentliche Nachricht. Jack ist im Friendica/DFRN-Netzwerk.
## Szenario #2. Jack antwortet auf Bobs öffentliche Nachricht. Jack ist im Friendica/DFRN-Netzwerk.
Jack nutzt dfrn-notify, um eine direkte Antwort an Bob zu schicken.
Bob erstellt dann einen Feed der Unterhaltung und sendet diesen an jeden, der an der Unterhaltung beteiligt ist und dfrn-notify nutzt.
Jack nutzt dfrn-notify, um eine direkte Antwort an Bob zu schicken.
Bob erstellt dann einen Feed der Unterhaltung und sendet diesen an jeden, der an der Unterhaltung beteiligt ist und dfrn-notify nutzt.
Die PuSH-Hubs werden darüber informiert, dass neuer Inhalt verfügbar ist. Der/die Hub/s erhalten dann die neuesten Feeds und übertragen diese an alle Hub-Teilnehmer (die auch zu verschiedenen Netzwerken gehören können).
### Szenario #3. Mary antwortet auf Bobs öffentliche Nachricht. Mary ist im Friendica/DFRN-Netzwerk.
## Szenario #3. Mary antwortet auf Bobs öffentliche Nachricht. Mary ist im Friendica/DFRN-Netzwerk.
Mary nutzt dfrn-notify, um eine direkte Antwort an Bob zu schicken.
Bob erstellt dann einen Feed der Unterhaltung und sendet diesen an jeden, der an der Unterhaltung beteiligt ist (mit Ausnahme von Bob selbst; die Unterhaltung wird nun an Jack und Mary geschickt).
Die Nachrichten werden mit dfrn-notify übertragen.
PuSH-Hubs werden darüber informiert, dass neuer Inhalt verfügbar ist.
Mary nutzt dfrn-notify, um eine direkte Antwort an Bob zu schicken.
Bob erstellt dann einen Feed der Unterhaltung und sendet diesen an jeden, der an der Unterhaltung beteiligt ist (mit Ausnahme von Bob selbst; die Unterhaltung wird nun an Jack und Mary geschickt).
Die Nachrichten werden mit dfrn-notify übertragen.
PuSH-Hubs werden darüber informiert, dass neuer Inhalt verfügbar ist.
Der/die Hub/s erhalten dann die neuesten Feeds und übertragen sie an alle Hub-Teilnehmer (die auch zu verschiedenen Netzwerken gehören können).
### Szenario #4. William antwortet auf Bobs öffentliche Nachricht. William ist in einem OStatus-Netzwerk.
## Szenario #4. William antwortet auf Bobs öffentliche Nachricht. William ist in einem OStatus-Netzwerk.
William nutzt salmon, um Bob über seine Antwort zu benachrichtigen.
Der Inhalt ist HTML-Code, der in das Salmon Magic Envelope eingebettet ist.
Bob erstellt dann einen Feed der Unterhaltung und sendet es an alle Friendica-Nutzer, die an der Unterhaltung beteiligt sind und dfrn-notify nutzen (mit Ausnahme von William selbst; die Unterhaltung wird an Jack und Mary weitergeleitet).
William nutzt salmon, um Bob über seine Antwort zu benachrichtigen.
Der Inhalt ist HTML-Code, der in das Salmon Magic Envelope eingebettet ist.
Bob erstellt dann einen Feed der Unterhaltung und sendet es an alle Friendica-Nutzer, die an der Unterhaltung beteiligt sind und dfrn-notify nutzen (mit Ausnahme von William selbst; die Unterhaltung wird an Jack und Mary weitergeleitet).
PuSH-Hubs werden darüber informiert, dass neuer Inhalt verfügbar ist. Der/die Hub/s erhalten dann die neuesten Feeds und übertragen sie an alle Hub-Teilnehmer (die auch zu verschiedenen Netzwerken gehören können).
### Szenario #5. Bob schreibt eine private Nachricht an Mary und Jack.
## Szenario #5. Bob schreibt eine private Nachricht an Mary und Jack.
Die Nachricht wird sofort an Mary und Jack mit Hilfe von dfrn_notify geschickt.
Öffentliche Hubs werden nicht benachrichtigt.
Im Falle eines Timeouts wird eine erneute Verarbeitung angestoßen.
Antworten folgen dem gleichen Nachrichtenfluss wie öffentliche Antworten, allerdings werden die Hubs nicht darüber informiert, wodurch die Nachrichten niemals in öffentliche Feeds gelangen.
Die Nachricht wird sofort an Mary und Jack mithilfe von dfrn_notify geschickt.
Öffentliche Hubs werden nicht benachrichtigt.
Im Falle eines Timeouts wird eine erneute Verarbeitung angestoßen.
Antworten folgen dem gleichen Nachrichtenfluss wie öffentliche Antworten, allerdings werden die Hubs nicht darüber informiert, wodurch die Nachrichten niemals in öffentliche Feeds gelangen.
Die komplette Unterhaltung ist nur für Mary und Jack in ihren durch dfrn-poll personalisierten Feeds verfügbar (und für niemanden sonst).

View file

@ -1,8 +1,4 @@
Account - Basics
==============
* [Zur Startseite der Hilfe](help)
# Account - Basics
## Registrierung
@ -19,15 +15,12 @@ Falls du keine [OpenID-Adresse](https://de.wikipedia.org/wiki/OpenID">OpenID-Adr
Solltest du eine OpenID Adresse haben, kannst Du sie im ersten Feld eintragen und "Registrieren" klicken.
Friendica wird versuchen, so viele Informationen wie möglich von Deinem OpenID-Provider zu übernehmen, um diese in Dein Profil auf dieser Seite einzutragen.
### Dein vollständiger Name
Bitte trage bei "vollständiger Name" Deinen **gewünschten Namen** ein, wie er über deinen Beiträgen angezeigt werden soll.
Du kannst deinen echten Namen eintragen, kannst Dir aber auch einen Namen ausdenken. Einen Zwang zu dem sogenannten Klarnamen gibt es nicht.
Du kannst deinen echten Namen eintragen, kannst dir aber auch einen Namen ausdenken. Einen Zwang zu dem sogenannten Klarnamen gibt es nicht.
### Email-Adresse
### E-Mail-Adresse
Bitte trage eine richtige Email-Adresse ein.
Dies ist die einzige persönliche Information, die korrekt sein muss.
@ -51,45 +44,40 @@ Durch die Art, wie der Spitzname genutzt wird, gibt es bestimmte Einschränkunge
Dieser Spitzname wird an vielen Stellen genutzt, um Deinen Account zu identifizieren, daher ist es nicht möglich ihn später zu ändern.
### Verzeichnis-Eintrag
Das Registrierungsformular erlaubt es dir, direkt auszuwählen, ob Du im [Onlineverzeichnis](https://dir.friendica.social/) (Friendica Directory) aufgelistet wirst oder nicht.
Das ist wie ein Telefonbuch und Du entscheidest, ob du darin eingetragen werden möchtest, oder nicht.
Das ist wie ein Telefonbuch und du entscheidest, ob du darin eingetragen werden möchtest, oder nicht.
* Wir bitten dich, "Ja" zu wählen, damit Andere Dich finden können, so wie Du sie finden kannst
* Wir bitten dich, "Ja" zu wählen, damit Andere dich finden können, so wie Du sie finden kannst
* Wählst Du "Nein", bist Du für Andere *nicht einfach auffindbar*
Was auch immer Du wählst, kann jederzeit nach dem Login in Deinen Account-Einstellungen geändert werden.
### Registrierung
Sobald Du die nötigen Informationen eingegeben hast, klicke auf "Registrieren".
Eine Email mit den Registrierungsdetails und Deinem Initialpasswort wird an die hinterlegte Email-Adresse geschickt.
Bitte prüfe den Posteingang (inkl. dem Spam-Ordner).
Bitte prüfe den Posteingang (inklusive dem Spam-Ordner).
## Login-Seite
Gib auf der "Login"-Seite die Informationen ein, die Du mit der oben genannten Email erhalten hast.
Du kannst entweder Deinen Spitznamen oder die Email-Adresse als Login-Namen nutzen.
Wenn Du Deinen Account nutzt, um unterschiedliche '[Seiten](help/Pages)' zu verwalten, die die gleiche Email-Adresse verwenden, dann nutze bitte den Spitznamen des Accounts, der verwaltet werden soll.
Wenn Du Deinen Account nutzt, um unterschiedliche '[accounts (Gruppen/Seiten)](help/accounts-groups-pages)' zu verwalten, die die gleiche Email-Adresse verwenden, dann nutze bitte den Spitznamen des Accounts, der verwaltet werden soll.
*Wenn* Dein Account OpenID nutzt, dann kannst Du Deine OpenID-Adresse als Login-Name nutzen und das Passwort-Feld frei lassen.
Du wirst zu Deinem OpenID-Anbieter weitergeleitet, wo Du Deine Anmeldung abschließt.
Du wirst zu deinem OpenID-Anbieter weitergeleitet, wo Du Deine Anmeldung abschließt.
Wenn Du OpenID nicht nutzt, dann gib Dein Passwort ein, das Du mit der Registrierungsmail erhalten hast.
Das Passwort muss genau so geschrieben werden, wie es in der Email steht; Groß- und Kleinschreibung wird beachtet.
Falls Du Schwierigkeiten beim Login hast, prüfe bitte, ob z. B. Deine Feststelltaste aktiv ist.
### Passwort ändern
Besuche nach Deinem ersten Login bitte die Einstellungsseite und wechsle das Passwort in eines, dass Du Dir merken kannst.
## Die ersten Schritte
### Persönliche Daten exportieren
@ -106,17 +94,14 @@ Dies ist z.B. dann nützlich wenn du mit deinem Account auf einen anderen Friend
Ein ['Tipp für neue Mitglieder'](newmember)-Link zeigt sich in den ersten beiden Wochen auf Deiner Startseite, um Dir erste Informationen zum Start zu bieten.
## Schau Dir ebenfalls folgende Seiten an
* [Circles und Privatssphäre](help/Circles-and-Privacy)
* [Circles und Privatssphäre](help/user/circles-and-privacy)
* [Account löschen](help/Remove-Account)
* [Account löschen](help/user/delete-account)
### Der eigene Friendica-Knoten
Wenn Du Deinen eigenen Friendica-Knoten auf einem Server aufsetzen willst, kannst Du das ebenfalls machen.
Besuche die [Friendica-Webseite](https://friendi.ca), um den Code mit den Installationsanleitungen herunterzuladen.
Es ist ein einfacher Installationsprozess, den jeder mit ein wenig technischen Erfahrungen im Webseiten-Hosting oder mit grundlegenden Linux-Erfahrungen handhaben kann.

View file

@ -1,8 +1,4 @@
Gruppen
=====
* [Zur Startseite der Hilfe](help)
# Accounttypen: Gruppen und Seiten
In Friendica kannst Du auch Gruppen und/oder Prominenten-Seiten erstellen.

View file

@ -1,7 +1,4 @@
Referenz der Friendica BBCode Tags
========================
* [Zur Startseite der Hilfe](help)
# Referenz der Friendica BBCode Tags
## Inline
@ -61,8 +58,8 @@ table.bbcodes > * > tr > th {
<td><span style="color: red;">rot</span></td>
</tr>
<tr>
<td>[url=http://friendi.ca]Friendica[/url]</td>
<td><a href="http://friendi.ca" target="external-link">Friendica</a></td>
<td>[url=https://friendi.ca]Friendica[/url]</td>
<td><a href="https://friendi.ca" target="external-link">Friendica</a></td>
</tr>
<tr>
<td>[img]https://raw.githubusercontent.com/friendica/friendica/stable/images/friendica-32.png[/img]</td>
@ -103,23 +100,23 @@ table.bbcodes > * > tr > th {
<th>Ergebnis</th>
</tr>
<tr>
<td>[url]http://friendi.ca[/url]</td>
<td><a href="http://friendi.ca">http://friendi.ca</a></td>
<td>[url]https://friendi.ca[/url]</td>
<td><a href="https://friendi.ca">https://friendi.ca</a></td>
</tr>
<tr>
<td>[url=http://friendi.ca.com]Friendica[/url]</td>
<td><a href="http://friendi.ca.com">Friendica</a></td>
<td>[url=https://friendi.ca.com]Friendica[/url]</td>
<td><a href="https://friendi.ca.com">Friendica</a></td>
</tr>
<tr>
<td>[bookmark]http://friendi.ca[/bookmark]<br><br>
#^[url]http://friendi.ca[/url]</td>
<td><span class="oembed link"><h4>Friendica: <a href="http://friendi.ca" rel="oembed"></a><a href="http://friendi.ca" target="_blank" rel="noopener noreferrer">http://friendi.ca</a></h4></span></td>
<td>[bookmark]https://friendi.ca[/bookmark]<br><br>
#^[url]https://friendi.ca[/url]</td>
<td><span class="oembed link"><h4>Friendica: <a href="https://friendi.ca" rel="oembed"></a><a href="https://friendi.ca" target="_blank" rel="noopener noreferrer">https://friendi.ca</a></h4></span></td>
</tr>
<tr>
<td>[bookmark=http://friendi.ca]Lesezeichen[/bookmark]<br><br>
#^[url=http://friendi.ca]Lesezeichen[/url]<br><br>
#[url=http://friendi.ca]^[/url][url=http://friendi.ca]Lesezeichen[/url]</td>
<td><span class="oembed link"><h4>Friendica: <a href="http://friendi.ca" rel="oembed"></a><a href="http://friendi.ca" target="_blank" rel="noopener noreferrer">Lesezeichen</a></h4></span></td>
<td>[bookmark=https://friendi.ca]Lesezeichen[/bookmark]<br><br>
#^[url=https://friendi.ca]Lesezeichen[/url]<br><br>
#[url=https://friendi.ca]^[/url][url=https://friendi.ca]Lesezeichen[/url]</td>
<td><span class="oembed link"><h4>Friendica: <a href="https://friendi.ca" rel="oembed"></a><a href="https://friendi.ca" target="_blank" rel="noopener noreferrer">Lesezeichen</a></h4></span></td>
</tr>
<tr>
<td>[url=/posts/f16d77b0630f0134740c0cc47a0ea02a]Diaspora Beitrag mit GUID[/url]</td>
@ -171,7 +168,7 @@ Zeilen</code></td>
</tr>
<tr>
<td>[code=php]function text_highlight($s,$lang)[/code]</td>
<td><code><div class="hl-main"><ol class="hl-main"><li><span class="hl-code">&nbsp;</span><span class="hl-reserved">function</span><span class="hl-code"> </span><span class="hl-identifier">text_highlight</span><span class="hl-brackets">(</span><span class="hl-var">$s</span><span class="hl-code">,</span><span class="hl-var">$lang</span><span class="hl-brackets">)</span></li></ol></div></code></td>
<td><code><div class="hl-main"><ol class="hl-main"><li><span class="hl-code"> </span><span class="hl-reserved">function</span><span class="hl-code"> </span><span class="hl-identifier">text_highlight</span><span class="hl-brackets">(</span><span class="hl-var">$s</span><span class="hl-code">,</span><span class="hl-var">$lang</span><span class="hl-brackets">)</span></li></ol></div></code></td>
</tr>
<tr>
<td>[quote]Zitat[/quote]</td>
@ -255,21 +252,21 @@ Zeilen</code></td>
</tr>
<tr>
<td>[table]<br>
&nbsp;&nbsp;[tr]<br>
&nbsp;&nbsp;&nbsp;&nbsp;[th]Kopfzeile 1[/th]<br>
&nbsp;&nbsp;&nbsp;&nbsp;[th]Kopfzeile 2[/th]<br>
&nbsp;&nbsp;&nbsp;&nbsp;[th]Kopfzeile 2[/th]<br>
&nbsp;&nbsp;[/tr]<br>
&nbsp;&nbsp;[tr]<br>
&nbsp;&nbsp;&nbsp;&nbsp;[td]Zelle 1[/td]<br>
&nbsp;&nbsp;&nbsp;&nbsp;[td]Zelle 2[/td]<br>
&nbsp;&nbsp;&nbsp;&nbsp;[td]Zelle 3[/td]<br>
&nbsp;&nbsp;[/tr]<br>
&nbsp;&nbsp;[tr]<br>
&nbsp;&nbsp;&nbsp;&nbsp;[td]Zelle 4[/td]<br>
&nbsp;&nbsp;&nbsp;&nbsp;[td]Zelle 5[/td]<br>
&nbsp;&nbsp;&nbsp;&nbsp;[td]Zelle 6[/td]<br>
&nbsp;&nbsp;[/tr]<br>
[tr]<br>
[th]Kopfzeile 1[/th]<br>
[th]Kopfzeile 2[/th]<br>
[th]Kopfzeile 2[/th]<br>
[/tr]<br>
[tr]<br>
[td]Zelle 1[/td]<br>
[td]Zelle 2[/td]<br>
[td]Zelle 3[/td]<br>
[/tr]<br>
[tr]<br>
[td]Zelle 4[/td]<br>
[td]Zelle 5[/td]<br>
[td]Zelle 6[/td]<br>
[/tr]<br>
[/table]</td>
<td>
<table>
@ -352,12 +349,12 @@ Zeilen</code></td>
</tr>
<tr>
<td>[ul]<br>
&nbsp;&nbsp;[li] Erstes Listenelement<br>
&nbsp;&nbsp;[li] Zweites Listenelement<br>
[li] Erstes Listenelement<br>
[li] Zweites Listenelement<br>
[/ul]<br>
[list]<br>
&nbsp;&nbsp;[li] Erstes Listenelement<br>
&nbsp;&nbsp;[li] Zweites Listenelement<br>
[li] Erstes Listenelement<br>
[li] Zweites Listenelement<br>
[/list]</td>
<td>
<ul class="listbullet" style="list-style-type: circle;">
@ -368,12 +365,12 @@ Zeilen</code></td>
</tr>
<tr>
<td>[ol]<br>
&nbsp;&nbsp;[li] Erstes Listenelement<br>
&nbsp;&nbsp;[li] Zweites Listenelement<br>
[li] Erstes Listenelement<br>
[li] Zweites Listenelement<br>
[/ol]<br>
[list=1]<br>
&nbsp;&nbsp;[li] Erstes Listenelement<br>
&nbsp;&nbsp;[li] Zweites Listenelement<br>
[li] Erstes Listenelement<br>
[li] Zweites Listenelement<br>
[/list]</td>
<td>
<ul class="listdecimal" style="list-style-type: decimal;">
@ -384,8 +381,8 @@ Zeilen</code></td>
</tr>
<tr>
<td>[list=]<br>
&nbsp;&nbsp;[li] Erstes Listenelement<br>
&nbsp;&nbsp;[li] Zweites Listenelement<br>
[li] Erstes Listenelement<br>
[li] Zweites Listenelement<br>
[/list]</td>
<td>
<ul class="listnone" style="list-style-type: none;">
@ -396,8 +393,8 @@ Zeilen</code></td>
</tr>
<tr>
<td>[list=i]<br>
&nbsp;&nbsp;[li] Erstes Listenelement<br>
&nbsp;&nbsp;[li] Zweites Listenelement<br>
[li] Erstes Listenelement<br>
[li] Zweites Listenelement<br>
[/list]</td>
<td>
<ul class="listlowerroman" style="list-style-type: lower-roman;">
@ -408,8 +405,8 @@ Zeilen</code></td>
</tr>
<tr>
<td>[list=I]<br>
&nbsp;&nbsp;[li] Erstes Listenelement<br>
&nbsp;&nbsp;[li] Zweites Listenelement<br>
[li] Erstes Listenelement<br>
[li] Zweites Listenelement<br>
[/list]</td>
<td>
<ul class="listupperroman" style="list-style-type: upper-roman;">
@ -420,8 +417,8 @@ Zeilen</code></td>
</tr>
<tr>
<td>[list=a]<br>
&nbsp;&nbsp;[li] Erstes Listenelement<br>
&nbsp;&nbsp;[li] Zweites Listenelement<br>
[li] Erstes Listenelement<br>
[li] Zweites Listenelement<br>
[/list]</td>
<td>
<ul class="listloweralpha" style="list-style-type: lower-alpha;">
@ -432,8 +429,8 @@ Zeilen</code></td>
</tr>
<tr>
<td>[list=A]<br>
&nbsp;&nbsp;[li] Erstes Listenelement<br>
&nbsp;&nbsp;[li] Zweites Listenelement<br>
[li] Erstes Listenelement<br>
[li] Zweites Listenelement<br>
[/list]</td>
<td>
<ul class="listupperalpha" style="list-style-type: upper-alpha;">
@ -551,7 +548,7 @@ Als ich die Bilder im Wald aufgenommen habe, hatte ich eine wirklich ungew&ouml;
</tr>
</table>
F&uuml;r Verbindungen zu Netzwerken, zu denen Friendica den HTML Code postet, wie Tumblr, Wordpress oder Pump.io wird das [abstract] Element nicht verwendet.
F&uuml;r Verbindungen zu Netzwerken, zu denen Friendica den HTML Code postet, wie Tumblr, WordPress oder Pump.io wird das [abstract] Element nicht verwendet.
Bei nativen Verbindungen; das hei&szlig;t zu z.B. Friendica, Hubzilla, Diaspora oder GNU Social Kontakten; wird der ungek&uuml;rzte Beitrag &uuml;bertragen.
Die Instanz des Kontakts k&uuml;mmert sich um die Darstellung.
@ -595,4 +592,3 @@ Du kannst alle [style=text-shadow: 0 0 4px #CC0000;]CSS-Eigenschaften[/style] di
<td>Du kannst alle <span style="text-shadow: 0 0 4px #cc0000;;">CSS-Eigenschaften</span> dieses Inline-Textes &auml;ndern-</td>
</tr>
</table>

View file

@ -1,16 +1,13 @@
Bugs und Probleme
===============
# Bugs und Probleme
* [Zur Startseite der Hilfe](help)
Du solltest jeden Bug und jedes Problem, den/das Du findest, zunächst dem Administrator (oder gegebenenfalls der Support-Seite) Deines Servers melden, statt auf der allgemeinen Bug-Seite.
Du solltest jeden Bug und jedes Problem, den/das Du findest, zunächst dem Administrator (oder gegebenenfalls der Support-Seite) Deines Servers melden, statt auf der allgemeinen Bug-Seite.
Das erleichtert den Entwicklern ihre Arbeit (z. B. neue Features zu entwickeln), da sie sich nicht mit Fehlern beschäftigen müssen, mit denen sie nichts zu tun haben.
Wenn Du technisch versiert bist oder Dein Knoten keine Support-Seite hat, dann kannst Du den <a href="https://github.com/friendica/friendica/issues">Bug Tracker</a> nutzen.
Bitte durchsuche zunächst die Seite, ob es bereits einen offenen Bug gibt, der Deiner Anfrage entspricht.
Wenn Du technisch versiert bist oder Dein Knoten keine Support-Seite hat, dann kannst Du den <a href="https://github.com/friendica/friendica/issues">Bug Tracker</a> nutzen.
Bitte durchsuche zunächst die Seite, ob es bereits einen offenen Bug gibt, der Deiner Anfrage entspricht.
Liefere so viele Informationen wie möglich zu dem Bug.
Hierzu gehört auch die **komplette** Fehlermeldung oder Notiz und alle Schritte, die zu dem Fehler geführt haben.
Es ist generell besser, zu viele Informationen zu liefern, als zu wenige.
Liefere so viele Informationen wie möglich zu dem Bug.
Hierzu gehört auch die **komplette** Fehlermeldung oder Notiz und alle Schritte, die zu dem Fehler geführt haben.
Es ist generell besser, zu viele Informationen zu liefern, als zu wenige.
Lies Dir diesen <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs-de.html">Artikel (mehrsprachig)</a> durch, um mehr über **gute** Bug-Reports zu erfahren.

View file

@ -1,7 +1,4 @@
Kanäle (Channels)
=====
* [Home](help)
# Kanäle (Channels)
Kanäle sind eine Möglichkeit neue Inhalte zu finden, oder Inhalte anzuzeigen, die du sonst möglicherweise verpasst hättest.
Es gibt mehrere vordefinierte Kanäle und zusätzlich kannst du deine eigenen, basierend auf ein paar Regeln, erstellen.
@ -18,8 +15,7 @@ Auf der Profilseite kannst du die Kanal-Frequenz für jeden Kontakt definieren.
* Zeige nur einige Beiträge an: Wenn ein Kontakt viele Beiträge in einem kurzen Zeitraum erstellt, reduziert diese Einstellung die Anzahl der angezeigten Beiträge in jedem Kanal.
* Zeige keine Beiträge an: Beiträge von diesem Kontakt werden in keinem Kanal angezeigt.
Voreingestellte Kanäle
---
## Voreingestellte Kanäle
* Für Dich: Beiträge von Kontakten mit denen du interagierst und die mit dir interagieren. Im Detail bestehend aus:
* Beiträge von Leuten, mit denen du überdurchschnittlich viel interagierst.
@ -38,8 +34,7 @@ Voreingestellte Kanäle
* Audio: Beiträge mit Audio.
* Videos: Beiträge mit Videos.
Vom Benutzer eingestellte Kanäle
---
## Vom Benutzer eingestellte Kanäle
In den Einstellungen, unter "Kanäle", kannst du deine eigenen Kanäle erstellen.
@ -54,8 +49,7 @@ Jeder Kanal wird durch diese Werte definiert:
* Volltextsuche: Dies kann genutzt werden um Inhalte, basierend auf dem Inhalt und ein paar zusätzlichen Schlüsselwörtern, ein- oder auszuschließen. Es nutzt die "boolean mode"-Operatoren von MariaDB: https://mariadb.com/kb/en/full-text-index-overview/#in-boolean-mode
* Bilder, Videos, Audio: Wenn ausgewählt, wirst du Inhalte mit dem gewählten Medientyp sehen. Diese Optionen können kombiniert werden. Wenn keines dieser Felder ausgewählt wurde, wirst du alle Inhalte, mit oder ohne angefügten Medien, sehen.
Zusätzliche Schlüsselwörter für die Volltextsuche
---
## Zusätzliche Schlüsselwörter für die Volltextsuche
Zusätzlich zu der Suche nach Inhalten, gibt es Schlüsselwörter, die in der Volltextsuche genutzt werden können.
Alternativen werden durch "|" dargestellt.

View file

@ -1,7 +1,4 @@
Chats
=====
* [Zur Startseite der Hilfe](help)
# Chats
Du hast derzeit zwei Möglichkeiten, einen Chat auf Deiner Friendica-Seite zu betreiben

View file

@ -1,7 +1,4 @@
Circles und Privatsphäre
==================
* [Zur Startseite der Hilfe](help)
# Circles und Privatsphäre
Circles sind nur eine Ansammlung von Freunden.
Aber Friendica nutzt diese, um sehr mächtige Features zur Verfügung zu stellen.
@ -45,9 +42,9 @@ Standardmäßig geht Friendica davon aus, dass alle deine Beiträge privat sein
Aus diesem Grund erstellt Friendica nach der Anmeldung eine Circle, in die automatisch alle deine Kontakte hinzugefügt werden.
Alle deine Beiträge sind nur auf diese Circle beschränkt.
Beachte, dass diese Einstellung von deinem Seiten-Administrator überschrieben werden kann, was bedeutet, dass alle deine Beiträge standardmäßig "öffentlich" sind (bspw. für das gesamte Internet).
Beachte, dass diese Einstellung von deinem Seiten-Administrator überschrieben werden kann, was bedeutet, dass alle deine Beiträge standardmäßig "öffentlich" sind (beispielweise für das gesamte Internet).
Wenn du deine Beiträge standardmäßig "öffentlich" haben willst, dann kannst du deine Standardzugriffsrechte auf deiner Einstellungseite ändern.
Wenn du deine Beiträge standardmäßig "öffentlich" haben willst, dann kannst du deine Standardzugriffsrechte auf deiner Einstellungsseite ändern.
Dort kannst du außerdem festlegen, welchen Circles standardmäßig deine Beiträge erhalten oder in welche Circle deine neuen Kontakte standardmäßig eingeordnet werden.
**Fragen der Privatssphäre, die zu beachten sind**
@ -64,19 +61,18 @@ Du musst **sehr** vorsichtig sein, wenn du Mitglieder anderer Netzwerke in einer
Wenn du auf die "Kontakt bearbeiten"-Seite einer Person gehst, zeigen wir dir, ob sie Mitglied eines unsicheren Netzwerks ist oder nicht.
Sobald du einen Post erstellt hast, kannst du die Zugriffsrechte nicht mehr ändern.
Innerhalb von Sekunden ist dieser an viele verschiedene Personen verschickt worden - möglicherweise bereits an alle Addressierten.
Innerhalb von Sekunden ist dieser an viele verschiedene Personen verschickt worden - möglicherweise bereits an alle Adressierten.
Wenn du versehentlich eine Nachricht erstellt hast und sie zurücknehmen willst, dann ist es das beste, diese zu löschen.
Wir senden eine Löschmitteilung an jeden, der deine Nachricht erhalten hat - und das sollte die Nachricht genauso schnell löschen, wie sie zunächst erstellt wurde.
In vielen Fällen wird sie in weniger als einer Minute aus dem Internet gelöscht.
Nochmals: das gilt für Friendica-Netzwerke.
Sobald eine Nachricht an ein anderes Netzwerk geschickt wurde, kann es nicht mehr so schnell gelöscht werden und in manchen Fällen auch gar nicht mehr.
Wenn du das bisher noch nicht wusstest, dann empfehlen wir dir, deine Freunde dazu zu ermutigen, auch Friendica zu nutzen, da alle diese Privatsphären-Einstellungen innerhalb eines privatsphärenbewussten Netzwerk viel besser funktionieren.
Wenn du das bisher noch nicht wusstest, dann empfehlen wir dir, deine Freunde dazu zu ermutigen, auch Friendica zu nutzen, da alle diese Privatsphären-Einstellungen innerhalb eines privatsphärenbewussten Netzwerks viel besser funktionieren.
Viele andere Netzwerke, mit denen sich Friendica verbinden kann, bieten keine Kontrolle über die Privatsphäre.
Profile, Fotos und die Privatsphäre
=============================
# Profile, Fotos und die Privatsphäre
Die dezentralisierte Natur von Friendica (statt eine Webseite zu haben, die alles kontrolliert, gibt es viele Webseiten, die Information austauschen) hat in der Kommunikation mit anderen Seiten einige Konsequenzen.
Du solltest dir über einige Dinge bewusst sein, um am besten entscheiden zu können, wie du mit deiner Privatsphäre umgehst.
@ -90,7 +86,7 @@ Wir können die Identität von Friendica-Nutzern prüfen, da es hierfür einen M
Deine Freunde anderer Netzwerke werden deine privaten Fotos nicht sehen können, da wir deren Identität nicht überprüfen können.
Unsere Entwickler arbeiten an einer Lösung, um deinen Freunden den Zugriff zu ermöglichen - unabhängig, zu welchem Netzwerk sie gehören.
Wir nehmen hingegen Privatsphäre ernst und agieren nicht wie andere Netzwerke, die __nur so tun__ als ob deine Fotos privat sind, sie aber trotzdem anderen ohne Identitätsprüfung zeigen.
Wir nehmen hingegen Privatsphäre ernst und agieren nicht wie andere Netzwerke, die __nur so tun__, als ob deine Fotos privat sind, sie aber trotzdem anderen ohne Identitätsprüfung zeigen.
**Profile**

View file

@ -1,38 +1,33 @@
Konnektoren (Connectors)
==========
# Konnektoren (Connectors)
* [Zur Startseite der Hilfe](help)
Konnektoren erlauben es Dir, Dich mit anderen sozialen Netzwerken zu verbinden.
Konnektoren erlauben es Dir, Dich mit anderen sozialen Netzwerken zu verbinden.
Mit diesen Konnektoren kannst Du z.B. zu Bluesky, Tumblr oder Twitter posten.
Für Bluesky und Tumblr gibt es eine bidirektionale Verbindung, d.h. du kannst Friendica nutzen, um deine Timeline von diesen Diensten zu lesen.
Für Bluesky und Tumblr gibt es eine bidirektionale Verbindung, d.h. du kannst Friendica nutzen, um deine Timeline von diesen Diensten zu lesen.
Außerdem gibt es einen Konnektor, um Deinen Email-Posteingang zu nutzen.
Wenn Du keinen eigenen Knoten betreibst und wissen willst, ob der Server Deiner Wahl diese Konnektoren installiert hat, kannst Du Dich darüber auf der Seite '&lt;domain_des_friendica-servers&gt;/friendica' informieren.
Anleitung, um sich mit Personen in bestimmten Netzwerken zu verbinden
==========================================================
# Anleitung, um sich mit Personen in bestimmten Netzwerken zu verbinden
**Friendica**
## Friendica
Du kannst Dich verbinden, indem Du die Adresse Deiner Identität (&lt;dein_nick&gt;@&lt;dein_friendica-host&gt;) auf der "Verbinden"-Seite des Friendica-Nutzers eingibst.
Ebenso kannst Du deren Identitäts-Adresse in der "Verbinden"-Box auf Deiner ["Kontakt"-Seite](contacts) eingeben.
Du kannst Dich verbinden, indem Du die Adresse Deiner Identität (&lt;dein_nick&gt;@&lt;dein_friendica-host&gt;) auf der "Verbinden"-Seite des Friendica-Nutzers eingibst.
Ebenso kannst Du deren Identitäts-Adresse in der "Verbinden"-Box auf Deiner ["Kontakt"-Seite](contact) eingeben.
## Diaspora
**Diaspora**
Füge die Diaspora-Identitäts-Adresse (z.B. name@diasporapod.com)auf Deiner ["Kontakte"-Seite](contact) in das Feld "Neuen Kontakt hinzufügen" ein.
Füge die Diaspora-Identitäts-Adresse (z.B. name@diasporapod.com)auf Deiner ["Kontakte"-Seite](contacts) in das Feld "Neuen Kontakt hinzufügen" ein.
## Blogger, WordPress, RSS feeds, andere Webseiten
**Blogger, Wordpress, RSS feeds, andere Webseiten**
Trage die URL auf Deiner ["Kontakte"-Seite](contacts) in das Feld "Neuen Kontakt hinzufügen" ein.
Trage die URL auf Deiner ["Kontakte"-Seite](contact) in das Feld "Neuen Kontakt hinzufügen" ein.
Du hast keine Möglichkeit, diesen Kontakten zu antworten.
Das erlaubt Dir, Dich mit Millionen von Seiten im Internet zu _verbinden_.
Alles, was dafür nötig ist, ist dass die Seite einen Feed im RSS- oder Atom Syndication-Format nutzt und welches einen Autoren und ein Bild zur Seite liefert.
Das erlaubt Dir, Dich mit Millionen von Seiten im Internet zu _verbinden_.
Alles, was dafür nötig ist, ist dass die Seite einen Feed im RSS- oder Atom Syndication-Format nutzt und welches einen Autoren und ein Bild zur Seite liefert.
**Email**
## Email
Konfiguriere den Email-Konnektor auf Deiner [Einstellungsseite](settings).
Wenn Du das gemacht hast, kannst Du auf Deiner ["Kontakte"-Seite](contacts) die Email-Adresse in das Feld "Neuen Kontakt hinzufügen" eintragen.
Diese Email-Adresse muss jedoch bereits mit einer Nachricht in Deinem Email-Posteingang auf dem Server liegen.
Konfiguriere den Email-Konnektor auf Deiner [Einstellungsseite](settings).
Wenn Du das gemacht hast, kannst Du auf Deiner ["Kontakte"-Seite](contact) die Email-Adresse in das Feld "Neuen Kontakt hinzufügen" eintragen.
Diese Email-Adresse muss jedoch bereits mit einer Nachricht in Deinem Email-Posteingang auf dem Server liegen.
Du hast die Möglichkeit, Email-Kontakte in Deine privaten Unterhaltungen einzubeziehen.

View file

@ -1,12 +1,9 @@
# Veranstaltungen
* [Zur Startseite der Hilfe](help)
Veranstaltungen sind spezielle Postings.
Die Veranstaltungen, die Du und deine Kontakte teilen, können unter [/events](/events) auf deiner Instanz aufgefunden werden.
Um da hinzukommen gehe über den Tab "Veranstalltungen", abhänig von dem Theme, das du benutzt, ist der eventuell ein zusätzlicher link im Navigationsmenü der Seite vorhanden.
## Veranstaltungsübersicht
Die Übersichtsseite zeigt den Kalender des aktuellen Monats an, plus einige Tage am Beginn und am Ende.

View file

@ -1,13 +1,11 @@
# Export / Import von gefolgten Kontakte
* [Home](help)
Zusätzlich zum [Umziehen des Accounts](help/Move-Account) kannst du die Liste der von dir gefolgten Kontakte exportieren und importieren.
Zusätzlich zum [Umziehen des Accounts](help/user/move-account) kannst du die Liste der von dir gefolgten Kontakte exportieren und importieren.
Die exportierte Liste wird als CSV Datei in einem zu anderen Plattformen, z.B. Mastodon, Misskey oder Pleroma, kompatiblen Format gespeichert.
## Export der gefolgten Kontakte
Um die Liste der Kontakte *denen du folgst* zu exportieren, geht die [Einstellungen Persönliche Daten exportieren](settings/userexport) und klicke den [Exportiere Kontakte als CSV](settings/userexport/contact) an.
Um die Liste der Kontakte *denen du folgst* zu exportieren, geht die [Einstellungen persönliche Daten exportieren](settings/userexport) und klicke den [Exportiere Kontakte als CSV](settings/userexport/contact) an.
## Import der gefolgten Kontakte
@ -17,6 +15,6 @@ Hier kannst du die CSV Datei auswählen und hoch laden.
### Unterstütztes Datei Format
Die CSV Datei *muss* mindestens eine Spalte beinhalten.
In der ersten Spalte der Tabelle sollte *sollte* entweder das Handle oder die URL des gefolgten Kontakts.
In der ersten Spalte der Tabelle *sollte* entweder das Handle oder die URL des gefolgten Kontakts.
(Ein Kontakt pro Zeile.)
Alle anderen Spalten der CSV Datei werden beim Importieren ignoriert.

View file

@ -1,22 +1,6 @@
Häufig gestellte Fragen - FAQ
==============
# Häufig gestellte Fragen - FAQ
* [Zur Startseite der Hilfe](help)
* **[Wo finde ich Hilfe?](help/FAQ#help)**
* **[Warum erhalte ich Warnungen über fehlende Zertifikate?](help/FAQ#ssl)**
* **[Wie kann ich Bilder, Dateien, Links, Video und Audio in Beiträge einfügen?](help/FAQ#upload)**
* **[Ist es möglich, bei mehreren Profilen verschiedene Avatare (Nutzerbilder) zu haben?](help/FAQ#avatars)**
* **[Wie kann ich Friendica in einer bestimmten Sprache ansehen?](help/FAQ#language)**
* **[Was ist der Unterschied zwischen blockierten|ignorierten|archivierten|versteckten Kontakten?](help/FAQ#contacts)**
* **[Was passiert, wenn ein Account gelöscht ist? Ist dieser richtig gelöscht?](help/FAQ#removed)**
* **[Kann ich einem Hashtag folgen?](help/FAQ#hashtag)**
* **[Wie kann ich einen RSS-Feed meiner Netzwerkseite (Stream) erstellen?](help/FAQ#rss)**
* **[Gibt es Clients für Friendica?](help/FAQ#clients)**
<a name="help"></a>
### Wo finde ich Hilfe?
## Wo finde ich Hilfe?
Wenn Du Probleme mit Deiner Friendica-Seite hast, dann kannst Du die Community in der [Friendica-Support-Gruppe](https://forum.friendi.ca/profile/helpers) fragen.
Wenn Du Deinen Account nicht nutzen kannst, kannst Du einen Account auf einer öffentlichen Seite ([Liste](https://dir.friendica.social/servers)) nutzen.
@ -35,8 +19,7 @@ Wenn du dir keinen weiteren Friendica Account einrichten willst, kannst du auch
https://github.com/github/opensource.guide/pull/807
--->
<a name="ssl"></a>
### Warum erhalte ich Warnungen über fehlende Zertifikate?
## Warum erhalte ich Warnungen über fehlende Zertifikate?
Manchmal erhältst Du eine Browser-Warnung über fehlende Zertifikate.
Diese Warnungen können drei Gründe haben:
@ -49,8 +32,8 @@ Diese Warnungen können drei Gründe haben:
*(SSL (Secure Socket Layer) ist eine Technologie, die Daten auf ihrem Weg zwischen zwei Computern verschlüsselt.)*
Wenn Du noch kein SSL-Zertifikat hast, dann gibt es drei Wege, eines zu erhalten: kauf Dir eines, hole Dir ein kostenloses (z.B. bei StartSSL, WoSign, hoffentlich bald auch letsencrypt) oder kreiere Dein eigenes (nicht empfohlen).
[Weitere Informationen über die Einrichtung von SSL und warum es schlecht ist, selbst-signierte Zertifikate zu nutzen, findest Du hier.](help/SSL)
Wenn Du noch kein SSL-Zertifikat hast, dann gibt es drei Wege, eines zu erhalten: kauf Dir eines, hole Dir ein kostenloses (z.B. bei StartSSL, WoSign, hoffentlich bald auch LetsEncrypt) oder kreiere Dein eigenes (nicht empfohlen).
[Weitere Informationen über die Einrichtung von SSL und warum es schlecht ist, selbst-signierte Zertifikate zu nutzen, findest Du hier.](help/admin/ssl)
Sei Dir bewusst, dass Browser-Warnungen über Sicherheitslücken etwas sind, wodurch neue Nutzer schnell das Vertrauen in das gesamte Friendica-Projekt verlieren können.
Aus diesem Grund wird Friendica Red nur SSL-Zertifikate eines anerkannten Anbieters (CA, certificate authority) akzeptieren und nicht zu Seiten verbinden, die kein SSL nutzen.
@ -65,10 +48,9 @@ Wenn Du zum jetzigen Zeitpunkt noch keinen Server aufgesetzt hast, ist es sinnvo
Einige erlauben die Nutzung von freien Zertifikaten oder lassen Dich ihre eigenen Zertifikate mitnutzen.
Andere erlauben nur kostenpflichtige Zertifikate als eigenes Angebot bzw. von anderen Anbietern.
<a name="upload"></a>
### Wie kann ich Bilder, Dateien, Links, Video und Audio in Beiträge einfügen?
## Wie kann ich Bilder, Dateien, Links, Video und Audio in Beiträge einfügen?
Bilder können direkt im [Beitragseditor](help/Text_editor) vom Computer hochgeladen werden.
Bilder können direkt im [Beitragseditor](help/text-editor) vom Computer hochgeladen werden.
Eine Übersicht aller Bilder, die auf Deinem Server liegen, findest Du unter <i>deineSeite.de/profile/profilname/photos</i>.
Dort kannst Du auch direkt Bilder hochladen und festlegen, ob Deine Kontakte eine Nachricht über das neue Bild bekommen.
@ -79,7 +61,7 @@ Deshalb eignet sich diese Methode vor allem für Office-Dateien oder gepackte Da
Wer hingegen Dateien über Dropbox, über eine auf dem eigenen Server installierte Owncloud oder über einen anderen [Filehoster](http://en.wikipedia.org/wiki/Comparison_of_file_hosting_services) einfügen will, verwendet den Link-Button.
Wenn Du mit dem Link-Button (Ketten-Symbol) URLs zu anderen Seiten einfügst, versucht Friendica eine kurze Zusammenfassung als Vorschau abzurufen.
Manchmal klappts das nicht ... dann verlinke den Beitrag einfach per [url=http://example.com]<i>freigewählter Name</i>[/url] im Editor.
Manchmal klappt das nicht ... dann verlinke den Beitrag einfach per [url=http://example.com]<i>freigewählter Name</i>[/url] im Editor.
Video- und Audiodateien können zwar in Beiträge eingebunden werden, allerdings geht das nicht über einen direkten Upload im Editor wie bei Fotos.
Du hast zwei Möglichkeiten:
@ -88,19 +70,17 @@ Du hast zwei Möglichkeiten:
2. Wenn Du Zugang zu einem eigenen Server hast, kannst Deine Multimediadatei per FTP dort hochladen und beim Video-/Audiobutton diese URL angeben. Dann wird das Video oder die Audiodatei direkt mit einem Player in Deinem Beitrag angezeigt.
Friendica verwendet zur Einbettung HTML5. Das bedeutet, dass je nach Browser und Betriebssystem andere Formate unterstützt werden, darunter WebM, MP4, MP3 und Ogg. Eine Tabelle findest Du bei Wikipedia ([Video](http://en.wikipedia.org/wiki/HTML5_video), [Audio](http://en.wikipedia.org/wiki/HTML5_audio)).
Zum Konvertieren von Videos in das lizenfreie Videoformat WebM gibt es unter Windows das kostenlose Programm [Xmedia-Recode](http://www.xmedia-recode.de/).
Zum Konvertieren von Videos in das lizenzfreie Videoformat WebM gibt es unter Windows das kostenlose Programm [Xmedia-Recode](http://www.xmedia-recode.de/).
<a name="avatars"></a>
### Ist es möglich, bei mehreren Profilen verschiedene Avatare (Nutzerbilder) zu haben?
## Ist es möglich, bei mehreren Profilen verschiedene Avatare (Nutzerbilder) zu haben?
Ja.
Auf Deiner ["Profile verwalten/editieren"-Seite](../profiles) wählst Du zunächst das gewünschte Profil aus.
Anschließend siehst Du eine Seite mit allen Infos zu diesem Profil.
Anschließend siehst Du eine Seite mit allen Informationen zu diesem Profil.
Klicke nun oben auf den Link "Profilbild ändern" und lade im nächsten Fenster ein Bild von Deinem PC hoch.
Um Deine privaten Daten zu schützen, wird in Beiträgen nur das Bild aus Deinem öffentlichen Profil angezeigt.
<a name="language"></a>
### Wie kann ich Friendica in einer bestimmten Sprache ansehen?
## Wie kann ich Friendica in einer bestimmten Sprache ansehen?
Die Sprache des Friendica Interfaces kann durch den `lang` Parameter un der URL beeinflusst werden.
Das Argument des Parameters ist ein [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) Code.
@ -114,8 +94,7 @@ auf Deutsch:
https://social.example.com/profile/example?lang=de.
<a name="contacts"></a>
### Was ist der Unterschied zwischen blockierten|ignorierten|archivierten|versteckten Kontakten?
## Was ist der Unterschied zwischen blockierten|ignorierten|archivierten|versteckten Kontakten?
Wir verhindern direkte Kommunikation mit blockierten Kontakten.
Sie gehören nicht zu den Empfängern beim Versand von Beiträgen und deren Beiträge werden auch nicht importiert.
@ -134,30 +113,27 @@ Dabei werden auch Kommentare dieser Person in Beiträgen Deiner Freunde blockier
Ein archivierter Kontakt bedeutet, dass Kommunikation nicht möglich ist und auch nicht versucht wird (das ist z.B. sinnvoll, wenn eine Person zu einem neuen Server gewechselt ist und das alte Profil gelöscht hat).
Anders als beim Blockieren werden existierende Beiträge, die vor der Archivierung erstellt wurden, weiterhin angezeigt.
Ein versteckter Kontakt wird in keiner "Freundeliste" erscheinen (außer für dich).
Trotzdem wird ein versteckter Kontakt normal in Unterhaltungen angezeigt - was für andere Kontakte ein Hinweis sein kann, dass diese Person als versteckter Kontakt in Deiner Liste ist.
Ein versteckter Kontakt wird in keiner "Freundesliste" erscheinen (außer für dich).
Trotzdem wird ein versteckter Kontakt normal in Unterhaltungen angezeigt - was für andere Kontakte ein Hinweis sein kann, dass diese Person als versteckter Kontakt in deiner Liste ist.
<a name="removed"></a>
### Was passiert, wenn ein Account gelöscht ist? Ist dieser richtig gelöscht?
## Was passiert, wenn ein Account gelöscht ist? Ist dieser richtig gelöscht?
Wenn Du Deinen Account löschst, wird sofort der gesamte Inhalt auf Deinem Server gelöscht und ein Löschbefehl an alle Deine Kontakte verschickt.
Dadurch wirst Du ebenfalls aus dem globalen Verzeichnis gelöscht.
Dieses Vorgehen setzt voraus, dass Dein Profil für 24 Stunden weiterhin "teilweise" verfügbar sein wird, um eine Verbindung zu allen Deinen Kontakten ermöglicht.
Wir können also Dein Profil blockieren und es so erscheinen lassen, als wären alle Daten sofort gelöscht, allerdings warten wir 24 Stunden (bzw. bis alle Deine Kontakte informiert wurden), bevor wir die Daten auch physikalisch löschen.
<a name="hashtag"></a>
### Kann ich einem Hashtag folgen?
## Kann ich einem Hashtag folgen?
Ja.
Füge die Tags zu Deinen gespeicherten Suchen hinzu, sie werden automatisch auf der Netzwerk-Seite auftauchen.
Bitte beachte, dass Deine Antworten auf solche Posts aus technischen Gründen nicht unter dem "Persönlich"-Reiter auf der Netzwerk-Seite und der gesamte Thread nicht per API zu sehen sind.
<a name="rss"></a>
### Wie kann ich einen RSS-Feed meiner Netzwerkseite (Stream) erstellen?
## Wie kann ich einen RSS-Feed meiner Netzwerkseite (Stream) erstellen?
Wenn Du die Beiträge Deines Accounts mit RSS teilen willst, dann kannst Du einen der folgenden Links nutzen:
#### RSS-Feed Deiner Beiträge
### RSS-Feed Deiner Beiträge
deineSeite.de/feed/[profilname]/posts
@ -165,7 +141,7 @@ Beispiel: Friendica Support
https://forum.friendi.ca/feed/helpers/posts
#### RSS-Feed all deiner Beiträge und Antworten
### RSS-Feed all deiner Beiträge und Antworten
deineSeite.de/dfrn_poll/feed/[profilname]/comments
@ -173,18 +149,17 @@ Beispiel: Friendica Support
https://forum.friendi.ca/feeds/helpers/comments
#### RSS-Feed all deiner Aktivitäten
### RSS-Feed all deiner Aktivitäten
deineSeite.de/feed/[profilname]/
<a name="clients">
### Gibt es Clients für Friendica?
## Gibt es Clients für Friendica?
Friendica unterstützt [Mastodon API](help/API-Mastodon) und [Twitter API | gnusocial](help/api).
Friendica unterstützt [Mastodon API](help/spec/api/mastodon) und [Twitter API | gnusocial](help/spec/api/index).
Das bedeutet, du kannst einge der Mastodon und Twitter Clients für Friendica verwenden.
Die verfügbaren Features sind Abhängig vom Client, so dass diese teils unterschiedlich sein können.
#### Android
### Android
* [AndStatus](http://andstatus.org) ([F-Droid](https://f-droid.org/repository/browse/?fdid=org.andstatus.app), [Google Play](https://play.google.com/store/apps/details?id=org.andstatus.app))
* [B4X for Pleroma & Mastodon](https://github.com/AnywhereSoftware/B4X-Pleroma)
@ -202,21 +177,21 @@ Die verfügbaren Features sind Abhängig vom Client, so dass diese teils untersc
* [twitlatte](https://github.com/moko256/twitlatte)
* [Yuito](https://github.com/accelforce/Yuito)
#### SailfishOS
### SailfishOS
* [Friendly](https://openrepos.net/content/fabrixxm/friendly#comment-form)
#### iOS
### iOS
* [B4X for Pleroma & Mastodon](https://www.b4x.com/) ([AppStore](https://apps.apple.com/app/b4x-pleroma/id1538396871), [GitHub](https://github.com/AnywhereSoftware/B4X-Pleroma))
* [Fedi](https://fediapp.com) ([AppStore](https://apps.apple.com/de/app/fedi-for-pleroma-and-mastodon/id1478806281))
* [Mastodon](https://joinmastodon.org/apps)([AppStore](https://apps.apple.com/us/app/mastodon-for-iphone/id1571998974))
* [Roma](https://www.roma.rocks/)([AppStore](https://apps.apple.com/de/app/roma-for-pleroma-and-mastodon/id1445328699))
* [Stella*](https://www.stella-app.net/) ([AppStore](https://apps.apple.com/us/app/stella-for-mastodon-twitter/id921372048))
* [Tooot](https://tooot.app/) ([AppStore](https://apps.apple.com/app/id1549772269), [GitHub](https://github.com/tooot-app)), Datensammlung (nicht mit Identität verknüpft)
* [Tootle](https://mastodon.cloud/@tootleapp) ([AppStore](https://apps.apple.com/de/app/tootle-for-mastodon/id1236013466)), letztes update: 2020
* [B4X for Pleroma & Mastodon](https://www.b4x.com/) ([App Store](https://apps.apple.com/app/b4x-pleroma/id1538396871), [GitHub](https://github.com/AnywhereSoftware/B4X-Pleroma))
* [Fedi](https://fediapp.com) ([App Store](https://apps.apple.com/de/app/fedi-for-pleroma-and-mastodon/id1478806281))
* [Mastodon](https://joinmastodon.org/apps)([App Store](https://apps.apple.com/us/app/mastodon-for-iphone/id1571998974))
* [Roma](https://www.roma.rocks/)([App Store](https://apps.apple.com/de/app/roma-for-pleroma-and-mastodon/id1445328699))
* [Stella*](https://www.stella-app.net/) ([App Store](https://apps.apple.com/us/app/stella-for-mastodon-twitter/id921372048))
* [Tooot](https://tooot.app/) ([App Store](https://apps.apple.com/app/id1549772269), [GitHub](https://github.com/tooot-app)), Datensammlung (nicht mit Identität verknüpft)
* [Tootle](https://mastodon.cloud/@tootleapp) ([App Store](https://apps.apple.com/de/app/tootle-for-mastodon/id1236013466)), letztes update: 2020
#### Linux
### Linux
* [Choqok](https://choqok.kde.org)
* [Whalebird](https://whalebird.social)
@ -224,12 +199,12 @@ Die verfügbaren Features sind Abhängig vom Client, so dass diese teils untersc
* [Toot](https://toot.readthedocs.io/en/latest/)
* [Tootle](https://github.com/bleakgrey/tootle)
#### macOS
### macOS
* [Mastonaut](https://mastonaut.app/) ([AppStore](https://apps.apple.com/us/app/mastonaut/id1450757574)), kostet ~8€
* [Whalebird](https://whalebird.social/en/desktop/contents) ([AppStore](https://apps.apple.com/de/app/whalebird/id1378283354), [GitHub](https://github.com/h3poteto/whalebird-desktop))
* [Mastonaut](https://mastonaut.app/) ([App Store](https://apps.apple.com/us/app/mastonaut/id1450757574)), kostet ~8€
* [Whalebird](https://whalebird.social/en/desktop/contents) ([App Store](https://apps.apple.com/de/app/whalebird/id1378283354), [GitHub](https://github.com/h3poteto/whalebird-desktop))
#### Web
### Web
* [Halcyon](https://www.halcyon.social/)
* [Pinafore](https://github.com/nolanlawson/pinafore)

View file

@ -1,7 +1,4 @@
Freunde finden
==============
* [Zur Startseite der Hilfe](help)
# Freunde finden
Freundschaft kann in Friendica viele verschiedene Bedeutungen annehmen.
Aber lasst es uns einfach halten, du willst einfach mit jemandem befreundet sein.
@ -12,23 +9,23 @@ Das Verzeichnis ist in zwei Teile aufgeteilt.
Wenn du auf den "Verzeichnis"-Button klickst, wirst du zunächst alle Mitglieder deines Servers sehen, die sich dazu entschlossen haben, angezeigt zu werden.
Außerdem siehst du dort einen Link zum globalen Verzeichnis.
Wenn du dich durch das globale Verzeichnis klickst, siehst du alle Nutzer weltweit auf allen Servern, die sich entschlossen haben, im Verzeichnis zu erscheinen.
Du wirst außerdem den Link "Show Community Groups" sehen, welcher dich zu Gruppen und Fan-Seiten führt.
Du wirst zudem den Link "Show Community Groups" sehen, welcher dich zu Gruppen und Fan-Seiten führt.
Du verbindest dich mit Personen und Gruppen auf die gleiche Art, wobei Gruppen deine Anfrage automatisch annehmen, wohingegen ein Mensch dich erst manuell bestätigen muss.
*Mit anderen Friendica-Nutzern verbinden*
Besuche ihr Profil.
Direkt unter dem Profilfoto ist das Wort "Verbinden" (bzw. "Connect" in einem englischsprachigem Profil).
Klicke drauf und du gelangst zur "Verbinden"-Seite.
Klicke darauf und du gelangst zur "Verbinden"-Seite.
Dort wirst du nach deiner Identitätsadresse gefragt.
Das ist nötig, damit die Seite dein Profil finden kann.
*Was kommt in die Box?*
Wenn deine Friendica-Seite "demo.friendica.com" heißt und dein Nutzername/Spitzname auf der Seite "bob" ist, dann wäre es "bob@demo.friendica.com".
Wie du siehst, sieht es wie eine Email-Adresse aus.
Wie du siehst, sieht es wie eine E-Mail-Adresse aus.
Das ist beabsichtigt, da sich die Leute das so leichter merken können.
Du *kannst* auch die URL deiner Startseite eintragen, wie z.B. "http://demo.friendica.com/profile/bob", aber der Email-Adressen-Stil ist einfacher.
Du *kannst* auch die URL deiner Startseite eintragen, wie z.B. "http://demo.friendica.com/profile/bob", aber der E-Mail-Adressen-Stil ist einfacher.
Wenn du die "Verbinden"-Seite bestätigt hast, kommst du zurück zu deiner Seite, um dort die Anfrage zu bestätigen.
Wenn du das gemacht hast, können beide Seiten miteinander kommunizieren, um den Prozess abzuschließen (sobald dein neuer Freund die Anfrage bestätigt hat).
@ -45,7 +42,7 @@ Wenn du z.B. "bob" auf quitter.se (eine GNU Social-Seite) kennst, dann kannst du
Tatsächlich kannst du jedem und jeder Website folgen, der/die einen Syndication-Feed (RSS/Atom etc.) zur Verfügung stellt.
Wenn wir einen Informationsstrom und einen Namen dazu finden, können wir auch versuchen, uns damit zu verbinden.
Wenn du deine Email-Postfachverbindung auf deiner Einstellungsseite konfiguriert hast, dann kannst du die Email-Adresse jeder Person eintragen, die dir schon eine Nachricht an dein Postfach geschickt hat und bereits in deinem sozialen Stream erscheint.
Wenn du deine E-Mail-Postfachverbindung auf deiner Einstellungsseite konfiguriert hast, dann kannst du die E-Mail-Adresse jeder Person eintragen, die dir schon eine Nachricht an dein Postfach geschickt hat und bereits in deinem sozialen Stream erscheint.
Du kannst diesen Personen außerdem von Friendica aus antworten.
Leute können sich ebenfalls von anderen Netzwerken aus mit dir befreunden.

View file

@ -1,8 +1,4 @@
Accounts Umziehen
=================
* [Zur Startseite der Hilfe](help)
# Accounts Umziehen
! **Dies ist ein experimentelles Feature**
@ -10,8 +6,8 @@ Accounts Umziehen
Unter "Einstellungen" -> "[Persönliche Daten exportieren](uexport)" aufrufen.
"Account exportieren" anklicken und die Daten speichern.
Diese Datei enthält Details über dich, deine Kontakte, Gruppen und persönliche Einstellungen.
Außerdem enthält sie deinen geheimen Schlüssel mit dem du dich deinen Kontakten gegenüber ausweist.
Diese Datei enthält Details über dich, deine Kontakte, Gruppen und persönliche Einstellungen.
Außerdem enthält sie deinen geheimen Schlüssel, mit dem du dich deinen Kontakten gegenüber ausweist.
**Speichere diese Datei an einem sicheren Ort**!
@ -24,11 +20,11 @@ Hier kann dies nur der Administrator selber durchführen.
Lege auf dem neuen Server auf keinen Fall einen gleichnamigen Account an!
user import muss anstelle des Registrierens verwendet werden.
Wähle die gesicherte Account Datei aus und klicke "Importieren".
Wähle die gesicherte Account-Datei aus und klicke "Importieren".
Friendica wird nun deinen Account auf dem neuen Server wiederherstellen, mit all deinen Friendica Kontakten und Gruppen.
Friendica wird nun deinen Account auf dem neuen Server wiederherstellen, mit all deinen Friendica Kontakten und Gruppen.
An deine Friendica Kontakte wird außerdem eine Nachricht gesendet um sie über deine neue Adresse zu informieren.
Wenn deine Kontakte ihren Account auf einem aktuellen Server haben werden deine Kontaktdetails automatisch aktualisiert.
Wenn deine Kontakte ihren Account auf einem aktuellen Server haben, werden deine Kontaktdetails automatisch aktualisiert.
Neuere Diaspora Server unterstützen ebenfalls eine Umzugsbenachrichtigung.

View file

@ -0,0 +1,14 @@
# ... und zuletzt
Und damit sind wir auch schon am Ende der Schnellstartanleitung.
Hier sind noch einige weitere Dinge, die Dir den Start vereinfachen können.
**Gruppen**
- [Friendica Support](https://forum.friendi.ca/profile/helpers) - Probleme? Dann ist das der Platz, um zu fragen!
**Dokumentation**
- [Zu weiteren Netzwerken verbinden](help/user/connectors)
- [Zur Startseite der Hilfe](help)

View file

@ -1,14 +1,11 @@
Gruppen und Seiten
==========
* [Zur Startseite der Hilfe](help)
# Gruppen und Seiten
Hier siehst Du das globale Verzeichnis.
Wenn Du Dich mal verirrt hast, kannst Du diesen Link klicken und wieder hierher kommen.
Auf dieser Seite findest Du eine Zusammenstellung von Gruppen.
Auf dieser Seite findest Du eine Zusammenstellung von Gruppen.
Gruppen sind keine realen Personen.
Sich mit diesen zu verbinden ist, als wenn man jemanden auf Facebook "liked" ("gefällt mir") oder wenn man sich in einem Forum anmeldet.
Sich mit diesen zu verbinden ist, als wenn man jemanden auf Facebook "liked" ("gefällt mir") oder wenn man sich in einem Forum anmeldet.
Du musst nicht unsicher sein, ob Du jemandem zu nahe trittst, wenn Du Dich so ohne weiteres mit einer Gruppe verbindest; es handelt sich eben nicht um reale Personen.
Wenn Du Dich mit einer Gruppe verbindest, erscheinen alle Nachrichten der Gruppe in Deinem "Netzwerk"-Tab.
@ -19,8 +16,6 @@ Suche Dir einfach eine Gruppe und füge sie so hinzu, wie Du auch normale Freund
Es gibt eine Menge Gruppen.
Solltest Du beim Stöbern durch die vielen Gruppen nicht wieder hierher zurück finden, so nutze einfach den Link oben auf dieser Seite.
Wenn Du einige Gruppen hinzugefügt hast, gehe <a href="help/Quick-Start-andfinally">weiter zum nächsten Schritt</a>.
<iframe src="https://dir.friendica.social/group" width="950" height="600"></iframe>
Wenn Du einige Gruppen hinzugefügt hast, gehe [weiter zum nächsten Schritt](help/user/quick-start/finally).
<iframe src="https://dir.friendica.social/group" width="100%" height="600"></iframe>

View file

@ -1,36 +1,31 @@
Erste Schritte...
==========
# Erste Schritte...
* [Zur Startseite der Hilfe](help)
Als Erstes: Gehe sicher, dass Du eingeloggt bist.
Wenn Du noch nicht eingeloggt bist, kannst Du das in dem Fenster unten machen.
Als Erstes: Gehe sicher, dass Du eingeloggt bist.
Wenn Du noch nicht eingeloggt bist, kannst Du das in dem Fenster unten machen.
Sobald dies geschehen ist, schaust Du auf die Netzwerkseite Deines Profils.
Sobald dies geschehen ist, schaust Du auf die Netzwerkseite Deines Profils.
Klicke auf den Reiter "Pinnwand".
Hier sieht es ein wenig wie auf (D)einer Facebook-Seite aus.
Du findest hier alle Deine Statusmeldungen und Nachrichten Deiner Freunde, die direkt auf Deine "Pinnwand" ("Wall") geschrieben haben.
Um Deinen Status einzutragen, klicke einfach auf die Box oben, in der "Teilen" steht.
Wenn Du das machst, vergrößert sich die Box, und Du kannst nun Deinen Text eintragen, mit Hilfe einiger Formatierungsoptionen wie fett, kursiv, unterstrichen formatieren und ebenfalls Bilder und Links hinzufügen.
Unten findest Du in diesem Feld weitere Knöpfe, mit denen Du Bilder und Dateien von Deinem Computer hochladen, Webseiten mit einem Kurztext teilen und Video- und Audiodateien aus dem Internet einfügen kannst.
Außerdem kannst Du hier eintragen, wo Du gerade bist.
Hier sieht es ein wenig wie auf (D)einer Facebook-Seite aus.
Du findest hier alle Deine Statusmeldungen und Nachrichten Deiner Freunde, die direkt auf Deine "Pinnwand" ("Wall") geschrieben haben.
Um Deinen Status einzutragen, klicke einfach auf die Box oben, in der "Teilen" steht.
Wenn Du das machst, vergrößert sich die Box, und Du kannst nun Deinen Text eintragen, mit Hilfe einiger Formatierungsoptionen wie fett, kursiv, unterstrichen formatieren und ebenfalls Bilder und Links hinzufügen.
Unten findest Du in diesem Feld weitere Knöpfe, mit denen Du Bilder und Dateien von Deinem Computer hochladen, Webseiten mit einem Kurztext teilen und Video- und Audiodateien aus dem Internet einfügen kannst.
Außerdem kannst Du hier eintragen, wo Du gerade bist.
Wenn Du Deinen Beitrag ("Post") geschrieben hast, kannst Du auf das "Schloss"-Symbol klicken und festlegen, wer Deinen Beitrag sehen kann.
Wenn Du dieses Symbol nicht anklickst, ist Dein Beitrag öffentlich, bzw. es werden deine Grundeinstellungen verwendet, wenn diese nicht öffentlich sind.
Wenn Du Deinen Beitrag ("Post") geschrieben hast, kannst Du auf das "Schloss"-Symbol klicken und festlegen, wer Deinen Beitrag sehen kann.
Wenn Du dieses Symbol nicht anklickst, ist Dein Beitrag öffentlich, bzw. es werden deine Grundeinstellungen verwendet, wenn diese nicht öffentlich sind.
Ein öffentlicher Beitrag ist sichbar für
<ul>
<li>Besucher Deines Profils</li>
<li>Besucher Deiner "Gemeinschafts"-Seite</li>
<li>Besucher der Profile Deiner Kontakte</li>
<li>Suchmaschinen</li>
</ul>
- Besucher Deines Profils
- Besucher Deiner "Gemeinschafts"-Seite
- Besucher der Profile Deiner Kontakte
- Suchmaschinen
Auch wenn Du Deinen Server so konfiguriert hast, dass der Zugriff von außerhalb des Friendica-Netzwerks theoretisch nicht möglich ist, so ist Dein Beitrag über die Profile Deiner Kontakte sichtbar, wenn deren Knoten solche Zugriffe zulassen.
<!--Das bedeutet, dass jeder, der Dein Profil ansieht, den Beitrag sehen kann. Außerdem auch jene, die den "Community"-Tab Deines Servers oder auf dem "Netzwerk"-Tab ("Beiträge Deiner Kontakte") eines befreundeten Kontakts betrachten.-->
Probiere es doch einfach mal aus. Wenn Du fertig bist, schauen wir uns den <a href="help/Quick-Start-network">"Netzwerk"-Tab</a> an.
<iframe src="login" width="950" height="600"></iframe>
Probiere es doch einfach mal aus. Wenn Du fertig bist, schauen wir uns den ["Netzwerk"-Tab](help/user/quick-start/network) an.
<iframe src="login" width="100%" height="600"></iframe>

View file

@ -1,10 +1,7 @@
Neue Freunde finden
==============
* [Zur Startseite der Hilfe](help)
# Neue Freunde finden
Hier siehst Du die Kontaktvorschläge.
Wenn Du Dich mal verirrt hast, kannst Du <a href="help/Quick-Start-makingnewfriends">diesen Link klicken</a> und wieder hierher kommen.
Wenn Du Dich mal verirrt hast, kannst Du [diesen Link klicken](help/user/quick-start/making-new-friends) und wieder hierher kommen.
Diese Seite funktioniert in etwa wie die Seite für Kontaktvorschläge in Facebook.
Jeder auf dieser Liste hat zugestimmt, als Kontaktvorschlag zu erscheinen.
@ -21,8 +18,6 @@ Jetzt, nachdem Du jemanden hinzugefügt hast, weißt Du vielleicht nicht mehr, w
Klicke einfach auf den Link oben auf dieser Seite und Du gelangst zur Seite mit den Kontaktvorschlägen zurück, um weitere Personen hinzuzufügen.
Du willst nicht einfach Personen hinzufügen, die du nicht kennst?
Kein Problem - an dieser Stelle kommen wir zu den <a href="help/Quick-Start-groupsandpages">Gruppen und Seiten</a>.
<iframe src="contact/suggestions" width="950" height="600"></iframe>
Kein Problem - an dieser Stelle kommen wir zu den [Gruppen und Seiten](help/user/quick-start/groups-and-pages).
<iframe src="contact/suggestions" width="100%" height="600"></iframe>

View file

@ -1,20 +1,15 @@
Deine "Netzwerk"-Seite
==============
# Deine "Netzwerk"-Seite
* [Zur Startseite der Hilfe](help)
Dies ist Dein "Netzwerk"-Tab.
Wenn Du Dich mal verirrt hast, kannst Du [diesen Link klicken](help/user/quick-start/network), um wieder hierher zu kommen.
Dies ist Dein "Netzwerk"-Tab.
Wenn Du Dich mal verirrt hast, kannst Du diesen Link klicken, um wieder hierher zu kommen.
Diese Seite ist ein wenig wie die News-Seite in Facebook oder der Stream in Diaspora.
Hier findest Du alle Beiträge Deiner Kontakte, Gruppen und Feeds, die Du eingetragen hast.
Wenn Du neu bist, siehst Du hier noch nichts, falls Du an Deinem Status im letzten Schritt noch nichts geändert haben solltest.
Wenn Du bereits ein paar Freunde gefunden hast, so findest Du hier ihre Beiträge.
Diese Seite ist ein wenig wie die News-Seite in Facebook oder der Stream in Diaspora.
Hier findest Du alle Beiträge Deiner Kontakte, Gruppen und Feeds, die Du eingetragen hast.
Wenn Du neu bist, siehst Du hier noch nichts, falls Du an Deinem Status im letzten Schritt noch nichts geändert haben solltest.
Wenn Du bereits ein paar Freunde gefunden hast, so findest Du hier ihre Beiträge.
Du kannst ihre Beiträge von hier aus kommentieren, mitteilen, dass Du den Beitrag magst oder ablehnst (Daumen hoch, Daumen runter) oder die Profile durch einen Klick auf deren Namen besuchen und dort auf deren "Pinnwand" ("Wall") Nachrichten schreiben.
Nun wollen wir diese Seite mit Inhalt füllen.
Der erste Schritt ist es, <a href="help/Quick-Start-makingnewfriends">Leute zu Deinem Account hinzuzufügen</a>.
<iframe src="network" width="950" height="600"></iframe>
Nun wollen wir diese Seite mit Inhalt füllen.
Der erste Schritt ist es, [Leute zu Deinem Account hinzuzufügen](help/user/quick-start/making-new-friends).
<iframe src="network" width="100%" height="600"></iframe>

View file

@ -1,23 +1,20 @@
Accounts löschen
==============
* [Zur Startseite der Hilfe](help)
# Accounts löschen
Wir freuen uns nicht, wenn Leute Friendica verlassen, aber wenn du deinen Account löschen willst, dann besuche die folgende URL
[Lösche mich (http://NamederSeite/settings/removeme)](../settings/removeme)
in deinem Webbrowser. Du musst dabei eingeloggt sein.
in deinem Webbrowser. Du musst dabei eingeloggt sein.
Du wirst nach deinem Passwort gefragt, um die Anfrage zu bestätigen.
Du wirst nach deinem Passwort gefragt, um die Anfrage zu bestätigen.
Wenn dieses mit deinem gespeichertem Passwort übereinstimmt, dann wird dein Account als "gelöscht" markiert.
Dies passiert sofort und kann nicht rückgängig gemacht werden.
Die meisten Deiner Inhalte und Benutzerdaten werden kurzfristig danach durch Hintergrundprozesse gelöscht.
Die meisten deiner Inhalte und Benutzerdaten werden kurzfristig danach durch Hintergrundprozesse gelöscht.
Parallel dazu senden wir eine Mitteilung an die Server deiner Kontakte, damit sie deine dort vorliegenden Daten ebenfalls löschen.
Wir haben keinen Einfluss darauf, wie sorgfältig und ob überhaupt diese Systeme der Löschaufforderung nachgehen.
Aus technischen Gründen benötigen wir für die Übetragung dieser Mitteilung ein paar Benutzerdaten.
Aus technischen Gründen benötigen wir für die Übertragung dieser Mitteilung ein paar Benutzerdaten.
Diese Daten werden dann nach einer Frist von etwa sieben Tagen ebenfalls gelöscht.
Wir speichern deinen Benutzernamen dauerhaft, damit sich niemand einen Account unter deinem Spitznamen anlegen kann.

View file

@ -1,7 +1,4 @@
Tags und Erwähnungen
=================
* [Zur Startseite der Hilfe](help)
# Tags und Erwähnungen
Wie viele andere soziale Netzwerke benutzt auch Friendica eine spezielle Schreibweise in seinen Nachrichten, um Tags oder kontextbezogene Links zu anderen Beiträgen hervorzuheben.

View file

@ -1,11 +1,8 @@
Beiträge kommentieren, einordnen und löschen
==========================================================
# Beiträge kommentieren, einordnen und löschen
* [Zur Startseite der Hilfe](help)
Hier findest du eine Übersicht über die verschiedenen Möglichkeiten, bestehende Beiträge einzuordnen und zu kommentieren.
Hier findest du eine Übersicht über die verschiedenen Möglichkeiten, bestehende Beiträge einzuordnen und zu kommentieren.
<span style="color: red;">
Achtung: für dieses Beispiel wurde das Thema <b>"Diabook"</b> genutzt.
Achtung: für dieses Beispiel wurde das Thema <b>"Diabook"</b> genutzt.
Wenn du ein anderes Design benutzt, wirst du manche dieser Symbole gar nicht oder in anderer Form vorfinden.
</span>
@ -13,37 +10,37 @@ Wenn du ein anderes Design benutzt, wirst du manche dieser Symbole gar nicht ode
<i>Die einzelnen Symbole</i>
<img src="doc/img/post_thumbs_up.png" width="27" height="32" alt="post_thumbs_up.png" align="left" style="padding-bottom: 10px;"> Mit diesem Symbol kannst du zeigen, dass dir ein Beitrag gefällt.
<img src="doc/img/post_thumbs_up.png" width="27" height="32" alt="post_thumbs_up.png" align="left" style="padding-bottom: 10px;"> Mit diesem Symbol kannst du zeigen, dass dir ein Beitrag gefällt.
Falls du diese Eingabe zurücknehmen willst, klicke einfach ein zweites Mal auf das Symbol.
<p style="clear:both;"></p>
<img src="doc/img/post_thumbs_down.png" width="27" height="32" alt="post_thumbs_down.png" align="left" style="padding-bottom: 10px;"> Mit diesem Symbol kannst du zeigen, dass dir ein Beitrag <b>nicht</b> gefällt.
<img src="doc/img/post_thumbs_down.png" width="27" height="32" alt="post_thumbs_down.png" align="left" style="padding-bottom: 10px;"> Mit diesem Symbol kannst du zeigen, dass dir ein Beitrag <b>nicht</b> gefällt.
Falls du diese Eingabe zurücknehmen willst, klicke einfach ein zweites Mal auf das Symbol.
<p style="clear:both;"></p>
<img src="doc/img/post_share.png" width="27" height="32" alt="post_share.png" align="left" style="padding-bottom: 10px;"> Mit diesem Symbol kannst du einen Beitrag weiter verteilen.
Einfach anklicken und sofort erscheint der Beitrag in deinem Beitragseditor.
<img src="doc/img/post_share.png" width="27" height="32" alt="post_share.png" align="left" style="padding-bottom: 10px;"> Mit diesem Symbol kannst du einen Beitrag weiter verteilen.
Einfach anklicken und sofort erscheint der Beitrag in deinem Beitragseditor.
Am Ende des eingefügten Beitrags erscheint ein Link zum Originalbeitrag.
<p style="clear:both;"></p>
<img src="doc/img/post_mark.png" width="27" height="32" alt="post_mark.png" align="left" style="padding-bottom: 10px;"> Mit diesem Symbol kannst du einen Beitrag für dich markieren.
Markierte Beiträge erscheinen in deiner Netzwerk-Seite unter "Markierte".
<img src="doc/img/post_mark.png" width="27" height="32" alt="post_mark.png" align="left" style="padding-bottom: 10px;"> Mit diesem Symbol kannst du einen Beitrag für dich markieren.
Markierte Beiträge erscheinen in deiner Netzwerk-Seite unter "Markierte".
Wenn du die Markierung entfernen willst, klicke einfach ein zweites Mal auf das Symbol.
<p style="clear:both;"></p>
<img src="doc/img/post_tag.png" width="27" height="41" alt="post_tag.png" align="left" style="padding-bottom: 10px;"> Mit diesem Symbol kannst du einen tag zum Beitrag hinzufügen und diesen so einem bestimmten Schlagwort zuzuordnen.
Anschließend kannst du auf diesen tag klicken und alle Beiträge mit diesem tag ansehen.
<img src="doc/img/post_tag.png" width="27" height="41" alt="post_tag.png" align="left" style="padding-bottom: 10px;"> Mit diesem Symbol kannst du einen tag zum Beitrag hinzufügen und diesen so einem bestimmten Schlagwort zuzuordnen.
Anschließend kannst du auf diesen tag klicken und alle Beiträge mit diesem tag ansehen.
ACHTUNG: tags können nicht mehr entfernt werden.
<p style="clear:both;"></p>
<img src="doc/img/post_categorize.png" width="27" height="32" alt="post_categorize.png" align="left" style="padding-bottom: 20px;"> Mit diesem Symbol ist es möglich, die Beiträge in bestimmte Gruppen einzuordnen.
Dies dient dazu, gewählte Beiträge nach eigenen Vorstellungen zu sortieren und wieder zu finden.
<img src="doc/img/post_categorize.png" width="27" height="32" alt="post_categorize.png" align="left" style="padding-bottom: 20px;"> Mit diesem Symbol ist es möglich, die Beiträge in bestimmte Gruppen einzuordnen.
Dies dient dazu, gewählte Beiträge nach eigenen Vorstellungen zu sortieren und wieder zu finden.
Wähle eine vorhandene Gruppe oder gib einen neuen Namen ein. Die erstellten Gruppen findest du unter "Gespeicherte Ordner" in der Netzwerk-Ansicht.
<p style="clear:both;"></p>
<img src="doc/img/post_delete.png" width="27" height="32" alt="post_delete.png" align="left"> Mit diesem Symbol löschst du deinen eigenen Beitrag bzw. entfernst einen Beitrag einer anderen Person aus deinem Stream.
<P style="clear: both;"></p>
<img src="doc/img/post_choose.png" width="27" height="32" alt="post_choose.png" align="left"> Mit diesem Symbol kannst du mehrere Beiträge auswählen und gesammelt löschen.
<img src="doc/img/post_choose.png" width="27" height="32" alt="post_choose.png" align="left"> Mit diesem Symbol kannst du mehrere Beiträge auswählen und gesammelt löschen.
Hierfür gehst du nach dem Markieren aller gewünschten Beiträge auf "Lösche die markierten Beiträge" am Ende der Seite mit allen Beiträgen.
<P style="clear: both;"></p>

View file

@ -0,0 +1,48 @@
# Beiträge erstellen
Hier findest du eine Übersicht über die verschiedenen Möglichkeiten, deinen Beitrag zu bearbeiten.
<span style="color: red;">
Achtung: für dieses Beispiel wurde das Thema <b>"Diabook"</b> genutzt.
Wenn du ein anderes Design benutzt, wirst du manche dieser Symbole gar nicht oder in anderer Form vorfinden.
</span>
<img src="doc/assets/img/friendica_rich_editor.png" width="538" height="218" alt="editor">
<i>Die einzelnen Symbole</i>
<img src="doc/assets/img/camera.png" alt="editor" align="left" style="margin: 0 10px 10px 0;"> Wenn du auf dieses Symbol klickst, dann kannst du ein Bild von deinem Computer hinzufügen.
Wenn du eine Internetadresse (URL) eingeben willst, dann kannst du das "Baum"-Symbol im oberen Teil des Editors nutzen.
Wenn du ein Bild ausgewählt hast, dann erscheint eine Miniaturdarstellung des Bildes im Editor.*
<p style="clear:both;"></p>
<img src="doc/assets/img/paper_clip.png" alt="paper_clip" align="left" style="margin: 0 10px 10px 0;"> Wenn du dieses Symbol anklickst, dann kannst du weitere Dateien von deinem Computer einfügen. Eine Vorschau des Dateiinhalts erfolgt nicht.*
<p style="clear:both;"></p>
<img src="doc/assets/img/chain.png" alt="chain" align="left" style="margin: 0 10px 10px 0;"> Wenn du die Kette anklickst, dann kannst du eine Internetadresse (URL) einfügen.
Im Editor erscheint automatisch eine kurze Information zum eingefügten Link.*
<p style="clear:both;"></p>
<img src="doc/assets/img/video.png" alt="video" align="left" style="margin: 0 10px 10px 0;"> Mit dieser Funktion kannst du die Internetadresse (URL) einer Videodatei einfügen.
Das Video erscheint dann mit einem Player in deinem Beitrag.
Da Friendica zur Einbindung [HTML5](http://en.wikipedia.org/wiki/HTML5_video) verwendet, werden je nach Browser verschiedene Videoformate unterstützt (z.B. WebM oder MP4).
Außerdem kannst du hier die URLs von Videos auf Youtube, Vimeo und manchen anderen Videohostern eingeben.
Die Videos werden dann mit Vorschaubild angezeigt, nach einem Klick öffnet sich ein eingebetteter Player.*
<p style="clear:both;"></p>
<img src="doc/assets/img/mic.png" alt="mic" align="left" style="margin: 0 10px 10px 0;"> Mit dieser Funktion kannst du die Internetadresse (URL) einer Sound-Datei einfügen.
Da Friendica zur Einbindung [HTML5](http://en.wikipedia.org/wiki/HTML5_video) verwendet, werden je nach Browser und Betriebssystem MP3, Ogg oder AAC unterstützt.
Außerdem kannst du hier auch URLs von manchen Audiohostern wie Soundcloud eingeben, um eine dort gespeicherte Audiodatei mit Player in deinem Beitrag anzuzeigen.*
<p style="clear:both;"></p>
<img src="doc/assets/img/globe.png" alt="globe" align="left" style="margin: 0 10px 10px 0;"> Wenn du dieses Symbol wählst, dann kannst du deinen Standort festlegen.
Hier reicht schon eine Angabe wie "Berlin" oder "10775".
Dieser Eintrag führt anschließend zu einer Suchanfrage bei Google Maps.
<p style="clear:both;"></p>
<i>* wie du Dateien hochladen kannst, erfährst du [hier](help/faq#upload)</i>
**Im Folgenden findest du Symbole weiterer Themen**
Frio <img src="doc/assets/img/editor_frio.png" alt="frio.png" style="padding-left: 44px; vertical-align:middle;">
Vier <img src="doc/assets/img/editor_vier.png" alt="vier.png" style="padding-left: 44px; vertical-align:middle;">

View file

@ -1,7 +1,4 @@
Config values that can only be set in config/local.config.php
==========================================================
* [Home](help)
# Config values that can only be set in config/local.config.php
Friendica's configuration is done in two places: in PHP array configuration files and in the `config` database table.
Database config values overwrite the same file config values.

View file

@ -1,22 +1,10 @@
Frequently Asked Questions (Admin) - FAQ
==============
# Frequently asked questions (Admin) - FAQ
* [Home](help)
* **[Can I configure multiple domains with the same code instance?](help/FAQ-admin#multiple)**
* **[Where can I find the source code of friendica, addons and themes?](help/FAQ-admin#sources)**
* **[I've changed the my email address now the admin panel is gone?](help/FAQ-admin#adminaccount1)**
* **[Can there be more then just one admin for a node?](help/FAQ-admin#adminaccount2)**
* **[The Database structure seems not to be updated. What can I do?](help/FAQ-admin#dbupdate)**
<a name="multiple"></a>
### Can I configure multiple domains with the same code instance?
## Can I configure multiple domains with the same code instance?
No, this function is no longer supported as of Friendica 3.3 onwards.
<a name="sources"></a>
### Where can I find the source code of friendica, addons and themes?
## Where can I find the source code of friendica, addons and themes?
You can find the main repository [here](https://github.com/friendica/friendica).
There you will always find the current stable version of friendica.
@ -25,13 +13,11 @@ Addons are listed at [this page](https://github.com/friendica/friendica-addons).
If you are searching for new themes, you can find them at [github.com/bkil/friendica-themes](https://github.com/bkil/friendica-themes)
<a name="adminaccount1"></a>
### I've changed my email address now the admin panel is gone?
## I've changed my email address now the admin panel is gone?
Have a look into your <tt>config/local.config.php</tt> and fix your email address there.
<a name="adminaccount2"></a>
### Can there be more then one admin for a node?
## Can there be more then one admin for a node?
Yes.
You just have to list more then one email address in the
@ -42,14 +28,14 @@ The listed emails need to be separated by a comma like this:
'admin_email' => 'mail1@example.com,mail2@example.com',
```
<a name="dbupdate"></a>
### The Database structure seems not to be updated. What can I do?
## The Database structure seems not to be updated. What can I do?
Please have a look at the Admin panel under [DB updates](/admin/dbsync/) and follow the link to *check database structure*.
This will start a background process to check if the structure is up to the current definition.
You can manually execute the structure update from the CLI in the base directory of your Friendica installation by running the following command:
bin/console dbstructure update
```sh
bin/console dbstructure update
```
if there occur any errors, please contact the [Friendica Support group](https://forum.friendi.ca/profile/helpers) or discuss in the [Friendica Admins group](https://forum.friendi.ca/profile/admins).

View file

@ -1,25 +1,20 @@
How to improve the performance of a Friendica site
==============
* [Home](help)
# How to improve the performance of a Friendica server
Feel free to ask in the [Friendica support group](https://forum.friendi.ca/profile/helpers) if you need some clarification about the following instructions or if you need help in any other way.
System configuration
--------
## System configuration
Please go to /admin/site/ on your system and change the following values:
Please go to `/admin/site/` on your system and change the following values:
Set "JPEG image quality" to 50.
This value reduces the data that is send from the server to the client. 50 is a value that doesn't influences image quality too much.
This value reduces the data that is sent from the server to the client. 50 is a value that doesn't influence image quality too much.
Enable "Use MySQL full text engine"
When using MyISAM (default) or InnoDB on MariaDB 10 this speeds up search.
Addons
--------
## Addons
Active the following addons:
@ -43,8 +38,7 @@ They show your performance problems.
Others: Everything else :)
Total: The sum of all above values
Apache Webserver
--------
## Apache Webserver
The following Apache modules are recommended:
@ -53,20 +47,20 @@ The following Apache modules are recommended:
This module tells the client to cache the content of static files so that they aren't fetched with every request.
Enable the module "mod_expires" by typing in "a2enmod expires" as root.
Please add the following lines to your site configuration in the "directory" context.
ExpiresActive on ExpiresDefault "access plus 1 week"
```
ExpiresActive on ExpiresDefault "access plus 1 week"
```
Also see the Apache [2.2](http://httpd.apache.org/docs/2.2/mod/mod_expires.html) / [2.4](https://httpd.apache.org/docs/2.4/mod/mod_expires.html) documentation.
### Compress content
This module compresses the traffic between the web server and the client.
Enable the module "mod_deflate" by typing in "a2enmod deflate" as root.
Enable the module `mod_deflate` by typing in `a2enmod deflate` as root.
Also see the Apache [2.2](http://httpd.apache.org/docs/2.2/mod/mod_deflate.html) / [2.4](https://httpd.apache.org/docs/2.4/mod/mod_deflate.html) documentation.
Also see the Apache [2.2](https://httpd.apache.org/docs/2.2/mod/mod_deflate.html) / [2.4](https://httpd.apache.org/docs/2.4/mod/mod_deflate.html) documentation.
PHP
--------
## PHP
### FCGI

View file

@ -0,0 +1,47 @@
# Install an ejabberd with synchronized credentials
[Ejabberd](https://www.ejabberd.im/) is a chat server that uses XMPP as messaging protocol that you can use with a large amount of clients.
In conjunction with the "xmpp" addon it can be used for a web based chat solution for your users.
## Installation
- Change its owner to whichever user is running the server, ie. ejabberd
```sh
chown ejabberd:ejabberd /path/to/friendica/bin/auth_ejabberd.php
```
- Change the access mode, so it is readable only to the user ejabberd and has exec
```sh
chmod 700 /path/to/friendica/bin/auth_ejabberd.php
```
- Edit your ejabberd.cfg file, comment out your auth_method and add:
```
{auth_method, external}.
{extauth_program, "/path/to/friendica/bin/auth_ejabberd.php"}.
```
- Disable the module "mod_register" and disable the registration:
```
{access, register, [{deny, all}]}.
```
- Enable BOSH:
- Enable the module "mod_http_bind"
- Edit this line:
```
{5280, ejabberd_http, [captcha, http_poll, http_bind]}
```
- In your apache configuration for your site add this line:
```
ProxyPass /http-bind http://127.0.0.1:5280/http-bind retry=0
```
- Restart your ejabberd service, you should be able to log in with your friendica credentials
## Other hints
- if a user has a space or a @ in the nickname, the user has to replace these characters:
- " " (space) is replaced with "%20"
- "@" is replaced with "(a)"

View file

@ -1,7 +1,7 @@
# Friendica Installation
# Friendica installation
We've tried very hard to ensure that Friendica will run on commodity hosting platforms - such as those used to host Wordpress blogs and Drupal websites.
We've tried very hard to ensure that Friendica will run on commodity hosting platforms - such as those used to host WordPress blogs and Drupal websites.
We offer a manual and an automatic installation.
But be aware that Friendica is more than a simple web application.
@ -12,10 +12,10 @@ This kind of functionality requires a bit more of the host system than the typic
Not every PHP/MySQL hosting provider will be able to support Friendica.
Many will.
But **please** review the [requirements](#Requirements) and confirm these with your hosting provider prior to installation.
But **please** review the requirements below and confirm these with your hosting provider prior to installation.
## Support
If you encounter installation issues, please let us know via the [helper](http://forum.friendi.ca/profile/helpers) or the [developer](https://forum.friendi.ca/profile/developers) group or [file an issue](https://github.com/friendica/friendica/issues).
If you encounter installation issues, please let us know via the [helper](https://forum.friendi.ca/profile/helpers) or the [developer](https://forum.friendi.ca/profile/developers) group or [file an issue](https://github.com/friendica/friendica/issues).
Please be as clear as you can about your operating environment and provide as much detail as possible about any error messages you may see, so that we can prevent it from happening in the future.
Due to the large variety of operating systems and PHP platforms in existence we may have only limited ability to debug your PHP installation or acquire any missing modules - but we will do our best to solve any general code issues.
@ -27,7 +27,7 @@ Due to the large variety of operating systems and PHP platforms in existence we
### Requirements
* Apache with mod_rewrite enabled and "[AllowOverride All](https://httpd.apache.org/docs/2.4/mod/core.html#allowoverride)" so you can use a local `.htaccess` file
* Apache with `mod_rewrite` enabled and "[AllowOverride All](https://httpd.apache.org/docs/2.4/mod/core.html#allowoverride)" so you can use a local `.htaccess` file
* PHP 7.4+
* PHP *command line* access with register_argc_argv set to true in the php.ini file
* Curl, GD, GMP, PDO, mbstring, MySQLi, xml, zip, IntlChar, IDN and OpenSSL extensions
@ -74,33 +74,40 @@ Clone the [friendica/friendica GitHub repository](https://github.com/friendica/f
This makes the software much easier to update.
The Linux commands to clone the repository into a directory "mywebsite" would be
git clone https://github.com/friendica/friendica.git -b stable mywebsite
```sh
git clone https://github.com/friendica/friendica.git -b stable mywebsite
```
Get the addons by going into your website folder.
cd mywebsite
```sh
cd mywebsite
```
Clone the addon repository (separately):
git clone https://github.com/friendica/friendica-addons.git -b stable addon
```sh
git clone https://github.com/friendica/friendica-addons.git -b stable addon
```
Install the dependencies:
bin/composer.phar run install:prod
```sh
bin/composer.phar run install:prod
```
Make sure the folder *view/smarty3* exists and is writable by the webserver user, in this case *www-data*
mkdir -p view/smarty3
chown www-data:www-data view/smarty3
chmod 775 view/smarty3
```sh
mkdir -p view/smarty3
chown www-data:www-data view/smarty3
chmod 775 view/smarty3
```
If you want to use the development version of Friendica you can switch to the develop branch in the repository by running
git checkout develop
bin/composer.phar run install:prod
cd addon
git checkout develop
```sh
git checkout develop
bin/composer.phar run install:prod
cd addon
git checkout develop
```
**Be aware that the develop branch is unstable and may break your Friendica node at any time.**
You should have a recent backup before updating.
@ -111,19 +118,23 @@ If you encounter a bug, please let us know.
Create an empty database and note the access details (hostname, username, password, database name).
Generate a strong password, then enter mysql with:
mysql
```sh
mysql
```
Then use the following script using the password you just generated:
CREATE DATABASE friendicadb;
CREATE USER 'friendica'@'localhost' IDENTIFIED BY '<<your mysql password here>>';
GRANT ALL ON friendicadb.* TO 'friendica'@'localhost';
FLUSH PRIVILEGES;
EXIT;
```sql
CREATE DATABASE friendicadb;
CREATE USER 'friendica'@'localhost' IDENTIFIED BY '<<your mysql password here>>';
GRANT ALL ON friendicadb.* TO 'friendica'@'localhost';
FLUSH PRIVILEGES;
EXIT;
```
Friendica needs the permission to create and delete fields and tables in its own database.
Please check the [troubleshooting](#Troubleshooting) section if running on MySQL 5.7.17 or newer.
Please check the Troubleshooting section below if running on MySQL 5.7.17 or newer.
### Option A: Run the installer
@ -144,42 +155,45 @@ Registration errors should all be recoverable automatically.
If you get any *critical* failure at this point, it generally indicates the database was not installed correctly.
You might wish to move/rename `config/local.config.php` to another name and empty (called 'dropping') the database tables, so that you can start fresh.
### Option B: Run the automatic install script
### Option B: Run the automatic installation script
You have the following options to automatically install Friendica:
- creating a prepared config file (f.e. `prepared.config.php`)
- using environment variables (f.e. `MYSQL_HOST`)
- using options (f.e. `--dbhost <host>`)
- creating a prepared config file (f.e. `prepared.config.php`)
- using environment variables (f.e. `MYSQL_HOST`)
- using options (f.e. `--dbhost <host>`)
You can combine environment variables and options, but be aware that options are prioritized over environment variables.
For more information during the installation, you can use this command line option
bin/console autoinstall -v
```sh
bin/console autoinstall -v
```
If you wish to include all optional checks, use `-a` like this statement:
bin/console autoinstall -a
```sh
bin/console autoinstall -a
```
*If* the automatic installation fails for any reason, check the following:
* Does `config/local.config.php` already exist? If yes, the automatic installation won't start
* Are the options in the `config/local.config.php` correct? If not, edit them directly.
* Is the empty MySQL-database created? If not, create it.
* Does `config/local.config.php` already exist? If yes, the automatic installation won't start
* Are the options in the `config/local.config.php` correct? If not, edit them directly.
* Is the empty MySQL-database created? If not, create it.
#### B.1: Config file
You can use a prepared config file like [local-sample.config.php](/config/local-sample.config.php).
Navigate to the main Friendica directory and execute the following command:
bin/console autoinstall -f <prepared.config.php>
```sh
bin/console autoinstall -f <prepared.config.php>
```
#### B.2: Environment variables
There are two types of environment variables.
- those you can use in normal mode too (Currently just **database credentials**)
- those you can only use during installation (because Friendica will normally ignore it)
- those you can use in normal mode too (Currently just **database credentials**)
- those you can only use during installation (because Friendica will normally ignore it)
You can use the options during installation too and skip some of the environment variables.
@ -187,53 +201,56 @@ You can use the options during installation too and skip some of the environment
if you don't use the option `--savedb` during installation, the DB credentials will **not** be saved in the `config/local.config.php`.
- `MYSQL_HOST` The host of the mysql/mariadb database
- `MYSQL_PORT` The port of the mysql/mariadb database
- `MYSQL_USERNAME` The username of the mysql database login (used for mysql)
- `MYSQL_USER` The username of the mysql database login (used for mariadb)
- `MYSQL_PASSWORD` The password of the mysql/mariadb database login
- `MYSQL_DATABASE` The name of the mysql/mariadb database
- `MYSQL_HOST` The host of the mysql/mariadb database
- `MYSQL_PORT` The port of the mysql/mariadb database
- `MYSQL_USERNAME` The username of the mysql database login (used for mysql)
- `MYSQL_USER` The username of the mysql database login (used for mariadb)
- `MYSQL_PASSWORD` The password of the mysql/mariadb database login
- `MYSQL_DATABASE` The name of the mysql/mariadb database
**Friendica settings**
This variables wont be used at normal Friendica runtime.
These variables won't be used at normal Friendica runtime.
Instead, they get saved into `config/local.config.php`.
- `FRIENDICA_URL_PATH` The URL path of Friendica (f.e. '/friendica')
- `FRIENDICA_PHP_PATH` The path of the PHP binary
- `FRIENDICA_ADMIN_MAIL` The admin email address of Friendica (this email will be used for admin access)
- `FRIENDICA_TZ` The timezone of Friendica
- `FRIENDICA_LANG` The language of Friendica
- `FRIENDICA_URL_PATH` The URL path of Friendica (f.e. '/friendica')
- `FRIENDICA_PHP_PATH` The path of the PHP binary
- `FRIENDICA_ADMIN_MAIL` The admin email address of Friendica (this email will be used for admin access)
- `FRIENDICA_TZ` The timezone of Friendica
- `FRIENDICA_LANG` The language of Friendica
Navigate to the main Friendica directory and execute the following command:
bin/console autoinstall [--savedb]
```sh
bin/console autoinstall [--savedb]
```
#### B.3: Execution options
All options will be saved in the `config/local.config.php` and are overruling the associated environment variables.
- `-H|--dbhost <host>` The host of the mysql/mariadb database (env `MYSQL_HOST`)
- `-p|--dbport <port>` The port of the mysql/mariadb database (env `MYSQL_PORT`)
- `-U|--dbuser <username>` The username of the mysql/mariadb database login (env `MYSQL_USER` or `MYSQL_USERNAME`)
- `-P|--dbpass <password>` The password of the mysql/mariadb database login (env `MYSQL_PASSWORD`)
- `-d|--dbdata <database>` The name of the mysql/mariadb database (env `MYSQL_DATABASE`)
- `-b|--phppath <php_path>` The path of the PHP binary (env `FRIENDICA_PHP_PATH`)
- `-A|--admin <mail>` The admin email address of Friendica (env `FRIENDICA_ADMIN_MAIL`)
- `-T|--tz <timezone>` The timezone of Friendica (env `FRIENDICA_TZ`)
- `-L|--lang <language>` The language of Friendica (env `FRIENDICA_LANG`)
- `-H|--dbhost <host>` The host of the mysql/mariadb database (env `MYSQL_HOST`)
- `-p|--dbport <port>` The port of the mysql/mariadb database (env `MYSQL_PORT`)
- `-U|--dbuser <username>` The username of the mysql/mariadb database login (env `MYSQL_USER` or `MYSQL_USERNAME`)
- `-P|--dbpass <password>` The password of the mysql/mariadb database login (env `MYSQL_PASSWORD`)
- `-d|--dbdata <database>` The name of the mysql/mariadb database (env `MYSQL_DATABASE`)
- `-b|--phppath <php_path>` The path of the PHP binary (env `FRIENDICA_PHP_PATH`)
- `-A|--admin <mail>` The admin email address of Friendica (env `FRIENDICA_ADMIN_MAIL`)
- `-T|--tz <timezone>` The timezone of Friendica (env `FRIENDICA_TZ`)
- `-L|--lang <language>` The language of Friendica (env `FRIENDICA_LANG`)
Navigate to the main Friendica directory and execute the following command:
bin/console autoinstall [options]
```sh
bin/console autoinstall [options]
```
### Prepare .htaccess file
Copy `.htaccess-dist` to `.htaccess` (be careful under Windows) to have working mod-rewrite again. If you have installed Friendica into a sub directory, like */friendica/* set this path in `RewriteBase` accordingly.
Example:
cp .htaccess-dist .htaccess
```sh
cp .htaccess-dist .htaccess
```
*Note*: Do **not** rename the `.htaccess-dist` file as it is tracked by GIT and renaming will cause a dirty working directory.
@ -250,9 +267,9 @@ Another common error related to host-meta is the "Invalid profile URL."
Check for a `.well-known` directory that did not come with Friendica.
The preferred configuration is to remove the directory, however this is not always possible.
If there is any /.well-known/.htaccess file, it could interfere with this Friendica core requirement.
You should remove any RewriteRules from that file, or remove that whole file if appropriate.
It may be necessary to chmod the /.well-known/.htaccess file if you were not given write permissions by default.
If there is any `/.well-known/.htaccess` file, it could interfere with this Friendica core requirement.
You should remove any `RewriteRules` from that file, or remove that whole file if appropriate.
It may be necessary to `chmod` the `/.well-known/.htaccess` file if you were not given write permissions by default.
## Register the admin account
@ -268,8 +285,9 @@ You might wish to delete/rename `config/local.config.php` to another name and dr
Set up a cron job or scheduled task to run the worker once every 5-10 minutes in order to perform background processing.
Example:
cd /base/directory; /path/to/php bin/console.php worker
```sh
cd /base/directory; /path/to/php bin/console.php worker
```
Change "/base/directory", and "/path/to/php" as appropriate for your situation.
@ -277,8 +295,9 @@ Change "/base/directory", and "/path/to/php" as appropriate for your situation.
If you are using a Linux server, run "crontab -e" and add a line like the
one shown, substituting for your unique paths and settings:
*/10 * * * * cd /home/myname/mywebsite; /usr/bin/php bin/console.php worker
```crontab
*/10 * * * * cd /home/myname/mywebsite; /usr/bin/php bin/console.php worker
```
You can generally find the location of PHP by executing "which php".
If you run into trouble with this section please contact your hosting provider for assistance.
@ -290,12 +309,15 @@ Once you have installed Friendica and created an admin account as part of the pr
#### worker alternative: daemon
Otherwise, youll need to use the command line on your remote server and start the Friendica daemon (background task) using the following command:
cd /path/to/friendica; php bin/console.php daemon start
```sh
cd /path/to/friendica; php bin/console.php daemon start
```
Once started, you can check the daemon status using the following command:
cd /path/to/friendica; php bin/console.php daemon status
```sh
cd /path/to/friendica; php bin/console.php daemon status
```
After a server restart or any other failure, the daemon needs to be restarted.
This could be achieved by a cronjob.
@ -303,7 +325,7 @@ This could be achieved by a cronjob.
### (RECOMMENDED) Logging & Log Rotation
At this point it is recommended that you set up logging and logrotation.
To do so please visit [Settings](help/Settings) and search the 'Logs' section for more information.
To do so please visit [Settings](help/admin/settings) and search the 'Logs' section for more information.
### (RECOMMENDED) Set up a backup plan
@ -319,16 +341,23 @@ As it stores all your data, you should also have a recent dump of your Friendica
Friendica looks for some well-known HTTP headers indicating a reverse-proxy
terminating an HTTPS connection.
While the standard from RFC 7239 specifies the use of the `Forwarded` header.
Forwarded: for=192.0.2.1; proto=https; by=192.0.2.2
```
Forwarded: for=192.0.2.1; proto=https; by=192.0.2.2
```
Friendica also supports a number on non-standard headers in common use.
X-Forwarded-Proto: https
```
X-Forwarded-Proto: https
```
Front-End-Https: on
```
Front-End-Https: on
```
X-Forwarded-Ssl: on
```
X-Forwarded-Ssl: on
```
It is however preferable to use the standard approach if configuring a new server.
@ -355,12 +384,12 @@ Often this will need to be resolved with your hosting provider or (if self-hoste
First check your file permissions.
Your website and all contents must generally be world-readable.
Ensure that mod-rewrite is installed and working, and that your `.htaccess` file
Ensure that `mod-rewrite` is installed and working, and that your `.htaccess` file
is being used. To verify the latter, create a file `test.out` containing the
word "test" in the top directory of Friendica, make it world readable and point
your web browser to
http://yoursitenamehere.com/test.out
> http://yoursitenamehere.com/test.out
This file should be blocked. You should get a permission denied message.
@ -376,9 +405,10 @@ If you do not see the word "test", your `.htaccess` is working, but it is likely
that mod-rewrite is not installed in your web server or is not working.
On most Linux flavors:
% a2enmod rewrite
% /etc/init.d/apache2 restart
```sh
a2enmod rewrite
/etc/init.d/apache2 restart
```
Consult your hosting provider, experts on your particular Linux distribution or
(if Windows) the provider of your Apache server software if you need to change
@ -391,15 +421,17 @@ distribution or Apache package (if using Windows).
Create an empty `config/local.config.php`file and apply world-write permission.
On Linux:
% touch config/local.config.php
% chmod 664 config/local.config.php
```sh
touch config/local.config.php
chmod 664 config/local.config.php
```
Retry the installation. As soon as the database has been created,
******* this is important *********
% chmod 644 config/local.config.php
```sh
chmod 644 config/local.config.php
```
### Suhosin issues
@ -436,7 +468,7 @@ provided by one of our members.
> (attacker 'REMOTE_ADDR not set', file '/var/www/friendica/friendica/boot.php',
> line 1341)
>
> After a while I noticed, that `bin/console.php worker` calls further PHP script via `proc_open`.
> After a while I noticed, that `bin/console.php worker` calls further PHP scripts via `proc_open`.
> These scripts themselves also use `proc_open` and fail, because they are NOT
> called with `-d suhosin.executor.func.blacklist=none`.
>
@ -457,12 +489,13 @@ provided by one of our members.
If the setup fails to create all the database tables and/or manual creation from
the command line fails, with this error:
ERROR 1067 (42000) at line XX: Invalid default value for 'created'
> ERROR 1067 (42000) at line XX: Invalid default value for 'created'
You need to adjust your my.cnf and add the following setting under the [mysqld]
section:
sql_mode = '';
```
sql_mode = '';
```
After that, restart mysql and try again.
@ -549,9 +582,11 @@ You may also set it manually in the config file or in the database within the `d
Altering of a table may fail if it contains a large number of rows.
First verify the existing timeout (50s by default):
`show global variables like "innodb_lock_wait_timeout";`
```sql
show global variables like "innodb_lock_wait_timeout";
```
Then increase it:
`set global innodb_lock_wait_timeout=600;`
```sql
set global innodb_lock_wait_timeout=600;
```

View file

@ -1,15 +1,11 @@
Installing Connectors
==================================================
* [Home](help)
# Installing Connectors
Friendica uses add-ons to connect to some networks, such as Tumblr or Bluesky.
All of these add-ons require an account on the target network.
In addition, you (or usually the server administrator) will need to obtain an API key to allow authenticated access to your Friendica server.
Site configuration
---
## Site configuration
Addons need to be installed by the site administrator before they can be used.
This is done through the site administration panel.
@ -20,8 +16,7 @@ Other connectors, such as Bluesky, don't require an API key at all.
You can find more information about specific requirements on each addon's settings page, either on the admin page or the user page.
Bluesky Jetstream
---
## Bluesky Jetstream
To further improve connectivity to Bluesky, Admins can choose to enable 'Jetstream' connectivity.
Jetstream is a service that connects to the Bluesky firehose.

View file

@ -1,7 +1,4 @@
Migrating to a new server installation
===============
* [Home](help)
# Migrating to a new server installation
## Preparation
@ -39,9 +36,9 @@ Before transferring your database, you may want to clean it up; ensure the expir
After adjusting these settings, the database cleaning up processes will be initiated according to your configured daily cron job.
To review the size of your database, log into MySQL with ``mysql -p`` run the following query:
````
```sql
SELECT table_schema AS "Database", SUM(data_length + index_length) / 1024 / 1024 / 1024 AS "Size (GB)" FROM information_schema.TABLES GROUP BY table_schema;
````
```
You should see an output like this:
````
@ -89,4 +86,3 @@ If you are unable to login to your newly migrated Friendica installation, check
If still unable to resolve the problem, it's likely an issue with your [installation](Install).
In this case, you may try to an entirely new Friendica installation on your new server, but use a different FQDN and DNS name.
Once you have this up and running, take it offline and purge the database and configuration file and try migrating to this installation.

View file

@ -1,7 +1,4 @@
Monitoring
===========
* [Home](help)
# Monitoring
## Endpoints

View file

@ -1,7 +1,5 @@
# Settings
* [Home](help)
If you are the admin of a Friendica node, you have access to the **Admin Panel** where you can configure your Friendica node.
## Overview
@ -48,17 +46,16 @@ It is used as fall back setting should Friendica fail to recognize the visitors
The Friendica community offers some translations.
Some more complete then others.
See [this help page](/help/translations) for more information about the translation process.
See [this help page](/help/developer/translations) for more information about the translation process.
#### System Theme
Choose a theme to be the default system theme.
This can be over-ridden by user profiles.
Default theme is `vier` at the moment.
Default theme is `frio` at the moment.
You may also want to set a special theme for mobile interfaces.
Which may or may not be necessary depending of the mobile friendliness of the desktop theme you have chosen.
The `vier` theme for instance is mobile friendly.
It may or may not be necessary depending of the mobile friendliness of the desktop theme you have chosen.
### Registration
@ -74,7 +71,7 @@ You can chose between the following modes:
##### Invitation based registry
Additionally to the setting in the admin panel, you can decide if registrations are only possible using an invitation code or not.
To enable invitation based registration, you have to set the `invitation_only` setting to `true` in the `system` section of the [config/local.config.php](/help/Config) file.
To enable invitation based registration, you have to set the `invitation_only` setting to `true` in the `system` section of the [config/local.config.php](/help/admin/config) file.
If you want to use this method, the registration policy has to be set to either *open* or *requires approval*.
#### Check Display Names
@ -114,7 +111,7 @@ If you use those, please refer to the documentation of those addons for further
Default value is 'Database (legacy)': it's the legacy way used to store data directly in database.
Existing data can be moved to the current active backend using the ['storage move' console command](help/tools)
Existing data can be moved to the current active backend using the ['storage move' console command](help/admin/tools)
If selected backend has configurable options, new fields are shown here.
@ -352,11 +349,12 @@ If you want to enable those, you have to activate them in the ``config/local.con
Use the following settings to redirect PHP errors to a file.
Config:
error_reporting(E_ERROR | E_WARNING | E_PARSE );
ini_set('error_log','php.out');
ini_set('log_errors','1');
ini_set('display_errors', '0');
```
error_reporting(E_ERROR | E_WARNING | E_PARSE );
ini_set('error_log','php.out');
ini_set('log_errors','1');
ini_set('display_errors', '0');
```
This will put all PHP errors in the file php.out (which must be writeable by the webserver).
Undeclared variables are occasionally referenced in the program and therefore we do not recommend using `E_NOTICE` or `E_ALL`.
@ -383,14 +381,15 @@ These are the data base settings, the admin account settings, the path of PHP an
## DB Settings
With the following settings, you specify the data base server, the username and password for Friendica and the database to use.
'database' => [
'hostname' => 'localhost',
'username' => 'mysqlusername',
'password' => 'mysqlpassword',
'database' => 'mysqldatabasename',
'charset' => 'utf8mb4',
],
```
'database' => [
'hostname' => 'localhost',
'username' => 'mysqlusername',
'password' => 'mysqlpassword',
'database' => 'mysqldatabasename',
'charset' => 'utf8mb4',
],
```
## Admin users
@ -398,31 +397,33 @@ You can set one, or more, accounts to be *Admin*.
By default this will be the one account you create during the installation process.
But you can expand the list of email addresses by any used email address you want.
Registration of new accounts with a listed email address is not possible.
'config' => [
'admin_email' => 'you@example.com, buddy@example.com',
],
```
'config' => [
'admin_email' => 'you@example.com, buddy@example.com',
],
```
## PHP Path
Some of Friendica's processes are running in the background.
For this you need to specify the path to the PHP binary to be used.
'config' => [
'php_path' => '/usr/bin/php',
],
```
'config' => [
'php_path' => '/usr/bin/php',
],
```
## Subdirectory configuration
It is possible to install Friendica into a subdirectory of your web server.
We strongly discourage you from doing so, as this will break federation to other networks (e.g. Diaspora, GNU Social, Hubzilla)
Say you have a subdirectory for tests and put Friendica into a further subdirectory, the config would be:
'system' => [
'url' => 'https://example.com/tests/friendica',
],
```
'system' => [
'url' => 'https://example.com/tests/friendica',
],
```
## Other exceptions
Furthermore there are some experimental settings, you can read-up in the [Config values that can only be set in config/local.config.php](help/Config) section of the documentation.
Furthermore there are some experimental settings, you can read-up in the [Config values that can only be set in config/local.config.php](help/admin/config) section of the documentation.

View file

@ -1,7 +1,4 @@
Using SSL with Friendica
=====================================
* [Home](help)
# Using SSL with Friendica
## Disclaimer
@ -49,7 +46,7 @@ If you run your own server, we recommend to check out the ["Let's Encrypt" initi
Not only do they offer free SSL certificates, but also a way to automate their renewal.
You need to install a client software on your server to use it.
Instructions for the official client are [here](https://certbot.eff.org/).
Depending on your needs, you might want to look at the [list of alternative letsencrypt clients](https://letsencrypt.org/docs/client-options/).
Depending on your needs, you might want to look at the [list of alternative LetsEncrypt clients](https://letsencrypt.org/docs/client-options/).
## Web server settings
@ -70,22 +67,26 @@ This is the simplest way to enforce site-wide secure access.
Every time a user tries to access any Friendica page by any mean (manual address bar entry or link), the web server issues a Permanent Redirect response with the secure protocol prepended to the requested URL.
With Apache, enable the modules rewrite and ssl (with a shared hosting provider, this should be enabled already):
sudo a2enmod rewrite ssl
```sh
sudo a2enmod rewrite ssl
```
Add the following lines to the .htaccess file in the root folder of your Friendica instance (thanks to [AlfredSK](https://github.com/AlfredSK)):
RewriteEngine On
RewriteCond %{SERVER_PORT} 80
RewriteRule ^(.*)$ https://your.friendica.domain/$1 [R=301,L]
```
RewriteEngine On
RewriteCond %{SERVER_PORT} 80
RewriteRule ^(.*)$ https://your.friendica.domain/$1 [R=301,L]
```
With nginx, configure your server directive this way ([documentation](https://www.nginx.com/blog/creating-nginx-rewrite-rules/)):
server {
listen 80;
server_name your.friendica.domain;
return 301 https://$server_name$request_uri;
}
```
server {
listen 80;
server_name your.friendica.domain;
return 301 https://$server_name$request_uri;
}
```
### SSL Settings

View file

@ -1,10 +1,6 @@
Admin Tools
===========
# Admin tools
* [Home](help)
Friendica Tools
---------------
## Friendica tools
Friendica has a build in command console you can find in the *bin* directory.
The console provides the following commands:
@ -31,8 +27,7 @@ The console provides the following commands:
Please consult *bin/console help* on the command line interface of your server for details about the commands.
3rd Party Tools
---------------
## 3rd Party Tools
In addition to the tools Friendica includes, some 3rd party tools can make your admin days easier.
@ -44,21 +39,23 @@ The following configuration was [provided](https://forum.friendi.ca/display/1745
You need to adjust the *logpath* in the *jail.local* file and the *bantime* (value is in seconds).
In */etc/fail2ban/jail.local* create a section for Friendica:
[friendica]
enabled = true
findtime = 300
bantime = 900
filter = friendica
port = http,https
logpath = /var/log/friendica.log
logencoding = utf-8
```toml
[friendica]
enabled = true
findtime = 300
bantime = 900
filter = friendica
port = http,https
logpath = /var/log/friendica.log
logencoding = utf-8
```
And create a filter definition in */etc/fail2ban/filter.d/friendica.conf*:
[Definition]
failregex = ^.*authenticate\: failed login attempt.*\"ip\"\:\"<HOST>\".*$
ignoreregex =
```toml
[Definition]
failregex = ^.*authenticate\: failed login attempt.*\"ip\"\:\"<HOST>\".*$
ignoreregex =
```
Additionally you have to define the number of failed logins before the ban should be activated.
This is done either in the global configuration or for each jail separately.
@ -73,8 +70,10 @@ To keep them in control you should add them to the automatic [log rotation](http
In */etc/logrotate.d/* add a file called *friendica* that contains the configuration.
The following will compress */var/log/friendica* (assuming this is the location of the log file) on a daily basis and keep 2 days of back-log.
/var/log/friendica.log {
compress
daily
rotate 2
}
```
/var/log/friendica.log {
compress
daily
rotate 2
}
```

View file

@ -1,7 +1,4 @@
Updating Friendica
===============
* [Home](help)
# Updating Friendica
## Using a Friendica archive
@ -27,15 +24,17 @@ To update Addons from an archive, simply delete the ``path/to/friendica/addon``
## Using Git
You can get the latest changes at any time with
cd path/to/friendica
git pull
bin/composer.phar run install:prod
```sh
cd path/to/friendica
git pull
bin/composer.phar run install:prod
```
The addon tree has to be updated separately like so:
cd path/to/friendica/addon
git pull
```sh
cd path/to/friendica/addon
git pull
```
For both repositories:
The default branch to use is the ``stable`` branch, which is the stable version of Friendica.
@ -61,7 +60,7 @@ There are two main ways of doing it, either by manually removing the duplicates
Manually removing the duplicates is usually faster if they're not too numerous.
To manually remove the duplicates, you need to know the UNIQUE index columns available in `database.sql`.
```SQL
```sql
SELECT GROUP_CONCAT(id), <index columns>, count(*) as count FROM users
GROUP BY <index columns> HAVING count >= 2;
@ -71,7 +70,7 @@ GROUP BY <index columns> HAVING count >= 2;
If there are too many rows to handle manually, you can create a new table with the same structure as the table with duplicates and insert the existing content with INSERT IGNORE.
To recreate the table you need to know the table structure available in `database.sql`.
```SQL
```sql
CREATE TABLE <table_name>_new <rest of the CREATE TABLE>;
INSERT IGNORE INTO <table_name>_new SELECT * FROM <table_name>;
DROP TABLE <table_name>;
@ -84,7 +83,7 @@ This method is slower overall, but it is better suited for large numbers of dupl
#### Foreign Keys
Some of the updates include the use of foreign keys now that will bump into issues with previous versions, which would sometimes shove bad data into tables, preventing, causing errors such as below.
Some updates include the use of foreign keys now that will bump into issues with previous versions, which would sometimes shove bad data into tables, preventing, causing errors such as below.
```
Error 1452 occurred during database update:
@ -94,7 +93,7 @@ ALTER TABLE `thread` ADD FOREIGN KEY (`iid`) REFERENCES `item` (`id`) ON UPDATE
All current known fixes for possible items that can go wrong are as below.
```SQL
```sql
DELETE FROM `item` WHERE `owner-id` NOT IN (SELECT `id` FROM `contact`);
DELETE FROM `item` WHERE `contact-id` NOT IN (SELECT `id` FROM `contact`);
DELETE FROM `notify` WHERE `uri-id` NOT IN (SELECT `id` FROM `item-uri`);

View file

@ -1,7 +1,4 @@
Friendica Addon development
==============
* [Home](help)
# Friendica addon development
Please see the sample addon 'randplace' for a working example of using some of these features.
Addons work by intercepting event hooks - which must be registered.
@ -144,7 +141,7 @@ No additional data is provided.
## Modules
Addons may also act as "modules" and intercept all page requests for a given URL path.
In order for a addon to act as a module it needs to declare an empty function `<addon>_module()`.
In order for an addon to act as a module it needs to declare an empty function `<addon>_module()`.
If this function exists, you will now receive all page requests for `https://my.web.site/<addon>` - with any number of URL components as additional arguments.
These are parsed into the `App\Arguments` object.
@ -560,7 +557,7 @@ For `select`, **field** is:
Called just before dispatching the router.
Hook data is a `\FastRoute\RouterCollector` object that should be used to add addon routes pointing to classes.
**Notice**: The class whose name is provided in the route handler must be reachable via auto-loader.
**Notice**: The class whose name is provided in the route handler must be reachable via autoloader.
### probe_detect
@ -618,7 +615,7 @@ Called when unfollowing a remote contact on a non-native network (like Bluesky)
Hook data:
- **contact** (input): the target public contact (uid = 0) array.
- **uid** (input): the id of the source local user.
- **result** (output): wether the unfollowing is successful or not.
- **result** (output): whether the unfollowing is successful or not.
### revoke_follow
@ -627,7 +624,7 @@ Called when making a remote contact on a non-native network (like Bluesky) unfol
Hook data:
- **contact** (input): the target public contact (uid = 0) array.
- **uid** (input): the id of the source local user.
- **result** (output): a boolean value indicating wether the operation was successful or not.
- **result** (output): a boolean value indicating whether the operation was successful or not.
### block
@ -636,7 +633,7 @@ Called when blocking a remote contact on a non-native network (like Bluesky).
Hook data:
- **contact** (input): the remote contact (uid = 0) array.
- **uid** (input): the user id to issue the block for.
- **result** (output): a boolean value indicating wether the operation was successful or not.
- **result** (output): a boolean value indicating whether the operation was successful or not.
### unblock
@ -645,7 +642,7 @@ Called when unblocking a remote contact on a non-native network (like Bluesky).
Hook data:
- **contact** (input): the remote contact (uid = 0) array.
- **uid** (input): the user id to revoke the block for.
- **result** (output): a boolean value indicating wether the operation was successful or not.
- **result** (output): a boolean value indicating whether the operation was successful or not.
### support_probe

View file

@ -1,7 +1,4 @@
Friendica Storage Backend Addon development
===========================================
* [Home](help)
# Friendica storage backend addon development
Storage backends can be added via addons.
A storage backend is implemented as a class, and the plugin register the class to make it available to the system.

View file

@ -1,16 +1,14 @@
Autoloader with Composer
==========
# Autoloader with Composer
* [Home](help)
* [Developer Intro](help/Developers-Intro)
* [Developer Intro](help/developer/index)
Friendica uses [Composer](https://getcomposer.org) to manage dependencies libraries and the class autoloader both for libraries and namespaced Friendica classes.
It's a command-line tool that downloads required libraries into the `vendor` folder and makes any namespaced class in `src` available through the whole application.
* [Using Composer](help/Composer)
* [Using Composer](help/developer/composer)
## A quick introduction to class autoloading
## A quick introduction to class auto-loading
The autoloader dynamically includes the file defining a class when it is first referenced, either by instantiating an object or simply making sure that it is available, without the need to explicitly use "require_once".
@ -87,7 +85,7 @@ class ItemsManager extends BaseManager {
```
Even though we didn't explicitly include the `src/BaseManager.php` file, the autoloader will when this class is first defined, because it is referenced as a parent class.
It works with the "BaseManager" example here and it works when we need to call static methods:
It works with the "BaseManager" example here, and it works when we need to call static methods:
```php
// src/Dfrn.php
@ -153,7 +151,7 @@ class Diaspora {
}
```
if you use that class in many places of the code and you don't want to write the full path to the class every time, you can use the "use" PHP keyword
if you use that class in many places of the code, and you don't want to write the full path to the class every time, you can use the "use" PHP keyword
```php
// src/Diaspora.php
@ -198,5 +196,5 @@ So you can think of namespaces as folders in a Unix file system, with global sco
## Related
* [Using Composer](help/Composer)
* [How To Move Classes to `src`](help/Developer-How-To-Move-Classes-to-src)
* [Using Composer](help/developer/composer)
* [How To Move Classes to `src`](help/developer/how-to-move-classes-to-src)

View file

@ -1,14 +1,12 @@
Using Composer
==============
# Using Composer
* [Home](help)
* [Developer Intro](help/Developers-Intro)
* [Developer Intro](help/developer/index)
Friendica uses [Composer](https://getcomposer.org) to manage dependencies libraries and the class autoloader both for libraries and namespaced Friendica classes.
It's a command-line tool that downloads required libraries into the `vendor` folder and makes any namespaced class in `src` available through the whole application.
* [Class autoloading](help/autoloader)
* [Class autoloading](help/developer/autoloader)
## How to use Composer
@ -55,8 +53,8 @@ If you don't need to use any third-party library, then you don't need to use Com
#### Adding a third-party library to Friendica
Does your shiny new [Addon](help/Addons) need to rely on a third-party library not required by Friendica yet?
First of all, this library should be available on [Packagist](https://packagist.org) so that Composer knows how to fetch it directly just by mentioning its name in `composer.json`.
Does your shiny new [Addon](help/developer/addon-development) need to rely on a third-party library not required by Friendica yet?
First, this library should be available on [Packagist](https://packagist.org) so that Composer knows how to fetch it directly just by mentioning its name in `composer.json`.
This file is the configuration of Friendica for Composer. It lists details about the Friendica project, but also a list of required dependencies and their target version.
Here's a simplified version of the one we currently use on Friendica:
@ -116,5 +114,5 @@ $> COMPOSER_HOME=/var/tmp/composer sudo -u [web user] bin/composer.phar [mode]
## Related
* [Class autoloading](help/autoloader)
* [How To Move Classes to `src`](help/Developer-How-To-Move-Classes-to-src)
* [Class autoloading](help/developer/autoloader)
* [How To Move Classes to `src`](help/developer/developer-how-to-move-classes-to-src)

View file

@ -1,8 +1,6 @@
Domain-Driven-Design
==============
# Domain-driven design
* [Home](help)
* [Developer Intro](help/Developers-Intro)
* [Developer Intro](help/developer/index)
Friendica uses class structures inspired by Domain-Driven-Design programming patterns.
This page is meant to explain what it means in practical terms for Friendica development.
@ -85,7 +83,7 @@ class Model
{
$this->dba = $dba;
}
function save()
{
return $this->dba->update('table', get_object_vars($this), ['id' => $this->id]);
@ -136,7 +134,7 @@ class Factory
public function create()
{
return new Model($this->dba);
return new Model($this->dba);
}
}
@ -170,7 +168,7 @@ class Model
{
$this->dba = $dba;
}
function save()
{
return $this->dba->update('table', get_object_vars($this), ['id' => $this->id]);
@ -191,7 +189,7 @@ class Factory
public function create()
{
return new Model($this->dba);
return new Model($this->dba);
}
}
@ -223,7 +221,7 @@ class Repository extends Factory
public function create()
{
return new Model($this->dba);
return new Model($this->dba);
}
public function save(Model $model)

View file

@ -1,12 +1,8 @@
Friendica on GitHub
===================
* [Home](help)
# Friendica on GitHub
Here is how you can work on the code with us. If you have any questions please write to the Friendica developers' group.
Introduction to the workflow with our GitHub repository
-------------------------------------------------------
## Introduction to the workflow with our GitHub repository
1. Install git on the system you will be developing on.
2. Create your own [GitHub](https://github.com) account.
@ -17,8 +13,7 @@ Follow the instructions provided here: [http://help.github.com/fork-a-repo/](htt
6. Commit your changes to your fork.
Then go to your GitHub page and create a "Pull request" to notify us to merge your work.
Our Git Branches
----------------
## Our Git Branches
There are two relevant branches in the main repo on GitHub:
@ -26,8 +21,7 @@ There are two relevant branches in the main repo on GitHub:
2. develop: This branch contains the latest code.
This is what you want to work with.
Fast-forwarding
---------------
## Fast-forwarding
Fast forwarding is enabled by default in git.
When you merge with fast-forwarding it does not add a new commit to mark when you've performed the merge and how.
@ -37,8 +31,7 @@ This is done by running "git merge --no-ff".
[Here](https://stackoverflow.com/questions/5519007/how-do-i-make-git-merges-default-be-no-ff-no-commit) is an explanation on how to configure git to turn off fast-forwarding by default.
You can find some more background reading [here](http://nvie.com/posts/a-successful-git-branching-model/).
Release branches
----------------
## Release branches
A release branch is created when the develop branch contains all features it should have.
A release branch is used for a few things.
@ -55,8 +48,7 @@ If you were to merge develop into release-3.4 at this point, features and bug-fi
This might introduce new bugs, too.
Which defeats the purpose of the release branch.
Some important reminders
------------------------
## Some important reminders
1. Please pull in any changes from the project repository and merge them with your work **before** issuing a pull request.
We reserve the right to reject any patch which results in a large number of merge conflicts.
@ -69,8 +61,9 @@ Don't hesitate to ask us in case of doubt.
3. Check your code for typos.
There is a console command called *typo* for this.
```sh
php bin/console.php typo
```
$> php bin/console.php typo
Check out how to work with [our Vagrant](help/Vagrant) to save a lot of setup time!
Check out how to work with [our Vagrant](help/developer/vagrant) to save a lot of setup time!

View file

@ -1,18 +1,16 @@
How To Move Classes to `src`
==============
# How to move classes to `src`
* [Home](help)
* [Developer Intro](help/Developers-Intro)
* [Developer Intro](help/developer/index)
Friendica uses [Composer](help/Composer) to manage autoloading.
This means that all the PHP class files moved to the `src` folder will be [automatically included](help/autoloader) when the class it defines is first used in the flow.
Friendica uses [Composer](help/developer/composer) to manage autoloading.
This means that all the PHP class files moved to the `src` folder will be [automatically included](help/developer/autoloader) when the class it defines is first used in the flow.
This is an improvement over the current `require` usage since files will be included on an actual usage basis instead of the presence of a `require` call.
However, there are a significant number of items to check when moving a class file from the `include` folder to the `src` folder, and this page is there to list them.
## Decide the namespace
This isn't the most technical decision of them all, but it has long lasting consequences as it will be the name that will be used to refer to this class from now on.
This isn't the most technical decision of them all, but it has long-lasting consequences as it will be the name that will be used to refer to this class from now on.
There is [a shared Ethercalc sheet](https://ethercalc.org/friendica_classes) to suggest namespace/class names that lists all the already moved class files for inspiration.
A few pointers though:
@ -34,7 +32,7 @@ namespace Friendica\Core;
From now on, the `Config` class can be referred to as `Friendica\Core\Config`, however it isn't very practical, especially when the class was previously used as `Config`.
Thankfully, PHP provides namespace shortcuts through `use`.
This language construct just provides a different naming scheme for a namespace or a class, but doesn't trigger the autoload mechanism on its own.
This language construct just provides a different naming scheme for a namespace or a class, but doesn't trigger the autoload-mechanism on its own.
Here are the different ways you can use `use`:
````php
@ -104,5 +102,5 @@ Most of the time it's used for debugging purposes but there can be instances whe
## Related
* [Class autoloading](help/autoloader)
* [Using Composer](help/Composer)
* [Class autoloading](help/developer/autoloader)
* [Using Composer](help/developer/composer)

View file

@ -2,11 +2,9 @@
<!-- markdownlint-disable MD010 MD013 -->
* [Home](help)
Do you want to help us improve Friendica?
Here we have compiled some hints on how to get started and some tasks to help you choose.
A project like Friendica is the sum of many different contributions.
A project like Friendica is the sum of many contributions.
**Very different skills are required to make good software, not all of them involve coding!**
We are looking for helpers in all areas, whether you write text or code, whether you spread the word to convince people or design new icons.
Whether you feel like an expert or like a newbie - join us with your ideas!
@ -25,7 +23,7 @@ Welcome them, answer their questions, point them to documentation or ping other
## Translation
The documentation contains help on how to translate Friendica [at Transifex](/help/translations) where the UI is translated.
The documentation contains help on how to translate Friendica [at Transifex](/help/developer/translations) where the UI is translated.
If you don't want to translate the UI, or it is already done to your satisfaction, you might want to work on the translation of the /help files?
## Design
@ -41,7 +39,7 @@ If you have seen Friendica you probably have ideas to improve it, haven't you?
## Programming
Friendica uses an implementation of [Domain-Driven-Design](help/Developer-Domain-Driven-Design), please make sure to check out the provided links for hints at the expected code architecture.
Friendica uses an implementation of [Domain-Driven-Design](help/developer/domain-driven-design), please make sure to check out the provided links for hints at the expected code architecture.
### Composer
@ -66,9 +64,9 @@ If you want to have git automatically update the dependencies with composer, you
just place it into `.git/hooks/post-merge` and make it executable.
* [Class autoloading](help/autoloader)
* [Using Composer](help/Composer)
* [How To Move Classes to `src`](help/Developer-How-To-Move-Classes-to-src)
* [Class autoloading](help/developer/autoloader)
* [Using Composer](help/developer/composer)
* [How To Move Classes to `src`](help/developer/how-to-move-classes-to-src)
### Coding standards
@ -148,7 +146,7 @@ If you want to get involved here:
### Client software
As Friendica is using a [Twitter/GNU Social compatible API](help/api) any of the clients for those platforms should work with Friendica as well.
As Friendica is using a [Twitter/GNU Social compatible API](help/spec/api/index) any of the clients for those platforms should work with Friendica as well.
Furthermore, there are several client projects, especially for use with Friendica.
If you are interested in improving those clients, please contact the developers of the clients directly.

View file

@ -1,7 +1,4 @@
Friendica Templating Documentation
==================================
* [Home](help)
# Friendica templating documentation
Friendica uses [Smarty 3](http://www.smarty.net/) as PHP templating engine.
The main templates are found in
@ -21,25 +18,27 @@ Templates that are only used by addons shall be placed in the
directory.
To render a template use the function *getMarkupTemplate* to load the template and *replaceMacros* to replace the macros/variables in the just loaded template file.
$tpl = Renderer::getMarkupTemplate('install_settings.tpl');
$o .= Renderer::replaceMacros($tpl, array( ... ));
```php
$tpl = Renderer::getMarkupTemplate('install_settings.tpl');
$o .= Renderer::replaceMacros($tpl, array( ... ));
```
the array consists of an association of an identifier and the value for that identifier, i.e.
'$title' => $install_title,
```php
'$title' => $install_title,
```
where the value may as well be an array by its own.
Form Templates
--------------
## Form Templates
To guarantee a consistent look and feel for input forms, i.e. in the settings sections, there are templates for the basic form fields.
They are initialized with an array of data, depending on the tyle of the field.
They are initialized with an array of data, depending on the style of the field.
All of these take an array holding the values, e.g. for a one line text input field, which is required and should be used to type email addresses use something along the lines of:
'$adminmail' => array('adminmail', DI::l10n()->t('Site administrator email address'), $adminmail, DI::l10n()->t('Your account email address must match this in order to use the web admin panel.'), 'required', '', 'email'),
```php
'$adminmail' => array('adminmail', DI::l10n()->t('Site administrator email address'), $adminmail, DI::l10n()->t('Your account email address must match this in order to use the web admin panel.'), 'required', '', 'email'),
```
To evaluate the input value, you can then use the $_POST array, more precisely the $_POST['adminemail'] variable.
@ -148,25 +147,25 @@ Field parameter:
### field_select.tpl
A drop down selection box.
A drop-down selection box.
Field parameter:
0. Name of the field,
1. Label of the selection box,
2. Current selected value,
3. Help text for the selection box,
4. Array holding the possible values of the selection drop down.
4. Array holding the possible values of the selection drop-down.
### field_select_raw.tpl
A drop down selection box (see above) but you have to prepare the values yourself.
A drop-down selection box (see above) but you have to prepare the values yourself.
Field parameter:
0. Name of the field,
1. Label of the selection box,
2. Current selected value,
3. Help text for the selection box,
4. Possible values of the selection drop down.
4. Possible values of the selection drop-down.
### field_textarea.tpl

View file

@ -1,7 +1,4 @@
Friendica strategy Hooks
===========================================
* [Home](help)
# Friendica strategy Hooks
## Strategy hooks

View file

@ -1,6 +1,4 @@
# Themes
* [Home](help)
# Tests
You can run unit tests with [PHPUnit](https://phpunit.de/):

View file

@ -1,7 +1,4 @@
Friendica translations
======================
* [Home](help)
# Friendica translations
## Overview
@ -30,7 +27,7 @@ We currently support the gettext version 0.19.8.1 and actively check new transla
If you don't use this version, it's possible that our checks fail (f.e. because of tiny differences at linebreaks).
In case you do have a Docker environment, you can easily update the translations with the following command:
```shell
```sh
docker run --rm -v $PWD:/data -w /data friendicaci/transifex bin/run_xgettext.sh
```
@ -43,9 +40,10 @@ Once you have added new translation strings in your code changes, please run `bi
If you have the `friendica-addons` repository in the `addon` directory of your Friendica cloned repository, just run `bin/run_xgettext.sh -a <addon_name>` from the base Friendica directory.
Otherwise:
cd /path/to/friendica-addons/<addon_name>
/path/to/friendica/bin/run_xgettext.sh -s
```sh
cd /path/to/friendica-addons/<addon_name>
/path/to/friendica/bin/run_xgettext.sh -s
```
In either case, you need to commit the updated `<addon_name>/lang/C/messages.po` to your working branch.
@ -65,17 +63,19 @@ After installation of the client, you should have a `tx` command available on yo
To use it, first create a configuration file with your credentials.
On Linux this file should be placed into your home directory `~/.transifexrc`.
The content of the file should be something like the following:
[https://app.transifex.com]
username = user
token =
password = p@ssw0rd
hostname = https://app.transifex.com
```toml
[https://app.transifex.com]
username = user
token =
password = p@ssw0rd
hostname = https://app.transifex.com
```
Since Friendica version 3.5.1 we ship configuration files for the Transifex client in the core repository and the addon repository in `.tx/config`.
To update the PO files after you have translated strings of e.g. Esperanto on the Transifex website you can use `tx` to download the updated PO file in the right location.
$> tx pull -l eo
```sh
tx pull -l eo
```
Then run `bin/console po2php view/lang/<language>/messages.po` to update the related `strings.php` file and commit both files to your working branch.

View file

@ -1,16 +1,12 @@
Vagrant for Friendica Developers
===================
# Vagrant for Friendica developers
* [Home](help)
Getting started
---------------
## Getting started
[Vagrant](https://www.vagrantup.com/) is a virtualization solution for developers.
No need to setup up a webserver, database etc. before actually starting.
Vagrant creates a virtual machine for you that you can just run inside VirtualBox and start to work directly on Friendica.
It brings an Debian Bullseye with PHP 8.0 and MariaDB 10.5.11.
It brings a Debian Bullseye with PHP 8.0 and MariaDB 10.5.11.
What you need to do:
@ -34,22 +30,24 @@ Find the Friendica log file `/vagrant/logfile.out` on the VM or in the `logfile.
8. Commit and push your changes directly back to GitHub.
If you want to stop vagrant after finishing your work, run the following command
$> vagrant halt
```sh
vagrant halt
```
in the development directory.
This will not delete the virtual machine.
9. To ultimately delete the virtual machine run
$> vagrant destroy
$> rm /vagrant/config/local.config.php
```sh
vagrant destroy
rm /vagrant/config/local.config.php
```
to make sure that you can start from scratch with another "vagrant up".
Default User Accounts
---------------------
By default the provision script will setup two user accounts.
By default the provision script will set up two user accounts.
* admin, password admin
* friendica, password friendica
@ -57,10 +55,11 @@ By default the provision script will setup two user accounts.
Trouble Shooting
----------------
If you see a version mis-match for the _VirtualBox Guest Additions_ between host and guest during the initial setup of the Vagrant VM, you will need to install an addon to Vagrant (ref. [Stack Overflow](https://stackoverflow.com/a/38010683)).
If you see a version mismatch for the _VirtualBox Guest Additions_ between host and guest during the initial setup of the Vagrant VM, you will need to install an addon to Vagrant (ref. [Stack Overflow](https://stackoverflow.com/a/38010683)).
Stop the Vagrant VM and run the following command:
$> vagrant plugin install vagrant-vbguest
```sh
vagrant plugin install vagrant-vbguest
```
On the next Vagrant up, the version problem should be fixed.

81
doc/en/home.md Normal file
View file

@ -0,0 +1,81 @@
# Help
## User Manual
* General functions - first steps
* [Account basics](help/user/account-basics)
* [Quick start for new users](help/user/quick-start/guide)
* [Creating posts](help/user/text-editor)
* [BBCode tag reference](help/user/bbcode)
* [Comment, sort and delete posts](help/user/text-comment)
* [Accesskey reference](help/user/access-keys)
* [Events](help/user/events)
* [Themes](help/user/themes)
* You and other users
* [Connectors](help/user/connectors)
* [Making friends](help/user/making-friends)
* [Safety](help/user/safety)
* [Circles and privacy](help/user/circles-and-privacy)
* [Tags and mentions](help/user/tags-and-mentions)
* [Account types: Groups and Pages](help/user/accounts-groups-pages)
* [Channels](help/user/channels)
* [Chats](help/user/chats)
* Further information
* [Frequently asked questions (FAQ)](help/user/faq)
* [Moving an account](help/user/move-account)
* [Export / Import of followed Contacts](help/user/export-import-contacts)
* [Deleting an account](help/user/delete-account)
* [Bugs and issues](help/user/bugs-and-issues)
## Admin Manual
* [Installation](help/admin/install)
* [Updating](help/admin/update)
* [Frequently asked questions (FAQ)](help/admin/faq)
* [Settings & Admin Panel](help/admin/settings)
* [Installing Connectors](help/admin/installing-connectors)
* [Installing an ejabberd server (XMPP chat) with synchronized credentials](help/admin/install-ejabberd)
* [Using SSL with Friendica](help/admin/ssl)
* [Config values that can only be set in config/local.config.php](help/admin/config)
* [Improving performance](help/admin/improve-performance)
* [Migrating to a new server](help/admin/migrate)
* [Administration tools](help/admin/tools)
* [Monitoring](help/admin/monitoring)
## Developer Manual
* [Get started](help/developer/index)
* Set up development environment
* [On GitHub](help/developer/github)
* [On Vagrant](help/developer/vagrant)
* Code structure
* [Domain-driven design](help/developer/domain-driven-design)
* [Addon development](help/developer/addon-development)
* [Smarty 3 templates](help/developer/smarty3-templates)
* [Storage backend addon](help/developer/addon-storage-backend)
* How To
* [Translating Friendica](help/developer/translations)
* [Using Composer](help/developer/composer)
* [Moving classes to the src directory](help/developer/how-to-move-classes-to-src)
* [Run tests](help/developer/tests)
* Reference
* [API endpoints](help/spec/api/index)
* [Code (Doxygen generated - sets cookies)](doc/html/)
* [Protocol documentation](help/spec/protocol/protocol)
* [Database schema documentation](help/spec/database/index)
* [Class autoloading](help/developer/autoloader)
## Links
* Website: [https://friendi.ca](https://friendi.ca)
* Help Group: [@helpers@forum.friendi.ca](https://forum.friendi.ca/~helpers)
* XMPP: [support@forum.friendi.ca](xmpp:support@forum.friendi.ca?join)
* IRC: [https://web.libera.chat/?channels=#friendica](https://web.libera.chat/?channels=#friendica)
* Matrix: [https://matrix.to/#/#friendi.ca:matrix.org](https://matrix.to/#/#friendi.ca:matrix.org)
* Mailing list: [https://mailman.friendi.ca/mailman/listinfo/support-friendi.ca](http://mailman.friendi.ca/mailman/listinfo/support-friendi.ca)
## About
* [Server information](friendica)
* [Terms of service](tos)
* [Credits](credits)

View file

@ -1,7 +1,7 @@
# Friendica API entities
* [Home](help)
* [Using the APIs](help/api)
* [Using the APIs](help/spec/api/index)
## Activities
@ -18,31 +18,31 @@
<tr>
<td><code>like</code></td>
<td>List of <a href="help/API-Entities#Contact">Contacts</a></td>
<td>List of <a href="help/spec/api/entities#contact">Contacts</a></td>
<td align="center">No</td>
</tr>
<tr>
<td><code>dislike</code></td>
<td>List of <a href="help/API-Entities#Contact">Contacts</a></td>
<td>List of <a href="help/spec/api/entities#contact">Contacts</a></td>
<td align="center">No</td>
</tr>
<tr>
<td><code>attendyes</code></td>
<td>List of <a href="help/API-Entities#Contact">Contacts</a></td>
<td>List of <a href="help/spec/api/entities#contact">Contacts</a></td>
<td align="center">No</td>
</tr>
<tr>
<td><code>attendno</code></td>
<td>List of <a href="help/API-Entities#Contact">Contacts</a></td>
<td>List of <a href="help/spec/api/entities#contact">Contacts</a></td>
<td align="center">No</td>
</tr>
<tr>
<td><code>attendmaybe</code></td>
<td>List of <a href="help/API-Entities#Contact">Contacts</a></td>
<td>List of <a href="help/spec/api/entities#contact">Contacts</a></td>
<td align="center">No</td>
</tr>
@ -330,31 +330,31 @@ Ex: Wed May 23 06:01:13 +0000 2007
<tr>
<td><code>hashtags</code></td>
<td>List of <a href="help/API-Entities#Hashtag">Hashtags</a></td>
<td>List of <a href="help/spec/api/entities#hashtag">Hashtags</a></td>
<td align="center">No</td>
</tr>
<tr>
<td><code>symbols</code></td>
<td>List of <a href="help/API-Entities#Symbol">Symbols</a></td>
<td>List of <a href="help/spec/api/entities#symbol">Symbols</a></td>
<td align="center">No</td>
</tr>
<tr>
<td><code>urls</code></td>
<td>List of <a href="help/API-Entities#URL">URLs</a></td>
<td>List of <a href="help/spec/api/entities#url">URLs</a></td>
<td align="center">No</td>
</tr>
<tr>
<td><code>user_mentions</code></td>
<td>List of <a href="help/API-Entities#User+Mention">User mentions</a></td>
<td>List of <a href="help/spec/api/entities#user+mention">User mentions</a></td>
<td align="center">No</td>
</tr>
<tr>
<td><code>media</code></td>
<td>List of <a href="help/API-Entities#Media">Medias</a></td>
<td>List of <a href="help/spec/api/entities#media">Medias</a></td>
<td align="center">No</td>
</tr>
@ -570,13 +570,13 @@ Ex: Wed May 23 06:01:13 +0000 2007
<tr>
<td><code>user</code></td>
<td><a href="help/API-Entities#Contact">Contact</a></td>
<td><a href="help/spec/api/entities#contact">Contact</a></td>
<td align="center">No</td>
</tr>
<tr>
<td><code>friendica_author</code></td>
<td><a href="help/API-Entities#Contact">Contact</a></td>
<td><a href="help/spec/api/entities#contact">Contact</a></td>
<td align="center">No</td>
</tr>
@ -584,7 +584,7 @@ Ex: Wed May 23 06:01:13 +0000 2007
<td><code>friendica_owner</code></td>
<td>
<a href="help/API-Entities#Contact">Contact</a></td>
<a href="help/spec/api/entities#contact">Contact</a></td>
<td align="center">No</td>
</tr>
@ -614,7 +614,7 @@ Ex: Wed May 23 06:01:13 +0000 2007
<tr>
<td><code>friendica_activities</code></td>
<td><a href="help/API-Entities#Activities">Activities</a></td>
<td><a href="help/spec/api/entities#activities">Activities</a></td>
<td align="center">No</td>
</tr>
@ -632,13 +632,13 @@ Ex: Wed May 23 06:01:13 +0000 2007
<tr>
<td><code>attachments</code></td>
<td>List of <a href="help/API-Entities#Attachment">Attachments</a></td>
<td>List of <a href="help/spec/api/entities#attachment">Attachments</a></td>
<td align="center">Yes</td>
</tr>
<tr>
<td><code>entities</code></td>
<td><a href="help/API-Entities#Entities">Entities</a></td>
<td><a href="help/spec/api/entities#entities">Entities</a></td>
<td align="center">Yes</td>
</tr>
@ -721,7 +721,7 @@ Identical to [the Twitter Media Object](https://developer.twitter.com/en/docs/tw
<tr>
<td><code>sizes</code></td>
<td><a href="help/API-Entities#Sizes">Sizes</a></td>
<td><a href="help/spec/api/entities#sizes">Sizes</a></td>
<td align="center">No</td>
</tr>
@ -1036,13 +1036,13 @@ Mutually exclusive with <code>link</code>.
<tr>
<td><code>friendica_activities</code></td>
<td><a href="help/API-Entities#Activities">Activities</a></td>
<td><a href="help/spec/api/entities#activities">Activities</a></td>
<td></td>
</tr>
<tr>
<td><code>friendica_comments</code></td>
<td>List of <a href="help/API-Entities#Item">Items</a></td>
<td>List of <a href="help/spec/api/entities#item">Items</a></td>
<td></td>
</tr>
@ -1260,13 +1260,13 @@ Mutually exclusive with <code>link</code>.
<tr>
<td><code>sender</code></td>
<td><a href="help/API-Entities#Contact">Contact</a></td>
<td><a href="help/spec/api/entities#contact">Contact</a></td>
<td></td>
</tr>
<tr>
<td><code>recipient</code></td>
<td><a href="help/API-Entities#Contact">Contact</a></td>
<td><a href="help/spec/api/entities#contact">Contact</a></td>
<td></td>
</tr>
@ -1471,25 +1471,25 @@ Mutually exclusive with <code>link</code>.
<tr>
<td><code>medium</code></td>
<td><a href="help/API-Entities#Size">Size</a></td>
<td><a href="help/spec/api/entities#size">Size</a></td>
<td align="center">No</td>
</tr>
<tr>
<td><code>large</code></td>
<td><a href="help/API-Entities#Size">Size</a></td>
<td><a href="help/spec/api/entities#size">Size</a></td>
<td align="center">Yes</td>
</tr>
<tr>
<td><code>thumb</code></td>
<td><a href="help/API-Entities#Size">Size</a></td>
<td><a href="help/spec/api/entities#size">Size</a></td>
<td align="center">Yes</td>
</tr>
<tr>
<td><code>small</code></td>
<td><a href="help/API-Entities#Size">Size</a></td>
<td><a href="help/spec/api/entities#size">Size</a></td>
<td align="center">Yes</td>
</tr>

View file

@ -1,23 +1,22 @@
# Friendica API
* [Home](help)
* [Using the APIs](help/api)
* [Using the APIs](help/spec/api/index)
## Overview
Friendica provides the following specific endpoints.
Authentication is the same as described in [Using the APIs](help/api#Authentication).
Authentication is the same as described in [Using the APIs](help/spec/api/index#authentication).
## Entities
These endpoints uses the [Friendica API entities](help/API-Entities).
These endpoints uses the [Friendica API entities](help/spec/api/entities).
## Endpoints
### GET api/friendica/events
Returns a list of [Event](help/API-Entities#Event) entities for the current logged in user.
Returns a list of [Event](help/spec/api/entities#event) entities for the current logged in user.
#### Parameters
@ -52,7 +51,7 @@ Delete event from calendar (not the message)
### GET api/externalprofile/show
Returns a [Contact](help/API-Entities#Contact) entity for the provided profile URL.
Returns a [Contact](help/spec/api/entities#contact) entity for the provided profile URL.
#### Parameters
@ -60,7 +59,7 @@ Returns a [Contact](help/API-Entities#Contact) entity for the provided profile U
### GET api/statuses/public_timeline
Returns a list of public [Items](help/API-Entities#Item) posted on this node.
Returns a list of public [Items](help/spec/api/entities#item) posted on this node.
Equivalent of the local community page.
#### Parameters
@ -79,7 +78,7 @@ Equivalent of the local community page.
### GET api/statuses/networkpublic_timeline
Returns a list of public [Items](help/API-Entities#Item) this node is aware of.
Returns a list of public [Items](help/spec/api/entities#item) this node is aware of.
Equivalent of the global community page.
#### Parameters
@ -206,7 +205,7 @@ Deprecated Twitter received direct message list endpoint.
### GET api/direct_messages/all
Returns all [Private Messages](help/API-Entities#Private+message).
Returns all [Private Messages](help/spec/api/entities#private+message).
#### Parameters
@ -219,7 +218,7 @@ Returns all [Private Messages](help/API-Entities#Private+message).
### GET api/direct_messages/conversation
Returns all replies of a single private message conversation. Returns [Private Messages](help/API-Entities#Private+message)
Returns all replies of a single private message conversation. Returns [Private Messages](help/spec/api/entities#private+message)
#### Parameters
@ -233,7 +232,7 @@ Returns all replies of a single private message conversation. Returns [Private M
### GET api/direct_messages/sent
Deprecated Twitter sent direct message list endpoint. Returns [Private Messages](help/API-Entities#Private+message).
Deprecated Twitter sent direct message list endpoint. Returns [Private Messages](help/spec/api/entities#private+message).
#### Parameters
@ -300,7 +299,7 @@ On error:
### GET api/friendica/direct_messages_search (GET; AUTH)
Returns [Private Messages](help/API-Entities#Private+message) matching the provided search string.
Returns [Private Messages](help/spec/api/entities#private+message) matching the provided search string.
#### Parameters
@ -339,7 +338,7 @@ Array of:
* `name`: name of the circle
* `gid`: id of the circle
* `user`: array of [Contacts](help/API-Entities#Contact)
* `user`: array of [Contacts](help/spec/api/entities#contact)
### POST api/friendica/circle_create
@ -357,7 +356,7 @@ JSON data as Array like the result of [GET api/friendica/circle_show](#GET+api%2
* `gid`
* `name`
* List of [Contacts](help/API-Entities#Contact)
* List of [Contacts](help/spec/api/entities#contact)
#### Return values
@ -386,7 +385,7 @@ JSON data as array like the result of [GET api/friendica/circle_show](#GET+api%2
* `gid`
* `name`
* List of [Contacts](help/API-Entities#Contact)
* List of [Contacts](help/spec/api/entities#contact)
#### Return values
@ -423,7 +422,7 @@ Array of:
### GET api/friendica/notifications
Return last 50 [Notifications](help/API-Entities#Notification) for the current user, ordered by date with unseen item on top.
Return last 50 [Notifications](help/spec/api/entities#notification) for the current user, ordered by date with unseen item on top.
#### Parameters
@ -439,7 +438,7 @@ Set notification as seen.
#### Return values
If the note is linked to an item, returns an [Item](help/API-Entities#Item).
If the note is linked to an item, returns an [Item](help/spec/api/entities#item).
Otherwise, a success status is returned:
@ -449,7 +448,7 @@ Otherwise, a success status is returned:
### GET api/friendica/photo
Returns a [Photo](help/API-Entities#Photo).
Returns a [Photo](help/spec/api/entities#photo).
#### Parameters
@ -523,7 +522,7 @@ xml:
### GET api/friendica/photos/list
Returns the API user's [Photo List Items](help/API-Entities#Photo+List+Item).
Returns the API user's [Photo List Items](help/spec/api/entities#photo+list+item).
#### Return values
@ -772,7 +771,7 @@ On success:
### GET api/friendica/profile/show
Returns the [Profile](help/API-Entities#Profile) data of the authenticated user.
Returns the [Profile](help/spec/api/entities#profile) data of the authenticated user.
#### Return values

View file

@ -1,17 +1,16 @@
# GNU Social API
* [Home](help)
* [Using the APIs](help/api)
* [Using the APIs](help/spec/api/index)
## Overview
Friendica provides the following endpoints defined in [the official GNU Social Twitter-like API reference](https://gnusocial.net/doc/twitterapi).
Authentication is the same as described in [Using the APIs](help/api#Authentication).
Authentication is the same as described in [Using the APIs](help/spec/api/index#authentication).
## Entities
These endpoints use the [Friendica API entities](help/API-Entities).
These endpoints use the [Friendica API entities](help/spec/api/entities).
## Implemented endpoints

View file

@ -6,10 +6,10 @@
Friendica offers multiple API endpoints to interface with third-party applications:
- [Twitter](help/API-Twitter)
- [Mastodon](help/API-Mastodon)
- [Friendica-specific](help/API-Friendica)
- [GNU Social](help/API-GNU-Social)
- [Twitter](help/spec/api/twitter)
- [Mastodon](help/spec/api/mastodon)
- [Friendica-specific](help/spec/api/friendica)
- [GNU Social](help/spec/api/gnu-social)
## Usage

View file

@ -1,17 +1,16 @@
# Mastodon API
* [Home](help)
* [Using the APIs](help/api)
* [Using the APIs](help/spec/api/index)
## Overview
Friendica provides the following endpoints defined in [the official Mastodon API reference](https://docs.joinmastodon.org/api/).
Authentication is the same as described in [Using the APIs](help/api#Authentication).
Authentication is the same as described in [Using the APIs](help/spec/api/index#authentication).
## Clients
Please find a list of supported apps at [FAQ](help/FAQ#clients).
Please find a list of supported apps at [FAQ](help/user/faq#clients).
## Entities

View file

@ -1,17 +1,16 @@
# Twitter API
* [Home](help)
* [Using the APIs](help/api)
* [Using the APIs](help/spec/api/index)
## Overview
Friendica provides the following endpoints defined in the [official Twitter API reference](https://developer.twitter.com/en/docs/api-reference-index).
Authentication is the same as described in [Using the APIs](help/api#Authentication).
Authentication is the same as described in [Using the APIs](help/spec/api/index#authentication).
## Entities
These endpoints use the [Friendica API entities](help/API-Entities).
These endpoints use the [Friendica API entities](help/spec/api/entities).
## Different behaviour
@ -27,7 +26,7 @@ These endpoints use the [Friendica API entities](help/API-Entities).
* `cursor`
* `trim_user`
* `contributor_details`
* `contributor_details`
* `place_id`
* `display_coordinates`
* `include_rts`: To-Do
@ -57,7 +56,7 @@ These endpoints use the [Friendica API entities](help/API-Entities).
- `skip_status`
- [POST api/account/update_profile_image](https://developer.twitter.com/en/docs/accounts-and-users/manage-account-settings/api-reference/post-account-update_profile_image)
- Additional parameter:
- `profile_id` (optional): Numerical id of the profile for which the image should be used, default is changing the default profile.
- `profile_id` (optional): Numerical id of the profile for which the image should be used, default is changing the default profile.
- [POST api/statuses/update](https://developer.twitter.com/en/docs/tweets/post-and-engage/api-reference/post-statuses-update)
@ -163,7 +162,7 @@ These endpoints use the [Friendica API entities](help/API-Entities).
- Unsupported parameter:
- `skip_status`: No status is returned even if it isn't set to true.
- Caveats:
- `cursor` trumps `since_id` trumps `max_id` if any combination is provided.
- `cursor` trumps `since_id` trumps `max_id` if any combination is provided.
- `user_id` must be the ID of a contact associated with a local user account.
- `screen_name` must be associated with a local user account.
- `screen_name` trumps `user_id` if both are provided (undocumented Twitter behavior).
@ -243,8 +242,8 @@ These endpoints use the [Friendica API entities](help/API-Entities).
- [POST statuses/filter](https://developer.twitter.com/en/docs/tweets/filter-realtime/api-reference/post-statuses-filter)
- [GET statuses/mentions_timeline](https://developer.twitter.com/en/docs/tweets/timelines/api-reference/get-statuses-mentions_timeline)
@ -258,10 +257,10 @@ These endpoints use the [Friendica API entities](help/API-Entities).
- [GET statuses/sample](https://developer.twitter.com/en/docs/tweets/sample-realtime/api-reference/get-statuses-sample)
- [GET compliance/firehose](https://developer.twitter.com/en/docs/tweets/compliance/api-reference/compliance-firehose)
- [DELETE custom_profiles/destroy.json](https://developer.twitter.com/en/docs/direct-messages/custom-profiles/api-reference/delete-profile)
- [GET custom_profiles/:id](https://developer.twitter.com/en/docs/direct-messages/custom-profiles/api-reference/get-profile)
@ -275,8 +274,8 @@ These endpoints use the [Friendica API entities](help/API-Entities).
- [POST direct_messages/events/new (message_create)](https://developer.twitter.com/en/docs/direct-messages/sending-and-receiving/api-reference/new-event)
- [POST direct_messages/indicate_typing](https://developer.twitter.com/en/docs/direct-messages/typing-indicator-and-read-receipts/api-reference/new-typing-indicator)
- [POST direct_messages/mark_read](https://developer.twitter.com/en/docs/direct-messages/typing-indicator-and-read-receipts/api-reference/new-read-receipt)
- [DELETE direct_messages/welcome_messages/destroy](https://developer.twitter.com/en/docs/direct-messages/welcome-messages/api-reference/delete-welcome-message)
- [DELETE direct_messages/welcome_messages/rules/destroy](https://developer.twitter.com/en/docs/direct-messages/welcome-messages/api-reference/delete-welcome-message-rule)
- [PUT direct_messages/welcome_messages/update](https://developer.twitter.com/en/docs/direct-messages/welcome-messages/api-reference/update-welcome-message)
@ -299,8 +298,8 @@ These endpoints use the [Friendica API entities](help/API-Entities).
- [GET trends/available](https://developer.twitter.com/en/docs/trends/locations-with-trending-topics/api-reference/get-trends-available)
- [GET trends/closest](https://developer.twitter.com/en/docs/trends/locations-with-trending-topics/api-reference/get-trends-closest)
- [GET trends/place](https://developer.twitter.com/en/docs/trends/trends-for-location/api-reference/get-trends-place)
- [GET geo/id/:place_id](https://developer.twitter.com/en/docs/geo/place-information/api-reference/get-geo-id-place_id)
- [GET geo/reverse_geocode](https://developer.twitter.com/en/docs/geo/places-near-location/api-reference/get-geo-reverse_geocode)
- [GET geo/search](https://developer.twitter.com/en/docs/geo/places-near-location/api-reference/get-geo-search)

View file

@ -1,10 +1,8 @@
Table 2fa_app_specific_password
===========
# Table 2fa_app_specific_password
Two-factor app-specific _password
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------------- | ---------------------------------------- | ------------------ | ---- | --- | ------- | -------------- |
@ -15,19 +13,17 @@ Fields
| generated | Datetime the password was generated | datetime | NO | | NULL | |
| last_used | Datetime the password was last used | datetime | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| --------------- | --------------------- |
| PRIMARY | id |
| uid_description | uid, description(190) |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table 2fa_recovery_codes
===========
# Table 2fa_recovery_codes
Two-factor authentication recovery codes
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------- | ------------------------------- | ------------------ | ---- | --- | ------- | ----- |
@ -13,18 +11,16 @@ Fields
| generated | Datetime the code was generated | datetime | NO | | NULL | |
| used | Datetime the code was used | datetime | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | --------- |
| PRIMARY | uid, code |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table 2fa_trusted_browser
===========
# Table 2fa_trusted_browser
Two-factor authentication trusted browsers
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----------- | ---------------------------------------------- | ------------------ | ---- | --- | ------- | ----- |
@ -15,19 +13,17 @@ Fields
| created | Datetime the trusted browser was recorded | datetime | NO | | NULL | |
| last_used | Datetime the trusted browser was last used | datetime | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ----------- |
| PRIMARY | cookie_hash |
| uid | uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table account-suggestion
===========
# Table account-suggestion
Account suggestion
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------ | ------------------------------------------------------------ | ------------------ | ---- | --- | ------- | ----- |
@ -13,20 +11,18 @@ Fields
| level | level of closeness | smallint unsigned | YES | | NULL | |
| ignore | If set, this account will not be suggested again | boolean | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ---------- | ----------- |
| PRIMARY | uid, uri-id |
| uri-id_uid | uri-id, uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| uid | [user](help/database/db_user) | uid |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table account-user
===========
# Table account-user
Remote and local accounts
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------ | ------------------------------------------------------------ | ------------------ | ---- | --- | ------- | -------------- |
@ -12,8 +10,7 @@ Fields
| uri-id | Id of the item-uri table entry that contains the account url | int unsigned | NO | | NULL | |
| uid | User ID | mediumint unsigned | NO | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ---------- | ------------------- |
@ -21,12 +18,11 @@ Indexes
| uri-id_uid | UNIQUE, uri-id, uid |
| uid_uri-id | uid, uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| uid | [user](help/database/db_user) | uid |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table apcontact
===========
# Table apcontact
ActivityPub compatible contacts - used in the ActivityPub implementation
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------------ | ------------------------------------------------------------------- | -------------- | ---- | --- | ------------------- | ----- |
@ -42,8 +40,7 @@ Fields
| statuses_count | Number of posts | int unsigned | YES | | 0 | |
| updated | | datetime | NO | | 0001-01-01 00:00:00 | |
Indexes
------------
## Indexes
| Name | Fields |
| ----------- | ---------------- |
@ -56,12 +53,11 @@ Indexes
| gsid | gsid |
| uri-id | UNIQUE, uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| gsid | [gserver](help/database/db_gserver) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| gsid | [gserver](help/spec/database/db-gserver) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table application-marker
===========
# Table application-marker
Timeline marker
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------------- | ---------------------------- | ------------------ | ---- | --- | ------- | ----- |
@ -15,20 +13,18 @@ Fields
| version | Version number | smallint unsigned | YES | | NULL | |
| updated_at | creation time | datetime | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ----------------------------- |
| PRIMARY | application-id, uid, timeline |
| uid_id | uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| application-id | [application](help/database/db_application) | id |
| uid | [user](help/database/db_user) | uid |
| application-id | [application](help/spec/database/db-application) | id |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table application-token
===========
# Table application-token
OAuth user token
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------------- | ------------- | ------------------ | ---- | --- | ------- | ----- |
@ -19,20 +17,18 @@ Fields
| follow | Follow scope | boolean | YES | | NULL | |
| push | Push scope | boolean | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------------------- |
| PRIMARY | application-id, uid |
| uid_id | uid, application-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| application-id | [application](help/database/db_application) | id |
| uid | [user](help/database/db_user) | uid |
| application-id | [application](help/spec/database/db-application) | id |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table application
===========
# Table application
OAuth application
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------- | --------------- | -------------- | ---- | --- | ------- | -------------- |
@ -20,8 +18,7 @@ Fields
| follow | Follow scope | boolean | YES | | NULL | |
| push | Push scope | boolean | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| --------- | ----------------- |
@ -29,4 +26,4 @@ Indexes
| client_id | UNIQUE, client_id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,22 +1,19 @@
Table arrived-activity
===========
# Table arrived-activity
Id of arrived activities
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------- | ---------------------------------- | -------------- | ---- | --- | ------- | ----- |
| object-id | object id of the incoming activity | varbinary(383) | NO | PRI | NULL | |
| received | Receiving date | datetime | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | --------- |
| PRIMARY | object-id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table attach
===========
# Table attach
file attachments
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------- | ----------------------------------------------------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -24,19 +22,17 @@ Fields
| backend-class | Storage backend class | tinytext | YES | | NULL | |
| backend-ref | Storage backend data reference | text | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
| PRIMARY | id |
| uid | uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table cache
===========
# Table cache
Stores temporary data
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------- | ---------------------------- | -------------- | ---- | --- | ------------------- | ----- |
@ -13,8 +11,7 @@ Fields
| expires | datetime of cache expiration | datetime | NO | | 0001-01-01 00:00:00 | |
| updated | datetime of cache insertion | datetime | NO | | 0001-01-01 00:00:00 | |
Indexes
------------
## Indexes
| Name | Fields |
| --------- | ---------- |
@ -22,4 +19,4 @@ Indexes
| k_expires | k, expires |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table channel
===========
# Table channel
User defined Channels
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ---------------- | ------------------------------------------------------------------------------------------------- | ------------------ | ---- | --- | ------- | -------------- |
@ -24,19 +22,17 @@ Fields
| publish | publish channel content | boolean | YES | | NULL | |
| valid | Set, when the full-text-search is valid | boolean | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
| PRIMARY | id |
| uid | uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,18 +1,15 @@
Table check-full-text-search
===========
# Table check-full-text-search
Check for a full text search match in user defined channels before storing the message in the system
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ---------- | ---------------------------------------- | ------------ | ---- | --- | ------- | ----- |
| pid | The ID of the process | int unsigned | NO | PRI | NULL | |
| searchtext | Simplified text for the full text search | mediumtext | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ---------- | -------------------- |
@ -20,4 +17,4 @@ Indexes
| searchtext | FULLTEXT, searchtext |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table config
===========
# Table config
main configuration storage
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----- | ------------------------- | ------------- | ---- | --- | ------- | -------------- |
@ -13,8 +11,7 @@ Fields
| k | The key of the entry | varbinary(50) | NO | | | |
| v | | mediumtext | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | -------------- |
@ -22,4 +19,4 @@ Indexes
| cat_k | UNIQUE, cat, k |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table contact-relation
===========
# Table contact-relation
Contact relations
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------------------- | ----------------------------------------------------------------------- | ----------------- | ---- | --- | ------------------- | ----- |
@ -19,20 +17,18 @@ Fields
| relation-thread-score | score for interactions of relation-cid on threads of cid | smallint unsigned | YES | | NULL | |
| post-score | score for the amount of posts from cid that can be seen by relation-cid | smallint unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------ | ----------------- |
| PRIMARY | cid, relation-cid |
| relation-cid | relation-cid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| cid | [contact](help/database/db_contact) | id |
| relation-cid | [contact](help/database/db_contact) | id |
| cid | [contact](help/spec/database/db-contact) | id |
| relation-cid | [contact](help/spec/database/db-contact) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table contact
===========
# Table contact
contact table
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------------------- | -------------------------------------------------------------------------------------------------------------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -94,8 +92,7 @@ Fields
| closeness | Deprecated | tinyint unsigned | NO | | 99 | |
| profile-id | Deprecated | int unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| --------------------------- | ------------------------------------ |
@ -124,13 +121,12 @@ Indexes
| gsid_uid_failed | gsid, uid, failed |
| uri-id | uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uri-id | [item-uri](help/database/db_item-uri) | id |
| gsid | [gserver](help/database/db_gserver) | id |
| uid | [user](help/spec/database/db-user) | uid |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| gsid | [gserver](help/spec/database/db-gserver) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table conv
===========
# Table conv
private messages
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------- | ----------------------------------------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -17,19 +15,17 @@ Fields
| updated | edited timestamp | datetime | NO | | 0001-01-01 00:00:00 | |
| subject | subject of initial message | text | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
| PRIMARY | id |
| uid | uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table delayed-post
===========
# Table delayed-post
Posts that are about to be distributed at a later time
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------- | ---------------------------------------------- | ------------------ | ---- | --- | ------- | -------------- |
@ -14,8 +12,7 @@ Fields
| delayed | delay time | datetime | YES | | NULL | |
| wid | Workerqueue id | int unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | --------------------- |
@ -23,12 +20,11 @@ Indexes
| uid_uri | UNIQUE, uid, uri(190) |
| wid | wid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| wid | [workerqueue](help/database/db_workerqueue) | id |
| uid | [user](help/spec/database/db-user) | uid |
| wid | [workerqueue](help/spec/database/db-workerqueue) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table delivery-queue
===========
# Table delivery-queue
Delivery data for posts for the batch processing
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------- | --------------------------------------- | ------------------ | ---- | --- | ------- | ----- |
@ -16,8 +14,7 @@ Fields
| uid | Delivering user | mediumint unsigned | YES | | NULL | |
| failed | Number of times the delivery has failed | tinyint | YES | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------ | ------------- |
@ -26,14 +23,13 @@ Indexes
| uid | uid |
| cid | cid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| gsid | [gserver](help/database/db_gserver) | id |
| uri-id | [item-uri](help/database/db_item-uri) | id |
| cid | [contact](help/database/db_contact) | id |
| uid | [user](help/database/db_user) | uid |
| gsid | [gserver](help/spec/database/db-gserver) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| cid | [contact](help/spec/database/db-contact) | id |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table diaspora-contact
===========
# Table diaspora-contact
Diaspora compatible contacts - used in the Diaspora implementation
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----------------- | ------------------------------------------------------------ | ------------ | ---- | --- | ------------------- | ----- |
@ -31,8 +29,7 @@ Fields
| interacted_count | Number of contacts that interacted with this contact | int unsigned | YES | | 0 | |
| post_count | Number of posts and comments | int unsigned | YES | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------------ |
@ -41,12 +38,11 @@ Indexes
| alias | alias |
| gsid | gsid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| gsid | [gserver](help/database/db_gserver) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| gsid | [gserver](help/spec/database/db-gserver) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,28 +1,24 @@
Table diaspora-interaction
===========
# Table diaspora-interaction
Signed Diaspora Interaction
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----------- | --------------------------------------------------------- | ------------ | ---- | --- | ------- | ----- |
| uri-id | Id of the item-uri table entry that contains the item uri | int unsigned | NO | PRI | NULL | |
| interaction | The Diaspora interaction | mediumtext | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
| PRIMARY | uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table endpoint
===========
# Table endpoint
ActivityPub endpoints - used in the ActivityPub implementation
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------ | -------------------------------------------------------------- | -------------- | ---- | --- | ------- | ----- |
@ -12,19 +10,17 @@ Fields
| type | | varchar(20) | NO | | NULL | |
| owner-uri-id | Id of the item-uri table entry that contains the apcontact url | int unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ----------------- | -------------------------- |
| PRIMARY | url |
| owner-uri-id_type | UNIQUE, owner-uri-id, type |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| owner-uri-id | [item-uri](help/database/db_item-uri) | id |
| owner-uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table event
===========
# Table event
Events
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------- | ---------------------------------------------------------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -29,8 +27,7 @@ Fields
| deny_cid | Access Control - list of denied contact.id | mediumtext | YES | | NULL | |
| deny_gid | Access Control - list of denied circles | mediumtext | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| --------- | ---------- |
@ -39,13 +36,12 @@ Indexes
| cid | cid |
| uri-id | uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| cid | [contact](help/database/db_contact) | id |
| uri-id | [item-uri](help/database/db_item-uri) | id |
| uid | [user](help/spec/database/db-user) | uid |
| cid | [contact](help/spec/database/db-contact) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table fetch-entry
===========
# Table fetch-entry
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------- | ---------------------------------- | -------------- | ---- | --- | ------------------- | -------------- |
@ -13,8 +11,7 @@ Fields
| created | Creation date of the fetch request | datetime | NO | | 0001-01-01 00:00:00 | |
| wid | Workerqueue id | int unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ----------- |
@ -23,11 +20,10 @@ Indexes
| created | created |
| wid | wid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| wid | [workerqueue](help/database/db_workerqueue) | id |
| wid | [workerqueue](help/spec/database/db-workerqueue) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,22 +1,19 @@
Table fetched-activity
===========
# Table fetched-activity
Id of fetched activities
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------- | ----------------------------- | -------------- | ---- | --- | ------- | ----- |
| object-id | object id of fetched activity | varbinary(383) | NO | PRI | NULL | |
| received | Receiving date | datetime | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | --------- |
| PRIMARY | object-id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table fsuggest
===========
# Table fsuggest
friend suggestion stuff
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------- | ----------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -18,8 +16,7 @@ Fields
| note | | text | YES | | NULL | |
| created | | datetime | NO | | 0001-01-01 00:00:00 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
@ -27,12 +24,11 @@ Indexes
| cid | cid |
| uid | uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| cid | [contact](help/database/db_contact) | id |
| uid | [user](help/spec/database/db-user) | uid |
| cid | [contact](help/spec/database/db-contact) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table group
===========
# Table group
privacy circles, circle info
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------- | ----------------------------------------------------------------------------------------- | ------------------ | ---- | --- | ------- | -------------- |
@ -15,8 +13,7 @@ Fields
| cid | Contact id of group. When this field is filled then the members are synced automatically. | int unsigned | YES | | NULL | |
| name | human readable name of circle | varchar(255) | NO | | | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
@ -24,12 +21,11 @@ Indexes
| uid | uid |
| cid | cid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| cid | [contact](help/database/db_contact) | id |
| uid | [user](help/spec/database/db-user) | uid |
| cid | [contact](help/spec/database/db-contact) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table group_member
===========
# Table group_member
privacy circles, member info
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ---------- | ---------------------------------------------------------- | ------------ | ---- | --- | ------- | -------------- |
@ -12,8 +10,7 @@ Fields
| gid | group.id of the associated circle | int unsigned | NO | | 0 | |
| contact-id | contact.id of the member assigned to the associated circle | int unsigned | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------- | ----------------------- |
@ -21,12 +18,11 @@ Indexes
| contactid | contact-id |
| gid_contactid | UNIQUE, gid, contact-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| gid | [group](help/database/db_group) | id |
| contact-id | [contact](help/database/db_contact) | id |
| gid | [group](help/spec/database/db-group) | id |
| contact-id | [contact](help/spec/database/db-contact) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,29 +1,25 @@
Table gserver-tag
===========
# Table gserver-tag
Tags that the server has subscribed
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ---------- | ---------------------------------- | ------------ | ---- | --- | ------- | ----- |
| gserver-id | The id of the gserver | int unsigned | NO | PRI | 0 | |
| tag | Tag that the server has subscribed | varchar(100) | NO | PRI | | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | --------------- |
| PRIMARY | gserver-id, tag |
| tag | tag |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| gserver-id | [gserver](help/database/db_gserver) | id |
| gserver-id | [gserver](help/spec/database/db-gserver) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table gserver
===========
# Table gserver
Global servers
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------------------- | -------------------------------------------------------------- | ---------------- | ---- | --- | ------------------- | -------------- |
@ -43,8 +41,7 @@ Fields
| next_contact | Next connection request | datetime | YES | | 0001-01-01 00:00:00 | |
| redirect-gsid | Target Gserver id in case of a redirect | int unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------- | ----------------- |
@ -54,11 +51,10 @@ Indexes
| network | network |
| redirect-gsid | redirect-gsid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| redirect-gsid | [gserver](help/database/db_gserver) | id |
| redirect-gsid | [gserver](help/spec/database/db-gserver) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table hook
===========
# Table hook
addon hook registry
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------- | ---------------------------------------------------------------------------------------------------------- | ----------------- | ---- | --- | ------- | -------------- |
@ -14,8 +12,7 @@ Fields
| function | function name of hook handler | varbinary(200) | NO | | | |
| priority | not yet implemented - can be used to sort conflicts in hook handling by calling handlers in priority order | smallint unsigned | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------------ | ---------------------------- |
@ -24,4 +21,4 @@ Indexes
| hook_file_function | UNIQUE, hook, file, function |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,30 +1,26 @@
Table inbox-entry-receiver
===========
# Table inbox-entry-receiver
Receiver for the incoming activity
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------- | ----------- | ------------------ | ---- | --- | ------- | ----- |
| queue-id | | int unsigned | NO | PRI | NULL | |
| uid | User id | mediumint unsigned | NO | PRI | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------------- |
| PRIMARY | queue-id, uid |
| uid | uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| queue-id | [inbox-entry](help/database/db_inbox-entry) | id |
| uid | [user](help/database/db_user) | uid |
| queue-id | [inbox-entry](help/spec/database/db-inbox-entry) | id |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table inbox-entry
===========
# Table inbox-entry
Incoming activity
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------------ | -------------------------------------- | ---------------- | ---- | --- | ------- | -------------- |
@ -25,8 +23,7 @@ Fields
| wid | Workerqueue id | int unsigned | YES | | NULL | |
| retrial | Retrial counter | tinyint unsigned | YES | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ----------- | ------------------- |
@ -36,11 +33,10 @@ Indexes
| received | received |
| wid | wid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| wid | [workerqueue](help/database/db_workerqueue) | id |
| wid | [workerqueue](help/spec/database/db-workerqueue) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table inbox-status
===========
# Table inbox-status
Status of ActivityPub inboxes
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------- | ------------------------------------ | -------------- | ---- | --- | ------------------- | ----- |
@ -18,8 +16,7 @@ Fields
| archive | Is the inbox archived? | boolean | NO | | 0 | |
| shared | Is it a shared inbox? | boolean | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
@ -27,12 +24,11 @@ Indexes
| uri-id | uri-id |
| gsid | gsid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| gsid | [gserver](help/database/db_gserver) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| gsid | [gserver](help/spec/database/db-gserver) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table intro
===========
# Table intro
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----------- | ----------------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -21,8 +19,7 @@ Fields
| blocked | deprecated | boolean | NO | | 0 | |
| ignore | | boolean | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ----------- | ----------- |
@ -31,13 +28,12 @@ Indexes
| suggest-cid | suggest-cid |
| uid | uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| contact-id | [contact](help/database/db_contact) | id |
| suggest-cid | [contact](help/database/db_contact) | id |
| uid | [user](help/spec/database/db-user) | uid |
| contact-id | [contact](help/spec/database/db-contact) | id |
| suggest-cid | [contact](help/spec/database/db-contact) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table item-uri
===========
# Table item-uri
URI and GUID for items
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----- | ------------------------------- | -------------- | ---- | --- | ------- | -------------- |
@ -12,8 +10,7 @@ Fields
| uri | URI of an item | varbinary(383) | NO | | NULL | |
| guid | A unique identifier for an item | varbinary(255) | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ----------- |
@ -22,4 +19,4 @@ Indexes
| guid | guid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table key-value
===========
# Table key-value
A key value storage
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ---------- | ---------------------------- | ------------- | ---- | --- | ------- | ----- |
@ -12,12 +10,11 @@ Fields
| v | | mediumtext | YES | | NULL | |
| updated_at | timestamp of the last update | int unsigned | NO | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
| PRIMARY | k |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table locks
===========
# Table locks
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------- | ---------------------------- | ------------ | ---- | --- | ------------------- | -------------- |
@ -14,8 +12,7 @@ Fields
| pid | Process ID | int unsigned | NO | | 0 | |
| expires | datetime of cache expiration | datetime | NO | | 0001-01-01 00:00:00 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------ | ------------- |
@ -23,4 +20,4 @@ Indexes
| name_expires | name, expires |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table mail
===========
# Table mail
private messages
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------- | -------------------------------------------------------------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -31,8 +29,7 @@ Fields
| thr-parent-id | Id of the item-uri table that contains the thread parent uri | int unsigned | YES | | NULL | |
| created | creation time of the private message | datetime | NO | | 0001-01-01 00:00:00 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------- | -------------- |
@ -47,15 +44,14 @@ Indexes
| parent-uri-id | parent-uri-id |
| thr-parent-id | thr-parent-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| author-id | [contact](help/database/db_contact) | id |
| uri-id | [item-uri](help/database/db_item-uri) | id |
| parent-uri-id | [item-uri](help/database/db_item-uri) | id |
| thr-parent-id | [item-uri](help/database/db_item-uri) | id |
| uid | [user](help/spec/database/db-user) | uid |
| author-id | [contact](help/spec/database/db-contact) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| parent-uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| thr-parent-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table mailacct
===========
# Table mailacct
Mail account data for fetching mails
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------ | ------------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -22,19 +20,17 @@ Fields
| pubmail | | boolean | NO | | 0 | |
| last_check | | datetime | NO | | 0001-01-01 00:00:00 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
| PRIMARY | id |
| uid | uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table manage
===========
# Table manage
table of accounts that can manage each other
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----- | ------------- | ------------------ | ---- | --- | ------- | -------------- |
@ -12,8 +10,7 @@ Fields
| uid | User id | mediumint unsigned | NO | | 0 | |
| mid | User id | mediumint unsigned | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ---------------- |
@ -21,12 +18,11 @@ Indexes
| uid_mid | UNIQUE, uid, mid |
| mid | mid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| mid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
| mid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table notification
===========
# Table notification
notifications
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------- | ------------------------------------------------------------------------------ | ------------------ | ---- | --- | ------- | -------------- |
@ -19,8 +17,7 @@ Fields
| seen | Seen on the desktop | boolean | YES | | 0 | |
| dismissed | Dismissed via the API | boolean | YES | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ----------------------------------- | ----------------------------------------------- |
@ -33,15 +30,14 @@ Indexes
| seen_uid | seen, uid |
| uid_type_parent-uri-id_actor-id | uid, type, parent-uri-id, actor-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| vid | [verb](help/database/db_verb) | id |
| actor-id | [contact](help/database/db_contact) | id |
| target-uri-id | [item-uri](help/database/db_item-uri) | id |
| parent-uri-id | [item-uri](help/database/db_item-uri) | id |
| uid | [user](help/spec/database/db-user) | uid |
| vid | [verb](help/spec/database/db-verb) | id |
| actor-id | [contact](help/spec/database/db-contact) | id |
| target-uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| parent-uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table notify-threads
===========
# Table notify-threads
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------------------- | --------------------------------------------- | ------------------ | ---- | --- | ------- | -------------- |
@ -15,8 +13,7 @@ Fields
| parent-item | | int unsigned | NO | | 0 | |
| receiver-uid | User id | mediumint unsigned | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| -------------------- | -------------------- |
@ -25,13 +22,12 @@ Indexes
| receiver-uid | receiver-uid |
| notify-id | notify-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| notify-id | [notify](help/database/db_notify) | id |
| master-parent-uri-id | [item-uri](help/database/db_item-uri) | id |
| receiver-uid | [user](help/database/db_user) | uid |
| notify-id | [notify](help/spec/database/db-notify) | id |
| master-parent-uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| receiver-uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table notify
===========
# Table notify
[Deprecated] User notifications
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------- | --------------------------------------------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -27,8 +25,7 @@ Fields
| name_cache | Cached bbcode parsing of name | tinytext | YES | | NULL | |
| msg_cache | Cached bbcode parsing of msg | mediumtext | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------- | -------------------- |
@ -39,13 +36,12 @@ Indexes
| uri-id | uri-id |
| parent-uri-id | parent-uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uri-id | [item-uri](help/database/db_item-uri) | id |
| parent-uri-id | [item-uri](help/database/db_item-uri) | id |
| uid | [user](help/spec/database/db-user) | uid |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| parent-uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table openwebauth-token
===========
# Table openwebauth-token
Store OpenWebAuth token to verify contacts
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------- | -------------------------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -15,19 +13,17 @@ Fields
| meta | | varchar(255) | NO | | | |
| created | datetime of creation | datetime | NO | | 0001-01-01 00:00:00 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
| PRIMARY | id |
| uid | uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table parsed_url
===========
# Table parsed_url
cache for 'parse_url' queries
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------- | --------------------------------------------------- | ---------- | ---- | --- | ------------------- | ----- |
@ -16,8 +14,7 @@ Fields
| created | datetime of creation | datetime | NO | | 0001-01-01 00:00:00 | |
| expires | datetime of expiration | datetime | NO | | 0001-01-01 00:00:00 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | -------------------------- |
@ -26,4 +23,4 @@ Indexes
| expires | expires |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table pconfig
===========
# Table pconfig
personal (per user) configuration storage
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----- | ----------- | ------------------ | ---- | --- | ------- | -------------- |
@ -14,19 +12,17 @@ Fields
| k | Key | varchar(100) | NO | | | |
| v | Value | mediumtext | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| --------- | ------------------- |
| PRIMARY | id |
| uid_cat_k | UNIQUE, uid, cat, k |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table permissionset
===========
# Table permissionset
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------- | ------------------------------------------------------ | ------------------ | ---- | --- | ------- | -------------- |
@ -15,19 +13,17 @@ Fields
| deny_cid | Access Control - list of denied contact.id | mediumtext | YES | | NULL | |
| deny_gid | Access Control - list of denied circles | mediumtext | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ----------------------------------------- | ------------------------------------------------------------- |
| PRIMARY | id |
| uid_allow_cid_allow_gid_deny_cid_deny_gid | uid, allow_cid(50), allow_gid(30), deny_cid(50), deny_gid(30) |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table photo
===========
# Table photo
photo storage
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------- | ------------------------------------------------------------------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -38,8 +36,7 @@ Fields
| backend-ref | Storage backend data reference | text | YES | | NULL | |
| updated | | datetime | NO | | 0001-01-01 00:00:00 | |
Indexes
------------
## Indexes
| Name | Fields |
| ----------------------------- | ------------------------------------ |
@ -52,12 +49,11 @@ Indexes
| resource-id | resource-id |
| uid_photo-type | uid, photo-type |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| contact-id | [contact](help/database/db_contact) | id |
| uid | [user](help/spec/database/db-user) | uid |
| contact-id | [contact](help/spec/database/db-contact) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-activity
===========
# Table post-activity
Original remote activity
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------- | --------------------------------------------------------- | ------------ | ---- | --- | ------- | ----- |
@ -12,18 +10,16 @@ Fields
| activity | Original activity | mediumtext | YES | | NULL | |
| received | | datetime | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
| PRIMARY | uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-category
===========
# Table post-category
post relation to categories
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------ | --------------------------------------------------------- | ------------------ | ---- | --- | ------- | ----- |
@ -13,8 +11,7 @@ Fields
| type | | tinyint unsigned | NO | PRI | 0 | |
| tid | | int unsigned | NO | PRI | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ---------- | ---------------------- |
@ -22,13 +19,12 @@ Indexes
| tid | tid |
| uid_uri-id | uid, uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| uid | [user](help/database/db_user) | uid |
| tid | [tag](help/database/db_tag) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| uid | [user](help/spec/database/db-user) | uid |
| tid | [tag](help/spec/database/db-tag) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-collection
===========
# Table post-collection
Collection of posts
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------- | --------------------------------------------------------- | ---------------- | ---- | --- | ------- | ----- |
@ -12,8 +10,7 @@ Fields
| type | 0 - Featured | tinyint unsigned | NO | PRI | 0 | |
| author-id | Author of the featured post | int unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| --------- | ------------ |
@ -21,12 +18,11 @@ Indexes
| type | type |
| author-id | author-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| author-id | [contact](help/database/db_contact) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| author-id | [contact](help/spec/database/db-contact) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,16 +1,14 @@
Table post-content
===========
# Table post-content
Content for all posts
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------- | ---- | --- | ------- | ----- |
| uri-id | Id of the item-uri table entry that contains the item uri | int unsigned | NO | PRI | NULL | |
| title | item title | varchar(255) | NO | | | |
| content-warning | | varchar(255) | NO | | | |
| content-warning | | varchar(500) | NO | | | |
| body | item body content | mediumtext | YES | | NULL | |
| raw-body | Body without embedded media links | mediumtext | YES | | NULL | |
| quote-uri-id | Id of the item-uri table that contains the quoted uri | int unsigned | YES | | NULL | |
@ -28,8 +26,7 @@ Fields
| resource-id | Used to link other tables to items, it identifies the linked resource (e.g. photo) and if set must also set resource_type | varchar(32) | NO | | | |
| plink | permalink or URL to a displayable copy of the message at its source | varbinary(383) | NO | | | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------ | ------------ |
@ -38,12 +35,11 @@ Indexes
| resource-id | resource-id |
| quote-uri-id | quote-uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| quote-uri-id | [item-uri](help/database/db_item-uri) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| quote-uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-counts
===========
# Table post-counts
Original remote activity
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------- | ----------------------------------------------------------- | ----------------- | ---- | --- | ------- | ----- |
@ -14,8 +12,7 @@ Fields
| parent-uri-id | Id of the item-uri table that contains the parent uri | int unsigned | YES | | NULL | |
| count | Number of activities | int unsigned | YES | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------- | --------------------- |
@ -23,13 +20,12 @@ Indexes
| vid | vid |
| parent-uri-id | parent-uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| vid | [verb](help/database/db_verb) | id |
| parent-uri-id | [item-uri](help/database/db_item-uri) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| vid | [verb](help/spec/database/db-verb) | id |
| parent-uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-delivery-data
===========
# Table post-delivery-data
Delivery data for items
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ---- | --- | ------- | ----- |
@ -19,18 +17,16 @@ Fields
| legacy_dfrn | Number of successful deliveries via legacy DFRN | mediumint | NO | | 0 | |
| diaspora | Number of successful deliveries via Diaspora | mediumint | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
| PRIMARY | uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-delivery
===========
# Table post-delivery
Delivery data for posts for the batch processing
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------- | --------------------------------------------------------- | ------------------ | ---- | --- | ------------------- | ----- |
@ -16,8 +14,7 @@ Fields
| failed | Number of times the delivery has failed | tinyint | YES | | 0 | |
| receivers | JSON encoded array with the receiving contacts | mediumtext | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ---------------- | ----------------- |
@ -25,13 +22,12 @@ Indexes
| inbox-id_created | inbox-id, created |
| uid | uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| inbox-id | [item-uri](help/database/db_item-uri) | id |
| uid | [user](help/database/db_user) | uid |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| inbox-id | [item-uri](help/spec/database/db-item-uri) | id |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-engagement
===========
# Table post-engagement
Engagement data per post
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------ | --------------------------------------------------------------------- | ------------------ | ---- | --- | ------- | ----- |
@ -21,8 +19,7 @@ Fields
| comments | Number of comments | mediumint unsigned | YES | | NULL | |
| activities | Number of activities (like, dislike, ...) | mediumint unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ---------- | -------------------- |
@ -31,12 +28,11 @@ Indexes
| created | created |
| searchtext | FULLTEXT, searchtext |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| owner-id | [contact](help/database/db_contact) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| owner-id | [contact](help/spec/database/db-contact) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,22 +1,22 @@
Table post-history
===========
# Table post-history
Post history
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------- | ---- | --- | ------------------- | ----- |
| uri-id | Id of the item-uri table entry that contains the item uri | int unsigned | NO | PRI | NULL | |
| edited | Date of edit | datetime | NO | PRI | 0001-01-01 00:00:00 | |
| title | item title | varchar(255) | NO | | | |
| content-warning | | varchar(255) | NO | | | |
| content-warning | | varchar(500) | NO | | | |
| body | item body content | mediumtext | YES | | NULL | |
| raw-body | Body without embedded media links | mediumtext | YES | | NULL | |
| quote-uri-id | Id of the item-uri table that contains the quoted uri | int unsigned | YES | | NULL | |
| location | text location where this item originated | varchar(255) | NO | | | |
| coord | longitude/latitude pair representing location where this item originated | varchar(255) | NO | | | |
| language | Language information about this post | text | YES | | NULL | |
| sensitive | If true, this post contains sensitive content | boolean | YES | | NULL | |
| app | application which generated this item | varchar(255) | NO | | | |
| rendered-hash | | varchar(32) | NO | | | |
| rendered-html | item.body converted to html | mediumtext | YES | | NULL | |
@ -27,18 +27,18 @@ Fields
| resource-id | Used to link other tables to items, it identifies the linked resource (e.g. photo) and if set must also set resource_type | varchar(32) | NO | | | |
| plink | permalink or URL to a displayable copy of the message at its source | varbinary(383) | NO | | | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | -------------- |
| PRIMARY | uri-id, edited |
| Name | Fields |
| ------------ | -------------- |
| PRIMARY | uri-id, edited |
| quote-uri-id | quote-uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| quote-uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-link
===========
# Table post-link
Post related external links
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------- | --------------------------------------------------------- | ----------------- | ---- | --- | ------- | -------------- |
@ -16,19 +14,17 @@ Fields
| width | Width of the media | smallint unsigned | YES | | NULL | |
| blurhash | BlurHash representation of the link | varbinary(255) | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ---------- | ------------------- |
| PRIMARY | id |
| uri-id-url | UNIQUE, uri-id, url |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-media
===========
# Table post-media
Attached media
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------------- | ----------------------------------------------------------------------------------- | ----------------- | ---- | --- | ------- | -------------- |
@ -37,12 +35,13 @@ Fields
| embed-html | HTML embed code for this media | text | YES | | NULL | |
| embed-height | Height of the embed | smallint unsigned | YES | | NULL | |
| embed-width | Width of the embed | smallint unsigned | YES | | NULL | |
| page-type | Type of the page (e.g. article, website) | varchar(30) | YES | | NULL | |
| schematypes | Schema types of the page as JSON string | varchar(255) | YES | | NULL | |
| language | Language information about this media in the ISO 639 format | char(3) | YES | | NULL | |
| published | Publification date of this media | datetime | YES | | NULL | |
| modified | Modification date of this media | datetime | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------ | ------------------------ |
@ -52,13 +51,12 @@ Indexes
| media-uri-id | media-uri-id |
| attach-id | attach-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| media-uri-id | [item-uri](help/database/db_item-uri) | id |
| attach-id | [attach](help/database/db_attach) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| media-uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| attach-id | [attach](help/spec/database/db-attach) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-origin
===========
# Table post-origin
Posts from local users
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------- | ------------------------------------------------------------ | ------------------ | ---- | --- | ------------------- | ----- |
@ -20,8 +18,7 @@ Fields
| private | 0=public, 1=private, 2=unlisted | tinyint unsigned | NO | | 0 | |
| wall | This item was posted to the wall of uid | boolean | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ----------------- | ------------------- |
@ -34,15 +31,14 @@ Indexes
| parent-uri-id_uid | parent-uri-id, uid |
| uid_wall_received | uid, wall, received |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| uid | [user](help/database/db_user) | uid |
| parent-uri-id | [item-uri](help/database/db_item-uri) | id |
| thr-parent-id | [item-uri](help/database/db_item-uri) | id |
| vid | [verb](help/database/db_verb) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| uid | [user](help/spec/database/db-user) | uid |
| parent-uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| thr-parent-id | [item-uri](help/spec/database/db-item-uri) | id |
| vid | [verb](help/spec/database/db-verb) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-question-option
===========
# Table post-question-option
Question option
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------- | --------------------------------------------------------- | ------------ | ---- | --- | ------- | ----- |
@ -13,18 +11,16 @@ Fields
| name | Name of the option | varchar(255) | YES | | NULL | |
| replies | Number of replies for this question option | int unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ---------- |
| PRIMARY | uri-id, id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-question
===========
# Table post-question
Question
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------- | --------------------------------------------------------- | ------------ | ---- | --- | ------------------- | -------------- |
@ -14,19 +12,17 @@ Fields
| voters | Number of voters for this question | int unsigned | YES | | NULL | |
| end-time | Question end time | datetime | YES | | 0001-01-01 00:00:00 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | -------------- |
| PRIMARY | id |
| uri-id | UNIQUE, uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-searchindex
===========
# Table post-searchindex
Content for all posts
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ---------- | --------------------------------------------------------------------- | ------------ | ---- | --- | ------- | ----- |
@ -17,8 +15,7 @@ Fields
| created | | datetime | YES | | NULL | |
| restricted | If true, this post is either unlisted or not from a federated network | boolean | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ---------- | -------------------- |
@ -27,12 +24,11 @@ Indexes
| created | created |
| searchtext | FULLTEXT, searchtext |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| owner-id | [contact](help/database/db_contact) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| owner-id | [contact](help/spec/database/db-contact) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-tag
===========
# Table post-tag
post relation to tags
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------ | --------------------------------------------------------- | ---------------- | ---- | --- | ------- | ----- |
@ -13,8 +11,7 @@ Fields
| tid | | int unsigned | NO | PRI | 0 | |
| cid | Contact id of the mentioned public contact | int unsigned | NO | PRI | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ---------------------- |
@ -22,13 +19,12 @@ Indexes
| tid | tid |
| cid | cid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| tid | [tag](help/database/db_tag) | id |
| cid | [contact](help/database/db_contact) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| tid | [tag](help/spec/database/db-tag) | id |
| cid | [contact](help/spec/database/db-contact) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-thread-user
===========
# Table post-thread-user
Thread related data per user
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------------- | ------------------------------------------------------------------------------------------------------- | ------------------ | ---- | --- | ------------------- | ----- |
@ -34,8 +32,7 @@ Fields
| psid | ID of the permission set of this post | int unsigned | YES | | NULL | |
| post-user-id | Id of the post-user table | int unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| -------------------- | --------------------- |
@ -64,20 +61,19 @@ Indexes
| contact-id_received | contact-id, received |
| contact-id_created | contact-id, created |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| context-id | [item-uri](help/database/db_item-uri) | id |
| conversation-id | [item-uri](help/database/db_item-uri) | id |
| owner-id | [contact](help/database/db_contact) | id |
| author-id | [contact](help/database/db_contact) | id |
| causer-id | [contact](help/database/db_contact) | id |
| uid | [user](help/database/db_user) | uid |
| contact-id | [contact](help/database/db_contact) | id |
| psid | [permissionset](help/database/db_permissionset) | id |
| post-user-id | [post-user](help/database/db_post-user) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| context-id | [item-uri](help/spec/database/db-item-uri) | id |
| conversation-id | [item-uri](help/spec/database/db-item-uri) | id |
| owner-id | [contact](help/spec/database/db-contact) | id |
| author-id | [contact](help/spec/database/db-contact) | id |
| causer-id | [contact](help/spec/database/db-contact) | id |
| uid | [user](help/spec/database/db-user) | uid |
| contact-id | [contact](help/spec/database/db-contact) | id |
| psid | [permissionset](help/spec/database/db-permissionset) | id |
| post-user-id | [post-user](help/spec/database/db-post-user) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-thread
===========
# Table post-thread
Thread related data
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------------- | ------------------------------------------------------------------------------------------------------- | ------------ | ---- | --- | ------------------- | ----- |
@ -20,8 +18,7 @@ Fields
| changed | Date that something in the conversation changed, indicating clients should fetch the conversation again | datetime | NO | | 0001-01-01 00:00:00 | |
| commented | | datetime | NO | | 0001-01-01 00:00:00 | |
Indexes
------------
## Indexes
| Name | Fields |
| --------------- | --------------- |
@ -34,16 +31,15 @@ Indexes
| received | received |
| commented | commented |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| context-id | [item-uri](help/database/db_item-uri) | id |
| conversation-id | [item-uri](help/database/db_item-uri) | id |
| owner-id | [contact](help/database/db_contact) | id |
| author-id | [contact](help/database/db_contact) | id |
| causer-id | [contact](help/database/db_contact) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| context-id | [item-uri](help/spec/database/db-item-uri) | id |
| conversation-id | [item-uri](help/spec/database/db-item-uri) | id |
| owner-id | [contact](help/spec/database/db-contact) | id |
| author-id | [contact](help/spec/database/db-contact) | id |
| causer-id | [contact](help/spec/database/db-contact) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-user-notification
===========
# Table post-user-notification
User post notifications
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----------------- | --------------------------------------------------------- | ------------------ | ---- | --- | ------- | ----- |
@ -12,20 +10,18 @@ Fields
| uid | Owner id which owns this copy of the item | mediumint unsigned | NO | PRI | NULL | |
| notification-type | | smallint unsigned | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ----------- |
| PRIMARY | uid, uri-id |
| uri-id | uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| uid | [user](help/database/db_user) | uid |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post-user
===========
# Table post-user
User specific post data
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----------------- | ------------------------------------------------------------------------------------ | ------------------ | ---- | --- | ------------------- | -------------- |
@ -41,8 +39,7 @@ Fields
| origin | item originated at this site | boolean | NO | | 0 | |
| psid | ID of the permission set of this post | int unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| --------------------- | ----------------------- |
@ -70,23 +67,22 @@ Indexes
| uid_unseen | uid, unseen |
| uid_hidden_uri-id | uid, hidden, uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| parent-uri-id | [item-uri](help/database/db_item-uri) | id |
| thr-parent-id | [item-uri](help/database/db_item-uri) | id |
| external-id | [item-uri](help/database/db_item-uri) | id |
| replies-id | [item-uri](help/database/db_item-uri) | id |
| owner-id | [contact](help/database/db_contact) | id |
| author-id | [contact](help/database/db_contact) | id |
| causer-id | [contact](help/database/db_contact) | id |
| vid | [verb](help/database/db_verb) | id |
| uid | [user](help/database/db_user) | uid |
| contact-id | [contact](help/database/db_contact) | id |
| event-id | [event](help/database/db_event) | id |
| psid | [permissionset](help/database/db_permissionset) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| parent-uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| thr-parent-id | [item-uri](help/spec/database/db-item-uri) | id |
| external-id | [item-uri](help/spec/database/db-item-uri) | id |
| replies-id | [item-uri](help/spec/database/db-item-uri) | id |
| owner-id | [contact](help/spec/database/db-contact) | id |
| author-id | [contact](help/spec/database/db-contact) | id |
| causer-id | [contact](help/spec/database/db-contact) | id |
| vid | [verb](help/spec/database/db-verb) | id |
| uid | [user](help/spec/database/db-user) | uid |
| contact-id | [contact](help/spec/database/db-contact) | id |
| event-id | [event](help/spec/database/db-event) | id |
| psid | [permissionset](help/spec/database/db-permissionset) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table post
===========
# Table post
Structure for all posts
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------- | ------------------------------------------------------------------------------------ | ----------------- | ---- | --- | ------------------- | ----- |
@ -28,8 +26,7 @@ Fields
| visible | | boolean | NO | | 0 | |
| deleted | item has been marked for deletion | boolean | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------- | ------------- |
@ -43,19 +40,18 @@ Indexes
| causer-id | causer-id |
| vid | vid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uri-id | [item-uri](help/database/db_item-uri) | id |
| parent-uri-id | [item-uri](help/database/db_item-uri) | id |
| thr-parent-id | [item-uri](help/database/db_item-uri) | id |
| external-id | [item-uri](help/database/db_item-uri) | id |
| replies-id | [item-uri](help/database/db_item-uri) | id |
| owner-id | [contact](help/database/db_contact) | id |
| author-id | [contact](help/database/db_contact) | id |
| causer-id | [contact](help/database/db_contact) | id |
| vid | [verb](help/database/db_verb) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| parent-uri-id | [item-uri](help/spec/database/db-item-uri) | id |
| thr-parent-id | [item-uri](help/spec/database/db-item-uri) | id |
| external-id | [item-uri](help/spec/database/db-item-uri) | id |
| replies-id | [item-uri](help/spec/database/db-item-uri) | id |
| owner-id | [contact](help/spec/database/db-contact) | id |
| author-id | [contact](help/spec/database/db-contact) | id |
| causer-id | [contact](help/spec/database/db-contact) | id |
| vid | [verb](help/spec/database/db-verb) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table process
===========
# Table process
Currently running system processes
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------- | ------------------------------------------ | ------------- | ---- | --- | ------------------- | ----- |
@ -13,8 +11,7 @@ Fields
| command | | varbinary(32) | NO | | | |
| created | | datetime | NO | | 0001-01-01 00:00:00 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------------- |
@ -22,4 +19,4 @@ Indexes
| command | command |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table profile
===========
# Table profile
user profiles data
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----------------- | -------------------------------------------------------------- | ------------------ | ---- | --- | ---------- | -------------- |
@ -53,19 +51,17 @@ Fields
| publish | publish default profile in local directory | boolean | NO | | 0 | |
| net-publish | publish profile in global directory | boolean | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| -------------- | --------------- |
| PRIMARY | id |
| uid_is-default | uid, is-default |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table profile_field
===========
# Table profile_field
Custom profile fields
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------- | ----------------------------------------------------------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -17,8 +15,7 @@ Fields
| created | creation time | datetime | NO | | 0001-01-01 00:00:00 | |
| edited | last edit time | datetime | NO | | 0001-01-01 00:00:00 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
@ -27,12 +24,11 @@ Indexes
| order | order |
| psid | psid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| psid | [permissionset](help/database/db_permissionset) | id |
| uid | [user](help/spec/database/db-user) | uid |
| psid | [permissionset](help/spec/database/db-permissionset) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table register
===========
# Table register
registrations requiring admin approval
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------- | ------------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -16,19 +14,17 @@ Fields
| language | | varchar(16) | NO | | | |
| note | | text | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
| PRIMARY | id |
| uid | uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table report-post
===========
# Table report-post
Individual posts attached to a moderation report
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------ | --------------------------- | ---------------- | ---- | --- | ------- | ----- |
@ -12,20 +10,18 @@ Fields
| uri-id | Uri-id of the reported post | int unsigned | NO | PRI | NULL | |
| status | Status of the reported post | tinyint unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ----------- |
| PRIMARY | rid, uri-id |
| uri-id | uri-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| rid | [report](help/database/db_report) | id |
| uri-id | [item-uri](help/database/db_item-uri) | id |
| rid | [report](help/spec/database/db-report) | id |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table report-rule
===========
# Table report-rule
Terms of service rule lines relevant to a moderation report
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------- | ------------------------------------------------------------------------- | ------------ | ---- | --- | ------- | ----- |
@ -12,18 +10,16 @@ Fields
| line-id | Terms of service rule line number, may become invalid after a TOS change. | int unsigned | NO | PRI | NULL | |
| text | Terms of service rule text recorded at the time of the report | text | NO | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------------ |
| PRIMARY | rid, line-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| rid | [report](help/database/db_report) | id |
| rid | [report](help/spec/database/db-report) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table report
===========
# Table report
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------------- | ------------------------------------------------------------ | ------------------ | ---- | --- | -------------------------- | -------------- |
@ -25,8 +23,7 @@ Fields
| created | | datetime(6) | NO | | 0001-01-01 00:00:00.000000 | |
| edited | Last time the report has been edited | datetime(6) | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ----------------- | ------------------ |
@ -41,16 +38,15 @@ Indexes
| created | created |
| edited | edited |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| reporter-id | [contact](help/database/db_contact) | id |
| cid | [contact](help/database/db_contact) | id |
| gsid | [gserver](help/database/db_gserver) | id |
| last-editor-uid | [user](help/database/db_user) | uid |
| assigned-uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
| reporter-id | [contact](help/spec/database/db-contact) | id |
| cid | [contact](help/spec/database/db-contact) | id |
| gsid | [gserver](help/spec/database/db-gserver) | id |
| last-editor-uid | [user](help/spec/database/db-user) | uid |
| assigned-uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table search
===========
# Table search
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----- | ------------- | ------------------ | ---- | --- | ------- | -------------- |
@ -12,8 +10,7 @@ Fields
| uid | User id | mediumint unsigned | NO | | 0 | |
| term | | varchar(255) | NO | | | |
Indexes
------------
## Indexes
| Name | Fields |
| -------- | ------------- |
@ -21,11 +18,10 @@ Indexes
| uid_term | uid, term(64) |
| term | term(64) |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table session
===========
# Table session
web session storage
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------ | ------------- | --------------- | ---- | --- | ------- | -------------- |
@ -13,8 +11,7 @@ Fields
| data | | text | YES | | NULL | |
| expire | | int unsigned | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------- |
@ -23,4 +20,4 @@ Indexes
| expire | expire |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,22 +1,19 @@
Table storage
===========
# Table storage
Data stored by Database storage backend
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----- | ------------------------------ | ------------ | ---- | --- | ------- | -------------- |
| id | Auto incremented image data id | int unsigned | NO | PRI | NULL | auto_increment |
| data | file data | longblob | NO | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
| PRIMARY | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table subscription
===========
# Table subscription
Push Subscription for the API
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------------- | ------------------------------ | ------------------ | ---- | --- | ------- | -------------- |
@ -22,8 +20,7 @@ Fields
| follow_request | | boolean | YES | | NULL | |
| status | | boolean | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------------ | --------------------------- |
@ -31,12 +28,11 @@ Indexes
| application-id_uid | UNIQUE, application-id, uid |
| uid_application-id | uid, application-id |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| application-id | [application](help/database/db_application) | id |
| uid | [user](help/database/db_user) | uid |
| application-id | [application](help/spec/database/db-application) | id |
| uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table tag
===========
# Table tag
tags and mentions
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----- | ----------------------------------------------------------------------------- | ---------------- | ---- | --- | ------- | -------------- |
@ -13,8 +11,7 @@ Fields
| url | | varbinary(383) | NO | | | |
| type | Type of the tag (Unknown, General Collection, Follower Collection or Account) | tinyint unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------------- | ----------------- |
@ -23,4 +20,4 @@ Indexes
| url | url |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table user-contact
===========
# Table user-contact
User specific public contact data
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------------------- | -------------------------------------------------------------------------- | ------------------ | ---- | --- | ------- | ----- |
@ -30,8 +28,7 @@ Fields
| rating | Automatically detected feed poll frequency | tinyint | YES | | NULL | |
| priority | Feed poll priority | tinyint unsigned | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ---------- | ------------------- |
@ -39,13 +36,12 @@ Indexes
| cid | cid |
| uri-id_uid | UNIQUE, uri-id, uid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| cid | [contact](help/database/db_contact) | id |
| uid | [user](help/database/db_user) | uid |
| uri-id | [item-uri](help/database/db_item-uri) | id |
| cid | [contact](help/spec/database/db-contact) | id |
| uid | [user](help/spec/database/db-user) | uid |
| uri-id | [item-uri](help/spec/database/db-item-uri) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table user-gserver
===========
# Table user-gserver
User settings about remote servers
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------- | ---------------------------------------- | ------------------ | ---- | --- | ------- | ----- |
@ -12,20 +10,18 @@ Fields
| gsid | Gserver id | int unsigned | NO | PRI | 0 | |
| ignored | server accounts are ignored for the user | boolean | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | --------- |
| PRIMARY | uid, gsid |
| gsid | gsid |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| uid | [user](help/database/db_user) | uid |
| gsid | [gserver](help/database/db_gserver) | id |
| uid | [user](help/spec/database/db-user) | uid |
| gsid | [gserver](help/spec/database/db-gserver) | id |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table user
===========
# Table user
The local users
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ------------------------ | --------------------------------------------------------------------------------- | ------------------ | ---- | --- | ------------------- | -------------- |
@ -51,8 +49,7 @@ Fields
| deny_gid | default permission for this user | mediumtext | YES | | NULL | |
| openidserver | | text | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ---------- | ------------ |
@ -62,11 +59,10 @@ Indexes
| guid | guid |
| email | email(64) |
Foreign Keys
------------
## Foreign keys
| Field | Target Table | Target Field |
|-------|--------------|--------------|
| parent-uid | [user](help/database/db_user) | uid |
| parent-uid | [user](help/spec/database/db-user) | uid |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,18 +1,15 @@
Table userd
===========
# Table userd
Deleted usernames
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| -------- | ------------- | ------------ | ---- | --- | ------- | -------------- |
| id | sequential ID | int unsigned | NO | PRI | NULL | auto_increment |
| username | | varchar(255) | NO | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| -------- | ------------ |
@ -20,4 +17,4 @@ Indexes
| username | username(32) |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,18 +1,15 @@
Table verb
===========
# Table verb
Activity Verbs
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----- | ----------- | ----------------- | ---- | --- | ------- | -------------- |
| id | | smallint unsigned | NO | PRI | NULL | auto_increment |
| name | | varchar(100) | NO | | | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
@ -20,4 +17,4 @@ Indexes
| name | name |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,22 +1,19 @@
Table worker-ipc
===========
# Table worker-ipc
Inter process communication between the frontend and the worker
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| ----- | ------------------------- | ------- | ---- | --- | ------- | ----- |
| key | | int | NO | PRI | NULL | |
| jobs | Flag for outstanding jobs | boolean | YES | | NULL | |
Indexes
------------
## Indexes
| Name | Fields |
| ------- | ------ |
| PRIMARY | key |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -1,10 +1,8 @@
Table workerqueue
===========
# Table workerqueue
Background tasks queue entries
Fields
------
## Fields
| Field | Description | Type | Null | Key | Default | Extra |
| --------- | ------------------------------------------------------- | ---------------- | ---- | --- | ------------------- | -------------- |
@ -19,8 +17,7 @@ Fields
| retrial | Retrial counter | tinyint | NO | | 0 | |
| done | Marked 1 when the task was done - will be deleted later | boolean | NO | | 0 | |
Indexes
------------
## Indexes
| Name | Fields |
| ----------------------------- | -------------------------------- |
@ -35,4 +32,4 @@ Indexes
| done_pid_priority_created | done, pid, priority, created |
Return to [database documentation](help/database)
Return to [database documentation](help/spec/database/index)

View file

@ -0,0 +1,94 @@
# Database tables
| Table | Description |
|-------|-------------|
| [2fa_app_specific_password](help/spec/database/db-2fa_app_specific_password) | Two-factor app-specific _password |
| [2fa_recovery_codes](help/spec/database/db-2fa_recovery_codes) | Two-factor authentication recovery codes |
| [2fa_trusted_browser](help/spec/database/db-2fa_trusted_browser) | Two-factor authentication trusted browsers |
| [account-suggestion](help/spec/database/db-account-suggestion) | Account suggestion |
| [account-user](help/spec/database/db-account-user) | Remote and local accounts |
| [apcontact](help/spec/database/db-apcontact) | ActivityPub compatible contacts - used in the ActivityPub implementation |
| [application](help/spec/database/db-application) | OAuth application |
| [application-marker](help/spec/database/db-application-marker) | Timeline marker |
| [application-token](help/spec/database/db-application-token) | OAuth user token |
| [arrived-activity](help/spec/database/db-arrived-activity) | Id of arrived activities |
| [attach](help/spec/database/db-attach) | file attachments |
| [cache](help/spec/database/db-cache) | Stores temporary data |
| [channel](help/spec/database/db-channel) | User defined Channels |
| [check-full-text-search](help/spec/database/db-check-full-text-search) | Check for a full text search match in user defined channels before storing the message in the system |
| [config](help/spec/database/db-config) | main configuration storage |
| [contact](help/spec/database/db-contact) | contact table |
| [contact-relation](help/spec/database/db-contact-relation) | Contact relations |
| [conv](help/spec/database/db-conv) | private messages |
| [delayed-post](help/spec/database/db-delayed-post) | Posts that are about to be distributed at a later time |
| [delivery-queue](help/spec/database/db-delivery-queue) | Delivery data for posts for the batch processing |
| [diaspora-contact](help/spec/database/db-diaspora-contact) | Diaspora compatible contacts - used in the Diaspora implementation |
| [diaspora-interaction](help/spec/database/db-diaspora-interaction) | Signed Diaspora Interaction |
| [endpoint](help/spec/database/db-endpoint) | ActivityPub endpoints - used in the ActivityPub implementation |
| [event](help/spec/database/db-event) | Events |
| [fetch-entry](help/spec/database/db-fetch-entry) | |
| [fetched-activity](help/spec/database/db-fetched-activity) | Id of fetched activities |
| [fsuggest](help/spec/database/db-fsuggest) | friend suggestion stuff |
| [group](help/spec/database/db-group) | privacy circles, circle info |
| [group_member](help/spec/database/db-group_member) | privacy circles, member info |
| [gserver](help/spec/database/db-gserver) | Global servers |
| [gserver-tag](help/spec/database/db-gserver-tag) | Tags that the server has subscribed |
| [hook](help/spec/database/db-hook) | addon hook registry |
| [inbox-entry](help/spec/database/db-inbox-entry) | Incoming activity |
| [inbox-entry-receiver](help/spec/database/db-inbox-entry-receiver) | Receiver for the incoming activity |
| [inbox-status](help/spec/database/db-inbox-status) | Status of ActivityPub inboxes |
| [intro](help/spec/database/db-intro) | |
| [item-uri](help/spec/database/db-item-uri) | URI and GUID for items |
| [key-value](help/spec/database/db-key-value) | A key value storage |
| [locks](help/spec/database/db-locks) | |
| [mail](help/spec/database/db-mail) | private messages |
| [mailacct](help/spec/database/db-mailacct) | Mail account data for fetching mails |
| [manage](help/spec/database/db-manage) | table of accounts that can manage each other |
| [notification](help/spec/database/db-notification) | notifications |
| [notify](help/spec/database/db-notify) | [Deprecated] User notifications |
| [notify-threads](help/spec/database/db-notify-threads) | |
| [openwebauth-token](help/spec/database/db-openwebauth-token) | Store OpenWebAuth token to verify contacts |
| [parsed_url](help/spec/database/db-parsed_url) | cache for 'parse_url' queries |
| [pconfig](help/spec/database/db-pconfig) | personal (per user) configuration storage |
| [permissionset](help/spec/database/db-permissionset) | |
| [photo](help/spec/database/db-photo) | photo storage |
| [post](help/spec/database/db-post) | Structure for all posts |
| [post-activity](help/spec/database/db-post-activity) | Original remote activity |
| [post-category](help/spec/database/db-post-category) | post relation to categories |
| [post-collection](help/spec/database/db-post-collection) | Collection of posts |
| [post-content](help/spec/database/db-post-content) | Content for all posts |
| [post-counts](help/spec/database/db-post-counts) | Original remote activity |
| [post-delivery](help/spec/database/db-post-delivery) | Delivery data for posts for the batch processing |
| [post-delivery-data](help/spec/database/db-post-delivery-data) | Delivery data for items |
| [post-engagement](help/spec/database/db-post-engagement) | Engagement data per post |
| [post-history](help/spec/database/db-post-history) | Post history |
| [post-link](help/spec/database/db-post-link) | Post related external links |
| [post-media](help/spec/database/db-post-media) | Attached media |
| [post-origin](help/spec/database/db-post-origin) | Posts from local users |
| [post-question](help/spec/database/db-post-question) | Question |
| [post-question-option](help/spec/database/db-post-question-option) | Question option |
| [post-searchindex](help/spec/database/db-post-searchindex) | Content for all posts |
| [post-tag](help/spec/database/db-post-tag) | post relation to tags |
| [post-thread](help/spec/database/db-post-thread) | Thread related data |
| [post-thread-user](help/spec/database/db-post-thread-user) | Thread related data per user |
| [post-user](help/spec/database/db-post-user) | User specific post data |
| [post-user-notification](help/spec/database/db-post-user-notification) | User post notifications |
| [process](help/spec/database/db-process) | Currently running system processes |
| [profile](help/spec/database/db-profile) | user profiles data |
| [profile_field](help/spec/database/db-profile_field) | Custom profile fields |
| [register](help/spec/database/db-register) | registrations requiring admin approval |
| [report](help/spec/database/db-report) | |
| [report-post](help/spec/database/db-report-post) | Individual posts attached to a moderation report |
| [report-rule](help/spec/database/db-report-rule) | Terms of service rule lines relevant to a moderation report |
| [search](help/spec/database/db-search) | |
| [session](help/spec/database/db-session) | web session storage |
| [storage](help/spec/database/db-storage) | Data stored by Database storage backend |
| [subscription](help/spec/database/db-subscription) | Push Subscription for the API |
| [tag](help/spec/database/db-tag) | tags and mentions |
| [user](help/spec/database/db-user) | The local users |
| [user-contact](help/spec/database/db-user-contact) | User specific public contact data |
| [user-gserver](help/spec/database/db-user-gserver) | User settings about remote servers |
| [userd](help/spec/database/db-userd) | Deleted usernames |
| [verb](help/spec/database/db-verb) | Activity Verbs |
| [worker-ipc](help/spec/database/db-worker-ipc) | Inter process communication between the frontend and the worker |
| [workerqueue](help/spec/database/db-workerqueue) | Background tasks queue entries |

View file

@ -1,5 +1,4 @@
Friendica Message Flow
===
# Friendica message flow
This page documents some of the details of how messages get from one person to another in the Friendica network.
There are multiple paths, using multiple protocols and message formats.
@ -11,7 +10,7 @@ This file also invokes the local side of all deliveries including DFRN-notify.
mod/dfrn_notify.php handles the remote side of DFRN-notify.
Local feeds are generated by mod/dfrn_poll.php - which also handles the remote side of DFRN-poll protocol.
Local feeds are generated by mod/dfrn_poll.php - which also handles the remote side of DFRN-poll protocol.
Salmon notifications arrive via mod/salmon.php.
@ -19,7 +18,7 @@ Push (pubsubhubbub) feeds arrive via mod/pubsub.php
DFRN-poll feed imports arrive via src/Worker/OnePoll.php as a scheduled task, this implements the local side of the DFRN-poll protocol.
### Scenario #1. Bob posts a public status message
## Scenario #1. Bob posts a public status message
This is a public message with no conversation members so no private transport is used.
There are two paths it can take - as a bbcode path to DFRN clients, and converted to HTML with the server's PuSH (pubsubhubbub) hubs notified.
@ -28,30 +27,30 @@ They will fall back on a daily poll in case the hub has delivery issues (this is
If there is no specified hub or hubs, DFRN clients will poll at a configurable (per-contact) rate at up to 5-minute intervals.
Feeds retrieved via dfrn-poll are bbcode and may also contain private conversations which the worker has permissions to see.
### Scenario #2. Jack replies to Bob's public message. Jack is on the Friendica/DFRN network.
## Scenario #2. Jack replies to Bob's public message. Jack is on the Friendica/DFRN network.
Jack uses dfrn-notify to send a direct reply to Bob.
Bob then creates a feed of the conversation and sends it to everybody involved in the conversation using dfrn-notify.
PuSH hubs are notified that new content is available.
The hub or hubs will then retrieve the latest feed and transmit it to all hub subscribers (which may be on different networks).
The hub or hubs will then retrieve the latest feed and transmit it to all hub subscribers (which may be on different networks).
### Scenario #3. Mary replies to Bob's public message. Mary is on the Friendica/DFRN network.
## Scenario #3. Mary replies to Bob's public message. Mary is on the Friendica/DFRN network.
Mary uses dfrn-notify to send a direct reply to Bob.
Bob then creates a feed of the conversation and sends it to everybody involved in the conversation (excluding himself, the conversation is now sent to both Jack and Mary).
Messages are sent using dfrn-notify.
Push hubs are also notified that new content is available.
The hub or hubs will then retrieve the latest feed and transmit it to all hub subscribers (which may be on different networks).
The hub or hubs will then retrieve the latest feed and transmit it to all hub subscribers (which may be on different networks).
### Scenario #4. William replies to Bob's public message. William is on the OStatus network.
## Scenario #4. William replies to Bob's public message. William is on the OStatus network.
William uses salmon to notify Bob of the reply.
Content is html embedded in salmon magic envelope.
Bob then creates a feed of the conversation and sends it to all Friendica participants involved in the conversation using dfrn-notify (excluding himself, the conversation is sent to both Jack and Mary).
Push hubs are notified that new content is available.
The hub or hubs will then retrieve the latest feed and transmit it to all hub subscribers (which may be on different networks).
The hub or hubs will then retrieve the latest feed and transmit it to all hub subscribers (which may be on different networks).
### Scenario #5. Bob posts a private message to Mary and Jack.
## Scenario #5. Bob posts a private message to Mary and Jack.
Message is delivered immediately to Mary and Jack using dfrn_notify.
Public hubs are not notified.

View file

Before

Width:  |  Height:  |  Size: 192 KiB

After

Width:  |  Height:  |  Size: 192 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 235 KiB

After

Width:  |  Height:  |  Size: 235 KiB

Before After
Before After

View file

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

Before After
Before After

Some files were not shown because too many files have changed in this diff Show more