Documentation
5.4. Mastering the Posting Screen
TODO: How to write a new post and how to reply. Special items like attachments or polls are subsections. Don't forget to mention the "someone has replied before you replied" feature, the topic review, and so forth. Topic icons, smilies, post options, usage of HTML ... it would probably best to add a screenshot with arrows to the different sections.
Posting is the primary purpose of bulletin boards. There are two main types of posts you can make: a topic or a reply. Selecting the New Topic button in a forum button will take you to the posting screen. After submitting your post, a new topic will appear in that forum with your post as the first displayed. Other users (and you as well) are now able to reply to your topic by using the Post Reply button. This will once again bring you to the posting screen, allowying you to enter your post.
5.4.1. Posting Form
You will be taken to the posting form when you decide to post either a new topic or reply, where you can enter your post content.
Topic/Post Icon - The topic/post icon is a small icon that will display to the left of your post subject. This helps identify your post and make it stand out, though it is completely optional.
Subject - If you are creating a new topic with your post, the subject is required and will become the title of the topic. If you are replying to an existing topic, this is optional, but it can be changed.
Post Content - While not being labled, the large text box is where your actual post content will be entered. Here, along with your text, you may use things like Smilies or BBCode if the board administrator has them enabled.
Smilies - Smilies, or emoticons, are small images which can be inserted into your post to add expression emphasis. If Smilies are enabled, you will see the text "Smilies are ON" to the righthand of the Post Content box. Otherwise, you will see the text "Smilies are OFF." See Posting Smilies for further details.
BBCode - BBCode is a type of formatting that can be applied to your post content if BBCode has been enabled by the board administrator. If BBCode is enabled, you will see the text "BBCode is ON" to the righthand of the Post Content box. Otherwise, you will see the text "BBCode is OFF." See Posting BBCode for further details.
5.4.2. Smilies
Smilies, or emoticons, are small images which can be inserted into your post to add expression emphasis. To use Smiles, certain characters are put together to get the desired output. For example, typing :) will insert [insert smilie here], ;) will insert [insert wink smilie here], etc. Other smilies require the format :texthere: to display. For example, :roll: will insert smilie whose eyes are rolling: [insert rolling smilie here], and :cry: will insert a smilie who is crying: [insert crying smilie here].
In many cases you can also select which smilie you'd like to insert by clicking its picture to the righthand side of the Post Content text box. When clicked, the smilie's characters will appear at the current location of the curser in the text box.
If you wish to be able to use these characters in your post, but not have them appear as smilies, please see Posting Options.
5.4.3. BBCodes
TODO: What are BBcodes. Again, permission based which ones you can use. Explain syntax of the default ones (quote and URL for instance). How to disable BBcode by default, how to disable/enable it for one post.
BBCode is a type of formatting that can be applied to your post content, much like HTML. Unlike HTML, however, BBCode uses square brackets [ and ] instead of angled brackets < and >. Depending on the permissions the board administrator has set, you may be able to use only certain BBCodes or even none at all.
For detailed instructions on the useage of BBCode, you can click the BBCode link to the righthand of the Post Content text box. Please note that the administrator has the option to add new and custom BBCodes, so others may be availible to you which are not on this list.
Basic BBCodes and their outputs are as follows:
TODO: How do we want to go about displaying the output?
[b]Boldface text[/b]:
[i]Italicised text[/i]:
[u]Underlined text[/u]:
[quote]Quoted text[/quote]:
[quote="Name to quote"]Quoted text[/quote]:
[url]http://www.phpbb.com[/url]: http://www.phpbb.com
[url=http://www.phpbb.com]Linked text[/url]: Linked text
Again, for more detailed instructions on the useage of BBCode and the many other available BBCodes, please click the BBCode link to the righthand of the Post Content text bos.
5.4.4. Post Options
TODO: Gather various screenshots of the basic post options box. When posting a topic/reply and/or moderation functions, etc.
When posting either a new topic or reply, there are several post options that are available to you. You can view these options by selecting the Options tab from the section below the posting form. Depending on the permissions the board administrator has assigned to you or whether you are posting a topic or reply, these options will be different.
Disable BBCode - If BBCode is enabled on the board and you are allowed to use it, this option will be available. Checking this box will not convert any BBCode in your post content into its respected output. For example, [b]Bolded text[/b] will be seen in your post as exactly [b]Bolded text[/b].
Disable Smilies - If Smilies are enabled on the board and you are allowed to use them, this option will be available. Checking this box will not convert any of the smilie's characters to their respected image. For example, ;) will be seen in your post as exactly ;).
Do not automatically parse URLs - When entering a URL directly into your post content (in the format of http://....com or www.etc.com), by default it will be converted to a clickable string of text. However, if this box is checked when posting, these URLs will stay as a standard string of text.
Attach a signature (signatures can be altered via the UCP) - If this box is checked, the signature you have set in your profile will be attached to the post provided signatures have been enabled by the administrator and you have the proper permissions. For more information about signatures, please see UCP Signatures.
Send me an email when a reply is posted - If this box is checked, you will receive a notification (either by email, Jabber, etc) every time another user replies to the topic. This is called subscribing to the topic. For more information, please see UCP Subscriptions.
Lock topic - Provided you have moderation permissions in this forum, checking this box will result in the topic being locked after your reply has been posted. At this point, no one but moderators or administrators may reply to the topic. For more information, please see Locking a topic or post.
5.4.4.1. Topic Types
Provided you have the right permissions, you have the option of selecting various topic types when posting a new topic by using Post topic as. The four possible types are: Normal, Sticky, Announcement, and Global. By default, all new posts are Normal.
Normal - By selecting normal, your new topic will be a standard topic in the forum.
Sticky - Stickies are special topics in the forum. They are "stuck" to the top of the first page of the forum in which they are posted, above every Normal topic.
Announcement - Announcements are much like Stickies in that they are "stuck" to the top of the forum. However, they are different from stickies in two ways: 1) they are above Stickies, and 2) they appear at the top of every page of the forum instead of only the first page of topics.
Global - Global, or Global Announcements, are special types of Announcements which appear at the top of every page of every forum on the board. They appear above every other type of special topic.
You also have the ability to specify how long the special (stickies, announcements, and global announcements) keep their type. For example, an announcement is created and specified to stay "stuck" for 4 days. After the 4 days are over, the announcement will automatically be switched to a Normal topic.
5.4.5. Attachments
TODO: How to add attachments, what restrictions might there be. Note that one needs to have the permission to use attachments. How to add more than one file, and so forth.
5.4.6. Polls
TODO: Again, permission based should be noted. Explain how to add the different options, allow for multiple votes, vote changing, and so forth.
5.4.7. Drafts
TODO: Explain how to load and save drafts. A link to the UCP drafts section should be added for reference. Not sure if permission based.
