casraf/nextcloud-forum
1
0
Fork 0
mirror of https://github.com/chenasraf/nextcloud-forum.git synced 2026-05-18 09:38:58 +00:00
Code Issues Packages Projects Releases Wiki Activity
Page: Users
Pages
Administration Development Home OCC Commands Troubleshooting Users
Clone
6
Users
Chen Asraf edited this page 2026-04-03 20:24:43 +03:00
Table of Contents

Getting Started

  1. Browse Categories - Start from the home page to see all available discussion areas
  2. Read Threads - Click on any thread to view the discussion
  3. Subscribe to Threads - Get notifications when new posts are added
  4. Participate - Reply to threads or create new ones (if you have permission)

Creating Content

Starting a New Thread

  1. Navigate to a category
  2. Click "New Thread" or the create button
  3. Enter a title and your message
  4. Use BBCode formatting for rich content
  5. Optionally attach files from your Nextcloud storage
  6. Your thread draft is automatically saved per category - you can return to it later

Replying to Threads

  1. Scroll to the bottom of a thread
  2. Enter your reply in the editor
  3. Use the formatting toolbar for BBCode
  4. Submit your post

BBCode Formatting

Common formatting options:

  • Bold - [b]text[/b]
  • Italic - [i]text[/i]
  • Underline - [u]text[/u]
  • Strikethrough - [s]text[/s]
  • Links - [url=https://example.com]link text[/url]
  • Images - [img]https://example.com/image.jpg[/img]
  • Code - [code]your code[/code]
  • Quote - [quote]quoted text[/quote]
  • Lists - [list][*]item 1[*]item 2[/list]
  • Spoiler - [spoiler="Title"]hidden content[/spoiler]
  • Color - [color=red]colored text[/color]
  • Size - [size=12]sized text[/size]
  • File Attachments - [attachment]/path/to/file[/attachment]
  • YouTube - [youtube]video-id[/youtube]

Mentions

You can mention other accounts in your posts using the @ symbol:

  • Type @ followed by a username to mention someone
  • For usernames with spaces, use quotes: @"John Doe"
  • Mentioned accounts receive a notification
  • An autocomplete menu appears as you type to help find accounts

Attaching Files

Files from your Nextcloud storage can be attached to posts using the [attachment] BBCode. You can attach files in three ways:

Using the Attachment Button

When composing a post, click the paperclip icon in the toolbar to open the attachment menu:

  1. Pick file from Nextcloud
  • Browse your existing Nextcloud files
  • Select a file to attach
  • The file path will be inserted as [attachment]path/to/file[/attachment]
  1. Upload file to Nextcloud
  • Select a file from your computer
  • The file will be uploaded to your configured upload directory
  • Once complete, the attachment tag will be automatically inserted

Using Drag and Drop

You can also drag and drop files directly into the editor:

  1. Drag a file from your computer over the editor area
  2. A drop zone will appear indicating you can drop the file
  3. Release the file to start uploading
  4. The attachment will be inserted once the upload completes

Configuring Upload Directory

By default, uploaded files are saved to a "Forum" folder in your Nextcloud files. To change this:

  1. Go to Preferences (click your name in the top right)
  2. Find the Files section
  3. Enter your preferred directory path or click Browse to select a folder
  4. Click Save

Note: Attachments will be visible to anyone who can view the thread, regardless of the file's sharing settings. Do not attach files you would like to keep entirely private.

Reusable Templates

Save frequently used text snippets as templates for quick insertion:

  1. Click the template button in the BBCode toolbar (text box icon)
  2. Create templates with a name, BBCode content, and visibility setting
  3. Set visibility to control where templates appear:
    • Threads - Only when creating threads
    • Replies - Only when replying
    • Both - In all editors
    • Neither - Disabled (saved but hidden)
  4. Click "Insert" on any template to insert its content into the editor

Templates are personal to each account and persist across sessions.

Interacting with Posts

  • React with Emoji - Click the reaction button to add emoji reactions to posts
  • Quote Reply - Quote another post in your reply
  • Edit Your Posts - Edit your own posts after publishing (shows "edited" indicator)
  • View Edit History - See previous versions of edited posts, including who edited and when. Visibility depends on forum settings — see Edit History Visibility
  • View Account Profiles - Click on usernames to see post history and statistics

Thread Drafts

The forum automatically saves your work when creating threads:

  • Drafts are saved per category - one draft per category
  • Your title and content are preserved if you navigate away
  • Return to the same category to resume your draft
  • Drafts are deleted when you publish the thread

Bookmarks

Save threads you want to find quickly:

  • Click the bookmark icon on any thread to save it
  • Access all your bookmarks from the Bookmarks page in the navigation sidebar
  • Bookmarks show unread indicators when new posts are added
  • Remove a bookmark at any time by clicking the bookmark icon again

Thread Subscriptions

Stay updated on discussions:

  1. Subscribe - Click the subscribe button on any thread
  2. Notifications - Receive Nextcloud notifications for new posts
  3. Auto-Subscribe - Enable in preferences to automatically subscribe to threads you create or reply to
  4. Unsubscribe - Remove subscription anytime from the thread view

Search

Find content quickly:

  • Search Threads - Search thread titles and first posts
  • Search Posts - Search all post content
  • Filter by Category - Narrow results to specific categories
  • Advanced Queries - Use quotes for phrases, - to exclude, AND/OR for boolean logic

Example searches:

  • "feature request" - Exact phrase
  • bug -resolved - Bug posts excluding "resolved"
  • (feature OR enhancement) AND urgent - Complex query

Pagination

Thread lists and replies are paginated for better performance:

  • Navigate between pages using the pagination controls
  • Page numbers show with smart ellipses for long lists
  • First, previous, next, and last page buttons are available

Account Preferences

Customize your forum experience:

  • Auto-subscribe to threads I create — Automatically get notified when threads you create receive replies
  • Auto-subscribe to threads I reply to — Automatically subscribe when you post a reply
  • Upload directory — Set the directory where files uploaded through the forum go to in your storage
  • Signature — Set a BBCode-formatted signature that appears on your posts
  • Hide my edit history from other accounts — When enabled, other accounts cannot view the edit history of your posts. Administration and moderators can always view edit history. This option is only available when the forum administrator has enabled both public edit history and the account override setting. See Edit History Visibility for details.

Reading Experience

  • Read Markers - The forum tracks which posts you have read in each thread
  • Unread Indicators - See which threads and categories have new posts since your last visit
  • Last Read Position - The forum remembers where you left off in long threads
  • Deep Links - Link directly to a specific post within a thread